From owner-freebsd-doc@FreeBSD.ORG Sat Oct 1 22:44:33 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 1233) id 8AE651065672; Sat, 1 Oct 2011 22:44:33 +0000 (UTC) Date: Sat, 1 Oct 2011 22:44:33 +0000 From: Alexander Best To: Glen Barber Message-ID: <20111001224433.GA88188@freebsd.org> References: <20111001191010.GA61141@freebsd.org> <20111001220347.GA82495@freebsd.org> <4E879708.6080000@FreeBSD.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="zYM0uCDKw75PZbzx" Content-Disposition: inline In-Reply-To: <4E879708.6080000@FreeBSD.org> Cc: freebsd-doc@freebsd.org, Ed Schouten Subject: Re: small ps(1) man page adjustment X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 01 Oct 2011 22:44:33 -0000 --zYM0uCDKw75PZbzx Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On Sat Oct 1 11, Glen Barber wrote: > Hi Alex, > > I can look later, unless someone else gets to it first. thanks. ed reminded me that i need to make sure a sentence always ends with a new line. here's an updated patch. cheers. alex > > Regards, > > Glen > > On 10/1/11 6:03 PM, Alexander Best wrote: > > On Sat Oct 1 11, Alexander Best wrote: > >> hi there, > >> > >> this small adjustment to the ps(1) man page sorts the fields being displayed > >> by merely typing 'ps' correctly. > > > > this patch cleans up the ps(1) man page some more: > > > > O there's no reason the semantics of the -x flag are being explained in the > > -a flag description > > > > O be more precise regarding the relation between the -a flag and the > > security.bsd.see_other_uids sysctl > > > > O describe the format of the -t flag's argument > > > > O 'con' no longer is a possible entry in the 'TT' column > > > > O explain that the 'TT' column refers to pseudo-terminals via mere numbers > > > > O add a hint in the 'tt' keyword description that a keyword 'tty' exists, > > which will give the full terminal pathname > > > > cheers. > > alex > > > >> > >> cheers. > >> alex > > > >> diff --git a/bin/ps/ps.1 b/bin/ps/ps.1 > >> index a66ed5d..8c27186 100644 > >> --- a/bin/ps/ps.1 > >> +++ b/bin/ps/ps.1 > >> @@ -90,8 +90,8 @@ and > >> .Fl o > >> options). > >> 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. > >> .Pp > >> The process file system (see > >> .Xr procfs 5 ) > > > > > -- > Glen Barber | gjb@FreeBSD.org > FreeBSD Documentation Project > --zYM0uCDKw75PZbzx Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="ps.1.diff4" diff --git a/bin/ps/ps.1 b/bin/ps/ps.1 index 8c27186..948ffad 100644 --- a/bin/ps/ps.1 +++ b/bin/ps/ps.1 @@ -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 @@ -53,7 +53,9 @@ The utility displays a header line, followed by lines containing information about all of your -processes that have controlling terminals. +processes that have controlling terminals, or, if the +.Fl x +options was specified, also 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 +105,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 +214,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 +428,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 --zYM0uCDKw75PZbzx--