#[non_exhaustive]pub struct Status {Show 61 fields
pub name: String,
pub umask: Option<u32>,
pub state: String,
pub tgid: i32,
pub ngid: Option<i32>,
pub pid: i32,
pub ppid: i32,
pub tracerpid: i32,
pub ruid: u32,
pub euid: u32,
pub suid: u32,
pub fuid: u32,
pub rgid: u32,
pub egid: u32,
pub sgid: u32,
pub fgid: u32,
pub fdsize: u32,
pub groups: Vec<i32>,
pub nstgid: Option<Vec<i32>>,
pub nspid: Option<Vec<i32>>,
pub nspgid: Option<Vec<i32>>,
pub nssid: Option<Vec<i32>>,
pub vmpeak: Option<u64>,
pub vmsize: Option<u64>,
pub vmlck: Option<u64>,
pub vmpin: Option<u64>,
pub vmhwm: Option<u64>,
pub vmrss: Option<u64>,
pub rssanon: Option<u64>,
pub rssfile: Option<u64>,
pub rssshmem: Option<u64>,
pub vmdata: Option<u64>,
pub vmstk: Option<u64>,
pub vmexe: Option<u64>,
pub vmlib: Option<u64>,
pub vmpte: Option<u64>,
pub vmswap: Option<u64>,
pub hugetlbpages: Option<u64>,
pub threads: u64,
pub sigq: (u64, u64),
pub sigpnd: u64,
pub shdpnd: u64,
pub sigblk: u64,
pub sigign: u64,
pub sigcgt: u64,
pub capinh: u64,
pub capprm: u64,
pub capeff: u64,
pub capbnd: Option<u64>,
pub capamb: Option<u64>,
pub nonewprivs: Option<u64>,
pub seccomp: Option<u32>,
pub speculation_store_bypass: Option<String>,
pub cpus_allowed: Option<Vec<u32>>,
pub cpus_allowed_list: Option<Vec<(u32, u32)>>,
pub mems_allowed: Option<Vec<u32>>,
pub mems_allowed_list: Option<Vec<(u32, u32)>>,
pub voluntary_ctxt_switches: Option<u64>,
pub nonvoluntary_ctxt_switches: Option<u64>,
pub core_dumping: Option<bool>,
pub thp_enabled: Option<bool>,
}Expand description
Status information about the process, based on the /proc/<pid>/status file.
Not all fields are available in every kernel. These fields have Option<T> types.
In general, the current kernel version will tell you what fields you can expect, but this
isn’t totally reliable, since some kernels might backport certain fields, or fields might
only be present if certain kernel configuration options are enabled. Be prepared to
handle None values.
New fields to this struct may be added at any time (even without a major or minor semver bump).
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.name: StringCommand run by this process.
umask: Option<u32>Process umask, expressed in octal with a leading zero; see umask(2). (Since Linux 4.7.)
state: StringCurrent state of the process.
tgid: i32Thread group ID (i.e., Process ID).
ngid: Option<i32>NUMA group ID (0 if none; since Linux 3.13).
pid: i32Thread ID (see gettid(2)).
ppid: i32PID of parent process.
tracerpid: i32PID of process tracing this process (0 if not being traced).
ruid: u32Real UID.
euid: u32Effective UID.
suid: u32Saved set UID.
fuid: u32Filesystem UID.
rgid: u32Real GID.
egid: u32Effective GID.
sgid: u32Saved set GID.
fgid: u32Filesystem GID.
fdsize: u32Number of file descriptor slots currently allocated.
groups: Vec<i32>Supplementary group list.
nstgid: Option<Vec<i32>>Thread group ID (i.e., PID) in each of the PID namespaces of which (pid)[struct.Status.html#structfield.pid] is a member. The leftmost entry shows the value with respect to the PID namespace of the reading process, followed by the value in successively nested inner namespaces. (Since Linux 4.1.)
nspid: Option<Vec<i32>>Thread ID in each of the PID namespaces of which (pid)[struct.Status.html#structfield.pid] is a member. The fields are ordered as for NStgid. (Since Linux 4.1.)
nspgid: Option<Vec<i32>>Process group ID in each of the PID namespaces of which (pid)[struct.Status.html#structfield.pid] is a member. The fields are ordered as for NStgid. (Since Linux 4.1.)
nssid: Option<Vec<i32>>NSsid: descendant namespace session ID hierarchy Session ID in each of the PID namespaces of which (pid)[struct.Status.html#structfield.pid] is a member. The fields are ordered as for NStgid. (Since Linux 4.1.)
vmpeak: Option<u64>Peak virtual memory size by kibibytes.
vmsize: Option<u64>Virtual memory size by kibibytes.
vmlck: Option<u64>Locked memory size by kibibytes (see mlock(3)).
vmpin: Option<u64>Pinned memory size by kibibytes (since Linux 3.2). These are pages that can’t be moved because something needs to directly access physical memory.
vmhwm: Option<u64>Peak resident set size by kibibytes (“high water mark”).
vmrss: Option<u64>Resident set size by kibibytes. Note that the value here is the sum of RssAnon, RssFile, and RssShmem.
rssanon: Option<u64>Size of resident anonymous memory by kibibytes. (since Linux 4.5).
rssfile: Option<u64>Size of resident file mappings by kibibytes. (since Linux 4.5).
rssshmem: Option<u64>Size of resident shared memory by kibibytes (includes System V shared memory, mappings from tmpfs(5), and shared anonymous mappings). (since Linux 4.5).
vmdata: Option<u64>Size of data by kibibytes.
vmstk: Option<u64>Size of stack by kibibytes.
vmexe: Option<u64>Size of text seg‐ments by kibibytes.
vmlib: Option<u64>Shared library code size by kibibytes.
vmpte: Option<u64>Page table entries size by kibibytes (since Linux 2.6.10).
vmswap: Option<u64>Swapped-out virtual memory size by anonymous private pages by kibibytes; shmem swap usage is not included (since Linux 2.6.34).
hugetlbpages: Option<u64>Size of hugetlb memory portions by kB. (since Linux 4.4).
threads: u64Number of threads in process containing this thread.
sigq: (u64, u64)This field contains two slash-separated numbers that relate to queued signals for the real user ID of this process. The first of these is the number of currently queued signals for this real user ID, and the second is the resource limit on the number of queued signals for this process (see the description of RLIMIT_SIGPENDING in getrlimit(2)).
sigpnd: u64Number of signals pending for thread (see pthreads(7) and signal(7)).
shdpnd: u64Number of signals pending for process as a whole (see pthreads(7) and signal(7)).
sigblk: u64Masks indicating signals being blocked (see signal(7)).
sigign: u64Masks indicating signals being ignored (see signal(7)).
sigcgt: u64Masks indicating signals being caught (see signal(7)).
capinh: u64Masks of capabilities enabled in inheritable sets (see capabilities(7)).
capprm: u64Masks of capabilities enabled in permitted sets (see capabilities(7)).
capeff: u64Masks of capabilities enabled in effective sets (see capabilities(7)).
capbnd: Option<u64>Capability Bounding set (since Linux 2.6.26, see capabilities(7)).
capamb: Option<u64>Ambient capability set (since Linux 4.3, see capabilities(7)).
nonewprivs: Option<u64>Value of the no_new_privs bit (since Linux 4.10, see prctl(2)).
seccomp: Option<u32>Seccomp mode of the process (since Linux 3.8, see seccomp(2)). 0 means SECCOMP_MODE_DISABLED; 1 means SEC‐ COMP_MODE_STRICT; 2 means SECCOMP_MODE_FILTER. This field is provided only if the kernel was built with the CON‐ FIG_SECCOMP kernel configuration option enabled.
speculation_store_bypass: Option<String>Speculative store bypass mitigation status.
cpus_allowed: Option<Vec<u32>>Mask of CPUs on which this process may run (since Linux 2.6.24, see cpuset(7)).
cpus_allowed_list: Option<Vec<(u32, u32)>>Same as previous, but in “list format” (since Linux 2.6.26, see cpuset(7)).
mems_allowed: Option<Vec<u32>>Mask of memory nodes allowed to this process (since Linux 2.6.24, see cpuset(7)).
mems_allowed_list: Option<Vec<(u32, u32)>>Same as previous, but in “list format” (since Linux 2.6.26, see cpuset(7)).
voluntary_ctxt_switches: Option<u64>Number of voluntary context switches (since Linux 2.6.23).
nonvoluntary_ctxt_switches: Option<u64>Number of involuntary context switches (since Linux 2.6.23).
core_dumping: Option<bool>Contains true if the process is currently dumping core.
This information can be used by a monitoring process to avoid killing a processing that is currently dumping core, which could result in a corrupted core dump file.
(Since Linux 4.15)
thp_enabled: Option<bool>Contains true if the process is allowed to use THP
(Since Linux 5.0)