Process:getProcess
Method
Purpose
On Linux, returns a process table filtered by the Process Name
argument.
Remarks
The argument is treated as a pattern to match. If no argument string is given, all processes are returned.
Type
Synchronous, IMPACT_INFO.
Arguments
Name |
Type |
Description |
Process Name |
String |
Process name. Empty argument returns information for all processes. |
Returns
Name |
Type |
Description |
Process Name |
String |
Name of the process being executed |
ID Process |
Integer |
Process ID of the process. Table is indexed on ID process. |
Parent Process ID |
Integer |
Parent process ID of the current process |
User Name |
String |
Effective user name of the process |
Status |
String |
Status of process |
Virtual KBytes |
Integer |
The size of virtual address space, in kilobytes |
Stack KBytes |
Integer |
The size of stack space, in kilobytes |
Heap KBytes |
Integer |
The size of heap space, in kilobytes |
CPU Time |
Integer |
CPU usage: the user time plus system time, in milliseconds. |
% CPU |
Integer |
Percent of CPU used |
% Memory |
Integer |
Percent of memory used |
Major Page Faults |
Integer |
Major page faults since process start |
Minor Page Faults |
Integer |
Minor page faults since process start |
Command |
String |
Full command line with all arguments |
Start Time |
Integer |
The number of seconds since the process started |
Number of threads |
Integer |
Number of threads in this process |
Characters Written |
Long |
The number of bytes which this task has caused, or shall cause to be written to disk |
Characters Read |
Long |
The number of bytes which this process has caused to be read from storage |
Read Syscalls |
Long |
Attempt to count the number of read I/O operations |
Write Syscalls |
Long |
Attempt to count the number of write I/O operations |
Bytes read |
Long |
Attempt to count the number of bytes which this process really did cause to be fetched from the storage layer. |
Bytes written |
Long |
Attempt to count the number of bytes which this process caused to be sent to the storage layer |
Cancelled_write_bytes |
Long |
This field represents the number of bytes which this process caused to not happen, by truncating pagecache |
RSS |
Double |
Resident Set Size: number of pages the process has in real memory |
VmPeak |
Long |
Peak virtual memory size in Kbytes |
VmPin |
Long |
Pinned memory size. It is size of pinned pages that cannot be swapped. (available since Linux 3.2) |
VmLCK |
Long |
Locked memory size in KBytes |
VmHWM |
Long |
Peak resident set size in KBytes |
VmPTE |
Long |
Page table entries size in KBytes |
VmRSS |
Long |
Resident set size in KBytes |
VmData |
Long |
Size of data in KBytes |
VmStk |
Long |
Size of stack in KBytes |
VmExe |
Long |
Size of text segments in KBytes |
VmLib |
Long |
Shared library code size in KBytes |
VmSwap |
Long |
Swap Space Used in Kbytes |
PGID |
Long |
The process group ID of the process |
SID |
Integer |
The session ID of the process |
TTY_NR |
Integer |
The controlling terminal of the process |
TTY_PGRP |
Integer |
The ID of the foreground process group of the controlling terminal of the process |
FLAGS |
Integer |
The kernel flags word of the process |
CMAJ_FLT |
Long |
The number of major faults that the process's waited-for children have made |
CMIN_FLT |
Long |
The number of minor faults that the process's waited-for children have made |
STIME |
Double |
Amount of time that this process has been scheduled in kernel mode |
CSTIME |
Double |
Amount of time that this process's waited-for children have been scheduled in kernel mode |
UTIME |
Double |
Amount of time that this process has been scheduled in user mode |
CUTIME |
Double |
Amount of time that this process's waited-for children have been scheduled in user mode |
Priority |
Long |
Process scheduling Priority |
NICE |
Long |
The nice value, a value in the range 19 (low priority) to -20 (high priority) |
IT_REAL_VALUE |
Long |
The time in jiffies before the next SIGALRM is sent to the process due to an interval timer |
Start_Code |
Long |
The address above which program text can run |
End_Code |
Long |
The address below which program text can run |
Start_Stack |
Long |
The address of the start (bottom) of the stack |
ESP |
Long |
The current value of ESP (stack pointer), as found in the kernel stack page for the process |
EIP |
Long |
The current EIP (instruction pointer) |
Pending |
Long |
The bitmap of pending signals, displayed as a decimal number |
Blocked |
Long |
The bitmap of blocked signals, displayed as a decimal number |
SIGIN |
Long |
The bitmap of ignored signals |
SIGCATCH |
Long |
The bitmap of caught signals |
WCHAN |
Double |
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 |
NSWAP |
Long |
Number of pages swapped |
CNSWAP |
Long |
Cumulative nswap for child processes |
EXIT_SIGNAL |
Long |
Signal to send to parent thread on exit. (available in Linux 2.1.22 and later) |
Processor |
Long |
CPU number last executed on. (available in Linux 2.2.8 and later) |
RT_PRIORITY |
Long |
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. (available in Linux 2.5.19 and later) |
Policy |
Long |
Scheduling policy. Decode using the SCHED_* constants in linux/sched.h. (available in Linux 2.5.19 and later) |