Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 1 Oct 2021 02:31:43 GMT
From:      Kyle Evans <kevans@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org
Subject:   git: 4b5554cebb66 - main - kqueue: document how timers with low/past timeouts are handled
Message-ID:  <202110010231.1912Vhip054521@gitrepo.freebsd.org>

next in thread | raw e-mail | index | archive | help
The branch main has been updated by kevans:

URL: https://cgit.FreeBSD.org/src/commit/?id=4b5554cebb66020f59dc869b835aebbd66e4bb8c

commit 4b5554cebb66020f59dc869b835aebbd66e4bb8c
Author:     Kyle Evans <kevans@FreeBSD.org>
AuthorDate: 2021-09-30 18:19:05 +0000
Commit:     Kyle Evans <kevans@FreeBSD.org>
CommitDate: 2021-10-01 02:31:28 +0000

    kqueue: document how timers with low/past timeouts are handled
    
    Reviewed by:    markj
    Differential Revision:  https://reviews.freebsd.org/D32237
---
 lib/libc/sys/kqueue.2 | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/lib/libc/sys/kqueue.2 b/lib/libc/sys/kqueue.2
index 3ded4ae3d8f7..72b3e544391c 100644
--- a/lib/libc/sys/kqueue.2
+++ b/lib/libc/sys/kqueue.2
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd September 23, 2021
+.Dd September 30, 2021
 .Dt KQUEUE 2
 .Os
 .Sh NAME
@@ -599,6 +599,12 @@ On return,
 .Va fflags
 contains the events which triggered the filter.
 .Pp
+Periodic timers with a specified timeout of 0 will be silently adjusted to
+timeout after 1 of the time units specified by the requested precision in
+.Va fflags .
+If an absolute time is specified that has already passed, then it is treated as
+if the current time were specified and the event will fire as soon as possible.
+.Pp
 If an existing timer is re-added, the existing timer will be
 effectively canceled (throwing away any undelivered record of previous
 timer expiration) and re-started using the new parameters contained in



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202110010231.1912Vhip054521>