Debian Codegraph @

upstream/debian-unstable/man5/proc_pid_status.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_status 5 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 /proc/pid/status \- memory usage and status information
10 .SH DESCRIPTION
11 .TP
12 .IR /proc/ pid /status
13 Provides much of the information in
14 .IR /proc/ pid /stat
15 and
16 .IR /proc/ pid /statm
17 in a format that's easier for humans to parse.
18 Here's an example:
19 .IP
20 .in +4n
21 .EX
22 .RB "$" " cat /proc/$$/status"
23 Name: bash
24 Umask: 0022
25 State: S (sleeping)
26 Tgid: 17248
27 Ngid: 0
28 Pid: 17248
29 PPid: 17200
30 TracerPid: 0
31 Uid: 1000 1000 1000 1000
32 Gid: 100 100 100 100
33 FDSize: 256
34 Groups: 16 33 100
35 NStgid: 17248
36 NSpid: 17248
37 NSpgid: 17248
38 NSsid: 17200
39 VmPeak: 131168 kB
40 VmSize: 131168 kB
41 VmLck: 0 kB
42 VmPin: 0 kB
43 VmHWM: 13484 kB
44 VmRSS: 13484 kB
45 RssAnon: 10264 kB
46 RssFile: 3220 kB
47 RssShmem: 0 kB
48 VmData: 10332 kB
49 VmStk: 136 kB
50 VmExe: 992 kB
51 VmLib: 2104 kB
52 VmPTE: 76 kB
53 VmPMD: 12 kB
54 VmSwap: 0 kB
55 HugetlbPages: 0 kB # 4.4
56 CoreDumping: 0 # 4.15
57 Threads: 1
58 SigQ: 0/3067
59 SigPnd: 0000000000000000
60 ShdPnd: 0000000000000000
61 SigBlk: 0000000000010000
62 SigIgn: 0000000000384004
63 SigCgt: 000000004b813efb
64 CapInh: 0000000000000000
65 CapPrm: 0000000000000000
66 CapEff: 0000000000000000
67 CapBnd: ffffffffffffffff
68 CapAmb: 0000000000000000
69 NoNewPrivs: 0
70 Seccomp: 0
71 Seccomp_filters: 0
72 Speculation_Store_Bypass: vulnerable
73 Cpus_allowed: 00000001
74 Cpus_allowed_list: 0
75 Mems_allowed: 1
76 Mems_allowed_list: 0
77 voluntary_ctxt_switches: 150
78 nonvoluntary_ctxt_switches: 545
79 .EE
80 .in
81 .IP
82 The fields are as follows:
83 .RS
84 .TP
85 .I Name
86 Command run by this process.
87 Strings longer than
88 .B TASK_COMM_LEN
89 (16) characters (including the terminating null byte) are silently truncated.
90 .TP
91 .I Umask
92 Process umask,
93 expressed in octal with a leading zero;
94 see
95 .BR umask (2).
96 (Since Linux 4.7.)
97 .TP
98 .I State
99 Current state of the process.
100 One of
101 "R (running)",
102 "S (sleeping)",
103 "D (disk sleep)",
104 "T (stopped)",
105 "t (tracing stop)",
106 "Z (zombie)",
107 or
108 "X (dead)".
109 .TP
110 .I Tgid
111 Thread group ID (i.e., Process ID).
112 .TP
113 .I Ngid
114 NUMA group ID
115 (0 if none;
116 since Linux 3.13).
117 .TP
118 .I Pid
119 Thread ID (see
120 .BR gettid (2)).
121 .TP
122 .I PPid
123 PID of parent process.
124 .TP
125 .I TracerPid
126 PID of process tracing this process (0 if not being traced).
127 .TP
128 .I Uid
129 .TQ
130 .I Gid
131 Real, effective, saved set, and filesystem UIDs (GIDs).
132 .TP
133 .I FDSize
134 Number of file descriptor slots currently allocated.
135 .TP
136 .I Groups
137 Supplementary group list.
138 .TP
139 .I NStgid
140 Thread group ID (i.e., PID) in each of the PID namespaces of which
141 .I pid
142 is a member.
143 The leftmost entry shows the value with respect to the PID namespace
144 of the process that mounted this procfs (or the root namespace
145 if mounted by the kernel),
146 followed by the value in successively nested inner namespaces.
147 .\" commit e4bc33245124db69b74a6d853ac76c2976f472d5
148 (Since Linux 4.1.)
149 .TP
150 .I NSpid
151 Thread ID in each of the PID namespaces of which
152 .I pid
153 is a member.
154 The fields are ordered as for
155 .IR NStgid .
156 (Since Linux 4.1.)
157 .TP
158 .I NSpgid
159 Process group ID in each of the PID namespaces of which
160 .I pid
161 is a member.
162 The fields are ordered as for
163 .IR NStgid .
164 (Since Linux 4.1.)
165 .TP
166 .I NSsid
167 descendant namespace session ID hierarchy
168 Session ID in each of the PID namespaces of which
169 .I pid
170 is a member.
171 The fields are ordered as for
172 .IR NStgid .
173 (Since Linux 4.1.)
174 .TP
175 .I VmPeak
176 Peak virtual memory size.
177 .TP
178 .I VmSize
179 Virtual memory size.
180 .TP
181 .I VmLck
182 Locked memory size (see
183 .BR mlock (2)).
184 .TP
185 .I VmPin
186 Pinned memory size
187 .\" commit bc3e53f682d93df677dbd5006a404722b3adfe18
188 (since Linux 3.2).
189 These are pages that can't be moved because something needs to
190 directly access physical memory.
191 .TP
192 .I VmHWM
193 Peak resident set size ("high water mark").
194 This value is inaccurate;
195 see
196 .IR /proc/ pid /statm
197 above.
198 .TP
199 .I VmRSS
200 Resident set size.
201 Note that the value here is the sum of
202 .IR RssAnon ,
203 .IR RssFile ,
204 and
205 .IR RssShmem .
206 This value is inaccurate;
207 see
208 .IR /proc/ pid /statm
209 above.
210 .TP
211 .I RssAnon
212 Size of resident anonymous memory.
213 .\" commit bf9683d6990589390b5178dafe8fd06808869293
214 (since Linux 4.5).
215 This value is inaccurate;
216 see
217 .IR /proc/ pid /statm
218 above.
219 .TP
220 .I RssFile
221 Size of resident file mappings.
222 .\" commit bf9683d6990589390b5178dafe8fd06808869293
223 (since Linux 4.5).
224 This value is inaccurate;
225 see
226 .IR /proc/ pid /statm
227 above.
228 .TP
229 .I RssShmem
230 Size of resident shared memory (includes System V shared memory,
231 mappings from
232 .BR tmpfs (5),
233 and shared anonymous mappings).
234 .\" commit bf9683d6990589390b5178dafe8fd06808869293
235 (since Linux 4.5).
236 .TP
237 .I VmData
238 .TQ
239 .I VmStk
240 .TQ
241 .I VmExe
242 Size of data, stack, and text segments.
243 This value is inaccurate;
244 see
245 .IR /proc/ pid /statm
246 above.
247 .TP
248 .I VmLib
249 Shared library code size.
250 .TP
251 .I VmPTE
252 Page table entries size (since Linux 2.6.10).
253 .TP
254 .I VmPMD
255 .\" commit dc6c9a35b66b520cf67e05d8ca60ebecad3b0479
256 Size of second-level page tables
257 (added in Linux 4.0;
258 removed in Linux 4.15).
259 .TP
260 .I VmSwap
261 .\" commit b084d4353ff99d824d3bc5a5c2c22c70b1fba722
262 Swapped-out virtual memory size by anonymous private pages;
263 shmem swap usage is not included
264 (since Linux 2.6.34).
265 This value is inaccurate;
266 see
267 .IR /proc/ pid /statm
268 above.
269 .TP
270 .I HugetlbPages
271 Size of hugetlb memory portions
272 .\" commit 5d317b2b6536592a9b51fe65faed43d65ca9158e
273 (since Linux 4.4).
274 .TP
275 .I CoreDumping
276 Contains the value 1 if the process is currently dumping core,
277 and 0 if it is not
278 .\" commit c643401218be0f4ab3522e0c0a63016596d6e9ca
279 (since Linux 4.15).
280 This information can be used by a monitoring process to avoid killing
281 a process that is currently dumping core,
282 which could result in a corrupted core dump file.
283 .TP
284 .I Threads
285 Number of threads in process containing this thread.
286 .TP
287 .I SigQ
288 This field contains two slash-separated numbers that relate to
289 queued signals for the real user ID of this process.
290 The first of these is the number of currently queued
291 signals for this real user ID, and the second is the
292 resource limit on the number of queued signals for this process
293 (see the description of
294 .B RLIMIT_SIGPENDING
295 in
296 .BR getrlimit (2)).
297 .TP
298 .I SigPnd
299 .TQ
300 .I ShdPnd
301 Mask (expressed in hexadecimal)
302 of signals pending for thread and for process as a whole (see
303 .BR pthreads (7)
304 and
305 .BR signal (7)).
306 .TP
307 .I SigBlk
308 .TQ
309 .I SigIgn
310 .TQ
311 .I SigCgt
312 Masks (expressed in hexadecimal)
313 indicating signals being blocked, ignored, and caught (see
314 .BR signal (7)).
315 .TP
316 .I CapInh
317 .TQ
318 .I CapPrm
319 .TQ
320 .I CapEff
321 Masks (expressed in hexadecimal)
322 of capabilities enabled in inheritable, permitted, and effective sets
323 (see
324 .BR capabilities (7)).
325 .TP
326 .I CapBnd
327 Capability bounding set, expressed in hexadecimal
328 (since Linux 2.6.26, see
329 .BR capabilities (7)).
330 .TP
331 .I CapAmb
332 Ambient capability set, expressed in hexadecimal
333 (since Linux 4.3, see
334 .BR capabilities (7)).
335 .TP
336 .I NoNewPrivs
337 .\" commit af884cd4a5ae62fcf5e321fecf0ec1014730353d
338 Value of the
339 .I no_new_privs
340 bit
341 (since Linux 4.10, see
342 .BR prctl (2)).
343 .TP
344 .I Seccomp
345 .\" commit 2f4b3bf6b2318cfaa177ec5a802f4d8d6afbd816
346 Seccomp mode of the process
347 (since Linux 3.8, see
348 .BR seccomp (2)).
349 0 means
350 .BR SECCOMP_MODE_DISABLED ;
351 1 means
352 .BR SECCOMP_MODE_STRICT ;
353 2 means
354 .BR SECCOMP_MODE_FILTER .
355 This field is provided only if the kernel was built with the
356 .B CONFIG_SECCOMP
357 kernel configuration option enabled.
358 .TP
359 .I Seccomp_filters
360 .\" commit c818c03b661cd769e035e41673d5543ba2ebda64
361 Number of seccomp filters attached to the process
362 (since Linux 5.9, see
363 .BR seccomp (2)).
364 .TP
365 .I Speculation_Store_Bypass
366 .\" commit fae1fa0fc6cca8beee3ab8ed71d54f9a78fa3f64
367 Speculation flaw mitigation state
368 (since Linux 4.17, see
369 .BR prctl (2)).
370 .TP
371 .I Cpus_allowed
372 Hexadecimal mask of CPUs on which this process may run
373 (since Linux 2.6.24, see
374 .BR cpuset (7)).
375 .TP
376 .I Cpus_allowed_list
377 Same as previous, but in "list format"
378 (since Linux 2.6.26, see
379 .BR cpuset (7)).
380 .TP
381 .I Mems_allowed
382 Mask of memory nodes allowed to this process
383 (since Linux 2.6.24, see
384 .BR cpuset (7)).
385 .TP
386 .I Mems_allowed_list
387 Same as previous, but in "list format"
388 (since Linux 2.6.26, see
389 .BR cpuset (7)).
390 .TP
391 .I voluntary_ctxt_switches
392 .TQ
393 .I nonvoluntary_ctxt_switches
394 Number of voluntary and involuntary context switches (since Linux 2.6.23).
395 .RE
396 .SH SEE ALSO
397 .BR proc (5)