From owner-freebsd-bugs  Sun Oct 21 14:20: 6 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 A6F1D37B403
	for <freebsd-bugs@hub.freebsd.org>; Sun, 21 Oct 2001 14:20:01 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.4/8.11.4) id f9LLK1P87079;
	Sun, 21 Oct 2001 14:20:01 -0700 (PDT)
	(envelope-from gnats)
Received: from lurza.secnetix.de (lurza.secnetix.de [212.66.1.130])
	by hub.freebsd.org (Postfix) with ESMTP id 4DC9737B401
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 21 Oct 2001 14:19:55 -0700 (PDT)
Received: (from olli@localhost)
	by lurza.secnetix.de (8.11.6/8.11.6) id f9LLJsF88854;
	Sun, 21 Oct 2001 23:19:54 +0200 (CEST)
	(envelope-from oliver.fromme@secnetix.de)
Message-Id: <200110212119.f9LLJsF88854@lurza.secnetix.de>
Date: Sun, 21 Oct 2001 23:19:54 +0200 (CEST)
From: Oliver Fromme <olli@secnetix.de>
Reply-To: Oliver Fromme <olli@secnetix.de>
To: FreeBSD-gnats-submit@freebsd.org
Cc: Oliver Fromme <olli@secnetix.de>
X-Send-Pr-Version: 3.113
Subject: bin/31415: install(1) is wrong about exit codes
Sender: owner-freebsd-bugs@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-bugs.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-bugs>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-bugs>
X-Loop: FreeBSD.org


>Number:         31415
>Category:       bin
>Synopsis:       install(1) is wrong about exit codes
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Oct 21 14:20:00 PDT 2001
>Closed-Date:
>Last-Modified:
>Originator:     Oliver Fromme
>Release:        FreeBSD 4.4-RELEASE i386
>Organization:
secnetix GmbH & Co KG
>Environment:

   System: FreeBSD lurza.secnetix.de 4.4-RELEASE FreeBSD 4.4-RELEASE #0: Wed Oct 10 18:15:28 CEST 2001 olli@lurza.secnetix.de:/usr/obj/usr/src/sys/LURZA i386

>Description:

   The install(1) manpage says:

   DIAGNOSTICS
      The install utility exits 0 on success, and 1 otherwise.

   This is wrong; the install utility never exits 1.
   Instead, it uses sysexits codes, according to the
   sysexits(3) manpage.

>How-To-Repeat:

   See the "diagnostics" section in the install(1) manpage.
   The compare the source code in src/usr.bin/xinstall/xinstall.c.
   Note the various places where err() and errx() is used.
   Also, you can simply try it:

   $ install -z
   install: illegal option -- z
   zsh: 88521 exit 64    install -z

   $ install / /
   install: /: Inappropriate file type or format
   zsh: 88522 exit 71    install / /

>Fix:

   I suggest a wording like this:

   DIAGNOSTICS
      The install utility exits 0 on success, and a
      value > 0 according to sysexits(3) otherwise.

>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-bugs" in the body of the message