| .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. |
