aboutsummaryrefslogtreecommitdiff
path: root/usr.bin/killall
diff options
context:
space:
mode:
authorRuslan Ermilov <ru@FreeBSD.org>2007-11-09 16:02:10 +0000
committerRuslan Ermilov <ru@FreeBSD.org>2007-11-09 16:02:10 +0000
commit0cf4978129e12c71dbf02d6f08da4bad1ffe8df5 (patch)
tree17165d193c570dd844b1210579186ee606cd627f /usr.bin/killall
parentc6e7f7df5a601a268d6722bcd476d4d92301254c (diff)
downloadsrc-0cf4978129e12c71dbf02d6f08da4bad1ffe8df5.tar.gz
src-0cf4978129e12c71dbf02d6f08da4bad1ffe8df5.zip
- Fix documentation to match code. Specifically, -c doesn't have
to be specified together with either -u or -t to have an effect, and exit status of 2 is not possible after a Perl->C conversion. - While here, fix markup.
Notes
Notes: svn path=/head/; revision=173504
Diffstat (limited to 'usr.bin/killall')
-rw-r--r--usr.bin/killall/killall.136
1 files changed, 15 insertions, 21 deletions
diff --git a/usr.bin/killall/killall.1 b/usr.bin/killall/killall.1
index bfac13f7e7e1..d2af033f0dc1 100644
--- a/usr.bin/killall/killall.1
+++ b/usr.bin/killall/killall.1
@@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd January 26, 2004
+.Dd November 9, 2007
.Os
.Dt KILLALL 1
.Sh NAME
@@ -38,12 +38,12 @@
.Op Fl u Ar user
.Op Fl t Ar tty
.Op Fl c Ar procname
-.Op Fl SIGNAL
+.Op Fl Ar SIGNAL
.Op Ar procname ...
.Sh DESCRIPTION
The
.Nm
-utility kills processes selected by name, as opposed to the selection by pid
+utility kills processes selected by name, as opposed to the selection by PID
as done by
.Xr kill 1 .
By default, it will send a
@@ -56,7 +56,7 @@ that match the name
The super-user is allowed to kill any process.
.Pp
The options are as follows:
-.Bl -tag -width 10n -offset indent
+.Bl -tag -width ".Fl c Ar procname"
.It Fl d | v
Be more verbose about what will be done.
For a single
@@ -84,12 +84,12 @@ This is dangerous, a single dot will match any process
running under the real UID of the caller.
.It Fl s
Show only what would be done, but do not send any signal.
-.It Fl SIGNAL
+.It Fl Ar SIGNAL
Send a different signal instead of the default
.Dv TERM .
The signal may be specified either as a name
(with or without a leading
-.Dv SIG ) ,
+.Dq Li SIG ) ,
or numerically.
.It Fl j Ar jid
Kill processes in the jail specified by
@@ -103,11 +103,7 @@ Limit potentially matching processes to those running on
the specified
.Ar tty .
.It Fl c Ar procname
-When used with the
-.Fl u
-or
-.Fl t
-flags, limit potentially matching processes to those matching
+Limit potentially matching processes to those matching
the specified
.Ar procname .
.It Fl z
@@ -116,23 +112,21 @@ This should not have any effect except to print a few error messages
if there are zombie processes that match the specified pattern.
.El
.Sh ALL PROCESSES
-Sending a signal to all processes with uid
-.Em XYZ
+Sending a signal to all processes with then given UID
is already supported by
.Xr kill 1 .
So use
.Xr kill 1
-for this job (e.g.\& $ kill -TERM -1 or
-as root $ echo kill -TERM -1 | su -m <user>)
+for this job (e.g.\&
+.Dq Li "kill -TERM -1
+or as root
+.Dq Li "echo kill -TERM -1 | su -m <user>" ) .
.Sh EXIT STATUS
The
.Nm
-command will respond with a short usage message and exit with a status
-of 2 in case of a command error.
-A status of 1 will be returned if
-either no matching process has been found or not all processes have
-been signalled successfully.
-Otherwise, a status of 0 will be
+utility exits 0 if some processes have been found and
+signalled successfully.
+Otherwise, a status of 1 will be
returned.
.Sh DIAGNOSTICS
Diagnostic messages will only be printed if requested by