Debian Codegraph @

upstream/debian-unstable/man2/timer_delete.2

raw
1 .\" Copyright, the authors of the Linux man-pages project
2 .\"
3 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
4 .\"
5 .TH timer_delete 2 2025-10-29 "Linux man-pages 6.18"
6 .SH NAME
7 timer_delete \- delete a POSIX per-process timer
8 .SH LIBRARY
9 Real-time library
10 .RI ( librt ,\~ \-lrt )
11 .SH SYNOPSIS
12 .nf
13 .B #include <time.h>
14 .P
15 .BI "int timer_delete(timer_t " timerid );
16 .fi
17 .P
18 .RS -4
19 Feature Test Macro Requirements for glibc (see
20 .BR feature_test_macros (7)):
21 .RE
22 .P
23 .BR timer_delete ():
24 .nf
25 _POSIX_C_SOURCE >= 199309L
26 .fi
27 .SH DESCRIPTION
28 .BR timer_delete ()
29 deletes the timer whose ID is given in
30 .IR timerid .
31 If the timer was armed at the time of this call,
32 it is disarmed before being deleted.
33 The treatment of any pending signal generated by the deleted timer
34 is unspecified.
35 .SH RETURN VALUE
36 On success,
37 .BR timer_delete ()
38 returns 0.
39 On failure, \-1 is returned, and
40 .I errno
41 is set to indicate the error.
42 .SH ERRORS
43 .TP
44 .B EINVAL
45 .I timerid
46 is not a valid timer ID.
47 .SH STANDARDS
48 POSIX.1-2024.
49 .SH HISTORY
50 Linux 2.6.
51 POSIX.1-2001.
52 .SH SEE ALSO
53 .BR clock_gettime (2),
54 .BR timer_create (2),
55 .BR timer_getoverrun (2),
56 .BR timer_settime (2),
57 .BR time (7)