xref: /dflybsd-src/share/man/man9/time.9 (revision 86d7f5d305c6adaa56ff4582ece9859d73106103)
1*86d7f5d3SJohn Marino.\"	$NetBSD: time.9,v 1.1 1995/11/25 21:24:53 perry Exp $
2*86d7f5d3SJohn Marino.\"
3*86d7f5d3SJohn Marino.\" Copyright (c) 1994 Christopher G. Demetriou
4*86d7f5d3SJohn Marino.\" All rights reserved.
5*86d7f5d3SJohn Marino.\"
6*86d7f5d3SJohn Marino.\" Redistribution and use in source and binary forms, with or without
7*86d7f5d3SJohn Marino.\" modification, are permitted provided that the following conditions
8*86d7f5d3SJohn Marino.\" are met:
9*86d7f5d3SJohn Marino.\" 1. Redistributions of source code must retain the above copyright
10*86d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer.
11*86d7f5d3SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright
12*86d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer in the
13*86d7f5d3SJohn Marino.\"    documentation and/or other materials provided with the distribution.
14*86d7f5d3SJohn Marino.\" 3. All advertising materials mentioning features or use of this software
15*86d7f5d3SJohn Marino.\"    must display the following acknowledgement:
16*86d7f5d3SJohn Marino.\"      This product includes software developed by Christopher G. Demetriou
17*86d7f5d3SJohn Marino.\"      for the NetBSD Project.
18*86d7f5d3SJohn Marino.\" 3. The name of the author may not be used to endorse or promote products
19*86d7f5d3SJohn Marino.\"    derived from this software without specific prior written permission
20*86d7f5d3SJohn Marino.\"
21*86d7f5d3SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
22*86d7f5d3SJohn Marino.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
23*86d7f5d3SJohn Marino.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
24*86d7f5d3SJohn Marino.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
25*86d7f5d3SJohn Marino.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
26*86d7f5d3SJohn Marino.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27*86d7f5d3SJohn Marino.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28*86d7f5d3SJohn Marino.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29*86d7f5d3SJohn Marino.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
30*86d7f5d3SJohn Marino.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31*86d7f5d3SJohn Marino.\"
32*86d7f5d3SJohn Marino.\" $FreeBSD: src/share/man/man9/time.9,v 1.3.2.5 2001/08/17 13:08:54 ru Exp $
33*86d7f5d3SJohn Marino.\" $DragonFly: src/share/man/man9/time.9,v 1.3 2008/04/09 21:41:59 swildner Exp $
34*86d7f5d3SJohn Marino.\"
35*86d7f5d3SJohn Marino.Dd April 9, 2008
36*86d7f5d3SJohn Marino.Dt TIME 9
37*86d7f5d3SJohn Marino.Os
38*86d7f5d3SJohn Marino.Sh NAME
39*86d7f5d3SJohn Marino.Nm boottime ,
40*86d7f5d3SJohn Marino.Nm time_second
41*86d7f5d3SJohn Marino.Nd system time variables
42*86d7f5d3SJohn Marino.Sh SYNOPSIS
43*86d7f5d3SJohn Marino.In sys/time.h
44*86d7f5d3SJohn Marino.Pp
45*86d7f5d3SJohn Marino.Vt extern struct timeval boottime ;
46*86d7f5d3SJohn Marino.Vt extern time_t time_second ;
47*86d7f5d3SJohn Marino.Sh DESCRIPTION
48*86d7f5d3SJohn MarinoThe
49*86d7f5d3SJohn Marino.Va boottime
50*86d7f5d3SJohn Marinovariable holds the system boot time.
51*86d7f5d3SJohn MarinoThe
52*86d7f5d3SJohn Marino.Va time_second
53*86d7f5d3SJohn Marinovariable is the system's
54*86d7f5d3SJohn Marino.Dq wall time
55*86d7f5d3SJohn Marinoclock to the second.
56*86d7f5d3SJohn Marino.Pp
57*86d7f5d3SJohn MarinoThe
58*86d7f5d3SJohn Marino.Xr microtime 9 ,
59*86d7f5d3SJohn Marino.Xr getmicrotime 9 ,
60*86d7f5d3SJohn Marino.Xr nanotime 9 ,
61*86d7f5d3SJohn Marinoand
62*86d7f5d3SJohn Marino.Xr getnanotime 9
63*86d7f5d3SJohn Marinofunctions can be used to get the current time in an atomic manner.
64*86d7f5d3SJohn MarinoSimilarly, the
65*86d7f5d3SJohn Marino.Xr microuptime 9 ,
66*86d7f5d3SJohn Marino.Xr getmicrouptime 9 ,
67*86d7f5d3SJohn Marino.Xr nanouptime 9 ,
68*86d7f5d3SJohn Marinoand
69*86d7f5d3SJohn Marino.Xr getnanouptime 9
70*86d7f5d3SJohn Marinofunctions can be used to get the time elapsed since boot in an atomic manner.
71*86d7f5d3SJohn MarinoThe
72*86d7f5d3SJohn Marino.Va boottime
73*86d7f5d3SJohn Marinovariable may be read and written without special precautions.
74*86d7f5d3SJohn Marino.Sh SEE ALSO
75*86d7f5d3SJohn Marino.Xr clock_settime 2 ,
76*86d7f5d3SJohn Marino.Xr ntp_adjtime 2 ,
77*86d7f5d3SJohn Marino.Xr settimeofday 2 ,
78*86d7f5d3SJohn Marino.Xr inittodr 9 ,
79*86d7f5d3SJohn Marino.Xr microtime 9 ,
80*86d7f5d3SJohn Marino.Xr microuptime 9
81