aboutsummaryrefslogtreecommitdiff
path: root/man/man3/time.3
blob: 90ec731155421018999e8fc360577f0ebe4d7c6a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
.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.