[PATCH] clock_getres.2: Document CLOCK_TAI

[PATCH] clock_getres.2: Document CLOCK_TAI

[Benjamin Peterson]

Signed-off-by: Benjamin Peterson <benjamin@python.org>
---
 man2/clock_getres.2 | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/man2/clock_getres.2 b/man2/clock_getres.2
index 3fb0ac61c..0f619ab0b 100644
--- a/man2/clock_getres.2
+++ b/man2/clock_getres.2
@@ -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".
-- 
2.20.1

[PATCH] clock_getres.2: Document CLOCK_TAI

[Benjamin Peterson]

Signed-off-by: Benjamin Peterson <benjamin@python.org>
---
 man2/clock_getres.2 | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/man2/clock_getres.2 b/man2/clock_getres.2
index 3fb0ac61c..7b25b8f65 100644
--- a/man2/clock_getres.2
+++ b/man2/clock_getres.2
@@ -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".
-- 
2.20.1

Re: [PATCH] clock_getres.2: Document CLOCK_TAI

[Michael Kerrisk (man-pages)]

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


On 3/21/20 11:08 PM, Benjamin Peterson wrote:
> Signed-off-by: Benjamin Peterson <benjamin@python.org>
> ---
>  man2/clock_getres.2 | 10 ++++++++++
>  1 file changed, 10 insertions(+)
> 
> diff --git a/man2/clock_getres.2 b/man2/clock_getres.2
> index 3fb0ac61c..7b25b8f65 100644
> --- a/man2/clock_getres.2
> +++ b/man2/clock_getres.2
> @@ -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".
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/