svn commit: r361783 - head/usr.bin/killall

[Eugene Grosbein]

04.06.2020 11:29, Benjamin Kaduk wrote:

> Author: bjk (doc committer)
> Date: Thu Jun  4 04:29:43 2020
> New Revision: 361783
> URL: https://svnweb.freebsd.org/changeset/base/361783
> 
> Log:
>   Add EXAMPLES to killall(1)
>   
>   Submitted by:	fernape
>   Differential Revision:	https://reviews.freebsd.org/D25002
> 
> Modified:
>   head/usr.bin/killall/killall.1
> 
> Modified: head/usr.bin/killall/killall.1
> ==============================================================================
> --- head/usr.bin/killall/killall.1	Thu Jun  4 02:36:41 2020	(r361782)
> +++ head/usr.bin/killall/killall.1	Thu Jun  4 04:29:43 2020	(r361783)
> @@ -145,6 +145,50 @@ utility exits 0 if some processes have been found and
>  signalled successfully.
>  Otherwise, a status of 1 will be
>  returned.
> +.Sh EXAMPLES
> +Send
> +.Dv SIGTERM
> +to all firefox processes:
> +.Bd -literal -offset indent
> +killall firefox
> +.Ed
> +.Pp
> +Send
> +.Dv SIGTERM
> +to firefox processes belonging to
> +.Va USER :
> +.Bd -literal -offset indent
> +killall -u ${USER} firefox
> +.Ed
> +.Pp
> +Stop all firefox processes:
> +.Bd -literal -offset indent
> +killall -SIGSTOP firefox
> +.Ed
> +.Pp
> +Resume firefox processes:
> +.Bd -literal -offset indent
> +killall -SIGCONT firefox
> +.Ed
> +.Pp
> +Show what would be done to firefox processes, but do not actually signal them:
> +.Bd -literal -offset indent
> +killall -s firefox
> +.Ed
> +.Pp
> +Send
> +.Dv SIGKILL
> +to csh process running inside jail ID 282:
> +.Bd -literal -offset indent
> +killall -9 -j282 csh
> +.Ed
> +.Pp
> +Send
> +.Dv SIGTERM
> +to all processes matching provided pattern (like vim and vimdiff):
> +.Bd -literal -offset indent
> +killall -m 'vim*'
> +.Ed
>  .Sh DIAGNOSTICS
>  Diagnostic messages will only be printed if requested by
>  .Fl d

"Firefox" is a trade mark (type of intellectual property) of Mozilla Foundation.
Is it OK for us to use this name such way?

Isn't it better using a name of some utility we have in the base system like systat(1) ?