| .TH TIME 3 | |
| .SH NAME | |
| time, nsec \- time in seconds and nanoseconds since epoch | |
| .SH SYNOPSIS | |
| .B #include <u.h> | |
| .br | |
| .B #include <libc.h> | |
| .PP | |
| .nf | |
| .B | |
| long time(long *tp) | |
| .PP | |
| .B | |
| vlong nsec(void) | |
| .SH DESCRIPTION | |
| Both | |
| .I time | |
| and | |
| .I nsec | |
| return the time since the epoch 00:00:00 GMT, Jan. 1, 1970. | |
| The return value of the former is in seconds and the latter in nanoseconds. | |
| For | |
| .IR time , | |
| if | |
| .I tp | |
| is not zero then | |
| .BI * tp | |
| is also set to the answer. | |
| .PP | |
| These functions work by reading | |
| .BR /dev/bintime , | |
| opening that file when | |
| .I they | |
| are first called. | |
| .SH SOURCE | |
| .B /usr/local/plan9/src/libc/9sys/time.c | |
| .br | |
| .B /usr/local/plan9/src/libc/9sys/nsec.c | |
| .SH SEE ALSO | |
| .IR cons (3) | |
| .SH DIAGNOSTICS | |
| Sets | |
| .IR errstr . | |
| .SH BUGS | |
| These routines maintain a static file descriptor. |