core/systems/HandleSys.h
author David Anderson <dvander@alliedmods.net>
Mon Jan 01 19:50:16 2007 +0000 (2007-01-01)
changeset 252 ce166c465bad
parent 229 7819a42069e4
child 259 ca9b124a2544
permissions -rw-r--r--
added usage of the Handle System to begin experimenting
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@252
    93
	Handle_t CreateScriptHandle(HandleType_t type, void *object, IPluginContext *pContext, 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_