diff --git a/Tool/Sources/AXExtension/Status.java b/Tool/Sources/AXExtension/Status.java new file mode 100644 index 00000000..f1505253 --- /dev/null +++ b/Tool/Sources/AXExtension/Status.java @@ -0,0 +1,205 @@ +/* + * Copyright (C) 2015. Jared Rummler + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + */ + +package com.jaredrummler.android.processes.models; + +import android.os.Parcel; +import java.io.IOException; +import java.util.Locale; + +/** + *

/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. + *
  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. + *
  3. Tgid: Thread group ID (i.e., Process ID).
    4. + *
  4. Pid: Thread ID (see gettid(2)).
    5. + *
  5. PPid: PID of parent process.
    6. + *
  6. TracerPid: PID of process tracing this process (0 if not being traced).
    7. + *
  7. Uid, Gid: Real, effective, saved set, and filesystem UIDs (GIDs).
    8. + *
  8. FDSize: Number of file descriptor slots currently allocated.
    9. + *
  9. Groups: Supplementary group list.
    10. + *
  10. VmPeak: Peak virtual memory size.
    11. + *
  11. VmSize: Virtual memory size.
    12. + *
  12. VmLck: Locked memory size (see mlock(3)).
    13. + *
  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. + *
  14. VmHWM: Peak resident set size ("high water mark").
    15. + *
  15. VmRSS: Resident set size.
    16. + *
  16. VmData, VmStk, VmExe: Size of data, stack, and text segments.
    17. + *
  17. VmLib: Shared library code size.
    18. + *
  18. VmPTE: Page table entries size (since Linux 2.6.10).
    19. + *
  19. VmPMD: Size of second-level page tables (since Linux 4.0).
    20. + *
  20. VmSwap: Swapped-out virtual memory size by anonymous private pages; shmem swap usage is not + * included (since Linux 2.6.34).
    21. + *
  21. Threads: Number of threads in process containing this thread.
    22. + *
  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. + *
  23. SigPnd, ShdPnd: Number of signals pending for thread and for process as a whole (see + * pthreads(7) and signal(7)).
    24. + *
  24. SigBlk, SigIgn, SigCgt: Masks indicating signals being blocked, ignored, and caught (see + * signal(7)).
    25. + *
  25. CapInh, CapPrm, CapEff: Masks of capabilities enabled in inheritable, permitted, and + * effective sets (see capabilities(7)).
    26. + *
  26. CapBnd: Capability Bounding set (since Linux 2.6.26, see capabilities(7)).
    27. + *
  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. + *
  28. Cpus_allowed: Mask of CPUs on which this process may run (since Linux 2.6.24, see + * cpuset(7)).
    29. + *
  29. Cpus_allowed_list: Same as previous, but in "list format" (since Linux 2.6.26, see + * cpuset(7)).
    30. + *
  30. Mems_allowed: Mask of memory nodes allowed to this process (since Linux 2.6.24, see + * cpuset(7)).
    31. + *
  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).
    32. + *
+ */ +public final class Status extends ProcFile { + + /** + * Read /proc/[pid]/status. + * + * @param pid + * the process id. + * @return the {@link Status} + * @throws IOException + * if the file does not exist or we don't have read permissions. + */ + public static Status get(int pid) throws IOException { + return new Status(String.format(Locale.ENGLISH, "/proc/%d/status", pid)); + } + + private Status(String path) throws IOException { + super(path); + } + + private Status(Parcel in) { + super(in); + } + + /** + * Get the value of one of the fields. + * + * @param fieldName + * the field name. E.g "PPid", "Uid", "Groups". + * @return The value of the field or {@code null}. + */ + public String getValue(String fieldName) { + String[] lines = content.split("\n"); + for (String line : lines) { + if (line.startsWith(fieldName + ":")) { + return line.split(fieldName + ":")[1].trim(); + } + } + return null; + } + + /** + * @return The process' UID or -1 if parsing the UID failed. + */ + public int getUid() { + try { + return Integer.parseInt(getValue("Uid").split("\\s+")[0]); + } catch (Exception e) { + return -1; + } + } + + /** + * @return The process' GID or -1 if parsing the GID failed. + */ + public int getGid() { + try { + return Integer.parseInt(getValue("Gid").split("\\s+")[0]); + } catch (Exception e) { + return -1; + } + } + + public static final Creator CREATOR = new Creator() { + + @Override public Status createFromParcel(Parcel source) { + return new Status(source); + } + + @Override public Status[] newArray(int size) { + return new Status[size]; + } + }; + +}