aboutsummaryrefslogtreecommitdiffstats
path: root/man2/timerfd_create.2
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2011-09-14 07:38:35 +0200
committerMichael Kerrisk <mtk.manpages@gmail.com>2011-09-16 07:00:48 +0200
commit009cdc2239fe84d1a7862b4fa30f3258f49279e4 (patch)
tree8ae1a846b94352e20581041809252dc9279c98e9 /man2/timerfd_create.2
parentbb0fed2e8a7b3d5b722635343eff96c5781e8f4f (diff)
downloadman-pages-009cdc2239fe84d1a7862b4fa30f3258f49279e4.tar.gz
timerfd_create.2: Note behavior when timerdfd_settime() old_value is NULL
See http://bugs.debian.org/cgi-bin/bugreport.cgi?641513 timerfd_settime(2) states that "The old_value argument returns a structure containing the setting of the timer that was current at the time of the call"; however, it does not mention that the caller can pass NULL to ignore that value. Only the example shows that the caller can pass NULL. Reported-by: Josh Triplett <josh@joshtriplett.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Diffstat (limited to 'man2/timerfd_create.2')
-rw-r--r--man2/timerfd_create.211
1 files changed, 7 insertions, 4 deletions
diff --git a/man2/timerfd_create.2 b/man2/timerfd_create.2
index f90e2218d0..47117b95da 100644
--- a/man2/timerfd_create.2
+++ b/man2/timerfd_create.2
@@ -17,7 +17,7 @@
.\"
.\" FIXME: Linux 3.0: timerfd_settime() adds a TFD_TIMER_CANCEL_ON_SET flag.
.\"
-.TH TIMERFD_CREATE 2 2009-03-10 Linux "Linux Programmer's Manual"
+.TH TIMERFD_CREATE 2 2011-09-14 Linux "Linux Programmer's Manual"
.SH NAME
timerfd_create, timerfd_settime, timerfd_gettime \-
timers that notify via file descriptors
@@ -167,10 +167,13 @@ that is, the timer will expire when the value of that
clock reaches the value specified in
.IR new_value.it_value ).
-The
+If the
.I old_value
-argument returns a structure containing the setting of the timer that
-was current at the time of the call; see the description of
+argument is not NULL, then the
+.I itimerspec
+structure that it points to is used to return the setting of the timer
+that was current at the time of the call;
+see the description of
.BR timerfd_gettime ()
following.
.\"