Performance-Monitoring Counters Library, for Intel/AMD Processors and Linux

This example introduces
   rabbit exit status

Return to Main Menu


The exit status for rabbit is intended to be consistent with the GNU /bin/time
program.

     0  RABBIT_SUCCESS       no error detected, no program attempted
     1  RABBIT_FAILURE       error detected, no program attempted
     2  RABBIT_NO_STATUS     no error detected; program ran with abnormal exit
   126  RABBIT_DID_NOT_FORK  error detected, could not fork
   126  RABBIT_DID_NOT_RUN   error detected, child process did not run
   127  RABBIT_DID_NOT_FIND  error detected, child process not found

If none of these situations occur, rabbit uses the exit status from the child
process.  The status symbols are defined in pmc_lib.h.

Programs executed with rabbit should leave the main program with exit(stat)
instead of return stat, to ensure that open files are closed and the status
value is communicated cleanly.  Programs using the PMC library must use
exit(), to ensure that files opened by the library are closed properly and
configuration settings are returned to their original values, as pmc_close()
is invoked through atexit().