epicsExit.c File Reference

#include <stdlib.h>
#include <stdio.h>
#include <errno.h>
#include <string.h>
#include "ellLib.h"
#include "errlog.h"
#include "epicsThread.h"
#include "epicsMutex.h"
#include "cantProceed.h"
#include "epicsExit.h"
#include "epicsExport.h"

Include dependency graph for epicsExit.c:

Go to the source code of this file.

Classes
struct	exitNode
struct	exitPvt

Typedefs
typedef struct exitNode	exitNode
typedef struct exitPvt	exitPvt

Functions
void	epicsMutexCleanup (void)
LIBCOM_API void	epicsExitCallAtExits (void)
	Internal routine that runs the registered exit routines. More...
LIBCOM_API void	epicsExitCallAtThreadExits (void)
	Internal routine that runs the registered thread exit routines. More...
LIBCOM_API 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. More...
LIBCOM_API int	epicsAtExit3 (epicsExitFunc func, void *arg, const char *name)
	Register a function and an associated context parameter. More...
LIBCOM_API void	epicsExit (int status)
	Calls epicsExitCallAtExits(), then the OS exit() routine. More...
LIBCOM_API void	epicsExitLater (int status)
	Arrange to call epicsExit() later from a low priority thread. More...
	epicsExportAddress (int, atExitDebug)

Variables
int	atExitDebug = 0

Typedef Documentation

typedef struct exitNode exitNode

typedef struct exitPvt exitPvt

Function Documentation

LIBCOM_API 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

Definition at line 166 of file epicsExit.c.

{
    int status = -1;

    epicsExitInit ();
    epicsMutexMustLock ( exitPvtLock );
    if ( !pExitPvtPerProcess ) {
        pExitPvtPerProcess = createExitPvt ();
    }
    if ( pExitPvtPerProcess ) {
        status = epicsAtExitPvt ( pExitPvtPerProcess, func, arg, name );
    }
    epicsMutexUnlock ( exitPvtLock );
    return status;
}

LIBCOM_API 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.

Definition at line 150 of file epicsExit.c.

{
    exitPvt * pep;

    epicsExitInit ();
    pep = epicsThreadPrivateGet ( exitPvtPerThread );
    if ( ! pep ) {
        pep = createExitPvt ();
        if ( ! pep ) {
            return -1;
        }
        epicsThreadPrivateSet ( exitPvtPerThread, pep );
    }
    return epicsAtExitPvt ( pep, func, arg, NULL );
}

LIBCOM_API void epicsExit

(

int

status

)

Calls epicsExitCallAtExits(), then the OS exit() routine.

Parameters

status

Passed to exit()

Definition at line 182 of file epicsExit.c.

{
    epicsExitCallAtExits();
    epicsThreadSleep(0.1);
    exit(status);
}

LIBCOM_API 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.

Definition at line 102 of file epicsExit.c.

{
    exitPvt * pep = 0;

    epicsExitInit ();
    epicsMutexMustLock ( exitPvtLock );
    if ( pExitPvtPerProcess ) {
        pep = pExitPvtPerProcess;
        pExitPvtPerProcess = 0;
    }
    epicsMutexUnlock ( exitPvtLock );
    if ( pep ) {
        epicsExitCallAtExitsPvt ( pep );
        destroyExitPvt ( pep );
    }
    /* Handle specially to avoid circular reference */
    epicsMutexCleanup();
}

LIBCOM_API 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.

Definition at line 121 of file epicsExit.c.

{
    exitPvt * pep;

    epicsExitInit ();
    pep = epicsThreadPrivateGet ( exitPvtPerThread );
    if ( pep ) {
        epicsExitCallAtExitsPvt ( pep );
        destroyExitPvt ( pep );
        epicsThreadPrivateSet ( exitPvtPerThread, 0 );
    }
}

LIBCOM_API 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()

Definition at line 204 of file epicsExit.c.

{
    epicsThreadOnce(&exitLaterOnce, &exitLaterOnceFunc, &status);
}

epicsExportAddress	(	int	,
		atExitDebug
	)

void epicsMutexCleanup

(

void

)

Definition at line 176 of file epicsMutex.cpp.

{
    ELLNODE *cur;
    epicsMutexLockStatus lockStat =
        epicsMutexOsdLock(epicsMutexGlobalLock);
    assert ( lockStat == epicsMutexLockOK );

    while((cur=ellGet(&freeList))!=NULL) {
        VALGRIND_MEMPOOL_FREE(&freeList, cur);
        free(cur);
    }

    epicsMutexOsdUnlock(epicsMutexGlobalLock);
}

Variable Documentation

int atExitDebug = 0

Definition at line 50 of file epicsExit.c.