Provided by: pcp_6.0.5-1_amd64 bug

NAME

       pcp-ps - Report statistics for Linux Process.

SYNOPSIS

       pcp   [pcp options]  ps  [-e]  [-U  [username]]  [-V  --version]  [-c  Command  name]  [-P
       pid1,pid2..]  [-p pid1,pid2..]  [-o col1,col2... or ALL] [-Z timezone] [-z] [-?]

DESCRIPTION

       The pcp-ps command is used for monitoring individual process running on the system.  Using
       various  options it helps a user to see useful information related to the processes.  This
       information includes CPU percentage, memory and stack usage, scheduling and priority.   By
       default pcp-ps reports live data for the local host.

OPTIONS

       When   invoked   via  the  pcp(1)  command,  the  -h/--host,  -O/--origin,  -t/--interval,
       -Z/--timezone and  several  other  pcp  options  become  indirectly  available;  refer  to
       PCPIntro(1) for a complete description of these options.

       The additional command line options available for pcp-ps are:

       -e   Display all the process.

            PID    Process idenfier.
            TTY    The termianl assoicated with the prcoess.
            TIME   The  cumulated CPU time in [DD-]hh:mm:ss
                   format (time=TIME).
            CMD    The command name of the task.

       -c [command name]
            Display the real Command name of the tasks being monitored instead of  the  UID.   If
            command  name  is  specified,  then only tasks belonging to the specified command are
            displayed.

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

       -V, --version
            Print version number then exit.

       -p pid1,pid2.., --pid-list=pid1,pid2..
            Display only processes with the listed PIDs.

       -P ppid1,ppid2.., --ppid-list=ppid1,ppid2..
            Display only processes with the listed PPIDs.

       -o   User-defined format.

            It  is  a  single  argument in the form of a blank-separated or comma-separated list,
            which offers a way to specify individual output columns.

            The argument to -o are following:

            COL      HEADER   DESCRIPTION
            ──────────────────────────────────────────────────────────────────────────────────────
            %cpu     %CPU     cpu utilization of the process
            %mem     %MEM     physical memory on the machine expressed as a percentage
            start    START    time the command started
            time     TIME     accumulated cpu time, user + system
            cls      CLS      scheduling class of the process

            cmd      CMD      see args.  (alias args, command).
            pid      PID      The process ID
            ppid     PPID     Parent process ID
            pri      PRI      Priority of the process
            state    S        see s
            rss      RSS      the non-swapped physical memory that a task has used
            rtprio   RTPRIO   realtime priority
            pname    Pname    Process name
            tty      TT       controlling tty (terminal)
            uid      UID      see euid
            uname    USER     see euser
            vsize    VSZ      see vsz
            wchan    WCHAN    name of the kernel function in which the process is sleeping

STANDARD FORMAT SPECIFIERS

       Here are the different keywords that may be used to control the output format  (e.g.  with
       option -o) or to sort the selected processes

       For example: pcp-ps -o pid,user,args

       CODE    HEADER    DESCRIPTION
       ───────────────────────────────────────────────────────────────────────────────────────────
       pid     PID       a number representing the process ID
       %cpu    %CPU      %cpu utilization of the process in "##.#" format.
                         Currently, it is the CPU time used divided by the time the process has
                         been running (cputime/realtime ratio), expressed as a percentage.
       %mem    %MEM      %ratio of the process's resident set size  to the physical memory on the
                         machine, expressed as a percentage.
       args    COMMAND   Command with all its arguments as a string. Modifications to the
                         arguments may be shown.  The output in this column may contain spaces.
                         A process marked <defunct> is partly dead, waiting to be fully destroyed
                         by its parent.  Sometimes the process args will be unavailable; when
                         this happens,will instead print the executable name in brackets.
       class   CLS       scheduling class of the process.
                         Field's possible values are: -      not reported
                         TS     SCHED_OTHER
                         FF     SCHED_FIFO
                         RR     SCHED_RR
                         B      SCHED_BATCH
                         ISO    SCHED_ISO
                         IDL    SCHED_IDLE
                         DLN    SCHED_DEADLINE
                         ?      unknown value
       s       S         minimal state display.  See also state if you want additional
                         information displayed.
       euid    EUID      effective user ID.
       vsz     VSZ       virtual memory size of the process in KiB (1024-byte units).  Device
                         mappings are currently excluded; this is subject to change.
       euser   EUSER     effective user name.  This will be the textual user ID, if it can be
                         obtained and the field width permits, or a decimal representation
                         otherwise.
       All     N/A       This option shows USER, PID, PPID, PRI, %CPU, %MEM, VSZ, RSS, S, START,
                         TIME, WCHAN and COMMAND.

       -Z timezone, --timezone=timezone
              By default, pcp-ps reports the time of day according to the local timezone  on  the
              system  where pcp-ps is run.  The -Z option changes the timezone to timezone in the
              format of the environment variable TZ as described in environ(7).

       -z , --hostzone
              Change the reporting timezone to the local timezone at the host that is the  source
              of  the  performance  metrics.  When replaying a PCP archive that was captured in a
              foreign timezone, the -z option would almost always be used (the default  reporting
              timezone  is  the  local timezone, which may not be the same as the timezone of the
              PCP archive).

       -? , --help
              Display usage message and exit.

NOTES

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

PCP ENVIRONMENT

       Environment variables with the prefix PCP_ are used to parameterize the file and directory
       names used by PCP.  On each installation, the file /etc/pcp.conf contains the local values
       for  these  variables.   The  $PCP_CONF  variable  may  be  used to specify an alternative
       configuration file, as described in pcp.conf(5).

       For environment variables affecting PCP tools, see pmGetOptions(3).

SEE ALSO

       PCPIntro(1), pcp(1), pcp-ps(1), python(1), pmParseInterval(3), strftime(3) and environ(7).