xref: /dflybsd-src/share/man/man9/time.9 (revision 86d7f5d305c6adaa56ff4582ece9859d73106103)
186d7f5d3SJohn Marino.\"	$NetBSD: time.9,v 1.1 1995/11/25 21:24:53 perry Exp $
286d7f5d3SJohn Marino.\"
386d7f5d3SJohn Marino.\" Copyright (c) 1994 Christopher G. Demetriou
486d7f5d3SJohn Marino.\" All rights reserved.
586d7f5d3SJohn Marino.\"
686d7f5d3SJohn Marino.\" Redistribution and use in source and binary forms, with or without
786d7f5d3SJohn Marino.\" modification, are permitted provided that the following conditions
886d7f5d3SJohn Marino.\" are met:
986d7f5d3SJohn Marino.\" 1. Redistributions of source code must retain the above copyright
1086d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer.
1186d7f5d3SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright
1286d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer in the
1386d7f5d3SJohn Marino.\"    documentation and/or other materials provided with the distribution.
1486d7f5d3SJohn Marino.\" 3. All advertising materials mentioning features or use of this software
1586d7f5d3SJohn Marino.\"    must display the following acknowledgement:
1686d7f5d3SJohn Marino.\"      This product includes software developed by Christopher G. Demetriou
1786d7f5d3SJohn Marino.\"      for the NetBSD Project.
1886d7f5d3SJohn Marino.\" 3. The name of the author may not be used to endorse or promote products
1986d7f5d3SJohn Marino.\"    derived from this software without specific prior written permission
2086d7f5d3SJohn Marino.\"
2186d7f5d3SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
2286d7f5d3SJohn Marino.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
2386d7f5d3SJohn Marino.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
2486d7f5d3SJohn Marino.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
2586d7f5d3SJohn Marino.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
2686d7f5d3SJohn Marino.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
2786d7f5d3SJohn Marino.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
2886d7f5d3SJohn Marino.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
2986d7f5d3SJohn Marino.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
3086d7f5d3SJohn Marino.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
3186d7f5d3SJohn Marino.\"
3286d7f5d3SJohn Marino.\" $FreeBSD: src/share/man/man9/time.9,v 1.3.2.5 2001/08/17 13:08:54 ru Exp $
3386d7f5d3SJohn Marino.\" $DragonFly: src/share/man/man9/time.9,v 1.3 2008/04/09 21:41:59 swildner Exp $
3486d7f5d3SJohn Marino.\"
3586d7f5d3SJohn Marino.Dd April 9, 2008
3686d7f5d3SJohn Marino.Dt TIME 9
3786d7f5d3SJohn Marino.Os
3886d7f5d3SJohn Marino.Sh NAME
3986d7f5d3SJohn Marino.Nm boottime ,
4086d7f5d3SJohn Marino.Nm time_second
4186d7f5d3SJohn Marino.Nd system time variables
4286d7f5d3SJohn Marino.Sh SYNOPSIS
4386d7f5d3SJohn Marino.In sys/time.h
4486d7f5d3SJohn Marino.Pp
4586d7f5d3SJohn Marino.Vt extern struct timeval boottime ;
4686d7f5d3SJohn Marino.Vt extern time_t time_second ;
4786d7f5d3SJohn Marino.Sh DESCRIPTION
4886d7f5d3SJohn MarinoThe
4986d7f5d3SJohn Marino.Va boottime
5086d7f5d3SJohn Marinovariable holds the system boot time.
5186d7f5d3SJohn MarinoThe
5286d7f5d3SJohn Marino.Va time_second
5386d7f5d3SJohn Marinovariable is the system's
5486d7f5d3SJohn Marino.Dq wall time
5586d7f5d3SJohn Marinoclock to the second.
5686d7f5d3SJohn Marino.Pp
5786d7f5d3SJohn MarinoThe
5886d7f5d3SJohn Marino.Xr microtime 9 ,
5986d7f5d3SJohn Marino.Xr getmicrotime 9 ,
6086d7f5d3SJohn Marino.Xr nanotime 9 ,
6186d7f5d3SJohn Marinoand
6286d7f5d3SJohn Marino.Xr getnanotime 9
6386d7f5d3SJohn Marinofunctions can be used to get the current time in an atomic manner.
6486d7f5d3SJohn MarinoSimilarly, the
6586d7f5d3SJohn Marino.Xr microuptime 9 ,
6686d7f5d3SJohn Marino.Xr getmicrouptime 9 ,
6786d7f5d3SJohn Marino.Xr nanouptime 9 ,
6886d7f5d3SJohn Marinoand
6986d7f5d3SJohn Marino.Xr getnanouptime 9
7086d7f5d3SJohn Marinofunctions can be used to get the time elapsed since boot in an atomic manner.
7186d7f5d3SJohn MarinoThe
7286d7f5d3SJohn Marino.Va boottime
7386d7f5d3SJohn Marinovariable may be read and written without special precautions.
7486d7f5d3SJohn Marino.Sh SEE ALSO
7586d7f5d3SJohn Marino.Xr clock_settime 2 ,
7686d7f5d3SJohn Marino.Xr ntp_adjtime 2 ,
7786d7f5d3SJohn Marino.Xr settimeofday 2 ,
7886d7f5d3SJohn Marino.Xr inittodr 9 ,
7986d7f5d3SJohn Marino.Xr microtime 9 ,
8086d7f5d3SJohn Marino.Xr microuptime 9
81