NAME | SYNOPSIS | DESCRIPTION | OPTIONS | NOTES | SEE ALSO | COLOPHON

PCP-PIDSTAT(1)             General Commands Manual            PCP-PIDSTAT(1)

NAME         top

        pcp-pidstat - Report statistics for Linux tasks.

SYNOPSIS         top

       pcp pidstat [-s N] [-t DELTA] [-I ] [-a FILE]  [-G NAME]
       [-U[USERNAME]] [-p PID1,PID2..] [-R/-r/-k] [-V] [-?]

DESCRIPTION         top

       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)

OPTIONS         top

       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).

       -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.

NOTES         top

       pcp-pidstat is inspired by the pidstat(1) command and aims to be
       command line and output compatible with it.

SEE ALSO         top

       pcp(1), pidstat(1), PCPIntro(1), pmParseInterval(3) and environ(7).

COLOPHON         top

       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-03-13.  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)