summaryrefslogtreecommitdiffstats
path: root/man2/adjtimex.2
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 19:41:07 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 19:41:07 +0000
commit3af6d22bb3850ab2bac67287e3a3d3b0e32868e5 (patch)
tree3ee7a3ec64525911fa865bb984c86d997d855527 /man2/adjtimex.2
parentAdding debian version 6.05.01-1. (diff)
downloadmanpages-3af6d22bb3850ab2bac67287e3a3d3b0e32868e5.tar.xz
manpages-3af6d22bb3850ab2bac67287e3a3d3b0e32868e5.zip
Merging upstream version 6.7.
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man2/adjtimex.2')
-rw-r--r--man2/adjtimex.231
1 files changed, 15 insertions, 16 deletions
diff --git a/man2/adjtimex.2 b/man2/adjtimex.2
index c850a3d..e5264df 100644
--- a/man2/adjtimex.2
+++ b/man2/adjtimex.2
@@ -8,7 +8,7 @@
.\" Modified 1997-07-30 by Paul Slootman <paul@wurtel.demon.nl>
.\" Modified 2004-05-27 by Michael Kerrisk <mtk.manpages@gmail.com>
.\"
-.TH adjtimex 2 2023-07-20 "Linux man-pages 6.05.01"
+.TH adjtimex 2 2023-10-31 "Linux man-pages 6.7"
.SH NAME
adjtimex, clock_adjtime, ntp_adjtime \- tune kernel clock
.SH LIBRARY
@@ -17,11 +17,11 @@ Standard C library
.SH SYNOPSIS
.nf
.B #include <sys/timex.h>
-.PP
+.P
.BI "int adjtimex(struct timex *" "buf" );
-.PP
+.P
.BI "int clock_adjtime(clockid_t " clk_id, " struct timex *" "buf" );
-.PP
+.P
.BI "int ntp_adjtime(struct timex *" buf );
.fi
.SH DESCRIPTION
@@ -34,7 +34,7 @@ It takes a pointer to a
structure, updates kernel parameters from (selected) field values,
and returns the same structure updated with the current kernel values.
This structure is declared as follows:
-.PP
+.P
.in +4n
.EX
struct timex {
@@ -81,7 +81,7 @@ struct timex {
};
.EE
.in
-.PP
+.P
The
.I modes
field determines which parameters, if any, to set.
@@ -204,7 +204,7 @@ and the difference between TAI and UTC, see
.B ADJ_TICK
Set tick value from
.IR buf.tick .
-.PP
+.P
Alternatively,
.I modes
can be specified as either of the following (multibit mask) values,
@@ -236,13 +236,13 @@ This feature was added in Linux 2.6.24,
but did not work correctly
.\" commit 916c7a855174e3b53d182b97a26b2e27a29726a1
until Linux 2.6.28.
-.PP
+.P
Ordinary users are restricted to a value of either 0 or
.B ADJ_OFFSET_SS_READ
for
.IR modes .
Only the superuser may set any parameters.
-.PP
+.P
The
.I buf.status
field is a bit mask that is used to set and/or retrieve status
@@ -346,7 +346,7 @@ Mode (0 = Phase Locked Loop, 1 = Frequency Locked Loop).
.\" commit eea83d896e318bda54be2d2770d2c5d6668d11db
.\" Author: Roman Zippel <zippel@linux-m68k.org>
Clock source (0 = A, 1 = B); currently unused.
-.PP
+.P
Attempts to set read-only
.I status
bits are silently ignored.
@@ -452,13 +452,13 @@ The symbolic name
is a synonym for
.BR TIME_ERROR ,
provided for backward compatibility.
-.PP
+.P
Note that starting with Linux 3.4,
.\" commit 6b43ae8a619d17c4935c3320d2ef9e92bdeed05d changed to asynchronous
.\" operation, so we can no longer rely on the return code.
the call operates asynchronously and the return value usually will
not reflect a state change caused by the call itself.
-.PP
+.P
On failure, these calls return \-1 and set
.I errno
to indicate the error.
@@ -548,14 +548,13 @@ T{
.BR \%ntp_adjtime ()
T} Thread safety MT-Safe
.TE
-.sp 1
.SH STANDARDS
.TP
.BR adjtimex ()
.TQ
.BR clock_adjtime ()
Linux.
-.PP
+.P
The preferred API for the NTP daemon is
.BR ntp_adjtime ().
.SH NOTES
@@ -571,7 +570,7 @@ actually means 2\[ha]-16 ppm, and 2\[ha]16=65536 is 1 ppm.
This is the case for both input values (in the case of
.IR freq )
and output values.
-.PP
+.P
The leap-second processing triggered by
.B STA_INS
and
@@ -589,7 +588,7 @@ for the leap second to be inserted or deleted.
.BR time (7),
.BR adjtimex (8),
.BR hwclock (8)
-.PP
+.P
.ad l
.UR http://www.slac.stanford.edu/comp/unix/\:package/\:rtems/\:src/\:ssrlApps/\:ntpNanoclock/\:api.htm
NTP "Kernel Application Program Interface"