Date: Sun, 21 Oct 2001 15:20:03 -0700 (PDT) From: Oliver Fromme <oliver.fromme@secnetix.de> To: freebsd-bugs@FreeBSD.org Subject: Re: bin/31415: install(1) is wrong about exit codes Message-ID: <200110212220.f9LMK3B97397@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR bin/31415; it has been noted by GNATS.
From: Oliver Fromme <oliver.fromme@secnetix.de>
To: dima@trit.org (Dima Dorfman)
Cc: olli@secnetix.de (Oliver Fromme),
freebsd-gnats-submit@freebsd.org
Subject: Re: bin/31415: install(1) is wrong about exit codes
Date: Mon, 22 Oct 2001 00:17:35 +0200 (CEST)
Dima Dorfman wrote:
> Oliver Fromme <olli@secnetix.de> wrote:
> > >Fix:
> >
> > I suggest a wording like this:
> >
> > DIAGNOSTICS
> > The install utility exits 0 on success, and a
> > value > 0 according to sysexits(3) otherwise.
>
> How about the following, which is a little more consistent with the
> rest of the man pages:
>
> DIAGNOSTICS
> The install utility exits 0 on success, and >0 if an error occurs.
Well ...
Actually I think it would be a good thing to give people
a hint to sysexits(3). It can help a lot to track down
problems. In particular, people sometimes think that the
exit values are errno numbers.
In the case of the install utility, it exits with EX_OSERR
(71) under certain conditions. This happened to someone
on the -stable list, who thought it would be errno 71 (too
many levels of remote in path), therefore searching for the
problem at paths of his NFS mounts.
Having said that, your suggested wording is at least better
than the existing one (which is just plain wrong), so I can
live with that. But it would certainly better to mention
sysexits(3) somehow. If this affects other manpages, too,
then all of those should be corrected.
Regards
Oliver
--
Oliver Fromme, secnetix GmbH & Co KG, Oettingenstr. 2, 80538 München
Any opinions expressed in this message may be personal to the author
and may not necessarily reflect the opinions of secnetix in any way.
"All that we see or seem is just a dream within a dream" (E. A. Poe)
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-bugs" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200110212220.f9LMK3B97397>