1PCP-PS(1) General Commands Manual PCP-PS(1)
2
6 pcp-ps - Report statistics for Linux Process.
7
9 pcp [pcp options] ps [-e] [-U [username]] [-V --version] [-c Command
10 name] [-P pid1,pid2..] [-p pid1,pid2..] [-o col1,col2... or ALL] [-Z
11 timezone] [-z] [-?]
12
14 The pcp-ps command is used for monitoring individual process running on
15 the system. Using various options it helps a user to see useful infor‐
16 mation related to the processes. This information includes CPU per‐
17 centage, memory and stack usage, scheduling and priority. By default
18 pcp-ps reports live data for the local host.
19
21 When invoked via the pcp(1) command, the -h/--host, -O/--origin,
22 -t/--interval, -Z/--timezone and several other pcp options become indi‐
23 rectly available; refer to PCPIntro(1) for a complete description of
24 these options.
25 The additional command line options available for pcp-ps are:
27 -e Display all the process.
29 PID Process idenfier.
31 TTY The termianl assoicated with the prcoess.
32 TIME The cumulated CPU time in [DD-]hh:mm:ss
33 format (time=TIME).
34 CMD The command name of the task.
35 -c [command name]
37 Display the real Command name of the tasks being monitored instead
38 of the UID. If command name is specified, then only tasks
39 belonging to the specified command are displayed.
40 -U [username], --user-name[=username]
42 Display the real user name of the tasks being monitored instead of
43 the UID. If username is specified, then only tasks belonging to
44 the specified user are displayed.
45 -V, --version
47 Print version number then exit.
48 -p pid1,pid2.., --pid-list=pid1,pid2..
50 Display only processes with the listed PIDs.
51 -P ppid1,ppid2.., --ppid-list=ppid1,ppid2..
53 Display only processes with the listed PPIDs.
54 -o User-defined format.
56 It is a single argument in the form of a blank-separated or comma-
58 separated list, which offers a way to specify individual output
59 columns.
60 The argument to -o are following:
62 COL HEADER DESCRIPTION
65 ───────────────────────────────────────────────────────────────────
66 %cpu %CPU cpu utilization of the process
68 %mem %MEM physical memory on the machine expressed as a
69 percentage
70 start START time the command started
71 time TIME accumulated cpu time, user + system
72 cls CLS scheduling class of the process
73 cmd CMD see args. (alias args, command).
74 pid PID The process ID
75 ppid PPID Parent process ID
76 pri PRI Priority of the process
77 state S see s
78 rss RSS the non-swapped physical memory that a task has
79 used
80 rtprio RTPRIO realtime priority
81 pname Pname Process name
82 tty TT controlling tty (terminal)
83 uid UID see euid
84 uname USER see euser
85 vsize VSZ see vsz
86 wchan WCHAN name of the kernel function in which the process
87 is sleeping
88
90 Here are the different keywords that may be used to control the output
91 format (e.g. with option -o) or to sort the selected processes
92 For example: pcp-ps -o pid,user,args
94 CODE HEADER DESCRIPTION
97 ────────────────────────────────────────────────────────────────────────
98 pid PID a number representing the process ID
99 %cpu %CPU %cpu utilization of the process in "##.#" format.
100 Currently, it is the CPU time used divided by the
101 time the process has been running (cputime/realtime
102 ratio), expressed as a percentage.
103 %mem %MEM %ratio of the process's resident set size to the
104 physical memory on the machine, expressed as a
105 percentage.
106 args COMMAND Command with all its arguments as a string.
107 Modifications to the arguments may be shown. The
108 output in this column may contain spaces. A process
109 marked <defunct> is partly dead, waiting to be fully
110 destroyed by its parent. Sometimes the process args
111 will be unavailable; when this happens,will instead
112 print the executable name in brackets.
113 class CLS scheduling class of the process.
114 Field's possible values are: - not reported
115 TS SCHED_OTHER
116 FF SCHED_FIFO
117 RR SCHED_RR
118 B SCHED_BATCH
119 ISO SCHED_ISO
120 IDL SCHED_IDLE
121 DLN SCHED_DEADLINE
122 ? unknown value
123 s S minimal state display. See also state if you want
124 additional information displayed.
125 euid EUID effective user ID.
126 vsz VSZ virtual memory size of the process in KiB (1024-byte
127 units). Device mappings are currently excluded; this
128 is subject to change.
129 euser EUSER effective user name. This will be the textual user
130 ID, if it can be obtained and the field width
131 permits, or a decimal representation otherwise.
132 All N/A This option shows USER, PID, PPID, PRI, %CPU, %MEM,
134 VSZ, RSS, S, START, TIME, WCHAN and COMMAND.
135 -Z timezone, --timezone=timezone
137 By default, pcp-ps reports the time of day according to the
138 local timezone on the system where pcp-ps is run. The -Z option
139 changes the timezone to timezone in the format of the
140 environment variable TZ as described in environ(7).
141 -z , --hostzone
143 Change the reporting timezone to the local timezone at the host
144 that is the source of the performance metrics. When replaying a
145 PCP archive that was captured in a foreign timezone, the -z
146 option would almost always be used (the default reporting
147 timezone is the local timezone, which may not be the same as the
148 timezone of the PCP archive).
149 -? , --help
151 Display usage message and exit.
152
154 pcp-ps is inspired by the ps(1) command and aims to be command line and
155 output compatible with it.
156
158 Environment variables with the prefix PCP_ are used to parameterize the
159 file and directory names used by PCP. On each installation, the file
160 /etc/pcp.conf contains the local values for these variables. The
161 $PCP_CONF variable may be used to specify an alternative configuration
162 file, as described in pcp.conf(5).
163 For environment variables affecting PCP tools, see pmGetOptions(3).
165
167 PCPIntro(1), pcp(1), pcp-ps(1), python(1), pmParseInterval(3),
168 strftime(3) and environ(7).
169Performance Co-Pilot PCP PCP-PS(1)