exit-value 1.3 KB

123456789101112131415161718192021222324252627282930313233343536
  1. ttn 2004-05-09
  2. The exit value of a program returning to the shell on unixoid systems is
  3. typically 0 for success, and non-0 (such as 1) for failure. For vms it is
  4. odd (1,3,5...) for success, even (0,2,4...) for failure.
  5. This holds from the point of view of the "shell" (in quotes because vms has a
  6. different dispatch model that is not explained further here).
  7. From the point of view of the program, nowadays stdlib.h on both type of
  8. systems provides macros `EXIT_SUCCESS' and `EXIT_FAILURE' that should DTRT.
  9. NB: The numerical values of these macros DO NOT need to fulfill the exit
  10. value requirements outlined in the first paragraph! That is the job of the
  11. `exit' function. Thus, this kind of construct shows misunderstanding:
  12. #ifdef VMS
  13. exit (1);
  14. #else
  15. exit (0);
  16. #endif
  17. Values aside from EXIT_SUCCESS and EXIT_FAILURE are tricky.
  18. ttn 2004-05-12
  19. Values aside from EXIT_SUCCESS and EXIT_FAILURE can be used to indicate
  20. finer gradations of failure. If this is the only information available
  21. to the caller, clamping such values to EXIT_FAILURE loses information.
  22. If there are other ways to indicate the problem to the caller (such as
  23. a message to stderr) it may be ok to clamp. In all cases, it is the
  24. relationship between the program and its caller that must be examined.
  25. [Insert ZAMM quote here.]