Macro

os_log_debug

Sends a debug-level message to the logging system.

Declaration

#define os_log_debug(log, format, ...)

Parameters

log

The OS_LOG_DEFAULT constant or a custom log object previously created by the os_log_create function.

format

A constant string or format string that produces a human-readable log message. See Formatting Log Messages.

Discussion

Debug-level messages are intended for use in a development environment while actively debugging your subsystem, not in shipping software. Debug-level messages sent by this function are only captured in memory when debug logging has been enabled through a configuration change. They’re purged in accordance with the configuration’s persistence setting.

Calling this function is equivalent to calling the os_log_with_type function and specifying a log type of OS_LOG_TYPE_DEBUG. Note that lengthy log messages may be truncated when stored by the logging system.

See Also

Generating Log Messages

os_log

Sends a default-level message to the logging system.

os_log_info

Sends an info-level message to the logging system.

os_log_error

Sends an error-level message to the logging system.

os_log_fault

Sends a fault-level message to the logging system.

os_log_with_type

Sends a message at a specific logging level, such as default, info, debug, error, or fault, to the logging system.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software