TimerDestroy(), TimerDestroy_r()

Destroy a process timer

Synopsis:

#include <sys/neutrino.h>

int TimerDestroy( timer_t id );

int TimerDestroy_r( timer_t id );

Library:

libc

Description:

The TimerDestroy() and TimerDestroy_r() functions are identical except in the way they indicate errors. See the Returns section for details.

These kernel calls remove a previously created timer specified by id. The timer is removed from the active system timer list and returned to the list of available timers.

If a timeout was pending when the timer is removed by TimerDestroy(), it is removed without being activated.

Blocking states

These calls don't block.

Returns:

The only difference between these functions is the way they indicate errors:

TimerDestroy(): If an error occurs, -1 is returned and errno is set. Any other value returned indicates success.
TimerDestroy_r(): EOK is returned on success. This function does NOT set errno. If an error occurs, any value in the Errors section may be returned.

Errors:

EINVAL: The timer specified by id doesn't exist.

Classification:

QNX 6

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	Yes
Thread	Yes