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