1
0
mirror of https://git.FreeBSD.org/src.git synced 2024-12-16 10:20:30 +00:00

- 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.
This commit is contained in:
Ruslan Ermilov 2007-11-09 16:02:10 +00:00
parent c6e7f7df5a
commit 0cf4978129
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=173504

View File

@ -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