svn commit: r226191 - stable/8/bin/ps
gjb at FreeBSD.org
Mon Oct 10 11:12:00 UTC 2011
Author: gjb (doc committer)
Date: Mon Oct 10 11:11:59 2011
New Revision: 226191
MFC 225908, 225912, 225927:
- Reorder default ps(1) output according to reality.
- there's no reason the semantics of the -x flag are being explained in
the -a flag description
- be more precise regarding the relation between the -a flag and the
- describe the format of the -t flag's argument
- 'con' no longer is a possible entry in the 'TT' column
- explain that the 'TT' column refers to pseudo-terminals
via mere numbers
- add a hint in the 'tt' keyword description that a
keyword 'tty' exists, which will give the full terminal pathname
- Correct a typo that was introduced in 225912
stable/8/bin/ps/ (props changed)
--- stable/8/bin/ps/ps.1 Mon Oct 10 11:11:05 2011 (r226190)
+++ stable/8/bin/ps/ps.1 Mon Oct 10 11:11:59 2011 (r226191)
@@ -29,7 +29,7 @@
.\" @(#)ps.1 8.3 (Berkeley) 4/18/94
-.Dd March 16, 2011
+.Dd October 1, 2011
.Dt PS 1
@@ -54,6 +54,11 @@ utility
displays a header line, followed by lines containing information about
all of your
processes that have controlling terminals.
+options is specified,
+will also display processes that do not have controlling terminals.
A different set of processes can be selected for display by using any
combination of the
@@ -90,8 +95,8 @@ and
The default output format includes, for each process, the process' ID,
-controlling terminal, CPU time (including both user and system time),
-state, and associated command.
+controlling terminal, state, CPU time (including both user and system time)
+and associated command.
The process file system (see
.Xr procfs 5 )
@@ -103,13 +108,9 @@ The options are as follows:
.Bl -tag -width indent
.It Fl a
Display information about other users' processes as well as your own.
-This will skip any processes which do not have a controlling terminal,
-option is also specified.
-This can be disabled by setting the
-sysctl to zero.
+sysctl is set to zero, this option is honored only if the UID of the user is 0.
.It Fl c
@@ -213,6 +214,9 @@ with the standard input.
.It Fl t
Display information about processes attached to the specified terminal
+Full pathnames, as well as abbreviations (see explanation of the
+keyword) can be specified.
.It Fl U
Display the processes belonging to the specified usernames.
.It Fl u
@@ -418,12 +422,15 @@ The process is being traced or debugged.
An abbreviation for the pathname of the controlling terminal, if any.
The abbreviation consists of the three letters following
.Pa /dev/tty ,
-or, for the console,
-.Dq Li con .
+or, for pseudo-terminals, the corresponding entry in
+.Pa /dev/pts .
This is followed by a
if the process can no longer reach that
controlling terminal (i.e., it has been revoked).
+The full pathname of the controlling terminal is available via the
.It Cm wchan
The event (an address in the system) on which a process waits.
When printed numerically, the initial part of the address is
More information about the svn-src-stable-8