core/sourcemod.cpp
author David Anderson <dvander@alliedmods.net>
Mon Mar 12 00:06:20 2007 +0000 (2007-03-12)
changeset 599 3a098eff4890
parent 593 507e74843261
child 652 d62a08ba6318
permissions -rw-r--r--
used a better error number
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@160
    14
#include <stdio.h>
dvander@160
    15
#include "sourcemod.h"
dvander@160
    16
#include "sourcemm_api.h"
dvander@160
    17
#include "systems/LibrarySys.h"
dvander@160
    18
#include "vm/sp_vm_engine.h"
dvander@160
    19
#include <sh_string.h>
dvander@176
    20
#include "PluginSys.h"
dvander@252
    21
#include "ShareSys.h"
dvander@592
    22
#include "Logger.h"
dvander@315
    23
#include "ExtensionSys.h"
dvander@340
    24
#include "AdminCache.h"
dvander@347
    25
#include "sm_stringutil.h"
dvander@591
    26
#include "PlayerManager.h"
dvander@591
    27
#include "Translator.h"
dvander@531
    28
#include "ForwardSys.h"
faluco@593
    29
#include "TimerSys.h"
dvander@160
    30
dvander@209
    31
SH_DECL_HOOK6(IServerGameDLL, LevelInit, SH_NOATTRIB, false, bool, const char *, const char *, const char *, const char *, bool, bool);
faluco@333
    32
SH_DECL_HOOK0_void(IServerGameDLL, LevelShutdown, SH_NOATTRIB, false);
dvander@448
    33
SH_DECL_HOOK1_void(IServerGameDLL, GameFrame, SH_NOATTRIB, false, bool);
dvander@209
    34
dvander@160
    35
SourcePawnEngine g_SourcePawn;
dvander@160
    36
SourceModBase g_SourceMod;
dvander@160
    37
dvander@160
    38
ILibrary *g_pJIT = NULL;
dvander@160
    39
SourceHook::String g_BaseDir;
dvander@160
    40
ISourcePawnEngine *g_pSourcePawn = &g_SourcePawn;
dvander@160
    41
IVirtualMachine *g_pVM;
dvander@252
    42
IdentityToken_t *g_pCoreIdent = NULL;
dvander@448
    43
float g_LastTime = 0.0f;
dvander@448
    44
float g_LastAuthCheck = 0.0f;
dvander@531
    45
IForward *g_pOnGameFrame = NULL;
dvander@160
    46
dvander@160
    47
typedef int (*GIVEENGINEPOINTER)(ISourcePawnEngine *);
dvander@160
    48
typedef unsigned int (*GETEXPORTCOUNT)();
dvander@160
    49
typedef IVirtualMachine *(*GETEXPORT)(unsigned int);
dvander@160
    50
typedef void (*NOTIFYSHUTDOWN)();
dvander@160
    51
dvander@160
    52
void ShutdownJIT()
dvander@160
    53
{
dvander@160
    54
	NOTIFYSHUTDOWN notify = (NOTIFYSHUTDOWN)g_pJIT->GetSymbolAddress("NotifyShutdown");
dvander@160
    55
	if (notify)
dvander@160
    56
	{
dvander@160
    57
		notify();
dvander@160
    58
	}
dvander@160
    59
dvander@160
    60
	g_pJIT->CloseLibrary();
dvander@160
    61
}
dvander@160
    62
dvander@209
    63
SourceModBase::SourceModBase()
dvander@209
    64
{
dvander@209
    65
	m_IsMapLoading = false;
faluco@333
    66
	m_ExecPluginReload = false;
dvander@209
    67
}
dvander@209
    68
dvander@160
    69
bool SourceModBase::InitializeSourceMod(char *error, size_t err_max, bool late)
dvander@160
    70
{
dvander@160
    71
	g_BaseDir.assign(g_SMAPI->GetBaseDir());
dvander@209
    72
	g_LibSys.PathFormat(m_SMBaseDir, sizeof(m_SMBaseDir), "%s/addons/sourcemod", g_BaseDir.c_str());
dvander@345
    73
	g_LibSys.PathFormat(m_SMRelDir, sizeof(m_SMRelDir), "addons/sourcemod");
dvander@160
    74
dvander@160
    75
	/* Attempt to load the JIT! */
dvander@160
    76
	char file[PLATFORM_MAX_PATH];
dvander@160
    77
	char myerror[255];
dvander@209
    78
	g_SMAPI->PathFormat(file, sizeof(file), "%s/bin/sourcepawn.jit.x86.%s",
dvander@317
    79
		GetSourceModPath(),
dvander@160
    80
		PLATFORM_LIB_EXT
dvander@160
    81
		);
dvander@160
    82
dvander@160
    83
	g_pJIT = g_LibSys.OpenLibrary(file, myerror, sizeof(myerror));
dvander@160
    84
	if (!g_pJIT)
dvander@160
    85
	{
dvander@160
    86
		if (error && err_max)
dvander@160
    87
		{
dvander@160
    88
			snprintf(error, err_max, "%s (failed to load bin/sourcepawn.jit.x86.%s)", 
dvander@160
    89
				myerror,
dvander@160
    90
				PLATFORM_LIB_EXT);
dvander@160
    91
		}
dvander@160
    92
		return false;
dvander@160
    93
	}
dvander@160
    94
dvander@160
    95
	int err;
dvander@160
    96
	GIVEENGINEPOINTER jit_init = (GIVEENGINEPOINTER)g_pJIT->GetSymbolAddress("GiveEnginePointer");
dvander@160
    97
	if (!jit_init)
dvander@160
    98
	{
dvander@160
    99
		ShutdownJIT();
dvander@160
   100
		if (error && err_max)
dvander@160
   101
		{
dvander@160
   102
			snprintf(error, err_max, "Failed to find GiveEnginePointer in JIT!");
dvander@160
   103
		}
dvander@160
   104
		return false;
dvander@160
   105
	}
dvander@160
   106
dvander@160
   107
	if ((err=jit_init(g_pSourcePawn)) != 0)
dvander@160
   108
	{
dvander@160
   109
		ShutdownJIT();
dvander@160
   110
		if (error && err_max)
dvander@160
   111
		{
dvander@160
   112
			snprintf(error, err_max, "GiveEnginePointer returned %d in the JIT", err);
dvander@160
   113
		}
dvander@160
   114
		return false;
dvander@160
   115
	}
dvander@160
   116
dvander@160
   117
	GETEXPORTCOUNT jit_getnum = (GETEXPORTCOUNT)g_pJIT->GetSymbolAddress("GetExportCount");
dvander@160
   118
	GETEXPORT jit_get = (GETEXPORT)g_pJIT->GetSymbolAddress("GetExport");
dvander@160
   119
	if (!jit_get)
dvander@160
   120
	{
dvander@160
   121
		ShutdownJIT();
dvander@160
   122
		if (error && err_max)
dvander@160
   123
		{
dvander@160
   124
			snprintf(error, err_max, "JIT is missing a necessary export!");
dvander@160
   125
		}
dvander@160
   126
		return false;
dvander@160
   127
	}
dvander@160
   128
dvander@160
   129
	unsigned int num = jit_getnum();
dvander@160
   130
	if (!num || ((g_pVM=jit_get(0)) == NULL))
dvander@160
   131
	{
dvander@160
   132
		ShutdownJIT();
dvander@160
   133
		if (error && err_max)
dvander@160
   134
		{
dvander@160
   135
			snprintf(error, err_max, "JIT did not export any virtual machines!");
dvander@160
   136
		}
dvander@160
   137
		return false;
dvander@160
   138
	}
dvander@160
   139
dvander@176
   140
	unsigned int api = g_pVM->GetAPIVersion();
dvander@176
   141
	if (api != SOURCEPAWN_VM_API_VERSION)
dvander@176
   142
	{
dvander@176
   143
		ShutdownJIT();
dvander@176
   144
		if (error && err_max)
dvander@176
   145
		{
dvander@176
   146
			snprintf(error, err_max, "JIT is not a compatible version");
dvander@176
   147
		}
dvander@176
   148
		return false;
dvander@176
   149
	}
dvander@176
   150
dvander@209
   151
	StartSourceMod(late);
dvander@176
   152
dvander@160
   153
	return true;
dvander@160
   154
}
dvander@209
   155
dvander@209
   156
void SourceModBase::StartSourceMod(bool late)
dvander@209
   157
{
dvander@209
   158
	/* First initialize the global hooks we need */
dvander@209
   159
	SH_ADD_HOOK_MEMFUNC(IServerGameDLL, LevelInit, gamedll, this, &SourceModBase::LevelInit, false);
faluco@333
   160
	SH_ADD_HOOK_MEMFUNC(IServerGameDLL, LevelShutdown, gamedll, this, &SourceModBase::LevelShutdown, false);
dvander@448
   161
	SH_ADD_HOOK_MEMFUNC(IServerGameDLL, GameFrame, gamedll, this, &SourceModBase::GameFrame, false);
dvander@209
   162
dvander@496
   163
	enginePatch = SH_GET_CALLCLASS(engine);
dvander@532
   164
	gamedllPatch = SH_GET_CALLCLASS(gamedll);
dvander@496
   165
dvander@214
   166
	/* Notify! */
dvander@214
   167
	SMGlobalClass *pBase = SMGlobalClass::head;
dvander@214
   168
	while (pBase)
dvander@214
   169
	{
dvander@315
   170
		pBase->OnSourceModStartup(false);
dvander@214
   171
		pBase = pBase->m_pGlobalClassNext;
dvander@214
   172
	}
dvander@214
   173
dvander@252
   174
	/* Make the global core identity */
dvander@252
   175
	g_pCoreIdent = g_ShareSys.CreateCoreIdentity();
dvander@252
   176
dvander@214
   177
	/* Notify! */
dvander@214
   178
	pBase = SMGlobalClass::head;
dvander@214
   179
	while (pBase)
dvander@214
   180
	{
dvander@214
   181
		pBase->OnSourceModAllInitialized();
dvander@214
   182
		pBase = pBase->m_pGlobalClassNext;
dvander@214
   183
	}
dvander@317
   184
dvander@317
   185
	/* Add us now... */
dvander@317
   186
	g_ShareSys.AddInterface(NULL, this);
dvander@209
   187
}
dvander@209
   188
dvander@209
   189
bool SourceModBase::LevelInit(char const *pMapName, char const *pMapEntities, char const *pOldLevel, char const *pLandmarkName, bool loadGame, bool background)
dvander@209
   190
{
dvander@209
   191
	m_IsMapLoading = true;
faluco@333
   192
	m_ExecPluginReload = true;
dvander@448
   193
	g_LastTime = 0.0f;
dvander@448
   194
	g_LastAuthCheck = 0.0f;
dvander@209
   195
faluco@281
   196
	g_Logger.MapChange(pMapName);
faluco@587
   197
	g_Timers.MapChange();
faluco@281
   198
dvander@520
   199
	/* Refresh language stuff */
dvander@520
   200
	char path[PLATFORM_MAX_PATH];
dvander@520
   201
	BuildPath(Path_SM, path, sizeof(path), "configs/languages.cfg");
dvander@520
   202
	g_Translator.RebuildLanguageDatabase(path);
dvander@520
   203
dvander@209
   204
	DoGlobalPluginLoads();
dvander@209
   205
dvander@209
   206
	m_IsMapLoading = false;
dvander@209
   207
dvander@438
   208
	g_Admins.DumpAdminCache(AdminCache_Overrides, true);
dvander@438
   209
	g_Admins.DumpAdminCache(AdminCache_Groups, true);
dvander@340
   210
dvander@531
   211
	if (!g_pOnGameFrame)
dvander@531
   212
	{
dvander@531
   213
		g_pOnGameFrame = g_Forwards.CreateForward("OnGameFrame", ET_Ignore, 0, NULL);
dvander@531
   214
	}
dvander@531
   215
dvander@209
   216
	RETURN_META_VALUE(MRES_IGNORED, true);
dvander@209
   217
}
dvander@209
   218
dvander@448
   219
void SourceModBase::GameFrame(bool simulating)
dvander@448
   220
{
dvander@448
   221
	/**
dvander@448
   222
	 * Note: This is all hardcoded rather than delegated to save
dvander@448
   223
	 * precious CPU cycles.
dvander@448
   224
	 */
dvander@448
   225
	float curtime = gpGlobals->curtime;
faluco@587
   226
	if (curtime - g_LastTime >= 0.1f)
dvander@448
   227
	{
dvander@448
   228
		if (m_CheckingAuth
dvander@448
   229
			&& (gpGlobals->curtime - g_LastAuthCheck > 0.7f))
dvander@448
   230
		{
dvander@448
   231
			g_LastAuthCheck = gpGlobals->curtime;
dvander@448
   232
			g_Players.RunAuthChecks();
dvander@448
   233
		}
faluco@587
   234
faluco@587
   235
		g_Timers.RunFrame();
dvander@448
   236
		g_LastTime = curtime;
dvander@448
   237
	}
faluco@587
   238
dvander@531
   239
	if (g_pOnGameFrame && g_pOnGameFrame->GetFunctionCount())
dvander@531
   240
	{
dvander@531
   241
		g_pOnGameFrame->Execute(NULL);
dvander@531
   242
	}
dvander@448
   243
}
dvander@448
   244
faluco@333
   245
void SourceModBase::LevelShutdown()
faluco@333
   246
{
faluco@333
   247
	if (m_ExecPluginReload)
faluco@333
   248
	{
faluco@333
   249
		g_PluginSys.ReloadOrUnloadPlugins();
faluco@333
   250
		m_ExecPluginReload = false;
faluco@333
   251
	}
faluco@333
   252
}
faluco@333
   253
faluco@484
   254
bool SourceModBase::IsMapLoading() const
dvander@315
   255
{
dvander@315
   256
	return m_IsMapLoading;
dvander@315
   257
}
dvander@315
   258
dvander@209
   259
void SourceModBase::DoGlobalPluginLoads()
dvander@209
   260
{
dvander@209
   261
	char config_path[PLATFORM_MAX_PATH];
dvander@209
   262
	char plugins_path[PLATFORM_MAX_PATH];
dvander@209
   263
dvander@317
   264
	BuildPath(Path_SM, config_path, 
dvander@209
   265
		sizeof(config_path),
dvander@317
   266
		"configs/plugin_settings.cfg");
dvander@317
   267
	BuildPath(Path_SM, plugins_path,
dvander@209
   268
		sizeof(plugins_path),
dvander@317
   269
		"plugins");
dvander@209
   270
dvander@397
   271
	/* Load any auto extensions */
dvander@397
   272
	g_Extensions.TryAutoload();
dvander@397
   273
dvander@315
   274
	/* Run the first pass */
dvander@211
   275
	g_PluginSys.LoadAll_FirstPass(config_path, plugins_path);
dvander@213
   276
dvander@315
   277
	/* Mark any extensions as loaded */
dvander@315
   278
	g_Extensions.MarkAllLoaded();
dvander@315
   279
dvander@213
   280
	/* No modules yet, it's safe to call this from here */
dvander@213
   281
	g_PluginSys.LoadAll_SecondPass();
dvander@315
   282
dvander@315
   283
	/* Re-mark any extensions as loaded */
dvander@315
   284
	g_Extensions.MarkAllLoaded();
dvander@211
   285
}
dvander@211
   286
dvander@317
   287
size_t SourceModBase::BuildPath(PathType type, char *buffer, size_t maxlength, char *format, ...)
dvander@317
   288
{
dvander@317
   289
	char _buffer[PLATFORM_MAX_PATH+1];
dvander@317
   290
	va_list ap;
dvander@317
   291
dvander@317
   292
	va_start(ap, format);
dvander@317
   293
	vsnprintf(_buffer, PLATFORM_MAX_PATH, format, ap);
dvander@317
   294
	va_end(ap);
dvander@317
   295
dvander@317
   296
	const char *base = NULL;
dvander@317
   297
	if (type == Path_Game)
dvander@317
   298
	{
dvander@317
   299
		base = GetModPath();
dvander@317
   300
	} else if (type == Path_SM) {
dvander@317
   301
		base = GetSourceModPath();
dvander@345
   302
	} else if (type == Path_SM_Rel) {
dvander@345
   303
		base = m_SMRelDir;
dvander@317
   304
	}
dvander@317
   305
dvander@317
   306
	if (base)
dvander@317
   307
	{
dvander@317
   308
		return g_LibSys.PathFormat(buffer, maxlength, "%s/%s", base, _buffer);
dvander@317
   309
	} else {
dvander@317
   310
		return g_LibSys.PathFormat(buffer, maxlength, "%s", _buffer);
dvander@317
   311
	}
dvander@317
   312
}
dvander@317
   313
faluco@289
   314
void SourceModBase::CloseSourceMod()
faluco@289
   315
{
dvander@531
   316
	if (g_pOnGameFrame)
dvander@531
   317
	{
dvander@531
   318
		g_Forwards.ReleaseForward(g_pOnGameFrame);
dvander@531
   319
	}
dvander@531
   320
faluco@289
   321
	/* Notify! */
faluco@289
   322
	SMGlobalClass *pBase = SMGlobalClass::head;
faluco@289
   323
	while (pBase)
faluco@289
   324
	{
faluco@289
   325
		pBase->OnSourceModShutdown();
faluco@289
   326
		pBase = pBase->m_pGlobalClassNext;
faluco@289
   327
	}
faluco@289
   328
faluco@484
   329
	/* Delete all data packs */
faluco@484
   330
	CStack<CDataPack *>::iterator iter;
faluco@484
   331
	CDataPack *pd;
faluco@484
   332
	for (iter=m_freepacks.begin(); iter!=m_freepacks.end(); iter++)
faluco@484
   333
	{
faluco@484
   334
		pd = (*iter);
faluco@484
   335
		delete pd;
faluco@484
   336
	}
faluco@484
   337
	m_freepacks.popall();
faluco@484
   338
faluco@289
   339
	/* Notify! */
faluco@289
   340
	pBase = SMGlobalClass::head;
faluco@289
   341
	while (pBase)
faluco@289
   342
	{
faluco@289
   343
		pBase->OnSourceModAllShutdown();
faluco@289
   344
		pBase = pBase->m_pGlobalClassNext;
faluco@289
   345
	}
faluco@289
   346
dvander@496
   347
	if (enginePatch)
dvander@496
   348
	{
dvander@496
   349
		SH_RELEASE_CALLCLASS(enginePatch);
dvander@496
   350
		enginePatch = NULL;
dvander@496
   351
	}
dvander@496
   352
dvander@532
   353
	if (gamedllPatch)
dvander@532
   354
	{
dvander@532
   355
		SH_RELEASE_CALLCLASS(gamedllPatch);
dvander@532
   356
		gamedllPatch = NULL;
dvander@532
   357
	}
dvander@532
   358
faluco@333
   359
	SH_REMOVE_HOOK_MEMFUNC(IServerGameDLL, LevelInit, gamedll, this, &SourceModBase::LevelInit, false);
faluco@333
   360
	SH_REMOVE_HOOK_MEMFUNC(IServerGameDLL, LevelShutdown, gamedll, this, &SourceModBase::LevelShutdown, false);
dvander@448
   361
	SH_REMOVE_HOOK_MEMFUNC(IServerGameDLL, GameFrame, gamedll, this, &SourceModBase::GameFrame, false);
faluco@333
   362
faluco@289
   363
	/* Rest In Peace */
faluco@289
   364
	ShutdownJIT();
faluco@289
   365
}
faluco@289
   366
dvander@317
   367
void SourceModBase::LogMessage(IExtension *pExt, const char *format, ...)
dvander@317
   368
{
dvander@317
   369
	IExtensionInterface *pAPI = pExt->GetAPI();
dvander@317
   370
	const char *tag = pAPI->GetExtensionTag();
dvander@317
   371
	char buffer[2048];
dvander@317
   372
	va_list ap;
dvander@317
   373
dvander@317
   374
	va_start(ap, format);
dvander@317
   375
	vsnprintf(buffer, sizeof(buffer), format, ap);
dvander@317
   376
	va_end(ap);
dvander@317
   377
dvander@317
   378
	if (tag)
dvander@317
   379
	{
dvander@317
   380
		g_Logger.LogMessage("[%s] %s", tag, buffer);
dvander@317
   381
	} else {
dvander@317
   382
		g_Logger.LogMessage("%s", buffer);
dvander@317
   383
	}
dvander@317
   384
}
dvander@317
   385
dvander@317
   386
void SourceModBase::LogError(IExtension *pExt, const char *format, ...)
dvander@317
   387
{
dvander@317
   388
	IExtensionInterface *pAPI = pExt->GetAPI();
dvander@317
   389
	const char *tag = pAPI->GetExtensionTag();
dvander@317
   390
	char buffer[2048];
dvander@317
   391
	va_list ap;
dvander@317
   392
dvander@317
   393
	va_start(ap, format);
dvander@317
   394
	vsnprintf(buffer, sizeof(buffer), format, ap);
dvander@317
   395
	va_end(ap);
dvander@317
   396
dvander@317
   397
	if (tag)
dvander@317
   398
	{
dvander@317
   399
		g_Logger.LogError("[%s] %s", tag, buffer);
dvander@317
   400
	} else {
dvander@317
   401
		g_Logger.LogError("%s", buffer);
dvander@317
   402
	}
dvander@317
   403
}
dvander@317
   404
dvander@347
   405
size_t SourceModBase::FormatString(char *buffer, size_t maxlength, IPluginContext *pContext, const cell_t *params, unsigned int param)
dvander@347
   406
{
dvander@347
   407
	char *fmt;
dvander@347
   408
dvander@347
   409
	pContext->LocalToString(params[param], &fmt);
dvander@347
   410
dvander@347
   411
	int lparam = ++param;
dvander@347
   412
dvander@347
   413
	return atcprintf(buffer, maxlength, fmt, pContext, params, &lparam);
dvander@347
   414
}
dvander@347
   415
faluco@484
   416
const char *SourceModBase::GetSourceModPath() const
dvander@209
   417
{
dvander@209
   418
	return m_SMBaseDir;
dvander@209
   419
}
dvander@211
   420
faluco@484
   421
const char *SourceModBase::GetModPath() const
dvander@255
   422
{
dvander@255
   423
	return g_BaseDir.c_str();
dvander@255
   424
}
dvander@255
   425
faluco@422
   426
void SourceModBase::SetGlobalTarget(unsigned int index)
faluco@422
   427
{
faluco@422
   428
	m_target = index;
faluco@422
   429
}
faluco@422
   430
dvander@448
   431
void SourceModBase::SetAuthChecking(bool set)
dvander@448
   432
{
dvander@448
   433
	m_CheckingAuth = set;
dvander@448
   434
}
dvander@448
   435
faluco@422
   436
unsigned int SourceModBase::GetGlobalTarget() const
faluco@422
   437
{
faluco@422
   438
	return m_target;
faluco@422
   439
}
faluco@422
   440
faluco@484
   441
IDataPack *SourceModBase::CreateDataPack()
faluco@484
   442
{
faluco@484
   443
	CDataPack *pack;
faluco@484
   444
	if (m_freepacks.empty())
faluco@484
   445
	{
faluco@484
   446
		pack = new CDataPack;
faluco@484
   447
	} else {
faluco@484
   448
		pack = m_freepacks.front();
faluco@484
   449
		m_freepacks.pop();
faluco@484
   450
		pack->Initialize();
faluco@484
   451
	}
faluco@484
   452
	return pack;
faluco@484
   453
}
faluco@484
   454
faluco@484
   455
void SourceModBase::FreeDataPack(IDataPack *pack)
faluco@484
   456
{
faluco@484
   457
	m_freepacks.push(static_cast<CDataPack *>(pack));
faluco@484
   458
}
faluco@484
   459
faluco@484
   460
Handle_t SourceModBase::GetDataPackHandleType(bool readonly)
faluco@484
   461
{
faluco@484
   462
	//:TODO:
faluco@484
   463
	return 0;
faluco@484
   464
}
faluco@484
   465
dvander@211
   466
SMGlobalClass *SMGlobalClass::head = NULL;
dvander@211
   467
dvander@211
   468
SMGlobalClass::SMGlobalClass()
dvander@211
   469
{
dvander@211
   470
	m_pGlobalClassNext = SMGlobalClass::head;
dvander@211
   471
	SMGlobalClass::head = this;
dvander@211
   472
}