[PATCH v3 2/2] man/man3/timespec_get.3: Add ISO C23 time bases
From: Mark Harris <hidden>
Date: 2026-01-29 16:58:52
Subsystem:
the rest · Maintainer:
Linus Torvalds
Document new time bases TIME_MONOTONIC, TIME_ACTIVE, and TIME_THREAD_ACTIVE, introduced in ISO C23 and supported by glibc 2.43.[1] [1] <https://sourceware.org/git/?p=glibc.git;a=commit;h=f28a11e43f40> Signed-off-by: Mark Harris <redacted> --- v3: Use .TQ for time bases in STANDARDS and HISTORY v2: Split into two patches, add time bases to History section man/man3/timespec_get.3 | 49 ++++++++++++++++++++++++++++++++++++++++- 1 file changed, 48 insertions(+), 1 deletion(-)
diff --git a/man/man3/timespec_get.3 b/man/man3/timespec_get.3
index 67da4858c..4f0fe1a96 100644
--- a/man/man3/timespec_get.3
+++ b/man/man3/timespec_get.3@@ -29,7 +29,10 @@ .SH SYNOPSIS _ISOC11_SOURCE .fi .P -.BR timespec_getres (): +.BR timespec_getres (), +.BR TIME_MONOTONIC , +.BR TIME_ACTIVE , +.BR TIME_THREAD_ACTIVE : .nf _ISOC23_SOURCE .fi
@@ -67,6 +70,37 @@ .SH DESCRIPTION and .IR clock_getres(CLOCK_REALTIME,\~tp) , respectively. +.TP +.BR TIME_MONOTONIC " (since glibc 2.43)" +A time base that measures time since an unspecified point in the past, +where the time within a process will not decrease even if the +system's real time clock is set or adjusted. +The time and resolution in this time base +are the same as those retrieved by +.I clock_gettime(CLOCK_MONOTONIC,\~res) +and +.IR clock_getres(CLOCK_MONOTONIC,\~tp) , +respectively. +.TP +.BR TIME_ACTIVE " (since glibc 2.43)" +A process-specific time base that measures CPU time consumed by +the calling process. +The time and resolution in this time base +are the same as those retrieved by +.I clock_gettime(CLOCK_PROCESS_CPUTIME_ID,\~res) +and +.IR clock_getres(CLOCK_PROCESS_CPUTIME_ID,\~tp) , +respectively. +.TP +.BR TIME_THREAD_ACTIVE " (since glibc 2.43)" +A thread-specific time base that measures CPU time consumed by +the calling thread. +The time and resolution in this time base +are the same as those retrieved by +.I clock_gettime(CLOCK_THREAD_CPUTIME_ID,\~res) +and +.IR clock_getres(CLOCK_THREAD_CPUTIME_ID,\~tp) , +respectively. .SH RETURN VALUE .BR timespec_get () returns the nonzero
@@ -103,6 +137,12 @@ .SH STANDARDS POSIX.1-2024. .TP .BR timespec_getres () +.TQ +.B TIME_MONOTONIC +.TQ +.B TIME_ACTIVE +.TQ +.B TIME_THREAD_ACTIVE C23. .SH HISTORY .TP
@@ -113,6 +153,13 @@ .SH HISTORY .TP .BR timespec_getres () C23, glibc 2.34. +.TP +.B TIME_MONOTONIC +.TQ +.B TIME_ACTIVE +.TQ +.B TIME_THREAD_ACTIVE +C23, glibc 2.43. .SH SEE ALSO .BR clock_gettime (2), .BR clock_getres (2)
--
2.52.0