annotate admin/notes/exit-value @ 64780:4def766e2c3f

Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-515 Merge from gnus--rel--5.10 Patches applied: * gnus--rel--5.10 (patch 104) - Update from CVS 2005-08-05 Daiki Ueno <ueno@unixuser.org> * lisp/gnus/mml2015.el (mml2015-pgg-sign): Make sure micalg is correct. * lisp/gnus/pgg-parse.el (pgg-parse-hash-algorithm-alist): Add SHA-2. 2005-08-06 Romain Francoise <romain@orebokech.com> * lisp/gnus/message.el: Fix typo in docstring. 2005-07-16 Romain Francoise <romain@orebokech.com> * lisp/gnus/gnus-uu.el (gnus-uu-save-article): Use `message-make-date' instead of `current-time-string' as the latter creates a time string that is not RFC 2822 compliant (it lacks the zone).
author Miles Bader <miles@gnu.org>
date Sun, 07 Aug 2005 23:56:33 +0000
parents dc9bd6dd0d8d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
55463
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
1 ttn 2004-05-09
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
2
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
3 The exit value of a program returning to the shell on unixoid systems is
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
4 typically 0 for success, and non-0 (such as 1) for failure. For vms it is
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
5 odd (1,3,5...) for success, even (0,2,4...) for failure.
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
6
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
7 This holds from the point of view of the "shell" (in quotes because vms has a
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
8 different dispatch model that is not explained further here).
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
9
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
10 From the point of view of the program, nowadays stdlib.h on both type of
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
11 systems provides macros `EXIT_SUCCESS' and `EXIT_FAILURE' that should DTRT.
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
12
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
13 NB: The numerical values of these macros DO NOT need to fulfill the the exit
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
14 value requirements outlined in the first paragraph! That is the job of the
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
15 `exit' function. Thus, this kind of construct shows misunderstanding:
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
16
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
17 #ifdef VMS
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
18 exit (1);
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
19 #else
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
20 exit (0);
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
21 #endif
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
22
843ab503fee2 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
23 Values aside from EXIT_SUCCESS and EXIT_FAILURE are tricky.
55552
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
24
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
25
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
26
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
27 ttn 2004-05-12
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
28
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
29 Values aside from EXIT_SUCCESS and EXIT_FAILURE can be used to indicate
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
30 finer gradations of failure. If this is the only information available
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
31 to the caller, clamping such values to EXIT_FAILURE loses information.
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
32 If there are other ways to indicate the problem to the caller (such as
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
33 a message to stderr) it may be ok to clamp. In all cases, it is the
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
34 relationship between the program and its caller that must be examined.
dc9bd6dd0d8d New entry re clamping to EXIT_FAILURE.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 55463
diff changeset
35 [Insert ZAMM quote here.]