|
|
udi_debug_printf(3udi)
Output a debugging message
#include <udi.h>void udi_debug_printf ( const char *format, ... );ARGUMENTS format is the format string, which controls the formatting of the output string, as described for udi_snprintf.
... are the remaining arguments, which provide the values used for the formatting codes.
description The udi_debug_printf function is intended for use in driver debugging, as a simplified alternative to the pair of udi_snprintf and udi_trace_write, in cases where the output is not needed in production environments. It is expected that udi_debug_printf calls would typically not appear in a (compiled) production driver.
Where required by this or other UDI specifications to trace or log events, drivers must use udi_trace_write or udi_log_write instead of udi_debug_printf, since udi_debug_printf may be a no-op in some environments. Use of udi_debug_printf may impair driver or system performance.
Environments may choose to ignore any or all calls to udi_debug_printf. Some environments may have different operational modes (e.g. debug mode vs. non-debug mode) that treat udi_debug_printf differently. Environments intended to facilitate driver debugging should include at least an option to enable output from udi_debug_printf calls. All environments must at least provide the udi_debug_printf function, even if it does nothing.
Output from udi_debug_printf, if any, will be sent to an environment implementation-defined device, file, or application. Newline (`\n') characters in the format string or any string or character arguments will be translated to an appropriate end of line character(s); other control characters must not be used. Output from each call to udi_debug_printf may be truncated to 99 bytes of text. Note that if the output is truncated, any terminating newline character may have been discarded.