NAME

        pcp-pidstat - Report statistics for Linux tasks.

SYNOPSIS

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

DESCRIPTION

       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

       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.

NOTES

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

SEE ALSO

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

Performance Co-Pilot                                   PCP                                        PCP-PIDSTAT(1)