Michael Davidsaver
fefe6fd1fc
The main reason for this merge proposal is the change to "public" API functions. Use atomic counter to resolve data race on threadsRunning in callback. Split up callbackShutdown() and scanShutdown() into two phases *Stop() and *Cleanup(). The *Stop() functions signal worker threads, and wait for them to exit. The *Cleanup() functions actually reclaim global resources. These two mechanisms have couplings which are quite complex. I/O Intr scans involve both scan lists and callbacks.
80 lines
2.4 KiB
C
80 lines
2.4 KiB
C
/*************************************************************************\
|
|
* Copyright (c) 2007 UChicago Argonne LLC, as Operator of Argonne
|
|
* National Laboratory.
|
|
* Copyright (c) 2002 The Regents of the University of California, as
|
|
* Operator of Los Alamos National Laboratory.
|
|
* Copyright (c) 2013 ITER Organization.
|
|
* EPICS BASE is distributed subject to a Software License Agreement found
|
|
* in file LICENSE that is included with this distribution.
|
|
\*************************************************************************/
|
|
/* $Revision-Id$ */
|
|
|
|
/* includes for general purpose callback tasks */
|
|
/*
|
|
* Original Author: Marty Kraimer
|
|
* Date: 07-18-91
|
|
*/
|
|
|
|
#ifndef INCcallbackh
|
|
#define INCcallbackh 1
|
|
|
|
#include "shareLib.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*
|
|
* WINDOWS also has a "CALLBACK" type def
|
|
*/
|
|
#ifdef _WIN32
|
|
# ifdef CALLBACK
|
|
# undef CALLBACK
|
|
# endif /*CALLBACK*/
|
|
#endif /*_WIN32*/
|
|
|
|
#define NUM_CALLBACK_PRIORITIES 3
|
|
#define priorityLow 0
|
|
#define priorityMedium 1
|
|
#define priorityHigh 2
|
|
|
|
typedef struct callbackPvt {
|
|
void (*callback)(struct callbackPvt*);
|
|
int priority;
|
|
void *user; /*for use by callback user*/
|
|
void *timer; /*for use by callback itself*/
|
|
}CALLBACK;
|
|
|
|
typedef void (*CALLBACKFUNC)(struct callbackPvt*);
|
|
|
|
#define callbackSetCallback(PFUN,PCALLBACK)\
|
|
( (PCALLBACK)->callback = (PFUN) )
|
|
#define callbackSetPriority(PRIORITY,PCALLBACK)\
|
|
( (PCALLBACK)->priority = (PRIORITY) )
|
|
#define callbackSetUser(USER,PCALLBACK)\
|
|
( (PCALLBACK)->user = (void *)(USER) )
|
|
#define callbackGetUser(USER,PCALLBACK)\
|
|
( (USER) = (void *)((CALLBACK *)(PCALLBACK))->user )
|
|
|
|
epicsShareFunc void callbackInit(void);
|
|
epicsShareFunc void callbackStop(void);
|
|
epicsShareFunc void callbackCleanup(void);
|
|
epicsShareFunc int callbackRequest(CALLBACK *pCallback);
|
|
epicsShareFunc void callbackSetProcess(
|
|
CALLBACK *pcallback, int Priority, void *pRec);
|
|
epicsShareFunc int callbackRequestProcessCallback(
|
|
CALLBACK *pCallback,int Priority, void *pRec);
|
|
epicsShareFunc void callbackRequestDelayed(
|
|
CALLBACK *pCallback,double seconds);
|
|
epicsShareFunc void callbackCancelDelayed(CALLBACK *pcallback);
|
|
epicsShareFunc void callbackRequestProcessCallbackDelayed(
|
|
CALLBACK *pCallback, int Priority, void *pRec, double seconds);
|
|
epicsShareFunc int callbackSetQueueSize(int size);
|
|
epicsShareFunc int callbackParallelThreads(int count, const char *prio);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /*INCcallbackh*/
|