OSReport / OSVReport

Syntax

#include <cafe/os.h>

void OSReport(const char* msg, ...);

void OSVReport(const char* msg, va_list list);

Parameters

msg Pointer to a null-terminated string that includes format specification (equivalent to C standard output functions).
... Optional argument (OSReport).
list Additional argument (OSVReport).

Return Values

None.

Description

The OSReport function outputs formatted output data to the output port. The OSVReport function and the OSReport function are the same except that the OSVReport function takes the variable argument list list as an extra argument.

NOTE:
If OSReport output should exceed the rate that the debugging interface can handle, then messages may be dropped. This rare behavior is by design so that system performance is not adversely affected by blocking until the printing could catch up. When this happens, the following message is printed:
******* log buffer overrun, some text was dropped *******

Do Not Call From

OSReport

None.

OSVReport

None.

See Also

ASSERT
ASSERTMSG
OSGetConsoleType
OSHalt

Revision History

2013/10/15 Note potential for dropped output at high message rates.
2013/05/08 Automated cleanup pass.
2010/08/30 Initial version.


CONFIDENTIAL