aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--man2/timerfd_create.222
1 files changed, 22 insertions, 0 deletions
diff --git a/man2/timerfd_create.2 b/man2/timerfd_create.2
index 066e0bee3a..63b8695898 100644
--- a/man2/timerfd_create.2
+++ b/man2/timerfd_create.2
@@ -317,6 +317,28 @@ fails with the error
if the real-time clock undergoes a discontinuous change.
(This allows the reading application to discover
such discontinuous changes to the clock.)
+.IP
+If the associated clock is either
+.BR CLOCK_REALTIME
+or
+.BR CLOCK_REALTIME_ALARM ,
+the timer is absolute
+.RB ( TFD_TIMER_ABSTIME ),
+and the flag
+.BR TFD_TIMER_CANCEL_ON_SET
+was
+.I not
+specified when calling
+.BR timerfd_settime (),
+then a discontinuous negative change to the clock (e.g.,
+.BR clock_settime (2))
+may cause
+.BR read (2)
+to unblock, but return a value of 0 (i.e., no bytes read),
+if the clock change occurs after the time expired,
+but before the
+.BR read (2)
+on the file descriptor.
.TP
.BR poll "(2), " select "(2) (and similar)"
The file descriptor is readable