com.jaredrummler.android.processes.models

Class Status

java.lang.Object

java.io.File

com.jaredrummler.android.processes.models.ProcFile

com.jaredrummler.android.processes.models.Status

All Implemented Interfaces:

android.os.Parcelable, java.io.Serializable, java.lang.Comparable<java.io.File>

public final class Status
extends ProcFile

/proc/[pid]/status

Provides much of the information in /proc/[pid]/stat and /proc/[pid]/statm in a format that's easier for humans to parse.

Here's an example:

 $ cat /proc/$$/status
 Name:   bash
 State:  S (sleeping)
 Tgid:   3515
 Pid:    3515
 PPid:   3452
 TracerPid:      0
 Uid:    1000    1000    1000    1000
 Gid:    100     100     100     100
 FDSize: 256
 Groups: 16 33 100
 VmPeak:     9136 kB
 VmSize:     7896 kB
 VmLck:         0 kB
 VmPin:         0 kB
 VmHWM:      7572 kB
 VmRSS:      6316 kB
 VmData:     5224 kB
 VmStk:        88 kB
 VmExe:       572 kB
 VmLib:      1708 kB
 VmPMD:         4 kB
 VmPTE:        20 kB
 VmSwap:        0 kB
 Threads:        1
 SigQ:   0/3067
 SigPnd: 0000000000000000
 ShdPnd: 0000000000000000
 SigBlk: 0000000000010000
 SigIgn: 0000000000384004
 SigCgt: 000000004b813efb
 CapInh: 0000000000000000
 CapPrm: 0000000000000000
 CapEff: 0000000000000000
 CapBnd: ffffffffffffffff
 Seccomp:        0
 Cpus_allowed:   00000001
 Cpus_allowed_list:      0
 Mems_allowed:   1
 Mems_allowed_list:      0
 voluntary_ctxt_switches:        150
 nonvoluntary_ctxt_switches:     545
 

The fields are as follows:

1. Name: Command run by this process.
2. State: Current state of the process. One of "R (running)", "S (sleeping)", "D (disk sleep)", "T (stopped)", "T (tracing stop)", "Z (zombie)", or "X (dead)".
3. Tgid: Thread group ID (i.e., Process ID).
4. Pid: Thread ID (see gettid(2)).
5. PPid: PID of parent process.
6. TracerPid: PID of process tracing this process (0 if not being traced).
7. Uid, Gid: Real, effective, saved set, and filesystem UIDs (GIDs).
8. FDSize: Number of file descriptor slots currently allocated.
9. Groups: Supplementary group list.
10. VmPeak: Peak virtual memory size.
11. VmSize: Virtual memory size.
12. VmLck: Locked memory size (see mlock(3)).
13. VmPin: Pinned memory size (since Linux 3.2). These are pages that can't be moved because something needs to directly access physical memory.
14. VmHWM: Peak resident set size ("high water mark").
15. VmRSS: Resident set size.
16. VmData, VmStk, VmExe: Size of data, stack, and text segments.
17. VmLib: Shared library code size.
18. VmPTE: Page table entries size (since Linux 2.6.10).
19. VmPMD: Size of second-level page tables (since Linux 4.0).
20. VmSwap: Swapped-out virtual memory size by anonymous private pages; shmem swap usage is not included (since Linux 2.6.34).
21. Threads: Number of threads in process containing this thread.
22. SigQ: 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)).
23. SigPnd, ShdPnd: Number of signals pending for thread and for process as a whole (see pthreads(7) and signal(7)).
24. SigBlk, SigIgn, SigCgt: Masks indicating signals being blocked, ignored, and caught (see signal(7)).
25. CapInh, CapPrm, CapEff: Masks of capabilities enabled in inheritable, permitted, and effective sets (see capabilities(7)).
26. CapBnd: Capability Bounding set (since Linux 2.6.26, see capabilities(7)).
27. Seccomp: Seccomp mode of the process (since Linux 3.8, see seccomp(2)). 0 means SECCOMP_MODE_DISABLED; 1 means SECCOMP_MODE_STRICT; 2 means SECCOMP_MODE_FILTER. This field is provided only if the kernel was built with the CONFIG_SECCOMP kernel configuration option enabled.
28. Cpus_allowed: Mask of CPUs on which this process may run (since Linux 2.6.24, see cpuset(7)).
29. Cpus_allowed_list: Same as previous, but in "list format" (since Linux 2.6.26, see cpuset(7)).
30. Mems_allowed: Mask of memory nodes allowed to this process (since Linux 2.6.24, see cpuset(7)).
31. Mems_allowed_list: Same as previous, but in "list format" (since Linux 2.6.26, see cpuset(7)). voluntary_ctxt_switches, nonvoluntary_ctxt_switches: Number of voluntary and involuntary context switches (since Linux 2.6.23).

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface android.os.Parcelable

android.os.Parcelable.ClassLoaderCreator<T>, android.os.Parcelable.Creator<T>

Field Summary

Fields inherited from class com.jaredrummler.android.processes.models.ProcFile

content, CREATOR

Fields inherited from class java.io.File

pathSeparator, pathSeparatorChar, separator, separatorChar

Fields inherited from interface android.os.Parcelable

CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE

Method Summary

Modifier and Type	Method and Description
static Status	get(int pid) Read /proc/[pid]/status.
int	getGid()
int	getUid()
java.lang.String	getValue(java.lang.String fieldName) Get the value of one of the fields.

Methods inherited from class com.jaredrummler.android.processes.models.ProcFile

describeContents, length, readFile, writeToParcel

Methods inherited from class java.io.File

canExecute, canRead, canWrite, compareTo, createNewFile, createTempFile, createTempFile, delete, deleteOnExit, equals, exists, getAbsoluteFile, getAbsolutePath, getCanonicalFile, getCanonicalPath, getFreeSpace, getName, getParent, getParentFile, getPath, getTotalSpace, getUsableSpace, hashCode, isAbsolute, isDirectory, isFile, isHidden, lastModified, list, list, listFiles, listFiles, listFiles, listRoots, mkdir, mkdirs, renameTo, setExecutable, setExecutable, setLastModified, setReadable, setReadable, setReadOnly, setWritable, setWritable, toPath, toString, toURI, toURL

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

get

public static Status get(int pid)
                  throws java.io.IOException

Read /proc/[pid]/status.

Parameters:

pid - the process id.

Returns:

the Status

Throws:

java.io.IOException - if the file does not exist or we don't have read permissions.

getValue

public java.lang.String getValue(java.lang.String fieldName)

Get the value of one of the fields.

Parameters:

fieldName - the field name. E.g "PPid", "Uid", "Groups".

Returns:

The value of the field or null.

getUid

public int getUid()

Returns:

The process' UID or -1 if parsing the UID failed.

getGid

public int getGid()

Returns:

The process' GID or -1 if parsing the GID failed.