93 lines · 1.8 KB · Text
RawDownload
.TH SECONDS 9.SH NAMEseconds, ticks, fastticks, HZ, MS2HZ, MS2TK, TK2MS, TK2SEC \- kernel times and time conversions.SH SYNOPSIS.ta \w'\fL#define 'u.Blong	seconds(void).PP.Bm->ticks.brMACHP(0)->ticks.PP.Bvlong   	fastticks(uvlong *hz).PP.EX#define	HZ          ...#define	MS2HZ(t)    ...#define	TK2SEC(t)   ...#define	TK2MS(t)    ...#define	MS2TK(m)    ....EE.SH DESCRIPTION.I Secondsreturns the system's idea of the current time as the number of secondssince the start of the epoch(00:00:00 GMT, January 1, 1970)..PPThe.B ticksfield of the.B Machstructure pointed to by.B mreturns the number of system-dependent clock ticks on thegiven processor since system boot.On a multiprocessor,.B MACHP(0)is sometimes used to provide a reference time, since the tick valuemight vary slightly across processors..PP.I Fastticksreturns the number of ticks since boot as measured by thefastest clock provided by the platform.The frequency of the clock, in ticks per second,is returned through.IR hz ,unless it is nil..PPThe system clock frequencies are platform-dependent.Several symbolic constants and macro functions are defined bythe file.B mem.hto convert between different time units:.TF TK2SEC(t).PD.TP.B HZThe number of clock ticks per second..TP.B MS2HZMilliseconds per clock tick..TP.BI TK2SEC( t )Convert.I tclock ticks to seconds and return the result (truncating not rounding)..TP.BI TK2MS( t )Convert.I tclock ticks to milliseconds and return the result..TP.BI MS2TK( m )Convert.I mmilliseconds to clock ticks and return the result (truncating)..PPThe functions are often used to calculate delays for timing functions,for instance:.IP.EXif(atactlrwait(dp->cp, DHmagic, 0, MS2TK(100))){	...}.EE.SH SOURCE.B /sys/src/9/*/mem.h.br.B /sys/src/9/*/clock.c.br.B /sys/src/9/port/tod.c