osdThreadHooks.c File Reference

#include <stdlib.h>
#include <stdio.h>
#include <errno.h>
#include <string.h>
#include "ellLib.h"
#include "epicsMutex.h"
#include "epicsThread.h"

Include dependency graph for osdThreadHooks.c:

Go to the source code of this file.

Classes
struct	epicsThreadHook

Typedefs
typedef struct epicsThreadHook	epicsThreadHook

Functions
LIBCOM_API int	epicsThreadHookAdd (EPICS_THREAD_HOOK_ROUTINE hook)
LIBCOM_API int	epicsThreadHookDelete (EPICS_THREAD_HOOK_ROUTINE hook)
LIBCOM_API void	osdThreadHooksRunMain (epicsThreadId id)
LIBCOM_API void	osdThreadHooksRun (epicsThreadId id)
LIBCOM_API void	epicsThreadHooksShow (void)

Variables
LIBCOM_API EPICS_THREAD_HOOK_ROUTINE	epicsThreadHookDefault
LIBCOM_API EPICS_THREAD_HOOK_ROUTINE	epicsThreadHookMain

Typedef Documentation

typedef struct epicsThreadHook epicsThreadHook

Function Documentation

LIBCOM_API int epicsThreadHookAdd

(

EPICS_THREAD_HOOK_ROUTINE

hook

)

Register a routine to be called by every new thread before the thread function gets run. Hook routines will often register a thread exit routine with epicsAtThreadExit() to release thread-specific resources they have allocated.

Definition at line 54 of file osdThreadHooks.c.

{
    epicsThreadHook *pHook;

    if (!hook) return 0;
    threadHookInit();

    pHook = calloc(1, sizeof(epicsThreadHook));
    if (!pHook) {
        fprintf(stderr, "epicsThreadHookAdd: calloc failed\n");
        return -1;
    }
    pHook->func = hook;

    if (epicsMutexLock(hookLock) == epicsMutexLockOK) {
        ellAdd(&hookList, &pHook->node);
        epicsMutexUnlock(hookLock);
        return 0;
    }
    fprintf(stderr, "epicsThreadHookAdd: Locking problem\n");
    return -1;
}

LIBCOM_API int epicsThreadHookDelete

(

EPICS_THREAD_HOOK_ROUTINE

hook

)

Remove routine from the list of hooks run at thread creation time.

Definition at line 77 of file osdThreadHooks.c.

{
    if (!hook) return 0;
    threadHookInit();

    if (epicsMutexLock(hookLock) == epicsMutexLockOK) {
        epicsThreadHook *pHook = (epicsThreadHook *) ellFirst(&hookList);

        while (pHook) {
            if (hook == pHook->func) {
                ellDelete(&hookList, &pHook->node);
                break;
            }
            pHook = (epicsThreadHook *) ellNext(&pHook->node);
        }
        epicsMutexUnlock(hookLock);
        return 0;
    }
    fprintf(stderr, "epicsThreadHookAdd: Locking problem\n");
    return -1;
}

LIBCOM_API void epicsThreadHooksShow

(

void

)

Print the current list of hook function pointers.

Definition at line 123 of file osdThreadHooks.c.

{
    threadHookInit();

    if (epicsMutexLock(hookLock) == epicsMutexLockOK) {
        epicsThreadHook *pHook = (epicsThreadHook *) ellFirst(&hookList);

        while (pHook) {
            printf("  %p\n", pHook->func);
            pHook = (epicsThreadHook *) ellNext(&pHook->node);
        }
        epicsMutexUnlock(hookLock);
    }
    else {
        fprintf(stderr, "epicsThreadHooksShow: Locking problem\n");
    }
}

LIBCOM_API void osdThreadHooksRun

(

epicsThreadId

id

)

Definition at line 105 of file osdThreadHooks.c.

{
    threadHookInit();

    if (epicsMutexLock(hookLock) == epicsMutexLockOK) {
        epicsThreadHook *pHook = (epicsThreadHook *) ellFirst(&hookList);

        while (pHook) {
            pHook->func(id);
            pHook = (epicsThreadHook *) ellNext(&pHook->node);
        }
        epicsMutexUnlock(hookLock);
    }
    else {
        fprintf(stderr, "osdThreadHooksRun: Locking problem\n");
    }
}

LIBCOM_API void osdThreadHooksRunMain

(

epicsThreadId

id

)

Definition at line 99 of file osdThreadHooks.c.

{
    if (epicsThreadHookMain)
        epicsThreadHookMain(id);
}

Variable Documentation

LIBCOM_API EPICS_THREAD_HOOK_ROUTINE epicsThreadHookDefault

Definition at line 14 of file osdThreadExtra.c.

LIBCOM_API EPICS_THREAD_HOOK_ROUTINE epicsThreadHookMain

Definition at line 15 of file osdThreadExtra.c.