1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
|
/** BEGIN COPYRIGHT BLOCK
* Copyright 2001 Sun Microsystems, Inc.
* Portions copyright 1999, 2001-2003 Netscape Communications Corporation.
* All rights reserved.
* END COPYRIGHT BLOCK **/
#ifndef __symbols_h
#define __symbols_h
/*
* Description (symbols.h)
*
* This file describes the interface to an ACL symbol table
* implementation. The symbol table provides for storing symbols
* keyed by name and type, creating a separate name space for
* each symbol type.
*/
#ifdef __PRIVATE_SYMBOLS
#include "plhash.h"
#include "base/crit.h"
/*
* Description (SymTable_t)
*
* This type describes a symbols table. It contains a pointer to
* an NSPR hash table and a pointer to a monitor. The monitor is
* needed even for read access to the symbol table because NSPR
* modifies the list for a hash bucket when a name is looked up.
*/
typedef struct SymTable_s SymTable_t;
struct SymTable_s {
CRITICAL stb_crit; /* monitor pointer */
PLHashTable * stb_ht; /* hash table pointer */
};
/* Private functions defined in symbols.c */
/*
static PLHashEntry * symAllocEntry(void * pool, const void *unused);
static void * symAllocTable(void * pool, PRSize size);
static int symCmpName(const void * name1, const void * name2);
static int symCmpValue(const void * value1, const void * value2);
static PLHashNumber symHash(const void * symkey);
static void symFreeEntry(void * pool, PLHashEntry * he, PRUintn flag);
static void symFreeTable(void * pool, void * item);
*/
#endif /* __PRIVATE_SYMBOLS */
/*
* Description (Symbol_t)
*
* This type describes a symbol table entry. A symbol is
* identified by the combination of its name and type. This
* structure is normally embedded in a structure for a particular
* symbol type, which will contain the symbol "value" information
* as well.
*/
typedef struct Symbol_s Symbol_t;
struct Symbol_s {
char * sym_name; /* pointer to symbol name string */
int sym_type; /* symbol type */
void *sym_data; /* symbol data storage */
};
/* Define error return codes */
#define SYMERRNOMEM -1 /* insufficient dynamic memory */
#define SYMERRDUPSYM -2 /* duplicate symbol name and type */
#define SYMERRNOSYM -3 /* symbol name and type not found */
/* Define return flags for symTableEnumerate() func() */
#define SYMENUMSTOP 0x1 /* terminate enumeration */
#define SYMENUMREMOVE 0x2 /* remove entry from symbol table */
NSPR_BEGIN_EXTERN_C
/* Public functions defined in symbols.c */
extern int symTableAddSym(void * table, Symbol_t * newsym, void * symref);
extern void symTableRemoveSym(void * table, Symbol_t * sym);
extern void symTableDestroy(void * table, int flags);
/* for ANSI C++ on SCO UDK, otherwise fn name is managled */
#ifdef UnixWare
typedef int (*ArgFn_symTableEnum)(Symbol_t * sym, void * parg);
extern void symTableEnumerate(void * table, void * argp, ArgFn_symTableEnum);
#else /* UnixWare */
extern void symTableEnumerate(void * table, void * argp,
int (*func)(Symbol_t * sym, void * parg));
#endif /* UnixWare */
extern int symTableFindSym(void * table, char * symname,
int symtype, void **psymref);
extern int symTableNew(void **ptable);
NSPR_END_EXTERN_C
#endif /* __symbols_h */
|