home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / forut062.zip / ForUtil-0.62 / man / EXITCODES < prev    next >
Text File  |  1996-08-27  |  2KB  |  77 lines
  1. EXIT CODES 
  2. ----------
  3.  
  4. 1. Common utilities
  5.  
  6.     0: no error, program exited normally
  7.     1: a command line option needing a second argument
  8.     2: -h, --help or --version used
  9.     3: unknown command line option given
  10.     4: get_common: no key given on command line
  11.        list_commons: unused
  12.        scan_commons: no files to scan
  13.     5: no database found/specified
  14.     6: gdbm error opening database file
  15.  
  16.     The three following exit codes can only be generated by scan_commons:
  17.     7: internal parser error; an internal counter exploded 
  18.     8: internal parser error; jumped out of a confined switch statement
  19.     13: internal scanner error: a diagnostic message will be shown.
  20.  
  21. 2. fflow
  22.  
  23.     0: no error, program exited normally
  24.     1: a command line option needing a second argument
  25.     2: -h, --help or --version used
  26.     3: unknown command line option given
  27.     4: no files to scan
  28.     5: unused
  29.     6: error opening output file
  30.     7: internal sorting error
  31.     8: a subroutine/function recurses into itself
  32.     9: possible recursion detected
  33.     10: no PROGRAM entry point found for the -p option
  34.     11: no subroutine/function entry point found for the -s option
  35.  
  36. 3. ffscan
  37.  
  38.     0: no error, program exited normally and no argument mismatches are
  39.        found.
  40.     1: a command line option needing a second argument
  41.     2: -h, --help or --version used
  42.     4: no files to scan
  43.     5: unused
  44.     6: error opening output file
  45.     7: internal sorting error
  46.     8: a subroutine/function recurses into itself
  47.     12: argument mismatches found
  48.  
  49. 4. ftags
  50.     0: no error, program exited normally
  51.     1: unused
  52.     2: no files given
  53.     3: unused
  54.     4: unused
  55.     5: unused
  56.     6: error opening output file
  57.  
  58. SIGNAL TRAPS
  59. ------------
  60.  
  61. Every exit code with a value larger than 20 is the value from a signal plus 20.
  62.  
  63. The signals trapped by the common utilities are (not all systems may support 
  64. all of these):
  65. SIGBUS, SIGSEGV, SIGALRM, SIGUSR1, SIGQUIT and SIGINT
  66.  
  67. The signals trapped by ffscan and fflow are:
  68. SIGSEGV, SIGUSR1, SIGQUIT and SIGINT
  69.  
  70. ftags does not trap any signals.
  71.  
  72. SIGUSR1 is used by the programs to signal a memory allocation error. 
  73. Since plain msdos does not have a SIGUSR1, SIGFPE is used instead. 
  74.  
  75. See signal(7) for the values of the signals that are generated by your system.
  76.  
  77.