kqueue: document how timers with low/past timeouts are handled

(cherry picked from commit 4b5554cebb)
This commit is contained in:
Kyle Evans 2021-09-30 13:19:05 -05:00
parent 121740e185
commit b7e90b290a

View file

@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd September 7, 2021
.Dd October 6, 2021
.Dt KQUEUE 2
.Os
.Sh NAME
@ -584,6 +584,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