1
2TIMER_SETTIME(2)           Linux Programmer's Guide           TIMER_SETTIME(2)
3
4
5

NAME

7       timer_settime - Set the time on a POSIX.1b interval timer
8

SYNOPSIS

10       long sys_timer_settime (timer_t timer_id, int flags,
11                               const struct itimerspec *new_setting,
12                               struct itimerspec *old_setting);
13
14

DESCRIPTION

16       time_settime  arms the time and sets the time if the new_setting struct
17       member it_value is non-zero, until the next  expiration  of  the  timer
18       specified  by  timer_id. If the timer was already armed when timer_set‐
19       time was called, the call resets the time until the next expiration  to
20       new_setting.  If the it_value of new_setting is zero, then the timer is
21       disarmed. If old_setting is non-NULL, the function stores the  previous
22       amount  of  time  before  the  timer would have expired, or zero if the
23       timer was disarmed along withthe previous timer reload  value  in  this
24       argument.
25
26

RETURN VALUE

28       timer_settime  returns  0  on success. Otherwise, timer_settime returns
29       the errors listed in the "Errors" section.
30
31

ERRORS

33       -EINVAL
34              An invalid timer_id value was specified.
35
36
37       -EFAULT
38              The new_setting valid is invalid.
39
40

SEE ALSO

42       timer_create(2),   timer_delete(2),   timer_getovverun(2),   timer_get‐
43       time(2).
44
45

AUTHOR

47       Niki Rahimi.
48
49
50
51Linux 2.6                        2004-March-12                TIMER_SETTIME(2)
Impressum