LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man2 / timer_settime.2

diff --git a/original/man2/timer_settime.2 b/original/man2/timer_settime.2
index ba596cb..2db50ea 100644 (file)
--- a/original/man2/timer_settime.2
+++ b/original/man2/timer_settime.2
@@ -1,6 +1,7 @@
 .\" Copyright (c) 2009 Linux Foundation, written by Michael Kerrisk
 .\"     <mtk.manpages@gmail.com>
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -20,7 +21,9 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
-.TH TIMER_SETTIME 2 2009-02-20 Linux "Linux Programmer's Manual"
+.\" %%%LICENSE_END
+.\"
+.TH TIMER_SETTIME 2 2012-10-15 Linux "Linux Programmer's Manual"
 .SH NAME
 timer_settime, timer_gettime \- arm/disarm and fetch
 state of POSIX per-process timer
@@ -30,7 +33,7 @@ state of POSIX per-process timer
 
 .BI "int timer_settime(timer_t " timerid ", int " flags ,
 .BI "                  const struct itimerspec *" new_value ,
-.BI "                  struct itimerspec * " old_value );
+.BI "                  struct itimerspec *" old_value );
 .BI "int timer_gettime(timer_t " timerid ", struct itimerspec *" curr_value );
 .fi
 
@@ -43,14 +46,14 @@ Feature Test Macro Requirements for glibc (see
 .sp
 .BR timer_settime (),
 .BR timer_gettime ():
-_POSIX_C_SOURCE >= 199309L
+_POSIX_C_SOURCE\ >=\ 199309L
 .SH DESCRIPTION
 .BR timer_settime ()
 arms or disarms the timer identified by
 .IR timerid .
 The
 .I new_value
-argument is an
+argument is pointer to an
 .I itimerspec
 structure that specifies the new initial value and
 the new interval for the timer.
@@ -80,7 +83,7 @@ structure that allows a time value to be specified
 in seconds and nanoseconds.
 These time values are measured according to the clock
 that was specified when the timer was created by
-.BR timer_create ()
+.BR timer_create (2).
 
 If
 .I new_value->it_value
@@ -104,7 +107,7 @@ the timer is reloaded from the value specified in
 .IR new_value->it_interval .
 If
 .I new_value->it_interval
-specifies a zero value
+specifies a zero value,
 then the timer expires just once, at the time specified by
 .IR it_value .
 
@@ -141,7 +144,8 @@ clock have no effect on relative timers based on that clock.
 
 If
 .I old_value
-is not NULL, then it returns the previous interval of the timer (in
+is not NULL, then it points to a buffer
+that is used to return the previous interval of the timer (in
 .IR old_value->it_interval )
 and the amount of time until the timer
 would previously have next expired (in
@@ -201,12 +205,20 @@ is negative or greater than 999,999,999.
 .SH VERSIONS
 These system calls are available since Linux 2.6.
 .SH CONFORMING TO
-POSIX.1-2001
+POSIX.1-2001.
 .SH EXAMPLE
 See
 .BR timer_create (2).
 .SH SEE ALSO
 .BR timer_create (2),
-.BR timer_settime (2),
 .BR timer_getoverrun (2),
 .BR time (7)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.