System Administration Commands prstat(1M)
NAME
prstat - report active process statistics
SYNOPSIS
prstat [-acJLmRtTv] [-C psrsetlist] [-j projlist] [-k task-
list] [-n ntop[,nbottom]] [-p pidlist] [-P cpulist] [-s key
| -S key ] [-u euidlist] [-U uidlist] [-z zoneidlist] [-Z]
[interval [count]]
DESCRIPTION
The prstat utility iteratively examines all active processes
on the system and reports statistics based on the selected
output mode and sort order. prstat provides options to exam-
ine only processes matching specified PIDs, UIDs, zone IDs,
CPU IDs, and processor set IDs.
The -j, -k, -C, -p, -P, -u, -U, and -z options accept lists
as arguments. Items in a list can be either separated by
commas or enclosed in quotes and separated by commas or
spaces.
If you do not specify an option, prstat examines all
processes and reports statistics sorted by CPU usage.
OPTIONS
The following options are supported:
-a Report information about processes
and users. In this mode prstat
displays separate reports about
processes and users at the same
time.
-c Print new reports below previous
reports instead of overprinting
them.
-C psrsetlist Report only processes or lwps that
are bound to processor sets in the
given list. Each processor set is
identified by an integer as reported
by psrset(1M). The load averages
displayed are the sum of the load
averages of the specified processor
sets (see pset_getloadavg(3C)).
Processes with one or more LWPs
bound to processor sets in the given
list are reported even when the -L
option is not used.
-j projlist Report only processes or lwps whose
project ID is in the given list.
Each project ID can be specified as
either a project name or a numerical
project ID. See project(4).
-J Report information about processes
and projects. In this mode prstat
displays separate reports about
processes and projects at the same
time.
-k tasklist Report only processes or lwps whose
task ID is in tasklist.
-L Report statistics for each light-
weight process (LWP). By default,
prstat reports only the number of
LWPs for each process.
-m Report microstate process accounting
information. In addition to all
fields listed in -v mode, this mode
also includes the percentage of time
the process has spent processing
system traps, text page faults, data
page faults, waiting for user locks
and waiting for CPU (latency time).
-n ntop[,nbottom] Restrict number of output lines. The
ntop argument determines how many
lines of process or lwp statistics
are reported, and the nbottom argu-
ment determines how many lines of
user, task, or projects statistics
are reported if the -a, -t, -T, or
-J options are specified. By
default, prstat displays as many
lines of output that fit in a window
or terminal. When you specify the -c
option or direct the output to a
file, the default values for ntop
and nbottom are 15 and 5.
-p pidlist Report only processes whose process
ID is in the given list.
-P cpulist Report only processes or lwps which
have most recently executed on a CPU
in the given list. Each CPU is iden-
tified by an integer as reported by
psrinfo(1M).
-R Put prstat in the real time schedul-
ing class. When this option is used,
prstat is given priority over time-
sharing and interactive processes.
This option is available only for
superuser.
-s key Sort output lines (that is,
processes, lwps, or users) by key in
descending order. Only one key can
be used as an argument.
There are five possible key values:
cpu
Sort by process CPU usage. This
is the default.
pri
Sort by process priority.
rss
Sort by resident set size.
size
Sort by size of process image.
time
Sort by process execution time.
-S key Sort output lines by key in ascend-
ing order. Possible key values are
the same as for the -s option. See
-s.
-t Report total usage summary for each
user. The summary includes the total
number of processes or LWPs owned by
the user, total size of process
images, total resident set size,
total cpu time, and percentages of
recent cpu time and system memory.
-T Report information about processes
and tasks. In this mode prstat
displays separate reports about
processes and tasks at the same
time.
-u euidlist Report only processes whose effec-
tive user ID is in the given list.
Each user ID may be specified as
either a login name or a numerical
user ID.
-U uidlist Report only processes whose real
user ID is in the given list. Each
user ID may be specified as either a
login name or a numerical user ID.
-v Report verbose process usage. This
output format includes the percen-
tage of time the process has spent
in user mode, in system mode, and
sleeping. It also includes the
number of voluntary and involuntary
context switches, system calls and
the number of signals received.
Statistics that are not reported are
marked with the - sign.
-z zoneidlist Report only processes or LWPs whose
zone ID is in the given list. Each
zone ID can be specified as either a
zone name or a numerical zone ID.
See zones(5).
-Z Report information about processes
and zones. In this mode, prstat
displays separate reports about
processes and zones at the same
time.
OUTPUT
The following list defines the column headings and the mean-
ings of a prstat report:
PID
The process ID of the process.
USERNAME
The real user (login) name or real user ID.
SIZE
The total virtual memory size of the process, including
all mapped files and devices, in kilobytes (K), mega-
bytes (M), or gigabytes (G).
RSS
The resident set size of the process (RSS), in kilobytes
(K), megabytes (M), or gigabytes (G). The RSS value is
an estimate provided by proc(4) that might underestimate
the actual resident set size. Users who want to get more
accurate usage information for capacity planning should
use the -x option to pmap(1) instead.
STATE
The state of the process:
cpuN
Process is running on CPU N.
sleep
Sleeping: process is waiting for an event to com-
plete.
run
Runnable: process in on run queue.
zombie
Zombie state: process terminated and parent not
waiting.
stop
Process is stopped.
PRI
The priority of the process. Larger numbers mean higher
priority.
NICE
Nice value used in priority computation. Only processes
in certain scheduling classes have a nice value.
TIME
The cumulative execution time for the process.
CPU
The percentage of recent CPU time used by the process.
If executing in a non-global zone and the pools facility
is active, the percentage will be that of the processors
in the processor set in use by the pool to which the
zone is bound.
PROCESS
The name of the process (name of executed file).
LWPID
The lwp ID of the lwp being reported.
NLWP
The number of lwps in the process.
The following columns are displayed when the -v or -m option
is specified
USR The percentage of time the process has spent
in user mode.
SYS The percentage of time the process has spent
in system mode.
TRP The percentage of time the process has spent
in processing system traps.
TFL The percentage of time the process has spent
processing text page faults.
DFL The percentage of time the process has spent
processing data page faults.
LCK The percentage of time the process has spent
waiting for user locks.
SLP The percentage of time the process has spent
sleeping.
LAT The percentage of time the process has spent
waiting for CPU.
VCX The number of voluntary context switches.
ICX The number of involuntary context switches.
SCL The number of system calls.
SIG The number of signals received.
Under the -L option, one line is printed for each lwp in the
process and some reporting fields show the values for the
lwp, not the process.
OPERANDS
The following operands are supported:
count Specifies the number of times that the
statistics are repeated. By default, prstat
reports statistics until a termination sig-
nal is received.
interval Specifies the sampling interval in seconds;
the default interval is 5 seconds.
EXAMPLES
Example 1: Reporting the Five Most Active Super-User
Processes
The following command reports the five most active super-
user processes running on CPU1 and CPU2:
example% prstat -u root -n 5 -P 1,2 1 1
PID USERNAME SIZE RSS STATE PRI NICE TIME CPU PROCESS/LWP
306 root 3024K 1448K sleep 58 0 0:00.00 0.3% sendmail/1
102 root 1600K 592K sleep 59 0 0:00.00 0.1% in.rdisc/1
250 root 1000K 552K sleep 58 0 0:00.00 0.0% utmpd/1
288 root 1720K 1032K sleep 58 0 0:00.00 0.0% sac/1
1 root 744K 168K sleep 58 0 0:00.00 0.0% init/1
TOTAL: 25, load averages: 0.05, 0.08, 0.12
Example 2: Displaying Verbose Process Usage Information
The following command displays verbose process usage infor-
mation about processes with lowest resident set sizes owned
by users root and john.
example% prstat -S rss -n 5 -vc -u root,john
PID USERNAME USR SYS TRP TFL DFL LCK SLP LAT VCX ICX SCL SIG PROCESS/LWP
1 root 0.0 0.0 - - - - 100 - 0 0 0 0 init/1
102 root 0.0 0.0 - - - - 100 - 0 0 3 0 in.rdisc/1
250 root 0.0 0.0 - - - - 100 - 0 0 0 0 utmpd/1
1185 john 0.0 0.0 - - - - 100 - 0 0 0 0 csh/1
240 root 0.0 0.0 - - - - 100 - 0 0 0 0 powerd/4
TOTAL: 71, load averages: 0.02, 0.04, 0.08
EXIT STATUS
The following exit values are returned:
0 Successful completion.
1 An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWcsu |
|_____________________________|_____________________________|
SEE ALSO
proc(1), psrinfo(1M), psrset(1M), sar(1M),
pset_getloadavg(3C), proc(4), project(4), attributes(5),
zones(5)
NOTES
The snapshot of system usage displayed by prstat is true
only for a split-second, and it may not be accurate by the
time it is displayed. When the -m option is specified,
prstat tries to turn on microstate accounting for each pro-
cess; the original state is restored when prstat exits. See
proc(4) for additional information about the microstate
accounting facility.
|
|
