From owner-svn-src-head@freebsd.org Fri Jun 5 16:56:49 2020 Return-Path: Delivered-To: svn-src-head@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 07391331414; Fri, 5 Jun 2020 16:56:49 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 49dphc1ckHz4HlY; Fri, 5 Jun 2020 16:56:47 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from mit.edu ([24.16.140.251]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.14.7/8.12.4) with ESMTP id 055Gufcc030752 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Fri, 5 Jun 2020 12:56:43 -0400 Date: Fri, 5 Jun 2020 09:56:40 -0700 From: Benjamin Kaduk To: rgrimes@freebsd.org Cc: Eugene Grosbein , Benjamin Kaduk , src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: Re: svn commit: r361783 - head/usr.bin/killall Message-ID: <20200605165640.GG58497@mit.edu> References: <9f04697e-91d9-1221-2c8f-136fdf564f5d@grosbein.net> <202006041312.054DC5gj026050@gndrsh.dnsmgr.net> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <202006041312.054DC5gj026050@gndrsh.dnsmgr.net> User-Agent: Mutt/1.12.1 (2019-06-15) X-Rspamd-Queue-Id: 49dphc1ckHz4HlY X-Spamd-Bar: -- Authentication-Results: mx1.freebsd.org; dkim=none; dmarc=none; spf=pass (mx1.freebsd.org: domain of kaduk@mit.edu designates 18.9.28.11 as permitted sender) smtp.mailfrom=kaduk@mit.edu X-Spamd-Result: default: False [-2.60 / 15.00]; MIME_TRACE(0.00)[0:+]; ARC_NA(0.00)[]; NEURAL_HAM_MEDIUM(-1.01)[-1.010]; FROM_HAS_DN(0.00)[]; TO_DN_SOME(0.00)[]; R_SPF_ALLOW(-0.20)[+ip4:18.9.28.0/24]; NEURAL_HAM_LONG(-0.98)[-0.977]; MIME_GOOD(-0.10)[text/plain]; DMARC_NA(0.00)[freebsd.org]; RCPT_COUNT_FIVE(0.00)[6]; TO_MATCH_ENVRCPT_SOME(0.00)[]; RCVD_IN_DNSWL_MED(-0.20)[18.9.28.11:from]; NEURAL_HAM_SHORT(-0.41)[-0.408]; FORGED_SENDER(0.30)[bjk@freebsd.org,kaduk@mit.edu]; RECEIVED_SPAMHAUS_PBL(0.00)[24.16.140.251:received]; RCVD_TLS_LAST(0.00)[]; R_DKIM_NA(0.00)[]; RCVD_COUNT_TWO(0.00)[2]; ASN(0.00)[asn:3, ipnet:18.9.0.0/16, country:US]; FROM_NEQ_ENVFROM(0.00)[bjk@freebsd.org,kaduk@mit.edu] X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.33 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 05 Jun 2020 16:56:49 -0000 It seems Conrad dropped me from his reply, so I can't include it directly, but... On Thu, Jun 04, 2020 at 06:12:05AM -0700, Rodney W. Grimes wrote: > > 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. I'm not aware of any issues with using a trademark-protected term to refer to the product named by the mark, and don't see how one could claim that this usage is an attempt to dilute the mark. I don't currently plan to make any further changes to this example, myself (though I will not stand in the way if someone else wants to blandify the example). Thanks, Ben