.\" Copyright (c) 2006 by Michael Kerrisk <mtk.manpages@gmail.com>
.\"
+.\" %%%LICENSE_START(VERBATIM)
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
.\"
.\" 2008-06-24, mtk: added some details about where jiffies come into
.\" play; added section on high-resolution timers.
.\"
-.TH TIME 7 2012-10-28 "Linux" "Linux Programmer's Manual"
+.TH TIME 7 2016-03-15 "Linux" "Linux Programmer's Manual"
.SH NAME
time \- overview of time and timers
.SH DESCRIPTION
-.SS "Real time and process time"
+.SS Real time and process time
.I "Real time"
is defined as time measured from some fixed point,
either from a standard point in the past
.BR getrusage (2),
or
.BR clock (3).
-.SS "The hardware clock"
+.SS The hardware clock
Most computers have a (battery-powered) hardware clock which the kernel
reads at boot time in order to initialize the software clock.
For further details, see
.BR rtc (4)
and
.BR hwclock (8).
-.SS "The software clock, HZ, and jiffies"
+.SS The software clock, HZ, and jiffies
The accuracy of various system calls that set timeouts,
(e.g.,
.BR select (2),
.\" glibc gets this info with a little help from the ELF loader;
.\" see glibc elf/dl-support.c and kernel fs/binfmt_elf.c.
.\"
-.SS "High-resolution timers"
+.SS High-resolution timers
Before Linux 2.6.21, the accuracy of timer and sleep system calls
(see below) was also limited by the size of the jiffy.
HRTs are not supported on all hardware architectures.
(Support is provided on x86, arm, and powerpc, among others.)
-.SS "The Epoch"
+.SS The Epoch
UNIX systems represent time in seconds since the
.IR Epoch ,
1970-01-01 00:00:00 +0000 (UTC).
nearest second.
The system time can be changed using
.BR settimeofday (2).
-.SS "Broken-down time"
+.SS Broken-down time
Certain library functions use a structure of
type
.I tm
.BR strftime (3),
and
.BR strptime (3).
-.SS "Sleeping and setting timers"
+.SS Sleeping and setting timers
Various system calls and functions allow a program to sleep
(suspend execution) for a specified period of time; see
.BR nanosleep (2),
.nh
.BR date (1),
.BR time (1),
+.BR timeout (1),
.BR adjtimex (2),
.BR alarm (2),
.BR clock_gettime (2),
.BR clock (3),
.BR clock_getcpuclockid (3),
.BR ctime (3),
+.BR ntp_adjtime (3),
+.BR ntp_gettime (3),
.BR pthread_getcpuclockid (3),
.BR sleep (3),
.BR strftime (3),