TIMER_SETTIME
Section: Linux Programmer's Guide (2)Updated: 2004-March-12
Index Return to Main Contents
NAME
timer_settime - Set the time on a POSIX.1b interval timerSYNOPSIS
- long sys_timer_settime (timer_t timer_id, int flags, const struct itimerspec *new_setting, struct itimerspec *old_setting);
DESCRIPTION
time_settime arms the time and sets the time if the new_setting struct member it_value is non-zero, until the next expiration of the timer specified by timer_id. If the timer was already armed when timer_settime was called, the call resets the time until the next expiration to new_setting. If the it_value of new_setting is zero, then the timer is disarmed. If old_setting is non-NULL, the function stores the previous amount of time before the timer would have expired, or zero if the timer was disarmed along withthe previous timer reload value in this argument.
RETURN VALUE
timer_settime returns 0 on success. Otherwise, timer_settime returns the errors listed in the "Errors" section.
ERRORS
- -EINVAL
- An invalid timer_id value was specified.
- -EFAULT
- The new_setting valid is invalid.
SEE ALSO
timer_create(2), timer_delete(2), timer_getovverun(2), timer_gettime(2).
AUTHOR
Niki Rahimi.
Index
This document was created by man2html, using the manual pages.
Time: 05:33:05 GMT, December 24, 2015