Debian Codegraph @

upstream/debian-unstable/man5/proc_pid_timers.5

raw
1 .\" Copyright 1994-1995, Daniel Quinlan <[email protected]>
2 .\" Copyright 2002-2017, Michael Kerrisk <[email protected]>
3 .\" Copyright, the authors of the Linux man-pages project
4 .\"
5 .\" SPDX-License-Identifier: GPL-3.0-or-later
6 .\"
7 .TH proc_pid_timers 5 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 /proc/pid/timers \- POSIX timers
10 .SH DESCRIPTION
11 .TP
12 .IR /proc/ pid /timers " (since Linux 3.10)"
13 .\" commit 5ed67f05f66c41e39880a6d61358438a25f9fee5
14 .\" commit 48f6a7a511ef8823fdff39afee0320092d43a8a0
15 A list of the POSIX timers for this process.
16 Each timer is listed with a line that starts with the string "ID:".
17 For example:
18 .IP
19 .in +4n
20 .EX
21 ID: 1
22 signal: 60/00007fff86e452a8
23 notify: signal/pid.2634
24 ClockID: 0
25 ID: 0
26 signal: 60/00007fff86e452a8
27 notify: signal/pid.2634
28 ClockID: 1
29 .EE
30 .in
31 .IP
32 The lines shown for each timer have the following meanings:
33 .RS
34 .TP
35 .I ID
36 The ID for this timer.
37 This is not the same as the timer ID returned by
38 .BR timer_create (2);
39 rather, it is the same kernel-internal ID that is available via the
40 .I si_timerid
41 field of the
42 .I siginfo_t
43 structure (see
44 .BR sigaction (2)).
45 .TP
46 .I signal
47 This is the signal number that this timer uses to deliver notifications
48 followed by a slash, and then the
49 .I sigev_value
50 value supplied to the signal handler.
51 Valid only for timers that notify via a signal.
52 .TP
53 .I notify
54 The part before the slash specifies the mechanism
55 that this timer uses to deliver notifications,
56 and is one of "thread", "signal", or "none".
57 Immediately following the slash is either the string "tid" for timers
58 with
59 .B SIGEV_THREAD_ID
60 notification, or "pid" for timers that notify by other mechanisms.
61 Following the "." is the PID of the process
62 (or the kernel thread ID of the thread) that will be delivered
63 a signal if the timer delivers notifications via a signal.
64 .TP
65 .I ClockID
66 This field identifies the clock that the timer uses for measuring time.
67 For most clocks, this is a number that matches one of the user-space
68 .B CLOCK_*
69 constants exposed via
70 .IR <time.h> .
71 .B CLOCK_PROCESS_CPUTIME_ID
72 timers display with a value of \-6
73 in this field.
74 .B CLOCK_THREAD_CPUTIME_ID
75 timers display with a value of \-2
76 in this field.
77 .RE
78 .IP
79 This file is available only when the kernel was configured with
80 .BR CONFIG_CHECKPOINT_RESTORE .
81 .SH SEE ALSO
82 .BR proc (5)