man/man5/proc_pid_status.5

   1 .\" Copyright (C) 1994, 1995, Daniel Quinlan <quinlan@yggdrasil.com>
   2 .\" Copyright (C) 2002-2008, 2017, Michael Kerrisk <mtk.manpages@gmail.com>
   3 .\" Copyright (C) 2023, Alejandro Colomar <alx@kernel.org>
   4 .\"
   5 .\" SPDX-License-Identifier: GPL-3.0-or-later
   6 .\"
   7 .TH proc_pid_status 5 (date) "Linux man-pages (unreleased)"
   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, expressed in octal with a leading zero; see
  93 .BR umask (2).
  94 (Since Linux 4.7.)
  95 .TP
  96 .I State
  97 Current state of the process.
  98 One of
  99 "R (running)",
 100 "S (sleeping)",
 101 "D (disk sleep)",
 102 "T (stopped)",
 103 "t (tracing stop)",
 104 "Z (zombie)",
 105 or
 106 "X (dead)".
 107 .TP
 108 .I Tgid
 109 Thread group ID (i.e., Process ID).
 110 .TP
 111 .I Ngid
 112 NUMA group ID (0 if none; since Linux 3.13).
 113 .TP
 114 .I Pid
 115 Thread ID (see
 116 .BR gettid (2)).
 117 .TP
 118 .I PPid
 119 PID of parent process.
 120 .TP
 121 .I TracerPid
 122 PID of process tracing this process (0 if not being traced).
 123 .TP
 124 .I Uid
 125 .TQ
 126 .I Gid
 127 Real, effective, saved set, and filesystem UIDs (GIDs).
 128 .TP
 129 .I FDSize
 130 Number of file descriptor slots currently allocated.
 131 .TP
 132 .I Groups
 133 Supplementary group list.
 134 .TP
 135 .I NStgid
 136 Thread group ID (i.e., PID) in each of the PID namespaces of which
 137 .I pid
 138 is a member.
 139 The leftmost entry shows the value with respect to the PID namespace
 140 of the process that mounted this procfs (or the root namespace
 141 if mounted by the kernel),
 142 followed by the value in successively nested inner namespaces.
 143 .\" commit e4bc33245124db69b74a6d853ac76c2976f472d5
 144 (Since Linux 4.1.)
 145 .TP
 146 .I NSpid
 147 Thread ID in each of the PID namespaces of which
 148 .I pid
 149 is a member.
 150 The fields are ordered as for
 151 .IR NStgid .
 152 (Since Linux 4.1.)
 153 .TP
 154 .I NSpgid
 155 Process group ID in each of the PID namespaces of which
 156 .I pid
 157 is a member.
 158 The fields are ordered as for
 159 .IR NStgid .
 160 (Since Linux 4.1.)
 161 .TP
 162 .I NSsid
 163 descendant namespace session ID hierarchy
 164 Session ID in each of the PID namespaces of which
 165 .I pid
 166 is a member.
 167 The fields are ordered as for
 168 .IR NStgid .
 169 (Since Linux 4.1.)
 170 .TP
 171 .I VmPeak
 172 Peak virtual memory size.
 173 .TP
 174 .I VmSize
 175 Virtual memory size.
 176 .TP
 177 .I VmLck
 178 Locked memory size (see
 179 .BR mlock (2)).
 180 .TP
 181 .I VmPin
 182 Pinned memory size
 183 .\" commit bc3e53f682d93df677dbd5006a404722b3adfe18
 184 (since Linux 3.2).
 185 These are pages that can't be moved because something needs to
 186 directly access physical memory.
 187 .TP
 188 .I VmHWM
 189 Peak resident set size ("high water mark").
 190 This value is inaccurate; see
 191 .IR /proc/ pid /statm
 192 above.
 193 .TP
 194 .I VmRSS
 195 Resident set size.
 196 Note that the value here is the sum of
 197 .IR RssAnon ,
 198 .IR RssFile ,
 199 and
 200 .IR RssShmem .
 201 This value is inaccurate; see
 202 .IR /proc/ pid /statm
 203 above.
 204 .TP
 205 .I RssAnon
 206 Size of resident anonymous memory.
 207 .\" commit bf9683d6990589390b5178dafe8fd06808869293
 208 (since Linux 4.5).
 209 This value is inaccurate; see
 210 .IR /proc/ pid /statm
 211 above.
 212 .TP
 213 .I RssFile
 214 Size of resident file mappings.
 215 .\" commit bf9683d6990589390b5178dafe8fd06808869293
 216 (since Linux 4.5).
 217 This value is inaccurate; see
 218 .IR /proc/ pid /statm
 219 above.
 220 .TP
 221 .I RssShmem
 222 Size of resident shared memory (includes System V shared memory,
 223 mappings from
 224 .BR tmpfs (5),
 225 and shared anonymous mappings).
 226 .\" commit bf9683d6990589390b5178dafe8fd06808869293
 227 (since Linux 4.5).
 228 .TP
 229 .I VmData
 230 .TQ
 231 .I VmStk
 232 .TQ
 233 .I VmExe
 234 Size of data, stack, and text segments.
 235 This value is inaccurate; see
 236 .IR /proc/ pid /statm
 237 above.
 238 .TP
 239 .I VmLib
 240 Shared library code size.
 241 .TP
 242 .I VmPTE
 243 Page table entries size (since Linux 2.6.10).
 244 .TP
 245 .I VmPMD
 246 .\" commit dc6c9a35b66b520cf67e05d8ca60ebecad3b0479
 247 Size of second-level page tables (added in Linux 4.0; removed in Linux 4.15).
 248 .TP
 249 .I VmSwap
 250 .\" commit b084d4353ff99d824d3bc5a5c2c22c70b1fba722
 251 Swapped-out virtual memory size by anonymous private pages;
 252 shmem swap usage is not included (since Linux 2.6.34).
 253 This value is inaccurate; see
 254 .IR /proc/ pid /statm
 255 above.
 256 .TP
 257 .I HugetlbPages
 258 Size of hugetlb memory portions
 259 .\" commit 5d317b2b6536592a9b51fe65faed43d65ca9158e
 260 (since Linux 4.4).
 261 .TP
 262 .I CoreDumping
 263 Contains the value 1 if the process is currently dumping core,
 264 and 0 if it is not
 265 .\" commit c643401218be0f4ab3522e0c0a63016596d6e9ca
 266 (since Linux 4.15).
 267 This information can be used by a monitoring process to avoid killing
 268 a process that is currently dumping core,
 269 which could result in a corrupted core dump file.
 270 .TP
 271 .I Threads
 272 Number of threads in process containing this thread.
 273 .TP
 274 .I SigQ
 275 This field contains two slash-separated numbers that relate to
 276 queued signals for the real user ID of this process.
 277 The first of these is the number of currently queued
 278 signals for this real user ID, and the second is the
 279 resource limit on the number of queued signals for this process
 280 (see the description of
 281 .B RLIMIT_SIGPENDING
 282 in
 283 .BR getrlimit (2)).
 284 .TP
 285 .I SigPnd
 286 .TQ
 287 .I ShdPnd
 288 Mask (expressed in hexadecimal)
 289 of signals pending for thread and for process as a whole (see
 290 .BR pthreads (7)
 291 and
 292 .BR signal (7)).
 293 .TP
 294 .I SigBlk
 295 .TQ
 296 .I SigIgn
 297 .TQ
 298 .I SigCgt
 299 Masks (expressed in hexadecimal)
 300 indicating signals being blocked, ignored, and caught (see
 301 .BR signal (7)).
 302 .TP
 303 .I CapInh
 304 .TQ
 305 .I CapPrm
 306 .TQ
 307 .I CapEff
 308 Masks (expressed in hexadecimal)
 309 of capabilities enabled in inheritable, permitted, and effective sets
 310 (see
 311 .BR capabilities (7)).
 312 .TP
 313 .I CapBnd
 314 Capability bounding set, expressed in hexadecimal
 315 (since Linux 2.6.26, see
 316 .BR capabilities (7)).
 317 .TP
 318 .I CapAmb
 319 Ambient capability set, expressed in hexadecimal
 320 (since Linux 4.3, see
 321 .BR capabilities (7)).
 322 .TP
 323 .I NoNewPrivs
 324 .\" commit af884cd4a5ae62fcf5e321fecf0ec1014730353d
 325 Value of the
 326 .I no_new_privs
 327 bit
 328 (since Linux 4.10, see
 329 .BR prctl (2)).
 330 .TP
 331 .I Seccomp
 332 .\" commit 2f4b3bf6b2318cfaa177ec5a802f4d8d6afbd816
 333 Seccomp mode of the process
 334 (since Linux 3.8, see
 335 .BR seccomp (2)).
 336 0 means
 337 .BR SECCOMP_MODE_DISABLED ;
 338 1 means
 339 .BR SECCOMP_MODE_STRICT ;
 340 2 means
 341 .BR SECCOMP_MODE_FILTER .
 342 This field is provided only if the kernel was built with the
 343 .B CONFIG_SECCOMP
 344 kernel configuration option enabled.
 345 .TP
 346 .I Seccomp_filters
 347 .\" commit c818c03b661cd769e035e41673d5543ba2ebda64
 348 Number of seccomp filters attached to the process
 349 (since Linux 5.9, see
 350 .BR seccomp (2)).
 351 .TP
 352 .I Speculation_Store_Bypass
 353 .\" commit fae1fa0fc6cca8beee3ab8ed71d54f9a78fa3f64
 354 Speculation flaw mitigation state
 355 (since Linux 4.17, see
 356 .BR prctl (2)).
 357 .TP
 358 .I Cpus_allowed
 359 Hexadecimal mask of CPUs on which this process may run
 360 (since Linux 2.6.24, see
 361 .BR cpuset (7)).
 362 .TP
 363 .I Cpus_allowed_list
 364 Same as previous, but in "list format"
 365 (since Linux 2.6.26, see
 366 .BR cpuset (7)).
 367 .TP
 368 .I Mems_allowed
 369 Mask of memory nodes allowed to this process
 370 (since Linux 2.6.24, see
 371 .BR cpuset (7)).
 372 .TP
 373 .I Mems_allowed_list
 374 Same as previous, but in "list format"
 375 (since Linux 2.6.26, see
 376 .BR cpuset (7)).
 377 .TP
 378 .I voluntary_ctxt_switches
 379 .TQ
 380 .I nonvoluntary_ctxt_switches
 381 Number of voluntary and involuntary context switches (since Linux 2.6.23).
 382 .RE
 383 .SH SEE ALSO
 384 .BR proc (5)