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