timer_delete man page

timer_delete — delete a POSIX per-process timer


#include <time.h>

int timer_delete(timer_t timerid);

Link with -lrt.

Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

timer_delete(): _POSIX_C_SOURCE >= 199309L


timer_delete() deletes the timer whose ID is given in timerid. If the timer was armed at the time of this call, it is disarmed before being deleted. The treatment of any pending signal generated by the deleted timer is unspecified.

Return Value

On success, timer_delete() returns 0. On failure, -1 is returned, and errno is set to indicate the error.


timerid is not a valid timer ID.


This system call is available since Linux 2.6.

Conforming to

POSIX.1-2001, POSIX.1-2008.

See Also

clock_gettime(2), timer_create(2), timer_getoverrun(2), timer_settime(2), time(7)

Referenced By

syscalls(2), timer_create(2), timer_getoverrun(2), ualarm(3), usleep(3).

Explore man page connections for timer_delete(2).