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





osProfileStart
osProfileStop

Syntax

#include <ultra64.h>
void osProfileStart(u32 microseconds);
void osProfileStop(void);


Explanation
The osProfileInit, osProfileStart, osProfileStop, and osProfileFlush functions provide execution time profiling for disjoint text spaces. Profiling provides CPU-use statistics by profiling the amount of CPU time expended by a program in disjoint text spaces. For general profiling information including the OSProf structure's field elements, the debugging error messages, and possible problems, see the osProfile page.

The osProfileStart function is called to start the profiler's interval counter. The microseconds argument sets the period of this timer; A typical value is 10000 microseconds (10 milliseconds). The minimum timer period is defined by PROF_MIN_INTERVAL. Each time an interrupt is generated by the counter, the profiler determines which profiled segment the PC belongs to and then increments the proper counter in the counter buffer for that segment. If the PC does not lie within any profiled segment, an internal overflow register is incremented. There is no protection for counter overflow. Remember to call osProfileInit before calling any other profiler function.

The osProfileStop function is called to turn off profiling. Profiling data remains in memory but is not incremented further. The thread started by osProfileInit to send profile data to the host continues to run. You can call it again to resume profiling.

See Also
osProfileInit
osProfileFlush
gperf
makerom (IRIX 5.3)
makerom (IRIX 6.x)



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 March 1998