summaryrefslogtreecommitdiffstats
path: root/bin/ps/ps.1
diff options
context:
space:
mode:
authorgad <gad@FreeBSD.org>2004-03-31 23:51:12 +0000
committergad <gad@FreeBSD.org>2004-03-31 23:51:12 +0000
commit174f84b21b6bad327beafa8ed2de283c66f09258 (patch)
tree49e16fc971310a775641e93dd314515d1b0eb5a5 /bin/ps/ps.1
parent5ef02cd175cbb3fe1ffe24d5beac82d3d60240b2 (diff)
downloadFreeBSD-src-174f84b21b6bad327beafa8ed2de283c66f09258.zip
FreeBSD-src-174f84b21b6bad327beafa8ed2de283c66f09258.tar.gz
Describe the sorting options in better and more complete detail.
Also improve the description of `-L' a little. MFC after: 4 days
Diffstat (limited to 'bin/ps/ps.1')
-rw-r--r--bin/ps/ps.135
1 files changed, 29 insertions, 6 deletions
diff --git a/bin/ps/ps.1 b/bin/ps/ps.1
index ad0661c..30461e9 100644
--- a/bin/ps/ps.1
+++ b/bin/ps/ps.1
@@ -67,10 +67,9 @@
The
.Nm
utility
-displays a header line followed by lines containing information about your
+displays a header line, followed by lines containing information about
+all of your
processes that have controlling terminals.
-This information is sorted by controlling terminal, then by process
-.Tn ID .
.Pp
A different set of processes can be selected for display by using any
combination of the
@@ -83,6 +82,24 @@ If more than one of these options are given, then
will select all processes which are matched by at least one of the
given options.
.Pp
+For the processes which have been selected for display,
+.Nm
+will usually display one line per process.
+The
+.Fl H
+option may result in multiple output lines (one line per thread) for
+some processes.
+By default all of these output lines are sorted first by controlling
+terminal, then by process
+.Tn ID .
+The
+.Fl m, r, u,
+and
+.Fl v
+options will change the sort order.
+If more than one sorting option was given, then the selected processes
+will be sorted by the last sorting option which was specified.
+.Pp
For the processes which have been selected for display, the information
to display is selected based on a set of keywords (see the
.Fl L
@@ -141,7 +158,11 @@ header per page of information.
Print information associated with the following keywords:
user, pid, ppid, pgid, jobc, state, tt, time and command.
.It Fl L
-List the set of available keywords.
+List the set of keywords available for the
+.Fl O
+and
+.Fl o
+options.
.It Fl l
Display information associated with the following keywords:
uid, pid, ppid, cpu, pri, nice, vsz, rss, mwchan, state, tt, time
@@ -150,7 +171,8 @@ and command.
Extract values associated with the name list from the specified core
instead of the currently running system.
.It Fl m
-Sort by memory usage, instead of by process
+Sort by memory usage, instead of the combination of controlling
+terminal and process
.Tn ID .
.It Fl N
Extract the name list from the specified system instead of the default,
@@ -177,7 +199,8 @@ the standard header.
Display information about processes which match the specified process
.Tn ID(s) .
.It Fl r
-Sort by current cpu usage, instead of by process
+Sort by current cpu usage, instead of the combination of controlling
+terminal and process
.Tn ID .
.It Fl S
Change the way the process time is calculated by summing all exited
OpenPOWER on IntegriCloud