231 lines
7.8 KiB
C
231 lines
7.8 KiB
C
/* asLib.h */
|
||
/*************************************************************************\
|
||
* Copyright (c) 2009 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.
|
||
* EPICS BASE is distributed subject to a Software License Agreement found
|
||
* in file LICENSE that is included with this distribution.
|
||
\*************************************************************************/
|
||
/* Author: Marty Kraimer Date: 09-27-93*/
|
||
|
||
#ifndef INCasLibh
|
||
#define INCasLibh
|
||
|
||
#include "shareLib.h"
|
||
#include "ellLib.h"
|
||
#include "errMdef.h"
|
||
#include "errlog.h"
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
typedef struct asgMember *ASMEMBERPVT;
|
||
typedef struct asgClient *ASCLIENTPVT;
|
||
typedef int (*ASINPUTFUNCPTR)(char *buf,int max_size);
|
||
typedef enum{
|
||
asClientCOAR /*Change of access rights*/
|
||
/*For now this is all*/
|
||
} asClientStatus;
|
||
|
||
typedef void (*ASCLIENTCALLBACK) (ASCLIENTPVT,asClientStatus);
|
||
/* The following routines are macros with the following syntax
|
||
long asCheckGet(ASCLIENTPVT asClientPvt);
|
||
long asCheckPut(ASCLIENTPVT asClientPvt);
|
||
*/
|
||
#define asCheckGet(asClientPvt)\
|
||
(asActive \
|
||
? ((asClientPvt)->access>=asREAD ? TRUE : FALSE)\
|
||
: TRUE)
|
||
#define asCheckPut(asClientPvt)\
|
||
(asActive \
|
||
? ((asClientPvt)->access>=asWRITE ? TRUE : FALSE)\
|
||
: TRUE)
|
||
#define asTrapWriteBefore(asClientPvt,user,host,addr) \
|
||
(((asActive) && (asClientPvt)->trapMask) \
|
||
? asTrapWriteBeforeWrite((user),(host),(addr)) \
|
||
: 0)
|
||
|
||
#define asTrapWriteAfter(pvt) if((pvt)) asTrapWriteAfterWrite((pvt))
|
||
|
||
epicsShareFunc long epicsShareAPI asInitialize(ASINPUTFUNCPTR inputfunction);
|
||
epicsShareFunc long epicsShareAPI asInitFile(
|
||
const char *filename,const char *substitutions);
|
||
epicsShareFunc long epicsShareAPI asInitFP(FILE *fp,const char *substitutions);
|
||
/*caller must provide permanent storage for asgName*/
|
||
epicsShareFunc long epicsShareAPI asAddMember(
|
||
ASMEMBERPVT *asMemberPvt,const char *asgName);
|
||
epicsShareFunc long epicsShareAPI asRemoveMember(ASMEMBERPVT *asMemberPvt);
|
||
/*caller must provide permanent storage for newAsgName*/
|
||
epicsShareFunc long epicsShareAPI asChangeGroup(
|
||
ASMEMBERPVT *asMemberPvt,const char *newAsgName);
|
||
epicsShareFunc void * epicsShareAPI asGetMemberPvt(ASMEMBERPVT asMemberPvt);
|
||
epicsShareFunc void epicsShareAPI asPutMemberPvt(
|
||
ASMEMBERPVT asMemberPvt,void *userPvt);
|
||
/*client must provide permanent storage for user and host*/
|
||
epicsShareFunc long epicsShareAPI asAddClient(
|
||
ASCLIENTPVT *asClientPvt,ASMEMBERPVT asMemberPvt,
|
||
int asl,const char *user,char *host);
|
||
/*client must provide permanent storage for user and host*/
|
||
epicsShareFunc long epicsShareAPI asChangeClient(
|
||
ASCLIENTPVT asClientPvt,int asl,const char *user,char *host);
|
||
epicsShareFunc long epicsShareAPI asRemoveClient(ASCLIENTPVT *asClientPvt);
|
||
epicsShareFunc void * epicsShareAPI asGetClientPvt(ASCLIENTPVT asClientPvt);
|
||
epicsShareFunc void epicsShareAPI asPutClientPvt(
|
||
ASCLIENTPVT asClientPvt,void *userPvt);
|
||
epicsShareFunc long epicsShareAPI asRegisterClientCallback(
|
||
ASCLIENTPVT asClientPvt, ASCLIENTCALLBACK pcallback);
|
||
epicsShareFunc long epicsShareAPI asComputeAllAsg(void);
|
||
/* following declared below after ASG is declared
|
||
epicsShareFunc long epicsShareAPI asComputeAsg(ASG *pasg);
|
||
*/
|
||
epicsShareFunc long epicsShareAPI asCompute(ASCLIENTPVT asClientPvt);
|
||
epicsShareFunc int epicsShareAPI asDump(
|
||
void (*memcallback)(ASMEMBERPVT,FILE *),
|
||
void (*clientcallback)(ASCLIENTPVT,FILE *),int verbose);
|
||
epicsShareFunc int epicsShareAPI asDumpFP(FILE *fp,
|
||
void (*memcallback)(ASMEMBERPVT,FILE *),
|
||
void (*clientcallback)(ASCLIENTPVT,FILE *),int verbose);
|
||
epicsShareFunc int epicsShareAPI asDumpUag(const char *uagname);
|
||
epicsShareFunc int epicsShareAPI asDumpUagFP(FILE *fp,const char *uagname);
|
||
epicsShareFunc int epicsShareAPI asDumpHag(const char *hagname);
|
||
epicsShareFunc int epicsShareAPI asDumpHagFP(FILE *fp,const char *hagname);
|
||
epicsShareFunc int epicsShareAPI asDumpRules(const char *asgname);
|
||
epicsShareFunc int epicsShareAPI asDumpRulesFP(FILE *fp,const char *asgname);
|
||
epicsShareFunc int epicsShareAPI asDumpMem(const char *asgname,
|
||
void (*memcallback)(ASMEMBERPVT,FILE *),int clients);
|
||
epicsShareFunc int epicsShareAPI asDumpMemFP(FILE *fp,const char *asgname,
|
||
void (*memcallback)(ASMEMBERPVT,FILE *),int clients);
|
||
epicsShareFunc int epicsShareAPI asDumpHash(void);
|
||
epicsShareFunc int epicsShareAPI asDumpHashFP(FILE *fp);
|
||
|
||
epicsShareFunc void * epicsShareAPI asTrapWriteBeforeWrite(
|
||
const char *userid,const char *hostid,void *addr);
|
||
|
||
epicsShareFunc void epicsShareAPI asTrapWriteAfterWrite(void *pvt);
|
||
|
||
#define S_asLib_clientsExist (M_asLib| 1) /*Client Exists*/
|
||
#define S_asLib_noUag (M_asLib| 2) /*User Access Group does not exist*/
|
||
#define S_asLib_noHag (M_asLib| 3) /*Host Access Group does not exist*/
|
||
#define S_asLib_noAccess (M_asLib| 4) /*access security: no access allowed*/
|
||
#define S_asLib_noModify (M_asLib| 5) /*access security: no modification allowed*/
|
||
#define S_asLib_badConfig (M_asLib| 6) /*access security: bad configuration file*/
|
||
#define S_asLib_badCalc (M_asLib| 7) /*access security: bad calculation espression*/
|
||
#define S_asLib_dupAsg (M_asLib| 8) /*Duplicate Access Security Group */
|
||
#define S_asLib_InitFailed (M_asLib| 9) /*access security: Init failed*/
|
||
#define S_asLib_asNotActive (M_asLib|10) /*access security is not active*/
|
||
#define S_asLib_badMember (M_asLib|11) /*access security: bad ASMEMBERPVT*/
|
||
#define S_asLib_badClient (M_asLib|12) /*access security: bad ASCLIENTPVT*/
|
||
#define S_asLib_badAsg (M_asLib|13) /*access security: bad ASG*/
|
||
#define S_asLib_noMemory (M_asLib|14) /*access security: no Memory */
|
||
|
||
/*Private declarations */
|
||
epicsShareExtern int asActive;
|
||
|
||
/* definition of access rights*/
|
||
typedef enum{asNOACCESS,asREAD,asWRITE} asAccessRights;
|
||
|
||
struct gphPvt;
|
||
|
||
/*Base pointers for access security*/
|
||
typedef struct asBase{
|
||
ELLLIST uagList;
|
||
ELLLIST hagList;
|
||
ELLLIST asgList;
|
||
struct gphPvt *phash;
|
||
} ASBASE;
|
||
|
||
epicsShareExtern volatile ASBASE *pasbase;
|
||
|
||
/*Defs for User Access Groups*/
|
||
typedef struct{
|
||
ELLNODE node;
|
||
char *user;
|
||
} UAGNAME;
|
||
typedef struct uag{
|
||
ELLNODE node;
|
||
char *name;
|
||
ELLLIST list; /*list of UAGNAME*/
|
||
} UAG;
|
||
/*Defs for Host Access Groups*/
|
||
typedef struct{
|
||
ELLNODE node;
|
||
char *host;
|
||
} HAGNAME;
|
||
typedef struct hag{
|
||
ELLNODE node;
|
||
char *name;
|
||
ELLLIST list; /*list of HAGNAME*/
|
||
} HAG;
|
||
/*Defs for Access SecurityGroups*/
|
||
typedef struct {
|
||
ELLNODE node;
|
||
UAG *puag;
|
||
}ASGUAG;
|
||
typedef struct {
|
||
ELLNODE node;
|
||
HAG *phag;
|
||
}ASGHAG;
|
||
#define AS_TRAP_WRITE 1
|
||
typedef struct{
|
||
ELLNODE node;
|
||
asAccessRights access;
|
||
int level;
|
||
unsigned long inpUsed; /*bitmap of which inputs are used*/
|
||
int result; /*Result of calc converted to TRUE/FALSE*/
|
||
char *calc;
|
||
void *rpcl;
|
||
ELLLIST uagList; /*List of ASGUAG*/
|
||
ELLLIST hagList; /*List of ASGHAG*/
|
||
int trapMask;
|
||
} ASGRULE;
|
||
typedef struct{
|
||
ELLNODE node;
|
||
char *inp;
|
||
void *capvt;
|
||
struct asg *pasg;
|
||
int inpIndex;
|
||
}ASGINP;
|
||
|
||
typedef struct asg{
|
||
ELLNODE node;
|
||
char *name;
|
||
ELLLIST inpList;
|
||
ELLLIST ruleList;
|
||
ELLLIST memberList;
|
||
double *pavalue; /*pointer to array of input values*/
|
||
unsigned long inpBad; /*bitmap of which inputs are bad*/
|
||
unsigned long inpChanged; /*bitmap of inputs that changed*/
|
||
} ASG;
|
||
typedef struct asgMember {
|
||
ELLNODE node;
|
||
ASG *pasg;
|
||
ELLLIST clientList;
|
||
const char *asgName;
|
||
void *userPvt;
|
||
} ASGMEMBER;
|
||
|
||
typedef struct asgClient {
|
||
ELLNODE node;
|
||
ASGMEMBER *pasgMember;
|
||
const char *user;
|
||
char *host;
|
||
void *userPvt;
|
||
ASCLIENTCALLBACK pcallback;
|
||
int level;
|
||
asAccessRights access;
|
||
int trapMask;
|
||
} ASGCLIENT;
|
||
|
||
epicsShareFunc long epicsShareAPI asComputeAsg(ASG *pasg);
|
||
/*following is "friend" function*/
|
||
epicsShareFunc void * epicsShareAPI asCalloc(size_t nobj,size_t size);
|
||
epicsShareFunc char * epicsShareAPI asStrdup(unsigned char *str);
|
||
epicsShareFunc void asFreeAll(ASBASE *pasbase);
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /*INCasLibh*/
|