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(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)