Date: Sat, 1 Oct 2011 22:03:47 +0000 From: Alexander Best <arundel@freebsd.org> To: freebsd-doc@freebsd.org Subject: Re: small ps(1) man page adjustment Message-ID: <20111001220347.GA82495@freebsd.org> In-Reply-To: <20111001191010.GA61141@freebsd.org> References: <20111001191010.GA61141@freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--GvXjxJ+pjyke8COw Content-Type: text/plain; charset=us-ascii Content-Disposition: inline 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 ) --GvXjxJ+pjyke8COw Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="ps.1.diff3" diff --git a/bin/ps/ps.1 b/bin/ps/ps.1 index 8c27186..d351b6c 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 sysctl .Va security.bsd.see_other_uids -sysctl to zero. +is set to zero, this option is honored only if the UID of the user is 0. .It Fl c Change the .Dq command @@ -215,7 +213,9 @@ Display information about processes attached to the device associated with the standard input. .It Fl t Display information about processes attached to the specified terminal -devices. +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 +427,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 --GvXjxJ+pjyke8COw--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20111001220347.GA82495>