timer_create(2) [netbsd man page]

TIMER_CREATE(2) 					      BSD System Calls Manual						   TIMER_CREATE(2)

NAME

     timer_create -- create a per-process timer

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <time.h>
     #include <signal.h>

     int
     timer_create(clockid_t clockid, struct sigevent * restrict evp, timer_t * restrict timerid);

DESCRIPTION

     The timer_create() function creates a per-process timer using the clock specified in the clockid argument.  If it succeeds, the
     timer_create() function fills in the timerid argument with an id associated with the timer created that can be used by other timer related
     calls.  The clockid must be a valid clock id as defined in <time.h>.  The timer is created in a disarmed state.

     An optional (non-NULL) struct sigevent argument can be specified by the evp argument.  If the evp argument is NULL, then evp->sigev_notify
     defaults to SIGEV_SIGNAL and evp->sigev_value is set to timerid.  Refer to sigevent(3) for more details.

NOTES

     Timers are not inherited after a fork(2) and are disarmed and deleted by an exec(3).

RETURN VALUES

     If successful, the timer_create() function returns 0, and fills in the timerid argument with the id of the new timer that was created.  Oth-
     erwise, it returns -1, and sets errno to indicate the error.

ERRORS

     The timer_create() function will fail if:

     [EAGAIN]		The system is out of resources to satisfy this request, or the process has created all the timers it is allowed.

     [EINVAL]		The argument clockid is not a valid clock id.

SEE ALSO

     clock_getres(2), clock_gettime(2), clock_settime(2), timer_delete(2), timer_getoverrun(2), timer_gettime(2), timer_settime(2)

STANDARDS

     IEEE Std 1003.1b-1993 (``POSIX.1''), IEEE Std 1003.1i-1995 (``POSIX.1'')

BSD
								   May 19, 2010 							       BSD

TIMER_SETTIME(2)					      BSD System Calls Manual						  TIMER_SETTIME(2)

NAME

     timer_settime, timer_gettime, timer_getoverrun -- process timer manipulation

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <time.h>

     int
     timer_settime(timer_t timerid, int flags, const struct itimerspec * restrict tim, struct itimerspec * restrict otim);

     int
     timer_gettime(timer_t timerid, struct itimerspec *tim);

     int
     timer_getoverrun(timer_t timerid);

DESCRIPTION

     The timer_settime() sets the next expiration time of the timer with ID timerid to the it_value (see itimerspec(3)) specified in the tim argu-
     ment.  If the value is 0, the timer is disarmed.  If the argument otim is not NULL the old timer settingas are returned.

     If the flags argument is set to TIMER_RELTIME then the expiration time is set to the value in nanoseconds specified in the tim argument from
     the time the call to timer_settime() was made.  If the flags argument is set to TIMER_ABSTIME then the expiration time is set to be equal to
     the difference between the clock associated with this timer, and the value specified in the tim argument.	If that time has already passed,
     then the call succeeds, and the expiration notification occurs.

     If the it_interval of the tim argument is non-zero, then the timer reloads upon expiration.

     The timer_gettime() function returns the current settings of the timer specified by the timerid argument in the tim argument.

     Only one notification event (signal) can be pending for a given timer and process.  If a timer expires while the signal is still queued for
     delivery, then the overrun counter for that timer is increased.  The counter can store values up to DELAYTIMER_MAX.  When the signal is
     finally delivered to the process, then the timer_getoverrun() function can be used to retrieve the overrun counter for the timer specified in
     the timerid argument.

NOTES

     Expiration time values are always rounded up to the resolution of the timer, so a notification will never be sent before the requested time.
     Values returned in the otim argument of timer_settime() or in the tim argment of timer_gettime() are subject to the above rounding effect and
     might not exactly match the requested values by the user.

RETURN VALUES

     If successful, the timer_gettime() and timer_settime() functions return 0, and the timer_getoverrun() function returns the expiration overrun
     count for the specified timer.  Otherwise, the functions return -1, and set errno to indicate the error.

ERRORS

     The timer_gettime(), timer_getoverrun(), and timer_settime() functions will fail if:

     [EINVAL]		The argument timerid does not correspond to a valid timer id as returned by timer_create() or that timer id has been
			deleted by timer_delete().

     The timer_settime() function will fail if:

     [EINVAL]		A nanosecond field in the tim structure specified a value less than zero or greater than or equal to 10e9.

SEE ALSO

     clock_gettime(2), timer_create(2), timer_delete(2)

STANDARDS

     IEEE Std 1003.1b-1993 (``POSIX.1''), IEEE Std 1003.1i-1995 (``POSIX.1'')

BSD
								   May 17, 2010 							       BSD