man > proc_pid_stat(5)

proc_pid_stat(5)                         File Formats Manual                        proc_pid_stat(5)

NAME
       /proc/pid/stat - status information

DESCRIPTION
       /proc/pid/stat
              Status  information  about  the process.  This is used by ps(1).  It is defined in the
              kernel source file fs/proc/array.c.

              The fields, in order, with their proper scanf(3) format specifiers, are listed  below.
              Whether  or  not  certain  of  these fields display valid information is governed by a
              ptrace access mode PTRACE_MODE_READ_FSCREDS  |  PTRACE_MODE_NOAUDIT  check  (refer  to
              ptrace(2)).   If the check denies access, then the field value is displayed as 0.  The
              affected fields are indicated with the marking [PT].

              (1) pid  %d
                     The process ID.

              (2) comm  %s
                     The  filename  of  the  executable,  in  parentheses.   Strings   longer   than
                     TASK_COMM_LEN  (16)  characters  (including  the  terminating  null  byte)  are
                     silently truncated.  This is visible whether or not the executable  is  swapped
                     out.

              (3) state  %c
                     One of the following characters, indicating process state:

                     R      Running

                     S      Sleeping in an interruptible wait

                     D      Waiting in uninterruptible disk sleep

                     Z      Zombie

                     T      Stopped (on a signal) or (before Linux 2.6.33) trace stopped

                     t      Tracing stop (Linux 2.6.33 onward)

                     W      Paging (only before Linux 2.6.0)

                     X      Dead (from Linux 2.6.0 onward)

                     x      Dead (Linux 2.6.33 to 3.13 only)

                     K      Wakekill (Linux 2.6.33 to 3.13 only)

                     W      Waking (Linux 2.6.33 to 3.13 only)

                     P      Parked (Linux 3.9 to 3.13 only)

                     I      Idle (Linux 4.14 onward)

              (4) ppid  %d
                     The PID of the parent of this process.

              (5) pgrp  %d
                     The process group ID of the process.

              (6) session  %d
                     The session ID of the process.

              (7) tty_nr  %d
                     The controlling terminal of the process.  (The minor device number is contained
                     in  the  combination of bits 31 to 20 and 7 to 0; the major device number is in
                     bits 15 to 8.)

              (8) tpgid  %d
                     The ID of the foreground process group  of  the  controlling  terminal  of  the
                     process.

              (9) flags  %u
                     The  kernel  flags word of the process.  For bit meanings, see the PF_* defines
                     in the Linux kernel source file include/linux/sched.h.  Details depend  on  the
                     kernel version.

                     The format for this field was %lu before Linux 2.6.

              (10) minflt  %lu
                     The number of minor faults the process has made which have not required loading
                     a memory page from disk.

              (11) cminflt  %lu
                     The number of minor faults that the process's waited-for children have made.

              (12) majflt  %lu
                     The  number  of major faults the process has made which have required loading a
                     memory page from disk.

              (13) cmajflt  %lu
                     The number of major faults that the process's waited-for children have made.

              (14) utime  %lu
                     Amount of time that this process has been scheduled in user mode,  measured  in
                     clock  ticks  (divide  by  sysconf(_SC_CLK_TCK)).   This  includes  guest time,
                     guest_time (time spent running a virtual CPU, see below), so that  applications
                     that  are  not  aware  of the guest time field do not lose that time from their
                     calculations.

              (15) stime  %lu
                     Amount of time that this process has been scheduled in kernel mode, measured in
                     clock ticks (divide by sysconf(_SC_CLK_TCK)).

              (16) cutime  %ld
                     Amount of time that this process's waited-for children have been  scheduled  in
                     user mode, measured in clock ticks (divide by sysconf(_SC_CLK_TCK)).  (See also
                     times(2).)  This includes guest time, cguest_time (time spent running a virtual
                     CPU, see below).

              (17) cstime  %ld
                     Amount  of  time that this process's waited-for children have been scheduled in
                     kernel mode, measured in clock ticks (divide by sysconf(_SC_CLK_TCK)).

              (18) priority  %ld
                     (Explanation for Linux 2.6) For processes running a real-time scheduling policy
                     (policy below; see sched_setscheduler(2)), this is the negated scheduling  pri‐
                     ority,  minus  one; that is, a number in the range -2 to -100, corresponding to
                     real-time priorities 1 to 99.  For  processes  running  under  a  non-real-time
                     scheduling  policy,  this is the raw nice value (setpriority(2)) as represented
                     in the kernel.  The kernel stores nice values as numbers in the range 0  (high)
                     to 39 (low), corresponding to the user-visible nice range of -20 to 19.

                     Before  Linux  2.6,  this  was  a scaled value based on the scheduler weighting
                     given to this process.

              (19) nice  %ld
                     The nice value (see setpriority(2)), a value in the range 19 (low priority)  to
                     -20 (high priority).

              (20) num_threads  %ld
                     Number  of  threads  in this process (since Linux 2.6).  Before Linux 2.6, this
                     field was hard coded to 0 as a placeholder for an earlier removed field.

              (21) itrealvalue  %ld
                     The time in jiffies before the next SIGALRM is sent to the process  due  to  an
                     interval timer.  Since Linux 2.6.17, this field is no longer maintained, and is
                     hard coded as 0.

              (22) starttime  %llu
                     The  time  the process started after system boot.  Before Linux 2.6, this value
                     was expressed in jiffies.  Since Linux 2.6, the value  is  expressed  in  clock
                     ticks (divide by sysconf(_SC_CLK_TCK)).

                     The format for this field was %lu before Linux 2.6.

              (23) vsize  %lu
                     Virtual memory size in bytes.

              (24) rss  %ld
                     Resident  Set  Size:  number  of pages the process has in real memory.  This is
                     just the pages which count toward text, data, or stack space.   This  does  not
                     include  pages  which have not been demand-loaded in, or which are swapped out.
                     This value is inaccurate; see /proc/pid/statm below.

              (25) rsslim  %lu
                     Current soft limit in bytes on the rss of the process; see the  description  of
                     RLIMIT_RSS in getrlimit(2).

              (26) startcode  %lu  [PT]
                     The address above which program text can run.

              (27) endcode  %lu  [PT]
                     The address below which program text can run.

              (28) startstack  %lu  [PT]
                     The address of the start (i.e., bottom) of the stack.

              (29) kstkesp  %lu  [PT]
                     The current value of ESP (stack pointer), as found in the kernel stack page for
                     the process.

              (30) kstkeip  %lu  [PT]
                     The current EIP (instruction pointer).

              (31) signal  %lu
                     The  bitmap  of  pending signals, displayed as a decimal number.  Obsolete, be‐
                     cause it does not provide information on real-time signals; use  /proc/pid/sta‐
                     tus instead.

              (32) blocked  %lu
                     The  bitmap  of  blocked signals, displayed as a decimal number.  Obsolete, be‐
                     cause it does not provide information on real-time signals; use  /proc/pid/sta‐
                     tus instead.

              (33) sigignore  %lu
                     The  bitmap  of  ignored signals, displayed as a decimal number.  Obsolete, be‐
                     cause it does not provide information on real-time signals; use  /proc/pid/sta‐
                     tus instead.

              (34) sigcatch  %lu
                     The bitmap of caught signals, displayed as a decimal number.  Obsolete, because
                     it  does not provide information on real-time signals; use /proc/pid/status in‐
                     stead.

              (35) wchan  %lu  [PT]
                     This is the "channel" in which the process is waiting.  It is the address of  a
                     location  in  the kernel where the process is sleeping.  The corresponding sym‐
                     bolic name can be found in /proc/pid/wchan.

              (36) nswap  %lu
                     Number of pages swapped (not maintained).

              (37) cnswap  %lu
                     Cumulative nswap for child processes (not maintained).

              (38) exit_signal  %d  (since Linux 2.1.22)
                     Signal to be sent to parent when we die.

              (39) processor  %d  (since Linux 2.2.8)
                     CPU number last executed on.

              (40) rt_priority  %u  (since Linux 2.5.19)
                     Real-time scheduling priority, a number in the range  1  to  99  for  processes
                     scheduled  under  a  real-time  policy,  or 0, for non-real-time processes (see
                     sched_setscheduler(2)).

              (41) policy  %u  (since Linux 2.5.19)
                     Scheduling policy (see sched_setscheduler(2)).  Decode using the  SCHED_*  con‐
                     stants in linux/sched.h.

                     The format for this field was %lu before Linux 2.6.22.

              (42) delayacct_blkio_ticks  %llu  (since Linux 2.6.18)
                     Aggregated block I/O delays, measured in clock ticks (centiseconds).

              (43) guest_time  %lu  (since Linux 2.6.24)
                     Guest time of the process (time spent running a virtual CPU for a guest operat‐
                     ing system), measured in clock ticks (divide by sysconf(_SC_CLK_TCK)).

              (44) cguest_time  %ld  (since Linux 2.6.24)
                     Guest  time  of  the  process's  children,  measured  in clock ticks (divide by
                     sysconf(_SC_CLK_TCK)).

              (45) start_data  %lu  (since Linux 3.3)  [PT]
                     Address above which  program  initialized  and  uninitialized  (BSS)  data  are
                     placed.

              (46) end_data  %lu  (since Linux 3.3)  [PT]
                     Address  below  which  program  initialized  and  uninitialized  (BSS) data are
                     placed.

              (47) start_brk  %lu  (since Linux 3.3)  [PT]
                     Address above which program heap can be expanded with brk(2).

              (48) arg_start  %lu  (since Linux 3.5)  [PT]
                     Address above which program command-line arguments (argv) are placed.

              (49) arg_end  %lu  (since Linux 3.5)  [PT]
                     Address below program command-line arguments (argv) are placed.

              (50) env_start  %lu  (since Linux 3.5)  [PT]
                     Address above which program environment is placed.

              (51) env_end  %lu  (since Linux 3.5)  [PT]
                     Address below which program environment is placed.

              (52) exit_code  %d  (since Linux 3.5)  [PT]
                     The thread's exit status in the form reported by waitpid(2).

SEE ALSO
       proc(5), proc_pid_status(5)

Linux man-pages 6.7                          2023-08-15                             proc_pid_stat(5)