From c55f0fd0d7758cc170ef72fce0d4a66d3200906f Mon Sep 17 00:00:00 2001 From: http://ftp.de.debian.org/debian/pool/main/p/procps/procps_3.2.8-8.debian.tar.gz Date: Fri, 19 Mar 2010 21:58:46 +0100 Subject: [PATCH 47/70] pgrep.1 Uses .BR for see also section #437678 --- pgrep.1 | 98 +++++++++++++++++++++++++++++++++++++------------------------- 1 files changed, 58 insertions(+), 40 deletions(-) diff --git a/pgrep.1 b/pgrep.1 index 9152799..257a6ce 100644 --- a/pgrep.1 +++ b/pgrep.1 @@ -2,35 +2,39 @@ .\" Licensed under version 2 of the GNU General Public License. .\" Copyright 2000 Kjetil Torgrim Homme .\" -.TH PGREP 1 "June 25, 2000" "Linux" "Linux User's Manual" +.TH PGREP 1 "October 5, 2007" "Linux" "Linux User's Manual" .SH NAME pgrep, pkill \- look up or signal processes based on name and other attributes .SH SYNOPSIS -pgrep [\-cflvx] [\-d \fIdelimiter\fP] [\-n|\-o] [\-P \fIppid\fP,...] [\-g \fIpgrp\fP,...] -.br - [\-s \fIsid\fP,...] [\-u \fIeuid\fP,...] [\-U \fIuid\fP,...] [\-G \fIgid\fP,...] -.br - [\-t \fIterm\fP,...] [\fIpattern\fP] - -pkill [\-\fIsignal\fP] [\-fvx] [\-n|\-o] [\-P \fIppid\fP,...] [\-g \fIpgrp\fP,...] -.br - [\-s \fIsid\fP,...] [\-u \fIeuid\fP,...] [\-U \fIuid\fP,...] [\-G \fIgid\fP,...] -.br - [\-t \fIterm\fP,...] [\fIpattern\fP] +.na +\fBpgrep\fR [\fB\-cflvx\fR] [\fB\-d\ \fIdelimiter\fR] [\fB\-n\fR|\fB\-o\fR] \ +[\fB\-P\ \fIppid\fR,...] [\fB\-g\ \fIpgrp\fR,...] [\fB\-s\ \fIsid\fR,...] \ +[\fB\-u\ \fIeuid\fR,...] [\fB\-U\ \fIuid\fR,...] [\fB\-G\ \fIgid\fR,...] \ +[\fB\-t\ \fIterm\fR,...] [\fIpattern\fR] + +.HP +\fBpkill\fR [\fB\-\fIsignal\fR] [\fB\-fvx\fR] [\fB\-n\fR|\fB\-o\fR] \ +[\fB\-P\ \fIppid\fR,...] [\fB\-g\ \fIpgrp\fR,...] [\fB\-s\ \fIsid\fR,...] \ +[\fB\-u\ \fIeuid\fR,...] [\fB\-U\ \fIuid\fR,...] [\fB\-G\ \fIgid\fR,...] \ +[\fB\-t\ \fIterm\fR,...] [\fIpattern\fR] .SH DESCRIPTION \fBpgrep\fP looks through the currently running processes and lists the process IDs which matches the selection criteria to stdout. All the criteria have to match. For example, -pgrep -u root sshd +.IP +$ pgrep \-u root sshd +.PP will only list the processes called \fBsshd\fP AND owned by \fBroot\fP. On the other hand, -pgrep -u root,daemon +.IP +$ pgrep \-u root,daemon +.PP will list the processes owned by \fBroot\fP OR \fBdaemon\fP. \fBpkill\fP will send the specified signal (by default \fBSIGTERM\fP) @@ -38,18 +42,18 @@ to each process instead of listing them on stdout. .SH OPTIONS .TP -\-c +\fB\-c\fR Suppress normal output; instead print a count of matching processes. .TP -\-d \fIdelimiter\fP +\fB\-d \fIdelimiter\fP Sets the string used to delimit each process ID in the output (by default a newline). (\fBpgrep\fP only.) .TP -\-f +\fB\-f\fR The \fIpattern\fP is normally only matched against the process name. -When \-f is set, the full command line is used. +When \fB\-f\fR is set, the full command line is used. .TP -\-g \fIpgrp\fP,... +\fB\-g \fIpgrp\fP,... Only match processes in the process group IDs listed. Process group 0 is translated into \fBpgrep\fP's or \fBpkill\fP's own process group. .TP @@ -57,40 +61,40 @@ is translated into \fBpgrep\fP's or \fBpkill\fP's own process group. Only match processes whose real group ID is listed. Either the numerical or symbolical value may be used. .TP -\-l +\fB\-l\fR List the process name as well as the process ID. (\fBpgrep\fP only.) .TP -\-n +\fB\-n\fR Select only the newest (most recently started) of the matching processes. .TP -\-o +\fB\-o\fR Select only the oldest (least recently started) of the matching processes. .TP -\-P \fIppid\fP,... +\fB\-P \fIppid\fP,... Only match processes whose parent process ID is listed. .TP -\-s \fIsid\fP,... +\fB\-s \fIsid\fP,... Only match processes whose process session ID is listed. Session ID 0 is translated into \fBpgrep\fP's or \fBpkill\fP's own session ID. .TP -\-t \fIterm\fP,... +\fB\-t \fIterm\fP,... Only match processes whose controlling terminal is listed. The terminal name should be specified without the "/dev/" prefix. .TP -\-u \fIeuid\fP,... +\fB\-u \fIeuid\fP,... Only match processes whose effective user ID is listed. Either the numerical or symbolical value may be used. .TP -\-U \fIuid\fP,... +\fB\-U \fIuid\fP,... Only match processes whose real user ID is listed. Either the numerical or symbolical value may be used. .TP -\-v +\fB\-v\fR Negates the matching. .TP -\-x +\fB\-x\fR Only match processes whose name (or command line if \-f is specified) \fBexactly\fP match the \fIpattern\fP. .TP @@ -107,32 +111,40 @@ process names or command lines. .SH EXAMPLES Example 1: Find the process ID of the \fBnamed\fP daemon: -unix$ pgrep \-u root named +.IP +$ pgrep \-u root named +.PP Example 2: Make \fBsyslog\fP reread its configuration file: -unix$ pkill \-HUP syslogd +.IP +$ pkill \-HUP syslogd +.PP Example 3: Give detailed information on all \fBxterm\fP processes: -unix$ ps \-fp $(pgrep \-d, \-x xterm) +.IP +$ ps \-fp $(pgrep \-d, \-x xterm) +.PP Example 4: Make all \fBnetscape\fP processes run nicer: -unix$ renice +4 `pgrep netscape` +.IP +$ renice +4 `pgrep netscape` .SH "EXIT STATUS" +.PD 0 .TP -.I "0" +.I 0 One or more processes matched the criteria. .TP -.I "1" +.I 1 No processes matched. .TP -.I "2" +.I 2 Syntax error in the command line. .TP -.I "3" +.I 3 Fatal error: out of memory etc. .SH NOTES @@ -144,13 +156,19 @@ The running \fBpgrep\fP or \fBpkill\fP process will never report itself as a match. .SH BUGS -The options \-n and \-o and \-v can not be combined. Let me know if -you need to do this. +The options \fB\-n\fP and \fB\-o\fP and \fB\-v\fP can not be combined. +Let me know if you need to do this. Defunct processes are reported. .SH "SEE ALSO" -ps(1) regex(7) signal(7) killall(1) skill(1) kill(1) kill(2) +.BR ps (1), +.BR regex (7), +.BR signal (7), +.BR killall (1), +.BR skill (1), +.BR kill (1), +.BR kill (2) .SH STANDARDS \fBpkill\fP and \fBpgrep\fP were introduced in Sun's Solaris 7. This -- 1.7.0