Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 1 Oct 2011 23:47:37 +0000 (UTC)
From:      Glen Barber <gjb@FreeBSD.org>
To:        src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org
Subject:   svn commit: r225912 - head/bin/ps
Message-ID:  <201110012347.p91NlbkK038750@svn.freebsd.org>

next in thread | raw e-mail | index | archive | help
Author: gjb (doc committer)
Date: Sat Oct  1 23:47:37 2011
New Revision: 225912
URL: http://svn.freebsd.org/changeset/base/225912

Log:
  Tweaks to ps(1):
  - 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
    security.bsd.see_other_uids sysctl
  - 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
  
  Submitted by:		arundel (via docs@) (original)
  MFC after:		1 week
  With-MFC:		225908

Modified:
  head/bin/ps/ps.1

Modified: head/bin/ps/ps.1
==============================================================================
--- head/bin/ps/ps.1	Sat Oct  1 22:19:22 2011	(r225911)
+++ head/bin/ps/ps.1	Sat Oct  1 23:47:37 2011	(r225912)
@@ -29,7 +29,7 @@
 .\"     @(#)ps.1	8.3 (Berkeley) 4/18/94
 .\" $FreeBSD$
 .\"
-.Dd July 1, 2011
+.Dd October 1, 2011
 .Dt PS 1
 .Os
 .Sh NAME
@@ -54,6 +54,11 @@ utility
 displays a header line, followed by lines containing information about
 all of your
 processes that have controlling terminals.
+If the
+.Fl x
+options is specified,
+.Nm
+will also display processes that do not have controlling terminals.
 .Pp
 A different set of processes can be selected for display by using any
 combination of the
@@ -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,
-unless the
-.Fl x
-option is also specified.
-This can be disabled by setting the
+If the
 .Va security.bsd.see_other_uids
-sysctl to zero.
+sysctl is set to zero, this option is honored only if the UID of the user is 0.
 .It Fl c
 Change the
 .Dq command
@@ -216,6 +217,9 @@ with the standard input.
 .It Fl t
 Display information about processes attached to the specified terminal
 devices.
+Full pathnames, as well as abbreviations (see explanation of the
+.Cm tt
+keyword) can be specified.
 .It Fl U
 Display the processes belonging to the specified usernames.
 .It Fl u
@@ -427,12 +431,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 psuedo-terminals, the corresponding entry in
+.Pa /dev/pts .
 This is followed by a
 .Ql -
 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
+.Cm tty
+keyword.
 .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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201110012347.p91NlbkK038750>