.TH osGetTime 3P local "Silicon Graphics, Inc."
.SH NAME
.upperok
osGetTime, osSetTime \- get, set real time counter value
.SH SYNOPSIS
.nf
\f3
.Op c
#include <ultra64.h>
.sp .8v
OSTime osGetTime(void);
.sp .8v
void osSetTime(OSTime time);
.Op
\f1
.fi
.SH DESCRIPTION
The
.I osGetTime
call returns the value of time since the last hard reset.
The time is expressed in CPU Count register cycles.
For NTSC systems, this counter increments at 45.6375 Mhz and each counter
tick represents approximately 21.91 nanoseconds.
For PAL systems, this counter increments at 46.5525 Mhz and each counter
tick represents approximately 21.48 nanoseconds.
When the counter reaches its maximum value,
it will roll over to zero and continue.
The 
.I osSetTime 
call is used to set the real time counter value. 
.sp
See
.IR OS_CYCLES_TO_NSEC (3P)
for useful macros for converting to and from counter cycle time and
nanoseconds or microseconds.
.sp
Note that the
.I OSTime
type is defined to be
.I u64
and so when using
.I rmonPrintf,
variables of this type must be specified with %llu rather than %i or %u.
.SH "SEE ALSO"
.IR osGetCount (3P),
.IR osLogEvent (3P),
.IR osSetTimer (3P),
.IR osTvType (3P)