From owner-freebsd-bugs Sun Oct 21 15:20: 7 2001 Delivered-To: freebsd-bugs@hub.freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id D960737B403 for ; Sun, 21 Oct 2001 15:20:03 -0700 (PDT) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.4/8.11.4) id f9LMK3B97397; Sun, 21 Oct 2001 15:20:03 -0700 (PDT) (envelope-from gnats) Date: Sun, 21 Oct 2001 15:20:03 -0700 (PDT) Message-Id: <200110212220.f9LMK3B97397@freefall.freebsd.org> To: freebsd-bugs@FreeBSD.org Cc: From: Oliver Fromme Subject: Re: bin/31415: install(1) is wrong about exit codes Reply-To: Oliver Fromme Sender: owner-freebsd-bugs@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The following reply was made to PR bin/31415; it has been noted by GNATS. From: Oliver Fromme 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 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