N64® Functions Menu

al - Audio Library Functions
gDP - DP GBI Macros
gdSP - General GBI Macros
gSP - SP GBI Macros
gt - Turbo Microcode RDP
gu - Graphics Utilities
Math - Math Functions
nuSys - NuSystem
os - N64 Operating System
sp - Sprite Library Functions
uh - Host to Target IO
64DD - N64 Disk Drive

Nintendo® Confidential

   

osCreateLog
osLogEvent
osFlushLog

Format
#include <ultra64.h>
void osCreateLog(OSLog *log, u32 *base, s32 len);
void osLogEvent(OSLog *log, s16 code, s16 numArgs, ...);
void osFlushLog(OSLog *log);


What These Functions Do
The osCreateLog, osLogEvent, and osFlushLog functions are logging utilities.

Logging provides an alternate mechanism to the osSyncPrintf tool for formatted character string output that has a lesser immediate performance impact. Logging works by buffering the output information in DRAM for later use. This delays the relatively expensive transfer to and formatting by the host. Conversely, the osSyncPrintf tool formats the given character string on the target and flushes the string back to the host immediately upon its invocation. Logging may be preferable for cases such as the debug of real-time problems or for performance analysis.

An OSLog data structure acts as a handle by which an individual log is referenced by the logging routines. The osCreateLog function initializes this structure. The base argument is a pointer to a memory region of len 32-bit words that will hold the actual log data.

The osLogEvent routine adds an entry to the given log. The log entry begins with a 16-bit code, followed by an additional argument count (numArgs), and finally the additional arguments themselves. There may be no more than OS_LOG_MAX_ARGS, or 16, additional arguments. The arguments are limited to 32-bit quantities, and may not be address pointers, including character strings.

The osFlushLog routine transfers the log data to the host, where the gload program interprets and print the log. The gload program looks up the logging code in a format file and applies the format string to the remaining arguments.

Example
Suppose the format file has this line:

10 "The hexadecimal equivalent of %d is 0x%x"

Then this call:

osLogEvent(log, 10, 2, 16, 16);

causes gload to output:

0xXXXXXXX (0010): The hexadecimal equivalent of 16 is 0x10

See Also
gload


Nintendo® Confidential

Warning: all information in this document is confidential and covered by a non-disclosure agreement. You are responsible for keeping this information confidential and protected. Nintendo will vigorously enforce this responsibility.


Copyright © 1998
Nintendo of America Inc. All rights reserved
Nintendo and N64 are registered trademarks of Nintendo
Last updated January 1998