Skip to contentSkip to conversation

clock_getres.2: Document CLOCK_TAI

PATCH New Benjamin Peterson 2 participants 3 messages Mar 21, 2020 – Mar 26, 2020 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore

Benjamin Peterson

author
#0 lore raw

PATCH 1/1 clock_getres.2: Document CLOCK_TAI

Signed-off-by Benjamin Peterson <[email protected]>
---
 man2/clock_getres.2 | 10 ++++++++++
 1 file changed, 10 insertions(+)
man2/clock_getres.2 +10 -0
index 3fb0ac61c..0f619ab0b 100644
@@ -137,6 +137,16 @@ Requires per-architecture support,
 and probably also architecture support for this flag in the
 .BR vdso (7).
 .TP
+.BR CLOCK_TAI " (since Linux 3.10; Linux-specific)"
+.\" Added in commit 1ff3c9677bff7e468e0c487d0ffefe4e901d33f4
+System-wide clock derived from wall time ignoring leap seconds. This clock does
+experience discontinuities and backwards jumps caused by NTP inserting leap
+seconds as
+.BR CLOCK_REALTIME
+does.
+.IP
+The acronym TAI refers to International Atomic Time.
+.TP
 .B CLOCK_MONOTONIC
 Clock that cannot be set and represents monotonic time since\(emas described
 by POSIX\(em"some unspecified point in the past".
Signature · 1 line
2.20.1
author
#1 lore raw

PATCH 1/1 clock_getres.2: Document CLOCK_TAI

Signed-off-by Benjamin Peterson <[email protected]>
---
 man2/clock_getres.2 | 10 ++++++++++
 1 file changed, 10 insertions(+)
man2/clock_getres.2 +10 -0
index 3fb0ac61c..7b25b8f65 100644
@@ -137,6 +137,16 @@ Requires per-architecture support,
 and probably also architecture support for this flag in the
 .BR vdso (7).
 .TP
+.BR CLOCK_TAI " (since Linux 3.10; Linux-specific)"
+.\" Added in commit 1ff3c9677bff7e468e0c487d0ffefe4e901d33f4
+System-wide clock derived from wall time but ignoring leap seconds. This clock does
+not experience discontinuities and backwards jumps caused by NTP inserting leap
+seconds as
+.BR CLOCK_REALTIME
+does.
+.IP
+The acronym TAI refers to International Atomic Time.
+.TP
 .B CLOCK_MONOTONIC
 Clock that cannot be set and represents monotonic time since\(emas described
 by POSIX\(em"some unspecified point in the past".
Signature · 1 line
2.20.1
#2 lore raw

Hello Benjamin,

Thanks! Patch applied. (Just for the future, when you send a second version of a patch, it make life a little easier for me if you note what has changed.)

Cheers,

Michael

Quoted 27 lines · Benjamin Peterson
Signed-off-by Benjamin Peterson <[email protected]>
---
 man2/clock_getres.2 | 10 ++++++++++
 1 file changed, 10 insertions(+)
man2/clock_getres.2 +10 -0
index 3fb0ac61c..7b25b8f65 100644
@@ -137,6 +137,16 @@ Requires per-architecture support,
 and probably also architecture support for this flag in the
 .BR vdso (7).
 .TP
+.BR CLOCK_TAI " (since Linux 3.10; Linux-specific)"
+.\" Added in commit 1ff3c9677bff7e468e0c487d0ffefe4e901d33f4
+System-wide clock derived from wall time but ignoring leap seconds. This clock does
+not experience discontinuities and backwards jumps caused by NTP inserting leap
+seconds as
+.BR CLOCK_REALTIME
+does.
+.IP
+The acronym TAI refers to International Atomic Time.
+.TP
 .B CLOCK_MONOTONIC
 Clock that cannot be set and represents monotonic time since\(emas described
 by POSIX\(em"some unspecified point in the past".
Signature · 3 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/