git: 172328c477b1 - main - timerfd.2: Add documentation for CLOCK_UPTIME and CLOCK_BOOTTIME

The branch main has been updated by imp:

URL: https://cgit.FreeBSD.org/src/commit/?id=172328c477b13458c5faa4cf81ad8669f6852aee

commit 172328c477b13458c5faa4cf81ad8669f6852aee
Author:     Cormac Stephenson <c7s@kasku.net>
AuthorDate: 2024-06-28 16:45:44 +0000
Commit:     Warner Losh <imp@FreeBSD.org>
CommitDate: 2024-07-02 16:40:04 +0000

    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