core/systems/HandleSys.cpp
author David Anderson <dvander@alliedmods.net>
Thu Jan 25 22:36:38 2007 +0000 (2007-01-25)
changeset 370 d3a484f98f6d
parent 364 99f3e60a7f68
child 528 ea61550036b5
permissions -rw-r--r--
added license headers
dvander@370
     1
/**
dvander@370
     2
 * ===============================================================
dvander@370
     3
 * SourceMod (C)2004-2007 AlliedModders LLC.  All rights reserved.
dvander@370
     4
 * ===============================================================
dvander@370
     5
 *
dvander@370
     6
 * This file is not open source and may not be copied without explicit
dvander@370
     7
 * written permission of AlliedModders LLC.  This file may not be redistributed 
dvander@370
     8
 * in whole or significant part.
dvander@370
     9
 * For information, see LICENSE.txt or http://www.sourcemod.net/license.php
dvander@370
    10
 *
dvander@370
    11
 * Version: $Id$
dvander@370
    12
 */
dvander@370
    13
dvander@218
    14
#include "HandleSys.h"
dvander@229
    15
#include "ShareSys.h"
dvander@218
    16
#include "PluginSys.h"
dvander@222
    17
#include <assert.h>
dvander@351
    18
#include <string.h>
dvander@218
    19
dvander@218
    20
HandleSystem g_HandleSys;
dvander@218
    21
dvander@229
    22
QHandle *ignore_handle;
dvander@229
    23
dvander@229
    24
inline HandleType_t TypeParent(HandleType_t type)
dvander@229
    25
{
dvander@229
    26
	return (type & ~HANDLESYS_SUBTYPE_MASK);
dvander@229
    27
}
dvander@229
    28
dvander@229
    29
inline HandleError IdentityHandle(IdentityToken_t *token, unsigned int *index)
dvander@229
    30
{
dvander@262
    31
	return g_HandleSys.GetHandle(token->ident, g_ShareSys.GetIdentRoot(), &ignore_handle, index);
dvander@229
    32
}
dvander@229
    33
dvander@218
    34
HandleSystem::HandleSystem()
dvander@218
    35
{
dvander@218
    36
	m_Handles = new QHandle[HANDLESYS_MAX_HANDLES + 1];
dvander@218
    37
	memset(m_Handles, 0, sizeof(QHandle) * (HANDLESYS_MAX_HANDLES + 1));
dvander@218
    38
dvander@218
    39
	m_Types = new QHandleType[HANDLESYS_TYPEARRAY_SIZE];
dvander@218
    40
	memset(m_Types, 0, sizeof(QHandleType) * HANDLESYS_TYPEARRAY_SIZE);
dvander@218
    41
dvander@218
    42
	m_TypeLookup = sm_trie_create();
dvander@218
    43
	m_strtab = new BaseStringTable(512);
dvander@218
    44
dvander@218
    45
	m_TypeTail = 0;
dvander@218
    46
}
dvander@218
    47
dvander@218
    48
HandleSystem::~HandleSystem()
dvander@218
    49
{
dvander@218
    50
	delete [] m_Handles;
dvander@218
    51
	delete [] m_Types;
dvander@218
    52
	sm_trie_destroy(m_TypeLookup);
dvander@218
    53
	delete m_strtab;
dvander@218
    54
}
dvander@218
    55
dvander@218
    56
dvander@262
    57
HandleType_t HandleSystem::CreateType(const char *name, 
dvander@262
    58
									  IHandleTypeDispatch *dispatch, 
dvander@262
    59
									  HandleType_t parent, 
dvander@262
    60
									  const TypeAccess *typeAccess, 
dvander@262
    61
									  const HandleAccess *hndlAccess, 
dvander@262
    62
									  IdentityToken_t *ident,
dvander@262
    63
									  HandleError *err)
dvander@218
    64
{
dvander@218
    65
	if (!dispatch)
dvander@218
    66
	{
dvander@262
    67
		if (err)
dvander@262
    68
		{
dvander@262
    69
			*err = HandleError_Parameter;
dvander@262
    70
		}
dvander@262
    71
		return 0;
dvander@262
    72
	}
dvander@262
    73
dvander@262
    74
	if (typeAccess && typeAccess->hsVersion > SMINTERFACE_HANDLESYSTEM_VERSION)
dvander@262
    75
	{
dvander@262
    76
		if (err)
dvander@262
    77
		{
dvander@262
    78
			*err = HandleError_Version;
dvander@262
    79
		}
dvander@262
    80
		return 0;
dvander@262
    81
	}
dvander@262
    82
dvander@262
    83
	if (hndlAccess && hndlAccess->hsVersion > SMINTERFACE_HANDLESYSTEM_VERSION)
dvander@262
    84
	{
dvander@262
    85
		if (err)
dvander@262
    86
		{
dvander@262
    87
			*err = HandleError_Version;
dvander@262
    88
		}
dvander@218
    89
		return 0;
dvander@218
    90
	}
dvander@218
    91
dvander@218
    92
	bool isChild = false;
dvander@218
    93
dvander@218
    94
	if (parent != 0)
dvander@218
    95
	{
dvander@218
    96
		isChild = true;
dvander@218
    97
		if (parent & HANDLESYS_SUBTYPE_MASK)
dvander@218
    98
		{
dvander@262
    99
			if (err)
dvander@262
   100
			{
dvander@262
   101
				*err = HandleError_NoInherit;
dvander@262
   102
			}
dvander@218
   103
			return 0;
dvander@218
   104
		}
dvander@218
   105
		if (parent >= HANDLESYS_TYPEARRAY_SIZE
dvander@262
   106
			|| m_Types[parent].dispatch == NULL)
dvander@218
   107
		{
dvander@262
   108
			if (err)
dvander@262
   109
			{
dvander@262
   110
				*err = HandleError_Parameter;
dvander@262
   111
			}
dvander@262
   112
			return 0;
dvander@262
   113
		}
dvander@262
   114
		if (m_Types[parent].typeSec.access[HTypeAccess_Inherit] == false
dvander@262
   115
			&& (m_Types[parent].typeSec.ident != ident))
dvander@262
   116
		{
dvander@262
   117
			if (err)
dvander@262
   118
			{
dvander@262
   119
				*err = HandleError_Access;
dvander@262
   120
			}
dvander@218
   121
			return 0;
dvander@218
   122
		}
dvander@218
   123
	}
dvander@218
   124
dvander@262
   125
	if (name && name[0] != '\0')
dvander@218
   126
	{
dvander@262
   127
		if (sm_trie_retrieve(m_TypeLookup, name, NULL))
dvander@218
   128
		{
dvander@262
   129
			if (err)
dvander@262
   130
			{
dvander@262
   131
				*err = HandleError_Parameter;
dvander@262
   132
			}
dvander@262
   133
			return 0;
dvander@218
   134
		}
dvander@218
   135
	}
dvander@218
   136
dvander@218
   137
	unsigned int index;
dvander@218
   138
dvander@218
   139
	if (isChild)
dvander@218
   140
	{
dvander@218
   141
		QHandleType *pParent = &m_Types[parent];
dvander@218
   142
		if (pParent->children >= HANDLESYS_MAX_SUBTYPES)
dvander@218
   143
		{
dvander@262
   144
			if (err)
dvander@262
   145
			{
dvander@262
   146
				*err = HandleError_Limit;
dvander@262
   147
			}
dvander@218
   148
			return 0;
dvander@218
   149
		}
dvander@218
   150
		index = 0;
dvander@218
   151
		for (unsigned int i=1; i<=HANDLESYS_MAX_SUBTYPES; i++)
dvander@218
   152
		{
dvander@218
   153
			if (m_Types[parent + i].dispatch == NULL)
dvander@218
   154
			{
dvander@218
   155
				index = parent + i;
dvander@218
   156
				break;
dvander@218
   157
			}
dvander@218
   158
		}
dvander@218
   159
		if (!index)
dvander@218
   160
		{
dvander@262
   161
			if (err)
dvander@262
   162
			{
dvander@262
   163
				*err = HandleError_Limit;
dvander@262
   164
			}
dvander@218
   165
			return 0;
dvander@218
   166
		}
dvander@218
   167
		pParent->children++;
dvander@218
   168
	} else {
dvander@218
   169
		if (m_FreeTypes == 0)
dvander@218
   170
		{
dvander@218
   171
			/* Reserve another index */
dvander@218
   172
			if (m_TypeTail >= HANDLESYS_TYPEARRAY_SIZE)
dvander@218
   173
			{
dvander@262
   174
				if (err)
dvander@262
   175
				{
dvander@262
   176
					*err = HandleError_Limit;
dvander@262
   177
				}
dvander@218
   178
				return 0;
dvander@218
   179
			} else {
dvander@218
   180
				m_TypeTail += (HANDLESYS_MAX_SUBTYPES + 1);
dvander@218
   181
				index = m_TypeTail;
dvander@218
   182
			}
dvander@218
   183
		} else {
dvander@218
   184
			/* The "free array" is compacted into the normal array for easiness */
dvander@218
   185
			index = m_Types[m_FreeTypes--].freeID;
dvander@218
   186
		}
dvander@218
   187
	}
dvander@218
   188
dvander@218
   189
	QHandleType *pType = &m_Types[index];
dvander@218
   190
	
dvander@218
   191
	pType->dispatch = dispatch;
dvander@218
   192
	if (name && name[0] != '\0')
dvander@218
   193
	{
dvander@218
   194
		pType->nameIdx = m_strtab->AddString(name);
dvander@218
   195
		sm_trie_insert(m_TypeLookup, name, (void *)pType);
dvander@218
   196
	} else {
dvander@218
   197
		pType->nameIdx = -1;
dvander@218
   198
	}
dvander@262
   199
dvander@218
   200
	pType->opened = 0;
dvander@218
   201
dvander@262
   202
	if (typeAccess)
dvander@262
   203
	{
dvander@262
   204
		pType->typeSec = *typeAccess;
dvander@262
   205
	} else {
dvander@262
   206
		InitAccessDefaults(&pType->typeSec, NULL);
dvander@262
   207
		pType->typeSec.ident = ident;
dvander@262
   208
	}
dvander@262
   209
dvander@262
   210
	if (hndlAccess)
dvander@262
   211
	{
dvander@262
   212
		pType->hndlSec = *hndlAccess;
dvander@262
   213
	} else {
dvander@262
   214
		InitAccessDefaults(NULL, &pType->hndlSec);
dvander@262
   215
	}
dvander@262
   216
dvander@218
   217
	if (!isChild)
dvander@218
   218
	{
dvander@218
   219
		pType->children = 0;
dvander@218
   220
	}
dvander@218
   221
dvander@218
   222
	return index;
dvander@218
   223
}
dvander@218
   224
dvander@218
   225
bool HandleSystem::FindHandleType(const char *name, HandleType_t *type)
dvander@218
   226
{
dvander@218
   227
	QHandleType *_type;
dvander@218
   228
dvander@218
   229
	if (!sm_trie_retrieve(m_TypeLookup, name, (void **)&_type))
dvander@218
   230
	{
dvander@218
   231
		return false;
dvander@218
   232
	}
dvander@218
   233
dvander@218
   234
	unsigned int offset = _type - m_Types;
dvander@218
   235
dvander@218
   236
	if (type)
dvander@218
   237
	{
dvander@218
   238
		*type = offset;
dvander@218
   239
	}
dvander@218
   240
dvander@218
   241
	return true;
dvander@218
   242
}
dvander@218
   243
dvander@222
   244
HandleError HandleSystem::MakePrimHandle(HandleType_t type, 
dvander@222
   245
						   QHandle **in_pHandle, 
dvander@222
   246
						   unsigned int *in_index, 
dvander@229
   247
						   Handle_t *in_handle,
dvander@283
   248
						   IdentityToken_t *owner,
dvander@283
   249
						   bool identity)
dvander@222
   250
{
dvander@229
   251
	unsigned int owner_index = 0;
dvander@229
   252
dvander@229
   253
	if (owner && (IdentityHandle(owner, &owner_index) != HandleError_None))
dvander@229
   254
	{
dvander@229
   255
		return HandleError_Identity;
dvander@229
   256
	}
dvander@229
   257
dvander@222
   258
	unsigned int handle;
dvander@222
   259
	if (m_FreeHandles == 0)
dvander@222
   260
	{
dvander@222
   261
		if (m_HandleTail >= HANDLESYS_MAX_HANDLES)
dvander@222
   262
		{
dvander@222
   263
			return HandleError_Limit;;
dvander@222
   264
		}
dvander@222
   265
		handle = ++m_HandleTail;
dvander@222
   266
	} else {
dvander@222
   267
		handle = m_Handles[m_FreeHandles--].freeID;
dvander@222
   268
	}
dvander@222
   269
dvander@222
   270
	QHandle *pHandle = &m_Handles[handle];
dvander@222
   271
	
dvander@222
   272
	assert(pHandle->set == false);
dvander@222
   273
dvander@222
   274
	if (++m_HSerial >= HANDLESYS_MAX_SERIALS)
dvander@222
   275
	{
dvander@222
   276
		m_HSerial = 1;
dvander@222
   277
	}
dvander@222
   278
dvander@222
   279
	/* Set essential information */
dvander@283
   280
	pHandle->set = identity ? HandleSet_Identity : HandleSet_Used;
dvander@222
   281
	pHandle->refcount = 1;
dvander@222
   282
	pHandle->type = type;
dvander@222
   283
	pHandle->serial = m_HSerial;
dvander@229
   284
	pHandle->owner = owner;
dvander@229
   285
	pHandle->ch_next = 0;
dvander@222
   286
dvander@222
   287
	/* Create the hash value */
dvander@222
   288
	Handle_t hash = pHandle->serial;
dvander@222
   289
	hash <<= 16;
dvander@222
   290
	hash |= handle;
dvander@222
   291
dvander@222
   292
	/* Add a reference count to the type */
dvander@222
   293
	m_Types[type].opened++;
dvander@222
   294
dvander@222
   295
	/* Output */
dvander@222
   296
	*in_pHandle = pHandle;
dvander@222
   297
	*in_index = handle;
dvander@222
   298
	*in_handle = hash;
dvander@222
   299
dvander@283
   300
	/* Decode the identity token 
dvander@283
   301
	 * For now, we don't allow nested ownership
dvander@283
   302
	 */
dvander@283
   303
	if (owner && !identity)
dvander@229
   304
	{
dvander@229
   305
		QHandle *pIdentity = &m_Handles[owner_index];
dvander@229
   306
		if (pIdentity->ch_prev == 0)
dvander@229
   307
		{
dvander@229
   308
			pIdentity->ch_prev = handle;
dvander@229
   309
			pIdentity->ch_next = handle;
dvander@229
   310
			pHandle->ch_prev = 0;
dvander@229
   311
		} else {
dvander@229
   312
			/* Link previous node to us (forward) */
dvander@229
   313
			m_Handles[pIdentity->ch_next].ch_next = handle;
dvander@229
   314
			/* Link us to previous node (backwards) */
dvander@229
   315
			pHandle->ch_prev = pIdentity->ch_next;
dvander@229
   316
			/* Set new tail */
dvander@229
   317
			pIdentity->ch_next = handle;
dvander@229
   318
		}
dvander@229
   319
		pIdentity->refcount++;
dvander@229
   320
	} else {
dvander@229
   321
		pHandle->ch_prev = 0;
dvander@229
   322
	}
dvander@229
   323
dvander@222
   324
	return HandleError_None;
dvander@222
   325
}
dvander@222
   326
dvander@229
   327
void HandleSystem::SetTypeSecurityOwner(HandleType_t type, IdentityToken_t *pToken)
dvander@229
   328
{
dvander@229
   329
	if (!type
dvander@229
   330
		|| type >= HANDLESYS_TYPEARRAY_SIZE
dvander@229
   331
		|| m_Types[type].dispatch == NULL)
dvander@229
   332
	{
dvander@229
   333
		return;
dvander@229
   334
	}
dvander@229
   335
dvander@262
   336
	m_Types[type].typeSec.ident = pToken;
dvander@229
   337
}
dvander@229
   338
dvander@283
   339
Handle_t HandleSystem::CreateHandleEx(HandleType_t type, void *object, IdentityToken_t *owner, IdentityToken_t *ident, HandleError *err, bool identity)
dvander@218
   340
{
dvander@218
   341
	if (!type 
dvander@218
   342
		|| type >= HANDLESYS_TYPEARRAY_SIZE
dvander@218
   343
		|| m_Types[type].dispatch == NULL)
dvander@218
   344
	{
dvander@262
   345
		if (err)
dvander@262
   346
		{
dvander@262
   347
			*err = HandleError_Parameter;
dvander@262
   348
		}
dvander@218
   349
		return 0;
dvander@218
   350
	}
dvander@218
   351
dvander@262
   352
	/* Check to see if we're allowed to create this handle type */
dvander@218
   353
	QHandleType *pType = &m_Types[type];
dvander@262
   354
	if (!pType->typeSec.access[HTypeAccess_Create]
dvander@283
   355
	&& (!pType->typeSec.ident
dvander@283
   356
		|| pType->typeSec.ident != ident))
dvander@218
   357
	{
dvander@262
   358
		if (err)
dvander@262
   359
		{
dvander@262
   360
			*err = HandleError_Access;
dvander@262
   361
		}
dvander@218
   362
		return 0;
dvander@218
   363
	}
dvander@218
   364
dvander@222
   365
	unsigned int index;
dvander@222
   366
	Handle_t handle;
dvander@222
   367
	QHandle *pHandle;
dvander@262
   368
	HandleError _err;
dvander@222
   369
dvander@283
   370
	if ((_err=MakePrimHandle(type, &pHandle, &index, &handle, owner, identity)) != HandleError_None)
dvander@218
   371
	{
dvander@262
   372
		if (err)
dvander@262
   373
		{
dvander@262
   374
			*err = _err;
dvander@262
   375
		}
dvander@222
   376
		return 0;
dvander@218
   377
	}
dvander@218
   378
dvander@218
   379
	pHandle->object = object;
dvander@222
   380
	pHandle->clone = 0;
dvander@218
   381
dvander@222
   382
	return handle;
dvander@218
   383
}
dvander@218
   384
dvander@283
   385
Handle_t HandleSystem::CreateHandle(HandleType_t type, void *object, IdentityToken_t *owner, IdentityToken_t *ident, HandleError *err)
dvander@283
   386
{
dvander@283
   387
	return CreateHandleEx(type, object, owner, ident, err, false);
dvander@283
   388
}
dvander@283
   389
dvander@229
   390
bool HandleSystem::TypeCheck(HandleType_t intype, HandleType_t outtype)
dvander@229
   391
{
dvander@229
   392
	/* Check the type inheritance */
dvander@229
   393
	if (intype & HANDLESYS_SUBTYPE_MASK)
dvander@229
   394
	{
dvander@229
   395
		if (intype != outtype
dvander@229
   396
			&& (TypeParent(intype) != TypeParent(outtype)))
dvander@229
   397
		{
dvander@229
   398
			return false;
dvander@229
   399
		}
dvander@229
   400
	} else {
dvander@229
   401
		if (intype != outtype)
dvander@229
   402
		{
dvander@229
   403
			return false;
dvander@229
   404
		}
dvander@229
   405
	}
dvander@229
   406
dvander@229
   407
	return true;
dvander@229
   408
}
dvander@229
   409
dvander@222
   410
HandleError HandleSystem::GetHandle(Handle_t handle,
dvander@229
   411
									IdentityToken_t *ident, 
dvander@222
   412
									QHandle **in_pHandle, 
dvander@222
   413
									unsigned int *in_index,
dvander@259
   414
									bool ignoreFree)
dvander@218
   415
{
dvander@218
   416
	unsigned int serial = (handle >> 16);
dvander@218
   417
	unsigned int index = (handle & HANDLESYS_HANDLE_MASK);
dvander@218
   418
dvander@218
   419
	if (index == 0 || index == 0xFFFF)
dvander@218
   420
	{
dvander@218
   421
		return HandleError_Index;
dvander@218
   422
	}
dvander@218
   423
dvander@218
   424
	QHandle *pHandle = &m_Handles[index];
dvander@218
   425
dvander@259
   426
	if (!pHandle->set
dvander@259
   427
		|| (pHandle->set == HandleSet_Freed && !ignoreFree))
dvander@218
   428
	{
dvander@218
   429
		return HandleError_Freed;
dvander@229
   430
	} else if (pHandle->set == HandleSet_Identity
dvander@229
   431
			   && ident != g_ShareSys.GetIdentRoot())
dvander@229
   432
	{
dvander@229
   433
		/* Only IdentityHandle() can read this! */
dvander@229
   434
		return HandleError_Identity;
dvander@218
   435
	}
dvander@218
   436
	if (pHandle->serial != serial)
dvander@218
   437
	{
dvander@218
   438
		return HandleError_Changed;
dvander@218
   439
	}
dvander@218
   440
dvander@222
   441
	*in_pHandle = pHandle;
dvander@222
   442
	*in_index = index;
dvander@222
   443
dvander@222
   444
	return HandleError_None;
dvander@222
   445
}
dvander@222
   446
dvander@262
   447
bool HandleSystem::CheckAccess(QHandle *pHandle, HandleAccessRight right, const HandleSecurity *pSecurity)
dvander@262
   448
{
dvander@262
   449
	QHandleType *pType = &m_Types[pHandle->type];
dvander@262
   450
	unsigned int access = pType->hndlSec.access[right];
dvander@262
   451
dvander@262
   452
	/* Check if the type's identity matches */
dvander@262
   453
	if (access & HANDLE_RESTRICT_IDENTITY)
dvander@262
   454
	{
dvander@262
   455
		IdentityToken_t *owner = pType->typeSec.ident;
dvander@262
   456
		if (!owner
dvander@262
   457
			|| (!pSecurity || pSecurity->pIdentity != owner))
dvander@262
   458
		{
dvander@262
   459
			return false;
dvander@262
   460
		}
dvander@262
   461
	}
dvander@262
   462
dvander@262
   463
	/* Check if the owner is allowed */
dvander@262
   464
	if (access & HANDLE_RESTRICT_OWNER)
dvander@262
   465
	{
dvander@262
   466
		IdentityToken_t *owner = pHandle->owner;
dvander@262
   467
		if (owner
dvander@262
   468
			&& (!pSecurity || pSecurity->pOwner != owner))
dvander@262
   469
		{
dvander@262
   470
			return false;
dvander@262
   471
		}
dvander@262
   472
	}
dvander@262
   473
dvander@262
   474
	return true;
dvander@262
   475
}
dvander@262
   476
dvander@283
   477
HandleError HandleSystem::CloneHandle(QHandle *pHandle, unsigned int index, Handle_t *newhandle, IdentityToken_t *newOwner)
dvander@283
   478
{
dvander@283
   479
	/* Get a new Handle ID */
dvander@283
   480
	unsigned int new_index;
dvander@283
   481
	QHandle *pNewHandle;
dvander@283
   482
	Handle_t new_handle;
dvander@283
   483
	HandleError err;
dvander@283
   484
dvander@283
   485
	if ((err=MakePrimHandle(pHandle->type, &pNewHandle, &new_index, &new_handle, newOwner)) != HandleError_None)
dvander@283
   486
	{
dvander@283
   487
		return err;
dvander@283
   488
	}
dvander@283
   489
dvander@283
   490
	pNewHandle->clone = index;
dvander@283
   491
	pHandle->refcount++;
dvander@283
   492
dvander@283
   493
	*newhandle = new_handle;
dvander@283
   494
dvander@283
   495
	return HandleError_None;
dvander@283
   496
}
dvander@283
   497
dvander@262
   498
HandleError HandleSystem::CloneHandle(Handle_t handle, Handle_t *newhandle, IdentityToken_t *newOwner, const HandleSecurity *pSecurity)
dvander@222
   499
{
dvander@222
   500
	HandleError err;
dvander@222
   501
	QHandle *pHandle;
dvander@222
   502
	unsigned int index;
dvander@262
   503
	IdentityToken_t *ident = pSecurity ? pSecurity->pIdentity : NULL;
dvander@222
   504
dvander@262
   505
	if ((err=GetHandle(handle, ident, &pHandle, &index)) != HandleError_None)
dvander@222
   506
	{
dvander@222
   507
		return err;
dvander@222
   508
	}
dvander@222
   509
dvander@259
   510
	/* Identities cannot be cloned */
dvander@259
   511
	if (pHandle->set == HandleSet_Identity)
dvander@259
   512
	{
dvander@259
   513
		return HandleError_Identity;
dvander@259
   514
	}
dvander@259
   515
dvander@262
   516
	/* Check if the handle can be cloned */
dvander@262
   517
	if (!CheckAccess(pHandle, HandleAccess_Clone, pSecurity))
dvander@262
   518
	{
dvander@262
   519
		return HandleError_Access;
dvander@262
   520
	}
dvander@222
   521
dvander@283
   522
	/* Make sure we're not cloning a clone */
dvander@283
   523
	if (pHandle->clone)
dvander@222
   524
	{
dvander@283
   525
		QHandle *pParent = &m_Handles[pHandle->clone];
dvander@283
   526
		return CloneHandle(pParent, pHandle->clone, newhandle, newOwner);
dvander@222
   527
	}
dvander@222
   528
dvander@283
   529
	return CloneHandle(pHandle, index, newhandle, newOwner);
dvander@283
   530
}
dvander@283
   531
dvander@283
   532
HandleError HandleSystem::FreeHandle(QHandle *pHandle, unsigned int index)
dvander@283
   533
{
dvander@283
   534
	QHandleType *pType = &m_Types[pHandle->type];
dvander@283
   535
dvander@283
   536
	if (pHandle->clone)
dvander@283
   537
	{
dvander@283
   538
		/* If we're a clone, decrease the parent reference count */
dvander@283
   539
		QHandle *pMaster;
dvander@283
   540
		unsigned int master;
dvander@283
   541
dvander@283
   542
		/* Note that if we ever have per-handle security, we would need to re-check
dvander@283
   543
		* the access on this Handle. */
dvander@283
   544
		master = pHandle->clone;
dvander@283
   545
		pMaster = &m_Handles[master];
dvander@283
   546
dvander@283
   547
		/* Release the clone now */
dvander@283
   548
		ReleasePrimHandle(index);
dvander@222
   549
dvander@283
   550
		/* Decrement the master's reference count */
dvander@283
   551
		if (--pMaster->refcount == 0)
dvander@283
   552
		{
dvander@283
   553
			/* Type should be the same but do this anyway... */
dvander@283
   554
			pType = &m_Types[pMaster->type];
dvander@283
   555
			pType->dispatch->OnHandleDestroy(pMaster->type, pMaster->object);
dvander@283
   556
			ReleasePrimHandle(master);
dvander@283
   557
		}
dvander@283
   558
	} else if (pHandle->set == HandleSet_Identity) {
dvander@283
   559
		/* If we're an identity, skip all this stuff!
dvander@283
   560
		 * NOTE: SHARESYS DOES NOT CARE ABOUT THE DESTRUCTOR
dvander@283
   561
		 */
dvander@283
   562
		ReleasePrimHandle(index);
dvander@283
   563
	} else {
dvander@283
   564
		/* Decrement, free if necessary */
dvander@283
   565
		if (--pHandle->refcount == 0)
dvander@283
   566
		{
dvander@283
   567
			pType->dispatch->OnHandleDestroy(pHandle->type, pHandle->object);
dvander@283
   568
			ReleasePrimHandle(index);
dvander@283
   569
		} else {
dvander@283
   570
			/* We must be cloned, so mark ourselves as freed */
dvander@283
   571
			pHandle->set = HandleSet_Freed;
dvander@283
   572
			/* Now, unlink us, so we're not being tracked by the owner */
dvander@283
   573
			if (pHandle->owner)
dvander@283
   574
			{
dvander@283
   575
				UnlinkHandleFromOwner(pHandle, index);
dvander@283
   576
			}
dvander@283
   577
		}
dvander@283
   578
	}
dvander@222
   579
dvander@222
   580
	return HandleError_None;
dvander@222
   581
}
dvander@222
   582
dvander@262
   583
HandleError HandleSystem::FreeHandle(Handle_t handle, const HandleSecurity *pSecurity)
dvander@222
   584
{
dvander@222
   585
	unsigned int index;
dvander@222
   586
	QHandle *pHandle;
dvander@222
   587
	HandleError err;
dvander@262
   588
	IdentityToken_t *ident = pSecurity ? pSecurity->pIdentity : NULL;
dvander@222
   589
dvander@262
   590
	if ((err=GetHandle(handle, ident, &pHandle, &index)) != HandleError_None)
dvander@222
   591
	{
dvander@222
   592
		return err;
dvander@222
   593
	}
dvander@222
   594
dvander@262
   595
	if (!CheckAccess(pHandle, HandleAccess_Delete, pSecurity))
dvander@259
   596
	{
dvander@259
   597
		return HandleError_Access;
dvander@259
   598
	}
dvander@259
   599
dvander@283
   600
	return FreeHandle(pHandle, index);
dvander@218
   601
}
dvander@218
   602
dvander@262
   603
HandleError HandleSystem::ReadHandle(Handle_t handle, HandleType_t type, const HandleSecurity *pSecurity, void **object)
dvander@218
   604
{
dvander@222
   605
	unsigned int index;
dvander@222
   606
	QHandle *pHandle;
dvander@222
   607
	HandleError err;
dvander@262
   608
	IdentityToken_t *ident = pSecurity ? pSecurity->pIdentity : NULL;
dvander@218
   609
dvander@262
   610
	if ((err=GetHandle(handle, ident, &pHandle, &index)) != HandleError_None)
dvander@218
   611
	{
dvander@222
   612
		return err;
dvander@218
   613
	}
dvander@218
   614
dvander@262
   615
	if (!CheckAccess(pHandle, HandleAccess_Read, pSecurity))
dvander@262
   616
	{
dvander@262
   617
		return HandleError_Access;
dvander@262
   618
	}
dvander@262
   619
dvander@218
   620
	/* Check the type inheritance */
dvander@218
   621
	if (pHandle->type & HANDLESYS_SUBTYPE_MASK)
dvander@218
   622
	{
dvander@218
   623
		if (pHandle->type != type
dvander@218
   624
			&& (TypeParent(pHandle->type) != TypeParent(type)))
dvander@218
   625
		{
dvander@218
   626
			return HandleError_Type;
dvander@218
   627
		}
dvander@247
   628
	} else if (type) {
dvander@218
   629
		if (pHandle->type != type)
dvander@218
   630
		{
dvander@218
   631
			return HandleError_Type;
dvander@218
   632
		}
dvander@218
   633
	}
dvander@218
   634
dvander@218
   635
	if (object)
dvander@218
   636
	{
dvander@222
   637
		/* if we're a clone, the rules change - object is ONLY in our reference */
dvander@222
   638
		if (pHandle->clone)
dvander@222
   639
		{
dvander@262
   640
			pHandle = &m_Handles[pHandle->clone];
dvander@222
   641
		}
dvander@218
   642
		*object = pHandle->object;
dvander@218
   643
	}
dvander@218
   644
dvander@218
   645
	return HandleError_None;
dvander@218
   646
}
dvander@218
   647
dvander@283
   648
void HandleSystem::UnlinkHandleFromOwner(QHandle *pHandle, unsigned int index)
dvander@283
   649
{
dvander@283
   650
	/* Unlink us if necessary */
dvander@283
   651
	unsigned int ident_index;
dvander@283
   652
	if (IdentityHandle(pHandle->owner, &ident_index) != HandleError_None)
dvander@283
   653
	{
dvander@283
   654
		/* Uh-oh! */
dvander@283
   655
		assert(pHandle->owner == 0);
dvander@283
   656
		return;
dvander@283
   657
	}
dvander@283
   658
	/* Note that since 0 is an invalid handle, if any of these links are 0,
dvander@283
   659
	* the data can still be set.
dvander@283
   660
	*/
dvander@283
   661
	QHandle *pIdentity = &m_Handles[ident_index];
dvander@283
   662
dvander@283
   663
	/* Unlink case: We're the head AND tail node */
dvander@283
   664
	if (index == pIdentity->ch_prev && index == pIdentity->ch_next)
dvander@283
   665
	{
dvander@283
   666
		pIdentity->ch_prev = 0;
dvander@283
   667
		pIdentity->ch_next = 0;
dvander@283
   668
	}
dvander@283
   669
	/* Unlink case: We're the head node */
dvander@283
   670
	else if (index == pIdentity->ch_prev) {
dvander@283
   671
		/* Link us to the next in the chain */
dvander@283
   672
		pIdentity->ch_prev = pHandle->ch_next;
dvander@283
   673
		/* Patch up the previous link */
dvander@283
   674
		m_Handles[pHandle->ch_next].ch_prev = 0;
dvander@283
   675
	}
dvander@283
   676
	/* Unlink case: We're the tail node */
dvander@283
   677
	else if (index == pIdentity->ch_next) {
dvander@283
   678
		/* Link us to the previous in the chain */
dvander@283
   679
		pIdentity->ch_next = pHandle->ch_prev;
dvander@283
   680
		/* Patch up the next link */
dvander@283
   681
		m_Handles[pHandle->ch_prev].ch_next = 0;
dvander@283
   682
	}
dvander@283
   683
	/* Unlink case: We're in the middle! */
dvander@283
   684
	else {
dvander@283
   685
		/* Patch the forward reference */
dvander@283
   686
		m_Handles[pHandle->ch_next].ch_prev = pHandle->ch_prev;
dvander@283
   687
		/* Patch the backward reference */
dvander@283
   688
		m_Handles[pHandle->ch_prev].ch_next = pHandle->ch_next;
dvander@283
   689
	}
dvander@283
   690
dvander@283
   691
	/* Lastly, decrease the reference count */
dvander@283
   692
	pIdentity->refcount--;
dvander@283
   693
}
dvander@283
   694
dvander@222
   695
void HandleSystem::ReleasePrimHandle(unsigned int index)
dvander@222
   696
{
dvander@222
   697
	QHandle *pHandle = &m_Handles[index];
dvander@283
   698
	HandleSet set = pHandle->set;
dvander@283
   699
dvander@283
   700
	if (pHandle->owner && (set != HandleSet_Identity))
dvander@283
   701
	{
dvander@283
   702
		UnlinkHandleFromOwner(pHandle, index);
dvander@283
   703
	}
dvander@283
   704
dvander@283
   705
	/* Were we an identity ourself? */
dvander@283
   706
	QHandle *pLocal;
dvander@283
   707
	if (set == HandleSet_Identity)
dvander@283
   708
	{
dvander@283
   709
		/* Extra work to do.  We need to find everything connected to this identity and release it. */
dvander@351
   710
		unsigned int ch_index;
dvander@364
   711
#if defined _DEBUG
dvander@364
   712
		unsigned int old_index = 0;
dvander@364
   713
#endif
dvander@283
   714
		while ((ch_index = pHandle->ch_next) != 0)
dvander@283
   715
		{
dvander@283
   716
			pLocal = &m_Handles[ch_index];
dvander@283
   717
#if defined _DEBUG
dvander@283
   718
			assert(old_index != ch_index);
dvander@283
   719
			assert(pLocal->set == HandleSet_Used);
dvander@283
   720
			old_index = ch_index;
dvander@283
   721
#endif
dvander@283
   722
			FreeHandle(pLocal, ch_index);
dvander@283
   723
		}
dvander@283
   724
	}
dvander@283
   725
dvander@229
   726
	pHandle->set = HandleSet_None;
dvander@222
   727
	m_Types[pHandle->type].opened--;
dvander@222
   728
	m_Handles[++m_FreeHandles].freeID = index;
dvander@222
   729
}
dvander@222
   730
dvander@229
   731
bool HandleSystem::RemoveType(HandleType_t type, IdentityToken_t *ident)
dvander@218
   732
{
dvander@218
   733
	if (type == 0 || type >= HANDLESYS_TYPEARRAY_SIZE)
dvander@218
   734
	{
dvander@218
   735
		return false;
dvander@218
   736
	}
dvander@218
   737
dvander@218
   738
	QHandleType *pType = &m_Types[type];
dvander@218
   739
dvander@262
   740
	if (pType->typeSec.ident
dvander@262
   741
		&& pType->typeSec.ident != ident)
dvander@218
   742
	{
dvander@218
   743
		return false;
dvander@218
   744
	}
dvander@218
   745
dvander@218
   746
	if (pType->dispatch == NULL)
dvander@218
   747
	{
dvander@218
   748
		return false;
dvander@218
   749
	}
dvander@218
   750
dvander@218
   751
	/* Remove children if we have to */
dvander@218
   752
	if (!(type & HANDLESYS_SUBTYPE_MASK))
dvander@218
   753
	{
dvander@218
   754
		QHandleType *childType;
dvander@218
   755
		for (unsigned int i=1; i<=HANDLESYS_MAX_SUBTYPES; i++)
dvander@218
   756
		{
dvander@218
   757
			childType = &m_Types[type + i];
dvander@218
   758
			if (childType->dispatch)
dvander@218
   759
			{
dvander@262
   760
				RemoveType(type + i, childType->typeSec.ident);
dvander@218
   761
			}
dvander@218
   762
		}
dvander@218
   763
		/* Link us into the free chain */
dvander@218
   764
		m_Types[++m_FreeTypes].freeID = type;
dvander@218
   765
	}
dvander@218
   766
dvander@218
   767
	/* Invalidate the type now */
dvander@218
   768
	IHandleTypeDispatch *dispatch = pType->dispatch;
dvander@218
   769
	pType->dispatch = NULL;
dvander@218
   770
dvander@218
   771
	/* Make sure nothing is using this type. */
dvander@218
   772
	if (pType->opened)
dvander@218
   773
	{
dvander@218
   774
		QHandle *pHandle;
dvander@297
   775
		for (unsigned int i=1; i<=m_HandleTail; i++)
dvander@218
   776
		{
dvander@218
   777
			pHandle = &m_Handles[i];
dvander@218
   778
			if (!pHandle->set || pHandle->type != type)
dvander@218
   779
			{
dvander@218
   780
				continue;
dvander@218
   781
			}
dvander@222
   782
			if (pHandle->clone)
dvander@222
   783
			{
dvander@222
   784
				/* Get parent */
dvander@222
   785
				QHandle *pOther = &m_Handles[pHandle->clone];
dvander@222
   786
				if (--pOther->refcount == 0)
dvander@222
   787
				{
dvander@222
   788
					/* Free! */
dvander@222
   789
					dispatch->OnHandleDestroy(type, pOther->object);
dvander@222
   790
					ReleasePrimHandle(pHandle->clone);
dvander@222
   791
				}
dvander@222
   792
				/* Unlink ourselves since we don't have a reference count */
dvander@222
   793
				ReleasePrimHandle(i);
dvander@222
   794
			} else {
dvander@222
   795
				/* If it's not a clone, we still have to check the reference count.
dvander@222
   796
				 * Either way, we'll be destroyed eventually because the handle types do not change.
dvander@222
   797
				 */
dvander@222
   798
				if (--pHandle->refcount == 0)
dvander@222
   799
				{
dvander@222
   800
					/* Free! */
dvander@222
   801
					dispatch->OnHandleDestroy(type, pHandle->object);
dvander@222
   802
					ReleasePrimHandle(i);
dvander@222
   803
				}
dvander@222
   804
			}
dvander@222
   805
			if (pType->opened == 0)
dvander@218
   806
			{
dvander@218
   807
				break;
dvander@218
   808
			}
dvander@218
   809
		}
dvander@218
   810
	}
dvander@218
   811
dvander@218
   812
	return true;
dvander@218
   813
}
dvander@229
   814
dvander@262
   815
bool HandleSystem::InitAccessDefaults(TypeAccess *pTypeAccess, HandleAccess *pHandleAccess)
dvander@262
   816
{
dvander@262
   817
	if (pTypeAccess)
dvander@262
   818
	{
dvander@262
   819
		if (pTypeAccess->hsVersion > SMINTERFACE_HANDLESYSTEM_VERSION)
dvander@262
   820
		{
dvander@262
   821
			return false;
dvander@262
   822
		}
dvander@262
   823
		pTypeAccess->access[HTypeAccess_Create] = false;
dvander@262
   824
		pTypeAccess->access[HTypeAccess_Inherit] = false;
dvander@262
   825
		pTypeAccess->ident = NULL;
dvander@262
   826
	}
dvander@262
   827
dvander@262
   828
	if (pHandleAccess)
dvander@262
   829
	{
dvander@262
   830
		if (pHandleAccess->hsVersion > SMINTERFACE_HANDLESYSTEM_VERSION)
dvander@262
   831
		{
dvander@262
   832
			return false;
dvander@262
   833
		}
dvander@262
   834
dvander@262
   835
		pHandleAccess->access[HandleAccess_Clone] = 0;
dvander@262
   836
		pHandleAccess->access[HandleAccess_Delete] = HANDLE_RESTRICT_OWNER;
dvander@262
   837
		pHandleAccess->access[HandleAccess_Read] = HANDLE_RESTRICT_IDENTITY;
dvander@262
   838
	}
dvander@262
   839
dvander@262
   840
	return true;
dvander@262
   841
}