|
dvander@218
|
1 |
#ifndef _INCLUDE_SOURCEMOD_HANDLESYSTEM_H_ |
|
dvander@218
|
2 |
#define _INCLUDE_SOURCEMOD_HANDLESYSTEM_H_ |
|
dvander@218
|
3 |
|
|
dvander@218
|
4 |
#include <IHandleSys.h> |
|
dvander@218
|
5 |
#include "sm_globals.h" |
|
dvander@218
|
6 |
#include "sm_trie.h" |
|
dvander@218
|
7 |
#include "sourcemod.h" |
|
dvander@218
|
8 |
#include "sm_memtable.h" |
|
dvander@218
|
9 |
|
|
dvander@222
|
10 |
#define HANDLESYS_MAX_HANDLES (1<<14) |
|
dvander@218
|
11 |
#define HANDLESYS_MAX_TYPES (1<<9) |
|
dvander@218
|
12 |
#define HANDLESYS_MAX_SUBTYPES 0xF |
|
dvander@218
|
13 |
#define HANDLESYS_SUBTYPE_MASK 0xF |
|
dvander@218
|
14 |
#define HANDLESYS_TYPEARRAY_SIZE (HANDLESYS_MAX_TYPES * (HANDLESYS_MAX_SUBTYPES + 1)) |
|
dvander@218
|
15 |
#define HANDLESYS_MAX_SERIALS 0xFFFF |
|
dvander@218
|
16 |
#define HANDLESYS_SERIAL_MASK 0xFFFF0000 |
|
dvander@218
|
17 |
#define HANDLESYS_HANDLE_MASK 0x0000FFFF |
|
dvander@218
|
18 |
|
|
dvander@229
|
19 |
/** |
|
dvander@229
|
20 |
* The QHandle is a nasty structure that compacts the handle system into a big vector. |
|
dvander@229
|
21 |
* The members of the vector each encapsulate one Handle, however, they also act as nodes |
|
dvander@229
|
22 |
* in an inlined linked list and an inlined vector. |
|
dvander@229
|
23 |
* |
|
dvander@229
|
24 |
* The first of these lists is the 'freeID' list. Each node from 1 to N (where N |
|
dvander@229
|
25 |
* is the number of free nodes) has a 'freeID' that specifies a free Handle ID. This |
|
dvander@229
|
26 |
* is a quick hack to get around allocating a second base vector. |
|
dvander@229
|
27 |
* |
|
dvander@229
|
28 |
* The second vector is the identity linked list. An identity has its own handle, so |
|
dvander@229
|
29 |
* these handles are used as sentinel nodes for index linking. They point to the first and last |
|
dvander@229
|
30 |
* index into the handle array. Each subsequent Handle who is owned by that indentity is mapped into |
|
dvander@229
|
31 |
* that list. This lets owning identities be unloaded in O(n) time. |
|
dvander@229
|
32 |
* |
|
dvander@229
|
33 |
* Eventually, there may be a third list for type chains. |
|
dvander@229
|
34 |
*/ |
|
dvander@229
|
35 |
|
|
dvander@229
|
36 |
enum HandleSet |
|
dvander@229
|
37 |
{ |
|
dvander@229
|
38 |
HandleSet_None = 0, |
|
dvander@229
|
39 |
HandleSet_Used, |
|
dvander@229
|
40 |
HandleSet_Identity |
|
dvander@229
|
41 |
}; |
|
dvander@229
|
42 |
|
|
dvander@218
|
43 |
struct QHandle |
|
dvander@218
|
44 |
{ |
|
dvander@222
|
45 |
HandleType_t type; /* Handle type */ |
|
dvander@222
|
46 |
void *object; /* Unmaintained object pointer */ |
|
dvander@229
|
47 |
IdentityToken_t *owner; /* Identity of object which owns this */ |
|
dvander@222
|
48 |
unsigned int serial; /* Serial no. for sanity checking */ |
|
dvander@222
|
49 |
unsigned int refcount; /* Reference count for safe destruction */ |
|
dvander@222
|
50 |
Handle_t clone; /* If non-zero, this is our cloned parent */ |
|
dvander@229
|
51 |
HandleSet set; /* Information about the handle's state */ |
|
dvander@229
|
52 |
/* The following variables are unrelated to the Handle array, and used |
|
dvander@229
|
53 |
* as an inlined chain of information */ |
|
dvander@229
|
54 |
unsigned int freeID; /* ID of a free handle in the free handle chain */ |
|
dvander@229
|
55 |
/* Indexes into the handle array for owner membership. |
|
dvander@229
|
56 |
* For identity roots, these are treated as the head/tail. */ |
|
dvander@229
|
57 |
unsigned int ch_prev; /* chained previous handle or HEAD */ |
|
dvander@229
|
58 |
unsigned int ch_next; /* chained next handle or TAIL */ |
|
dvander@218
|
59 |
}; |
|
dvander@218
|
60 |
|
|
dvander@218
|
61 |
struct QHandleType |
|
dvander@218
|
62 |
{ |
|
dvander@218
|
63 |
IHandleTypeDispatch *dispatch; |
|
dvander@218
|
64 |
unsigned int freeID; |
|
dvander@218
|
65 |
unsigned int children; |
|
dvander@218
|
66 |
HandleSecurity sec; |
|
dvander@218
|
67 |
unsigned int opened; |
|
dvander@218
|
68 |
int nameIdx; |
|
dvander@218
|
69 |
}; |
|
dvander@218
|
70 |
|
|
dvander@218
|
71 |
class HandleSystem : |
|
dvander@218
|
72 |
public IHandleSys |
|
dvander@218
|
73 |
{ |
|
dvander@229
|
74 |
friend HandleError IdentityHandle(IdentityToken_t *token, unsigned int *index); |
|
dvander@229
|
75 |
friend class ShareSystem; |
|
dvander@218
|
76 |
public: |
|
dvander@218
|
77 |
HandleSystem(); |
|
dvander@218
|
78 |
~HandleSystem(); |
|
dvander@218
|
79 |
public: //IHandleSystem |
|
dvander@218
|
80 |
HandleType_t CreateType(const char *name, IHandleTypeDispatch *dispatch); |
|
dvander@218
|
81 |
HandleType_t CreateTypeEx(const char *name, |
|
dvander@218
|
82 |
IHandleTypeDispatch *dispatch, |
|
dvander@218
|
83 |
HandleType_t parent, |
|
dvander@229
|
84 |
const HandleSecurity *security, |
|
dvander@229
|
85 |
IdentityToken_t *ident); |
|
dvander@218
|
86 |
HandleType_t CreateChildType(const char *name, HandleType_t parent, IHandleTypeDispatch *dispatch); |
|
dvander@229
|
87 |
bool RemoveType(HandleType_t type, IdentityToken_t *ident); |
|
dvander@218
|
88 |
bool FindHandleType(const char *name, HandleType_t *type); |
|
dvander@218
|
89 |
Handle_t CreateHandle(HandleType_t type, |
|
dvander@218
|
90 |
void *object, |
|
dvander@229
|
91 |
IdentityToken_t *source, |
|
dvander@229
|
92 |
IdentityToken_t *ident); |
|
dvander@229
|
93 |
Handle_t CreateScriptHandle(HandleType_t type, void *object, sp_context_t *ctx, IdentityToken_t *ident); |
|
dvander@229
|
94 |
HandleError FreeHandle(Handle_t handle, IdentityToken_t *ident); |
|
dvander@229
|
95 |
HandleError CloneHandle(Handle_t handle, Handle_t *newhandle, IdentityToken_t *source, IdentityToken_t *ident); |
|
dvander@229
|
96 |
HandleError ReadHandle(Handle_t handle, HandleType_t type, IdentityToken_t *ident, void **object); |
|
dvander@229
|
97 |
bool TypeCheck(HandleType_t intype, HandleType_t outtype); |
|
dvander@229
|
98 |
protected: |
|
dvander@222
|
99 |
/** |
|
dvander@222
|
100 |
* Decodes a handle with sanity and security checking. |
|
dvander@222
|
101 |
*/ |
|
dvander@222
|
102 |
HandleError GetHandle(Handle_t handle, |
|
dvander@229
|
103 |
IdentityToken_t *ident, |
|
dvander@222
|
104 |
QHandle **pHandle, |
|
dvander@222
|
105 |
unsigned int *index, |
|
dvander@222
|
106 |
HandleAccessRight access); |
|
dvander@222
|
107 |
|
|
dvander@222
|
108 |
/** |
|
dvander@222
|
109 |
* Creates a basic handle and sets its reference count to 1. |
|
dvander@222
|
110 |
* Does not do any type or security checking. |
|
dvander@222
|
111 |
*/ |
|
dvander@229
|
112 |
HandleError MakePrimHandle(HandleType_t type, |
|
dvander@229
|
113 |
QHandle **pHandle, |
|
dvander@229
|
114 |
unsigned int *index, |
|
dvander@229
|
115 |
HandleType_t *handle, |
|
dvander@229
|
116 |
IdentityToken_t *owner); |
|
dvander@222
|
117 |
|
|
dvander@222
|
118 |
/** |
|
dvander@229
|
119 |
* Frees a primitive handle. Does no object freeing, only reference count, bookkeepping, |
|
dvander@229
|
120 |
* and linked list maintenance. |
|
dvander@222
|
121 |
*/ |
|
dvander@222
|
122 |
void ReleasePrimHandle(unsigned int index); |
|
dvander@229
|
123 |
|
|
dvander@229
|
124 |
/** |
|
dvander@229
|
125 |
* Sets the security owner of a type |
|
dvander@229
|
126 |
*/ |
|
dvander@229
|
127 |
void SetTypeSecurityOwner(HandleType_t type, IdentityToken_t *pToken); |
|
dvander@229
|
128 |
|
|
dvander@229
|
129 |
/** |
|
dvander@229
|
130 |
* Marks a handle as an identity. |
|
dvander@229
|
131 |
* This prevents it from being tampered with by outside stuff |
|
dvander@229
|
132 |
*/ |
|
dvander@229
|
133 |
void MarkHandleAsIdentity(Handle_t handle); |
|
dvander@222
|
134 |
private: |
|
dvander@218
|
135 |
QHandle *m_Handles; |
|
dvander@218
|
136 |
QHandleType *m_Types; |
|
dvander@218
|
137 |
Trie *m_TypeLookup; |
|
dvander@218
|
138 |
unsigned int m_TypeTail; |
|
dvander@218
|
139 |
unsigned int m_FreeTypes; |
|
dvander@218
|
140 |
unsigned int m_HandleTail; |
|
dvander@218
|
141 |
unsigned int m_FreeHandles; |
|
dvander@218
|
142 |
unsigned int m_HSerial; |
|
dvander@218
|
143 |
BaseStringTable *m_strtab; |
|
dvander@218
|
144 |
}; |
|
dvander@218
|
145 |
|
|
dvander@218
|
146 |
extern HandleSystem g_HandleSys; |
|
dvander@218
|
147 |
|
|
dvander@218
|
148 |
#endif //_INCLUDE_SOURCEMOD_HANDLESYSTEM_H_ |