diff options
| author | Ken Raeburn | 2015-11-01 01:42:21 -0400 |
|---|---|---|
| committer | Ken Raeburn | 2015-11-01 01:42:21 -0400 |
| commit | 39372e1a1032521be74575bb06f95a3898fbae30 (patch) | |
| tree | 754bd242a23d2358ea116126fcb0a629947bd9ec /admin/notes/exit-value | |
| parent | 6a3121904d76e3b2f63007341d48c5c1af55de80 (diff) | |
| parent | e11aaee266da52937a3a031cb108fe13f68958c3 (diff) | |
| download | emacs-39372e1a1032521be74575bb06f95a3898fbae30.tar.gz emacs-39372e1a1032521be74575bb06f95a3898fbae30.zip | |
merge from trunk
Diffstat (limited to 'admin/notes/exit-value')
| -rw-r--r-- | admin/notes/exit-value | 35 |
1 files changed, 0 insertions, 35 deletions
diff --git a/admin/notes/exit-value b/admin/notes/exit-value deleted file mode 100644 index cad6862c8aa..00000000000 --- a/admin/notes/exit-value +++ /dev/null | |||
| @@ -1,35 +0,0 @@ | |||
| 1 | ttn 2004-05-09 | ||
| 2 | |||
| 3 | The exit value of a program returning to the shell on unixoid systems is | ||
| 4 | typically 0 for success, and non-0 (such as 1) for failure. For vms it is | ||
| 5 | odd (1,3,5...) for success, even (0,2,4...) for failure. | ||
| 6 | |||
| 7 | This holds from the point of view of the "shell" (in quotes because vms has a | ||
| 8 | different dispatch model that is not explained further here). | ||
| 9 | |||
| 10 | From the point of view of the program, nowadays stdlib.h on both type of | ||
| 11 | systems provides macros `EXIT_SUCCESS' and `EXIT_FAILURE' that should DTRT. | ||
| 12 | |||
| 13 | NB: The numerical values of these macros DO NOT need to fulfill the exit | ||
| 14 | value requirements outlined in the first paragraph! That is the job of the | ||
| 15 | `exit' function. Thus, this kind of construct shows misunderstanding: | ||
| 16 | |||
| 17 | #ifdef VMS | ||
| 18 | exit (1); | ||
| 19 | #else | ||
| 20 | exit (0); | ||
| 21 | #endif | ||
| 22 | |||
| 23 | Values aside from EXIT_SUCCESS and EXIT_FAILURE are tricky. | ||
| 24 | |||
| 25 | |||
| 26 | |||
| 27 | ttn 2004-05-12 | ||
| 28 | |||
| 29 | Values aside from EXIT_SUCCESS and EXIT_FAILURE can be used to indicate | ||
| 30 | finer gradations of failure. If this is the only information available | ||
| 31 | to the caller, clamping such values to EXIT_FAILURE loses information. | ||
| 32 | If there are other ways to indicate the problem to the caller (such as | ||
| 33 | a message to stderr) it may be ok to clamp. In all cases, it is the | ||
| 34 | relationship between the program and its caller that must be examined. | ||
| 35 | [Insert ZAMM quote here.] | ||