TIMER_DELETE(3C) Standard C Library Functions TIMER_DELETE(3C)


NAME


timer_delete - delete a timer

SYNOPSIS


#include <time.h>

int timer_delete(timer_t timerid);


DESCRIPTION


The timer_delete() function deletes the specified timer, timerid,
previously created by the timer_create(3C) function. If the timer is
armed when timer_delete() is called, the behavior will be as if the timer
is automatically disarmed before removal. The disposition of pending
signals for the deleted timer is unspecified.

RETURN VALUES


If successful, the function returns 0. Otherwise, the function returns -1
and sets errno to indicate the error.

ERRORS


The timer_delete() function will fail if:

EINVAL
The timer ID specified by timerid is not a valid timer ID.


ENOSYS
The timer_delete() function is not supported by the system.


ATTRIBUTES


See attributes(5) for descriptions of the following attributes:


+--------------------+-------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-------------------------+
|Interface Stability | Committed |
+--------------------+-------------------------+
|MT-Level | MT-Safe with exceptions |
+--------------------+-------------------------+
|Standard | See standards(5). |
+--------------------+-------------------------+

SEE ALSO


timer_create(3C), attributes(5), standards(5)


February 5, 2008 TIMER_DELETE(3C)