TIMER_DELETE(3C) Standard C Library Functions TIMER_DELETE(3C)
timer_delete - delete a timer
#include <time.h>
int timer_delete(timer_t timerid);
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.
If successful, the function returns 0. Otherwise, the function
returns -1 and sets errno to indicate the error.
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.
See attributes(7) for descriptions of the following attributes:
+--------------------+-------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-------------------------+
|Interface Stability | Committed |
+--------------------+-------------------------+
|MT-Level | MT-Safe with exceptions |
+--------------------+-------------------------+
|Standard | See standards(7). |
+--------------------+-------------------------+
timer_create(3C), attributes(7), standards(7)
February 5, 2008 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(7) for descriptions of the following attributes:
+--------------------+-------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-------------------------+
|Interface Stability | Committed |
+--------------------+-------------------------+
|MT-Level | MT-Safe with exceptions |
+--------------------+-------------------------+
|Standard | See standards(7). |
+--------------------+-------------------------+
SEE ALSO
timer_create(3C), attributes(7), standards(7)
February 5, 2008 TIMER_DELETE(3C)