From 172328c477b13458c5faa4cf81ad8669f6852aee Mon Sep 17 00:00:00 2001
From: Cormac Stephenson <c7s@kasku.net>
Date: Fri, 28 Jun 2024 10:45:44 -0600
Subject: [PATCH] timerfd.2: Add documentation for CLOCK_UPTIME and
 CLOCK_BOOTTIME

Add CLOCK_UPTIME and CLOCK_BOOTTIME options and a quick pointer
to clock_gettime(2) for a better definition of these values.

Reviewed-by: imp (small tweaks and added Xr)
Pull-Request: https://github.com/freebsd/freebsd-src/pull/1302
---
 lib/libsys/timerfd.2 | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/lib/libsys/timerfd.2 b/lib/libsys/timerfd.2
index 7a112ad0dfcb..ae6cc6f6f49a 100644
--- a/lib/libsys/timerfd.2
+++ b/lib/libsys/timerfd.2
@@ -23,7 +23,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd May 21, 2023
+.Dd June 28, 2024
 .Dt TIMERFD 2
 .Os
 .Sh NAME
@@ -95,9 +95,16 @@ argument specifies the clock used as a timing base and may be:
 .Bl -tag -width "Dv CLOCK_MONOTONIC" -compact
 .It Dv CLOCK_REALTIME
 Increments as a wall clock should.
+.It Dv CLOCK_BOOTTIME
 .It Dv CLOCK_MONOTONIC
 Increments monotonically in SI seconds.
+.It Dv CLOCK_UPTIME
+Increments monotonically in SI seconds, but is paused while the system is
+suspended.
 .El
+See
+.Xr clock_gettime 2
+for more precise definitions.
 .Pp
 The
 .Fa flags