git: 246fadcb2d97 - stable/15 - _umtx_op.2: correct the description of the valid _clockid for _umtx_time

From: Konstantin Belousov <kib_at_FreeBSD.org>
Date: Tue, 17 Nov 2026 01:09:41 UTC
The branch stable/15 has been updated by kib:

URL: https://cgit.FreeBSD.org/src/commit/?id=246fadcb2d974dfe5850932763ab492f3395edc3

commit 246fadcb2d974dfe5850932763ab492f3395edc3
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2026-11-05 21:28:13 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2026-11-17 00:24:59 +0000

    _umtx_op.2: correct the description of the valid _clockid for _umtx_time
    
    (cherry picked from commit 701ac0b230503db65b53c7ee8a211b146fcc82c9)
---
 lib/libsys/_umtx_op.2 | 71 +++++++++++++++++++++++++++------------------------
 1 file changed, 38 insertions(+), 33 deletions(-)

diff --git a/lib/libsys/_umtx_op.2 b/lib/libsys/_umtx_op.2
index 8bdb20fa2178..f83690bcc250 100644
--- a/lib/libsys/_umtx_op.2
+++ b/lib/libsys/_umtx_op.2
@@ -190,36 +190,10 @@ member provides the clock identifier to use for timeout, when the
 request has both the
 .Dv CVWAIT_CLOCKID
 flag and the timeout specified.
-Valid clock identifiers are a subset of those for
-.Xr clock_gettime 2 :
-.Bl -bullet -compact
-.It
-.Dv CLOCK_MONOTONIC
-.It
-.Dv CLOCK_MONOTONIC_FAST
-.It
-.Dv CLOCK_MONOTONIC_PRECISE
-.It
-.Dv CLOCK_PROF
-.It
-.Dv CLOCK_REALTIME
-.It
-.Dv CLOCK_REALTIME_FAST
-.It
-.Dv CLOCK_REALTIME_PRECISE
-.It
-.Dv CLOCK_SECOND
-.It
-.Dv CLOCK_TAI
-.It
-.Dv CLOCK_UPTIME
-.It
-.Dv CLOCK_UPTIME_FAST
-.It
-.Dv CLOCK_UPTIME_PRECISE
-.It
-.Dv CLOCK_VIRTUAL
-.El
+Valid clock identifiers are the same as for the
+.Dv _clockid
+member of the
+.Vt struct _umtx_time .
 .It Sy Reader/writer lock
 .Bd -literal
 struct urwlock {
@@ -357,15 +331,46 @@ The
 member specifies the time when the timeout should occur.
 Legal values for clock identifier
 .Dv _clockid
-are shared with the
+are a subset of the valid values for the
 .Fa clock_id
 argument to the
 .Xr clock_gettime 2
-function,
-and use the same underlying clocks.
+function, and use the same underlying clocks.
 The specified clock is used to obtain the current time value.
 Interval counting is always performed by the monotonic wall clock.
 .Pp
+Currently accepted clocks are:
+.Bl -bullet -compact
+.It
+.Dv CLOCK_MONOTONIC
+.It
+.Dv CLOCK_MONOTONIC_FAST
+.It
+.Dv CLOCK_MONOTONIC_PRECISE
+.It
+.Dv CLOCK_PROCESS_CPUTIME_ID
+.It
+.Dv CLOCK_PROF
+.It
+.Dv CLOCK_REALTIME
+.It
+.Dv CLOCK_REALTIME_FAST
+.It
+.Dv CLOCK_REALTIME_PRECISE
+.It
+.Dv CLOCK_SECOND
+.It
+.Dv CLOCK_TAI
+.It
+.Dv CLOCK_UPTIME
+.It
+.Dv CLOCK_UPTIME_FAST
+.It
+.Dv CLOCK_UPTIME_PRECISE
+.It
+.Dv CLOCK_VIRTUAL
+.El
+.Pp
 The
 .Dv _flags
 argument allows the following flags to further define the timeout behaviour: