|
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | NOTES | SEE ALSO | COLOPHON |
PCP-PIDSTAT(1) General Commands Manual PCP-PIDSTAT(1)
pcp-pidstat - Report statistics for Linux tasks.
pcp pidstat [-s N] [-t DELTA] [-I] [-a FILE] [-f FORMAT] [-G NAME]
[-U[USERNAME]] [-p PID1,PID2..] [-R/-r/-k] [-V] [-?]
pcp-pidstat command is used for monitoring individual tasks currently
being managed by the Linux kernel. Using various options it helps
user to see useful information related with the processes. This
information can include percentage CPU, memory and stack usages,
scheduling and priority information. pcp-pidstat fetches the data to
be analysed from PMCD unless provided -a option. (See below)
Output control options:
-s N, --samples=N
Set the number of samples to be displayed. Since the first
sample is used for the rate conversion of some of the metrics,
the total number of samples reported are one less that N.
Default is continous.
-t DELTA, --interval=DELTA
Set the interval between two samples. Default is one second.
General Options:
-I In an SMP environment, indicates that tasks CPU usage should
be divided by the total number of processors.
-a FILE, --archive=FILE
Causes pcp-pidstat to use the specified archive than
connecting to PMCD. The argument to -a is a comma-separated
list of names, each of which may be the base name of an
archive or the name of a directory containing one or more
archives. Archives can be created using pmlogger(1).
-f Use the format string for formatting the timestamp. The format
will be used with Python's datetime.strftime method which is
mostly the same as that described in strftime(3). An empty
format string(i.e,"") will remove the timestamps from the
output. The default with stdout is %H:%M:%S.
-R Report realtime priority and scheduling policy information.
The following values may be displayed:
UID
The real user identification number of the task being
monitored.
USER
The name of the real user owning the task being
monitored.
PID
The identification number of the task being monitored.
prio
The realtime priority of the task being monitored.
policy
The scheduling policy of the task being monitored.
Command
The command name of the task.
-r Report page faults and memory utilization. The following
values may be displayed:
UID
The real user identification number of the task being
monitored.
USER
The name of the real user owning the task being
monitored.
PID
The identification number of the task being monitored.
minflt/s
Total number of minor faults the task has made per
second, those which have not required loading a memory page
from disk.
majflt/s
Total number of major faults the task has made per
second, those which have required loading a memory page from
disk.
VSZ
Virtual Size: The virtual memory usage of entire task
in kilobytes.
RSS
Resident Set Size: The non-swapped physical memory used
by the task in kilobytes.
%MEM
The tasks's currently used share of available physical
memory.
Command
The command name of the task.
-k Report stack utilization. The following values may be
displayed:
UID
The real user identification number of the task being
monitored.
USER
The name of the real user owning the task being
monitored.
PID
The identification number of the task being monitored.
StkSize
The amount of memory in kilobytes reserved for the task
as stack, but not necessarily used.
StkRef
The amount of memory in kilobytes used as stack,
referenced by the task.
Command
The command name of the task.
-V Display version and exit
-? , --help
Display help and exit
Ouput Filter Options
-G NAME, --process-name=NAME
Display only processes whose command name includes the string
NAME. This string can be a regular expression.
-U[USERNAME], --user-name=[USERNAME]
Display the real user name of the tasks being monitored
instead of the UID. If username is specified, then only tasks
belonging to the specified user are displayed.
-p PID1,PID2.. , --pid-list=PID1,PID2..
Display only processes whose PID belongs to the given Pid
List.
pcp-pidstat is inspired by the pidstat(1) command and aims to be
command line and output compatible with it.
pcp(1), pidstat(1), PCPIntro(1), pmParseInterval(3) and environ(7).
This page is part of the PCP (Performance Co-Pilot) project.
Information about the project can be found at ⟨http://www.pcp.io/⟩.
If you have a bug report for this manual page, send it to
pcp@oss.sgi.com. This page was obtained from the project's upstream
Git repository ⟨git://git.pcp.io/pcp⟩ on 2017-07-05. If you discover
any rendering problems in this HTML version of the page, or you
believe there is a better or more up-to-date source for the page, or
you have corrections or improvements to the information in this
COLOPHON (which is not part of the original manual page), send a mail
to man-pages@man7.org
Performance Co-Pilot PCP PCP-PIDSTAT(1)