1 .TH TIME 3
2 .SH NAME
3 time, nsec \- time in seconds and nanoseconds since epoch
4 .SH SYNOPSIS
5 .B #include <u.h>
6 .br
7 .B #include <libc.h>
8 .PP
9 .nf
10 .B
11 long time(long *tp)
12 .PP
13 .B
14 vlong nsec(void)
15 .SH DESCRIPTION
16 Both
17 .I time
18 and
19 .I nsec
20 return the time since the epoch 00:00:00 GMT, Jan. 1, 1970.
21 The return value of the former is in seconds and the latter in nanoseconds.
22 For
23 .IR time ,
24 if
25 .I tp
26 is not zero then
27 .BI * tp
28 is also set to the answer.
29 .PP
30 These functions work by reading
31 .BR /dev/bintime ,
32 opening that file when
33 .I they
34 are first called.
35 .SH SOURCE
36 .B /sys/src/libc/9sys/time.c
37 .br
38 .B /sys/src/libc/9sys/nsec.c
39 .SH SEE ALSO
40 .IR cons (3)
41 .SH DIAGNOSTICS
42 Sets
43 .IR errstr .
44 .SH BUGS
45 These routines maintain a static file descriptor.