.\" 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.
.\"
.\" 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
.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
.sp
.BR timer_settime (),
.BR timer_gettime ():
-_POSIX_C_SOURCE >= 199309
+_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.
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
.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 .
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
.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/.