killall(1): Clarify -d, -s and -v options

-d and -v are not equivalent options. The former is more verbose than the
latter and the former does not actually send the signals while the latter does.
Let them have their own paragraphs.

From the point of view of the output, -v is equivalent to -s, so describe them
close to each other. The difference is that former actually sends the signals
and the latter doesn't.

PR:	247411
Approved by:	manpages(0mp)
Differential Revision:	https://reviews.freebsd.org/D25413
This commit is contained in:
Fernando Apesteguía 2020-06-27 11:28:11 +00:00
parent fe5bc3e6af
commit c842df4889

View File

@ -24,7 +24,7 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd June 4, 2020 .Dd June 27, 2020
.Dt KILLALL 1 .Dt KILLALL 1
.Os .Os
.Sh NAME .Sh NAME
@ -58,13 +58,11 @@ The super-user is allowed to kill any process.
.Pp .Pp
The options are as follows: The options are as follows:
.Bl -tag -width ".Fl c Ar procname" .Bl -tag -width ".Fl c Ar procname"
.It Fl d | v .It Fl d
Be more verbose about what will be done. Be more verbose about what will be done, but do not send any signal.
For a single The total number of user processes and the real user ID is shown.
.Fl d A list of the processes that will be sent the signal will be printed, or a
option, a list of the processes that will be sent the signal will be message indicating that no matching processes have been found.
printed, or a message indicating that no matching processes have been
found.
.It Fl e .It Fl e
Use the effective user ID instead of the (default) real user ID for matching Use the effective user ID instead of the (default) real user ID for matching
processes specified with the processes specified with the
@ -86,8 +84,12 @@ of processes found.
CAUTION! CAUTION!
This is dangerous, a single dot will match any process This is dangerous, a single dot will match any process
running under the real UID of the caller. running under the real UID of the caller.
.It Fl v
Be verbose about what will be done.
.It Fl s .It Fl s
Show only what would be done, but do not send any signal. Same as
.Fl v ,
but do not send any signal.
.It Fl Ar SIGNAL .It Fl Ar SIGNAL
Send a different signal instead of the default Send a different signal instead of the default
.Dv TERM . .Dv TERM .
@ -190,9 +192,9 @@ to all processes matching provided pattern (like vim and vimdiff):
killall -m 'vim*' killall -m 'vim*'
.Ed .Ed
.Sh DIAGNOSTICS .Sh DIAGNOSTICS
Diagnostic messages will only be printed if requested by Diagnostic messages will only be printed if the
.Fl d .Fl d
options. flag is used.
.Sh SEE ALSO .Sh SEE ALSO
.Xr kill 1 , .Xr kill 1 ,
.Xr pkill 1 , .Xr pkill 1 ,