Bug 34758

Summary: Irrelevant comment in killall(1) manpage
Product: Documentation Reporter: Jakob Borg <jakob>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Jakob Borg 2002-02-09 16:20:01 UTC
The manpage for killall(1) says:

       Be warned that  typing  killall  name  may  not  have  the
       desired  effect on non-Linux systems, especially when done
       by a privileged user.

which, while perhaps correct, is not relevant for a FreeBSD system. Also,
the operating system kernel in use at a particular system should not influence
the behavior of killall.

Fix: 

Replace with warning about FreeBSD or non-FreeBSD systems as appropriate, or
rephrase to talk about "... systems with non-GNU killall ..." or the whatever
the correct source for the current killall is.
How-To-Repeat: 
man 1 killall
Comment 1 Giorgos Keramidas freebsd_committer freebsd_triage 2002-02-10 00:36:20 UTC
Jakob Borg wrote:

> The manpage for killall(1) says:
>
>        Be warned that  typing  killall  name  may  not  have  the
>        desired  effect on non-Linux systems, especially when done
>        by a privileged user.
>
> which, while perhaps correct, is not relevant for a FreeBSD system. Also,
> the operating system kernel in use at a particular system should not influence
> the behavior of killall.

Well the point the author is trying to make is that on Solaris (and
probably other systems) typing "killall" in a prompt is a surprise in
itself, because it REBOOTS the system !!!

You're right that this should exclude Linux systems only though :-)


Giorgos Keramidas                           FreeBSD Documentation Project
keramida@{freebsd.org,ceid.upatras.gr}      http://www.FreeBSD.org/docproj/
Comment 2 Jakob Borg 2002-02-10 10:33:00 UTC
On Sunday 10 February 2002 01.36, you wrote:
> Jakob Borg wrote:
> > The manpage for killall(1) says:
> >
> >        Be warned that  typing  killall  name  may  not  have  the
> >        desired  effect on non-Linux systems, especially when done
> >        by a privileged user.
> >
> > which, while perhaps correct, is not relevant for a FreeBSD system.
> > Also, the operating system kernel in use at a particular system should
> > not influence the behavior of killall.
>
> Well the point the author is trying to make is that on Solaris (and
> probably other systems) typing "killall" in a prompt is a surprise in
> itself, because it REBOOTS the system !!!

It does what the command says, yes, I know, been there, done that in my 
youth... My point was just that the Linuxness or non-Linuxness is not the 
point, since it's FreeBSD wer're talking about.

-- 
Jakob Borg  |  jakob@borg.pp.se  |  +46 (0)46 397692
Kämnärsv. 3a214 / SE-226 46 Lund / Sweden
Comment 3 Giorgos Keramidas freebsd_committer freebsd_triage 2002-02-11 01:52:45 UTC
State Changed
From-To: open->closed

The killall.1 manpage does not seem to contain the text posted. 
Are you sure this was on a 4.5-STABLE FreeBSD system?
Comment 4 Peter Pentchev 2002-02-11 08:50:58 UTC
On Sun, Feb 10, 2002 at 06:33:29PM -0800, Gary W. Swearingen wrote:
> Giorgos Keramidas <keramida@FreeBSD.ORG> writes:
> 
> > Date: Sun, 10 Feb 2002 02:36:20 +0200 (EET)
> > 
> >  Jakob Borg wrote:
> >  
> >  > The manpage for killall(1) says:
> >  >
> >  >        Be warned that  typing  killall  name  may  not  have  the
> >  >        desired  effect on non-Linux systems, especially when done
> >  >        by a privileged user.
> >  >
> >  > which, while perhaps correct, is not relevant for a FreeBSD system. Also,
> >  > the operating system kernel in use at a particular system should not influence
> >  > the behavior of killall.
> >  
> >  Well the point the author is trying to make is that on Solaris (and
> >  probably other systems) typing "killall" in a prompt is a surprise in
> >  itself, because it REBOOTS the system !!!
> 
> 1) The PR says it's on "FreeBSD 4.5-STABLE i386", but
> http://www.FreeBSD.org/cgi/man.cgi?query=killall&apropos=0&sektion=0&manpath=FreeBSD+4.5-STABLE&format=html
> doesn't have the text quoted.  (I was wanting to look at a different
> display format.)  Is there a problem with with the CGI thing or with
> the PR or me?

This is a fun one: I guess the submitter made the same mistake I did
once before.  The manual page in question, containing the Linux-specific
text, comes from the sysutils/psmisc port :)  This is not a FreeBSD
problem, this is a problem of the psmisc package and should be brought
up with the psmisc author, Werner Almesberger
<werner.almesberger@lrc.di.epfl.ch>.

G'luck,
Peter

-- 
Peter Pentchev	roam@ringlet.net	roam@FreeBSD.org
PGP key:	http://people.FreeBSD.org/~roam/roam.key.asc
Key fingerprint	FDBA FD79 C26F 3C51 C95E  DF9E ED18 B68D 1619 4553
Thit sentence is not self-referential because "thit" is not a word.
Comment 5 Jakob Borg 2002-02-11 10:08:21 UTC
On Monday 11 February 2002 09.50, Peter Pentchev wrote:

> This is a fun one: I guess the submitter made the same mistake I did
> once before.  The manual page in question, containing the Linux-specific
> text, comes from the sysutils/psmisc port :)  This is not a FreeBSD
> problem, this is a problem of the psmisc package and should be brought
> up with the psmisc author, Werner Almesberger
> <werner.almesberger@lrc.di.epfl.ch>.

Indeed this seems to be the case. Thank you for clearing it up.

-- 
Jakob Borg  |  jakob@borg.pp.se  |  +46 (0)46 397692
Kämnärsv. 3a214 / SE-226 46 Lund / Sweden
Comment 6 Gary W. Swearingen 2002-02-11 17:38:49 UTC
"Jakob Borg" <jakob@borg.pp.se> writes:

> On Monday 11 February 2002 09.50, Peter Pentchev wrote:
> 
> > This is a fun one: I guess the submitter made the same mistake I did
> > once before.  The manual page in question, containing the Linux-specific
> > text, comes from the sysutils/psmisc port :)  This is not a FreeBSD
> > problem, this is a problem of the psmisc package and should be brought
> > up with the psmisc author, Werner Almesberger
> > <werner.almesberger@lrc.di.epfl.ch>.
> 
> Indeed this seems to be the case. Thank you for clearing it up.

From pkg-comment:
    A port of the Linux pstree, killall and pidof commands

It seems wrong to ask the Linux people to make the Linux "killall" man
page to not mention "Linux" (or "non-Linux" in this case).  I suppose
it makes some sense, so others will disagree, but if you're going to ask
them to change, please be extraordinarily polite.

I've CC'd the port maintainer.  Let's see what he has to say about it.
Comment 7 Jakob Borg 2002-02-11 20:40:21 UTC
On Monday 11 February 2002 18.38, Gary W. Swearingen wrote:
> From pkg-comment:
>     A port of the Linux pstree, killall and pidof commands
>
> It seems wrong to ask the Linux people to make the Linux "killall" man
> page to not mention "Linux" (or "non-Linux" in this case).  I suppose
> it makes some sense, so others will disagree, but if you're going to ask
> them to change, please be extraordinarily polite.

I wouldn't presume to suggest that that manpage be changed - my entire 
problem report was dependant on it being a FreeBSD manpage, which it isn't. 
I think the report has the status 'closed' now, and it would be best to 
leave it there.

-- 
Jakob Borg  |  jakob@borg.pp.se  |  +46 (0)46 397692
Kämnärsv. 3a214 / SE-226 46 Lund / Sweden