epicsExit.h
Extended replacement for the Posix exit and atexit routines.
This is an extended replacement for the Posix exit and atexit routines, which also provides a pointer argument to pass to the exit handlers. This facility was created because of problems on vxWorks and windows with the implementation of atexit, i.e. neither of these systems implement exit and atexit according to the POSIX standard.
Defines
-
epicsAtExit(F, A)
Convenience macro to register a function and context value to be run when the process exits.
- Parameters:
F – Function to be called at process shutdown.
A – Context parameter for the function.
Typedefs
-
typedef void (*epicsExitFunc)(void *arg)
Pointer to a callback function that is to be called by the epicsExit subsystem.
Functions
-
void epicsExit(int status)
Calls epicsExitCallAtExits(), then the OS exit() routine.
- Parameters:
status – Passed to exit()
-
void epicsExitLater(int status)
Arrange to call epicsExit() later from a low priority thread.
This delays the actual call to exit() so it doesn’t run in this thread.
- Parameters:
status – Passed to exit()
-
void epicsExitCallAtExits(void)
Internal routine that runs the registered exit routines.
Calls each of the functions registered by prior calls to epicsAtExit in reverse order of their registration.
Note
Most applications will not call this routine directly.
-
int epicsAtExit3(epicsExitFunc func, void *arg, const char *name)
Register a function and an associated context parameter.
- Parameters:
func – Function to be called when epicsExitCallAtExits is invoked.
arg – Context parameter for the function.
name – Function name
-
void epicsExitCallAtThreadExits(void)
Internal routine that runs the registered thread exit routines.
Calls each of the functions that were registered in the current thread by calling epicsAtThreadExit(), in reverse order of their registration.
Note
This routine is called automatically when an epicsThread’s main entry routine returns. It will not be run if the thread gets stopped by some other method.
-
int epicsAtThreadExit(epicsExitFunc func, void *arg)
Register a function and an context value to be run by this thread when it returns from its entry routine.
- Parameters:
func – Function be called at thread completion.
arg – Context parameter for the function.