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

[Rodney W. Grimes]

> 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) ?

Purley out of simple safety I agree here.   Though I doubt a case could
be made for infringement it is just too easy to do the safe thing.

-- 
Rod Grimes                                                 rgrimes at freebsd.org