From nobody  Fri Dec 19 13:32:06 1997
Received: (from nobody@localhost)
          by hub.freebsd.org (8.8.7/8.8.7) id NAA20202;
          Fri, 19 Dec 1997 13:32:06 -0800 (PST)
          (envelope-from nobody)
Message-Id: <199712192132.NAA20202@hub.freebsd.org>
Date: Fri, 19 Dec 1997 13:32:06 -0800 (PST)
From: paco@cs.virginia.edu
To: freebsd-gnats-submit@freebsd.org
Subject: Discrepancy between dump(8) man page and behavior
X-Send-Pr-Version: www-1.0

>Number:         5346
>Category:       docs
>Synopsis:       Discrepancy between dump(8) man page and behavior
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Dec 19 13:40:00 PST 1997
>Closed-Date:    Tue Jul 14 02:16:47 PDT 1998
>Last-Modified:  Tue Jul 14 02:21:16 PDT 1998
>Originator:     Paco Hope
>Release:        2.1.5-RELEASE
>Organization:
University of Virginia
>Environment:
FreeBSD xxx.xxx.edu 2.1.5-RELEASE FreeBSD 2.1.5-RELEASE #1: Thu Aug 21 15:42:54 EDT 1997     root@xxx.xxx.edu:/usr/src/sys/compile/AIDA  i386
>Description:
The man page to dump says this:
     Dump exits with zero status on success.  Startup errors are indicated
     with an exit code of 1; abnormal termination is indicated with an exit
     code of 3.

The source code to dump says this:
#define X_FINOK         0       /* normal exit */
#define X_REWRITE       2       /* restart writing from the check point */
#define X_ABORT         3       /* abort dump; don't attempt checkpointing */

In practice, dump exits with error codes 0,1,2, or 3.  It would
be nice if these things were properly documented so that people
could rely on the error code just a little.  I discovered this
bug on linux, too, so it's probably been in the source for a
while.
>How-To-Repeat:

>Fix:

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->analyzed 
State-Changed-By: phk 
State-Changed-When: Thu Apr 30 13:15:34 PDT 1998 
State-Changed-Why:  
doc issue 


Responsible-Changed-From-To: freebsd-bugs->doc 
Responsible-Changed-By: phk 
Responsible-Changed-When: Thu Apr 30 13:15:34 PDT 1998 
Responsible-Changed-Why:  
->doc 
Responsible-Changed-From-To: doc->freebsd-doc 
Responsible-Changed-By: steve 
Responsible-Changed-When: Tue May 5 07:01:57 PDT 1998 
Responsible-Changed-Why:  
Belongs to freebsd-doc. 
State-Changed-From-To: analyzed->closed 
State-Changed-By: jkoshy 
State-Changed-When: Tue Jul 14 02:16:47 PDT 1998 
State-Changed-Why:  
Fixed in -current (rev 1.7 "dump.h", rev 1.12 "dumprmt.c", rev 1.17 "main.c"). 
>Unformatted:
