ps(1) — 4 BSD
NAME
ps − process status
SYNOPSIS
ps [ acegklstuvwx# ]
DESCRIPTION
ps prints information about processes. Normally, only your processes are candidates to be printed by ps; specifying “a” causes other users processes to be candidates to be printed; specifying “x” includes processes without control terminals in the candidate pool.
All output formats include, for each process, the process id PID, control terminal of the process TT, cpu time used by the process TIME (this includes both user and system time), the state STAT of the process, and an indication of the COMMAND which is running. The state is given by a sequence of three letters, e.g. “RWN”. The first letter indicates the runnability of the process: R for runnable processes, T for stopped processes, P for processes in page wait, D for those in disk (or other short term) waits, S for those sleeping for less than about 20 seconds, and I for idle (sleeping longer than about 20 seconds) processes. The second letter indicates whether a process is swapped out, showing W if it is, or a blank if it is loaded (in-core); a process which has specified a soft limit on memory requirements and which is exceeding that limit shows >; such a process is (necessarily) not swapped. The third letter indicates whether a process is running with a nice value which affects the process’s scheduling priority. If the process has a positive nice value (it’s scheduling priority has been reduced), an N is shown, if the process has a negative nice value (its scheduling priority has been artificially raised) then a ‘<’ is shown; processes running without special treatment have just a blank.
Here are the options:
a asks for information about all processes with terminals (ordinarily only one’s own processes are displayed).
c prints the command name, as stored internally in the system for purposes of accounting, rather than the command arguments, which are kept in the process’ address space. This is more reliable, if less informative, since the process is free to destroy the latter information.
e Asks for the environment to be printed as well as the arguments to the command.
g Asks for all processes. Without this option, ps only prints “interesting” processes. Processes are deemed to be uninteresting if they are process group leaders. This normally eliminates top-level command interpreters and processes waiting for users to login on free terminals.
k causes the file /vmcore is used in place of /dev/kmem and /dev/mem. This is used for postmortem system debugging.
l asks for a long listing, with fields PPID, CP, PRI, NI, ADDR, SIZE, RSS and WCHAN as described below.
s Adds the size SSIZ of the kernel stack of each process (for use by system maintainers) to the basic output format.
tx restricts output to processes whose controlling tty is x (which should be specified as printed by ps, e.g. t3 for tty3, tco for console, td0 for ttyd0, t? for processes with no tty, t for processes at the current tty, etc). This option must be the last one given.
u A user oriented output is produced. This includes fields USER, %CPU, NICE, SIZE, and RSS as described below.
v A version of the output containing virtual memory statistics is output. This includes fields RE, SL, PAGEIN, SIZE, RSS, LIM, TSIZ, TRS, %CPU and %MEM, described below.
w Use a wide output format (132 columns rather than 80); if repeated, e.g. ww, use arbitrarily wide output. This information is used to decide how much of long commands to print.
x asks even about processes with no terminal.
# A process number may be given, (indicated here by #), in which case the output is restricted to that process. This option must also be last.
A second argument is taken to be the file containing the system’s namelist. Otherwise, /unix is used. A third argument tells ps where to look for core if the k option is given, instead of /vmcore. If a fourth argument is given, it is taken to be the name of a swap file to use instead of the default /dev/drum.
Fields which are not common to all output formats:
USERname of the owner of the process
%CPUcpu utilization of the process; this is a decaying average over up to a minute of previous (real) time. Since the time base over which this is computed varies (since processes may be very young) it is possible for the sum of all %CPU fields to exceed 100%.
NICE(or NI) process scheduling increment (see setpriority(2)). For processes in a real-time scheduling policy this field will only contain the string "RT".
SIZEvirtual size of the process (in 1024 byte units)
RSSreal memory (resident set) size of the process (in 1024 byte units)
LIMsoft limit on memory used, specified via a call to setrlimit(2); if no limit has been specified then shown as xx
TSIZsize of text (shared program) image
TRSsize of resident (real memory) set of text
%MEMpercentage of global memory and local memory (on the cpu that the process is executing on) used by this process.
REresidency time of the process (seconds in core)
SLsleep time of the process (seconds blocked)
PAGEINnumber of disk i/o’s resulting from references by the process to pages not loaded in core.
UIDnumerical user-id of process owner (real user id)
PPIDnumerical id of parent of process
CPshort-term cpu utilization factor (used in scheduling)
PRIprocess priority
ADDRswap address of the process
WCHANevent on which process is waiting (an address in the system), with the initial part of the address trimmed off e.g. C0004000 prints as 4000.
Fflags associated with process as in < sys/proc.h >:
SLOAD000001in core
SSYS000002swapper or pager process
SLOCK000004process being swapped out
SKPRMP000008process preempted while in kernel
STRC000010process is being traced
SWTED000020another tracing flag
SULOCK000040user settable lock in core
SPAGE000080process in page wait state
SKEEP000100another flag to prevent swap out
SOMASK000200restore old mask after taking signal
SWEXIT000400working on exiting
SPHYSIO000800doing physical i/o (bio.c)
SVFORK001000process resulted from vfork()
SVFDONE002000another vfork flag
SNOVM004000no vm, parent in a vfork()
SPAGI008000init data space on demand from inode
SSEQL010000user warned of sequential vm behavior
SUANOM020000user warned of random vm behavior
STIMO040000timing out during sleep
SWAKE080000sleep may be interrupted by signal
SOUSIG100000using old signal mechanism
A process that has exited and has a parent, but has not yet been waited for by the parent is marked <defunct>; a process which is blocked trying to exit is marked <exiting>; ps makes an educated guess as to the file name and arguments given when the process was created by examining memory or the swap area. The method is inherently somewhat unreliable and in any event a process is entitled to destroy this information, so the names cannot be counted on too much.
On systems running CX/SX, there is only one version of the ps command, the att version. The ucb version is not available.
NOTES
If the high resolution timing facility is configured into the currently executing kernel, TIME will exclude or include time spent servicing interrupts, depending on what the system timing mode is set to. See hirestmode(2) and CX/UX Programmer’s Guide for more information on the high resolution timing facility.
FILES
/unix system namelist
/dev/kmem kernel memory
/dev/drum swap device
/vmcore core file
/dev searched to find swap device and tty names
SEE ALSO
BUGS
Things can change while ps is running; the picture it gives is only a close approximation to reality.
CX/UX User’s Reference Manual