shithub: riscv

ref: cff0ebade5fb37b3d5614ae9ff76513e4b0e4640
dir: /sys/man/1/ps/

View raw version
.TH PS 1
.SH NAME
ps, psu, pstree \- process status
.SH SYNOPSIS
.B ps
[
.B -apnr
]
.PP
.B psu
[
.B -apnr
]
[
.I user
]
.PP
.B pstree
.SH DESCRIPTION
.I Ps
prints information about processes.
.I Psu
prints only information about processes started by
.I user
(default
.BR $user ).
.PP
For each process reported,
the user,
process id,
user time,
system time,
size,
state,
and command name are printed.
State is one of the following:
.TP \w'\fLno\ \fIresource\ \ \ 'u
.B Moribund
Process has exited and is about to have its
resources reclaimed.
.TP
.B Ready
on the queue of processes ready to be run.
.TP
.B Scheding
about to be run.
.TP
.B Running
running.
.TP
.B Queueing
waiting on a queue for a resource.
.TP
.B Wakeme
waiting for I/O or some other kernel event to wake it up.
.TP
.B Broken
dead of unnatural causes; lingering
so that it can be examined.
.TP
.B Stopped
stopped.
.TP
.B Stopwait
waiting for another process to stop.
.TP
.B Fault
servicing a page fault.
.TP
.B Idle
waiting for something to do (kernel processes only).
.TP
.B New
being created.
.TP
.B Pageout
paging out some other process.
.TP
.I Syscall
performing the named system call.
.TP
.BI no " resource
waiting for more of a critical
.IR resource .
.PD
.PP
The
.B -n
flag causes
.I ps
to print, after the process id, the note group to which the process belongs.
.PP
The
.B -r
flag causes
.I ps
to print, before the user time, the elapsed real time for the process.
.PP
The
.B -p
flag causes
.I ps
to print, after the system time, the baseline and current priorities of each process.
.PP
The
.B -a
flag causes
.I ps
to print the arguments for the process.  Newlines in arguments will be translated to spaces for display.
.PP
.I Pstree
prints the processes as a tree in a two-column layout where
the first column being the process id and second column
the program name and arguments indented and prefixed with
line drawing runes to reflect the nesting in the hierarchy.
.SH FILES
.B /proc/*/status
.SH SOURCE
.B /sys/src/cmd/ps.c
.br
.B /rc/bin/psu
.br
.B /sys/src/cmd/pstree.c
.SH "SEE ALSO"
.IR acid (1),
.IR db (1),
.IR kill (1), 
.IR ns (1),
.IR proc (3)
.SH HISTORY
.I Pstree
first appeared in 9front (June, 2011).