core/ForwardSys.cpp
author David Anderson <dvander@alliedmods.net>
Sat Dec 19 18:16:41 2009 -0800 (2009-12-19)
changeset 2883 1d7b415cef73
parent 2411 8dfaa3d730b5
child 2890 54f2a62d6198
permissions -rw-r--r--
Add ability to change dontBroadcast status on hooked events (bug 3886, r=ds).
     1 /**
     2  * vim: set ts=4 sw=4 tw=99 noet :
     3  * =============================================================================
     4  * SourceMod
     5  * Copyright (C) 2004-2008 AlliedModders LLC.  All rights reserved.
     6  * =============================================================================
     7  *
     8  * This program is free software; you can redistribute it and/or modify it under
     9  * the terms of the GNU General Public License, version 3.0, as published by the
    10  * Free Software Foundation.
    11  * 
    12  * This program is distributed in the hope that it will be useful, but WITHOUT
    13  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
    14  * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
    15  * details.
    16  *
    17  * You should have received a copy of the GNU General Public License along with
    18  * this program.  If not, see <http://www.gnu.org/licenses/>.
    19  *
    20  * As a special exception, AlliedModders LLC gives you permission to link the
    21  * code of this program (as well as its derivative works) to "Half-Life 2," the
    22  * "Source Engine," the "SourcePawn JIT," and any Game MODs that run on software
    23  * by the Valve Corporation.  You must obey the GNU General Public License in
    24  * all respects for all other code used.  Additionally, AlliedModders LLC grants
    25  * this exception to all derivative works.  AlliedModders LLC defines further
    26  * exceptions, found in LICENSE.txt (as of this writing, version JULY-31-2007),
    27  * or <http://www.sourcemod.net/license.php>.
    28  *
    29  * Version: $Id$
    30  */
    31 
    32 #include <assert.h>
    33 #include <stdarg.h>
    34 #include <string.h>
    35 #include "ForwardSys.h"
    36 #include "PluginSys.h"
    37 #include "ShareSys.h"
    38 #include "DebugReporter.h"
    39 
    40 CForwardManager g_Forwards;
    41 
    42 /**
    43  * Genesis turns to its source, reduction occurs stepwise although the essence is all one.
    44  * End of line.  FTL system check.
    45  *
    46  * :TODO: WHAT NEEDS TO BE TESTED IN THIS BEAST
    47  * VARARG FUNCTIONS:
    48  * - Pushing no varargs
    49  */
    50 
    51 // :TODO: IMPORTANT!!! The result pointer arg in the execute function maybe invalid if the forward fails
    52 // so later evaluation of this result may cause problems on higher levels of abstraction. DOCUMENT OR FIX ALL FORWARDS!
    53 
    54 CForwardManager::~CForwardManager()
    55 {
    56 	CStack<CForward *>::iterator iter;
    57 	for (iter=m_FreeForwards.begin(); iter!=m_FreeForwards.end(); iter++)
    58 	{
    59 		delete (*iter);
    60 	}
    61 	m_FreeForwards.popall();
    62 }
    63 
    64 void CForwardManager::OnSourceModAllInitialized()
    65 {
    66 	g_PluginSys.AddPluginsListener(this);
    67 	g_ShareSys.AddInterface(NULL, this);
    68 }
    69 
    70 IForward *CForwardManager::CreateForward(const char *name, ExecType et, unsigned int num_params, const ParamType *types, ...)
    71 {
    72 	CForward *fwd;
    73 	va_list ap;
    74 	va_start(ap, types);
    75 	
    76 	fwd = CForward::CreateForward(name, et, num_params, types, ap);
    77 
    78 	va_end(ap);
    79 
    80 	if (fwd)
    81 	{
    82 		g_PluginSys.AddFunctionsToForward(name, fwd);
    83 
    84 		m_managed.push_back(fwd);
    85 	}
    86 
    87 	return fwd;
    88 }
    89 
    90 IChangeableForward *CForwardManager::CreateForwardEx(const char *name, ExecType et, int num_params, const ParamType *types, ...)
    91 {
    92 	CForward *fwd;
    93 	va_list ap;
    94 	va_start(ap, types);
    95 
    96 	fwd = CForward::CreateForward(name, et, num_params, types, ap);
    97 
    98 	va_end(ap);
    99 
   100 	if (fwd)
   101 	{
   102 		m_unmanaged.push_back(fwd);
   103 	}
   104 
   105 	return fwd;
   106 }
   107 
   108 void CForwardManager::OnPluginLoaded(IPlugin *plugin)
   109 {
   110 	/* Attach any globally managed forwards */
   111 	List<CForward *>::iterator iter;
   112 	CForward *fwd;
   113 
   114 	for (iter=m_managed.begin(); iter!=m_managed.end(); iter++)
   115 	{
   116 		fwd = (*iter);
   117 		IPluginFunction *pFunc = plugin->GetBaseContext()->GetFunctionByName(fwd->GetForwardName());
   118 		if (pFunc)
   119 		{
   120 			fwd->AddFunction(pFunc);
   121 		}
   122 	}
   123 }
   124 
   125 void CForwardManager::OnPluginUnloaded(IPlugin *plugin)
   126 {
   127 	List<CForward *>::iterator iter;
   128 	CForward *fwd;
   129 
   130 	for (iter=m_managed.begin(); iter!=m_managed.end(); iter++)
   131 	{
   132 		fwd = (*iter);
   133 		fwd->RemoveFunctionsOfPlugin(plugin);
   134 	}
   135 
   136 	for (iter=m_unmanaged.begin(); iter!=m_unmanaged.end(); iter++)
   137 	{
   138 		fwd = (*iter);
   139 		fwd->RemoveFunctionsOfPlugin(plugin);
   140 	}
   141 }
   142 
   143 IForward *CForwardManager::FindForward(const char *name, IChangeableForward **ifchng)
   144 {
   145 	List<CForward *>::iterator iter;
   146 	CForward *fwd;
   147 
   148 	for (iter=m_managed.begin(); iter!=m_managed.end(); iter++)
   149 	{
   150 		fwd = (*iter);
   151 		if (strcmp(fwd->GetForwardName(), name) == 0)
   152 		{
   153 			if (ifchng)
   154 			{
   155 				*ifchng = NULL;
   156 			}
   157 			return fwd;
   158 		}
   159 	}
   160 
   161 	for (iter=m_unmanaged.begin(); iter!=m_unmanaged.end(); iter++)
   162 	{
   163 		fwd = (*iter);
   164 		if (strcmp(fwd->GetForwardName(), name) == 0)
   165 		{
   166 			if (ifchng)
   167 			{
   168 				*ifchng = fwd;
   169 			}
   170 			return fwd;
   171 		}
   172 	}
   173 
   174 	if (ifchng)
   175 	{
   176 		*ifchng = NULL;
   177 	}
   178 
   179 	return NULL;
   180 }
   181 
   182 void CForwardManager::ReleaseForward(IForward *forward)
   183 {
   184 	ForwardFree(static_cast<CForward *>(forward));
   185 }
   186 
   187 void CForwardManager::ForwardFree(CForward *fwd)
   188 {
   189     if (fwd == NULL)
   190     {
   191         return;
   192     }
   193 
   194 	m_FreeForwards.push(fwd);
   195 	m_managed.remove(fwd);
   196 }
   197 
   198 CForward *CForwardManager::ForwardMake()
   199 {
   200 	CForward *fwd;
   201 	if (m_FreeForwards.empty())
   202 	{
   203 		fwd = new CForward;
   204 	} else {
   205 		fwd = m_FreeForwards.front();
   206 		m_FreeForwards.pop();
   207 	}
   208 	return fwd;
   209 }
   210 
   211 void CForwardManager::OnPluginPauseChange(IPlugin *plugin, bool paused)
   212 {
   213 	/* No longer used */
   214 }
   215 
   216 /*************************************
   217  * ACTUAL FORWARD API IMPLEMENTATION *
   218  *************************************/
   219 
   220 CForward *CForward::CreateForward(const char *name, ExecType et, unsigned int num_params, const ParamType *types, va_list ap)
   221 {
   222 	ParamType _types[SP_MAX_EXEC_PARAMS];
   223 
   224 	if (num_params > SP_MAX_EXEC_PARAMS)
   225 	{
   226 		return NULL;
   227 	}
   228 	
   229 	if (types == NULL && num_params)
   230 	{
   231 		for (unsigned int i=0; i<num_params; i++)
   232 		{
   233 			_types[i] = (ParamType)va_arg(ap, int);
   234 			if (_types[i] == Param_VarArgs && (i != num_params - 1))
   235 			{
   236 				return NULL;
   237 			}
   238 		}
   239 		types = _types;
   240 	} else {
   241 		for (unsigned int i=0; i<num_params; i++)
   242 		{
   243 			_types[i] = types[i];
   244 			if (types[i] == Param_VarArgs && (i != num_params - 1))
   245 			{
   246 				return NULL;
   247 			}
   248 		}
   249 	}
   250 
   251 	/* First parameter can never be varargs */
   252 	if (num_params && _types[0] == Param_VarArgs)
   253 	{
   254 		return NULL;
   255 	}
   256 
   257 	CForward *pForward = g_Forwards.ForwardMake();
   258 	pForward->m_curparam = 0;
   259 	pForward->m_ExecType = et;
   260 	snprintf(pForward->m_name, FORWARDS_NAME_MAX, "%s", name ? name : "");
   261 	
   262 	for (unsigned int i=0; i<num_params; i++)
   263 	{
   264 		pForward->m_types[i] = _types[i];
   265 	}
   266 
   267 	if (num_params && _types[num_params-1] == Param_VarArgs)
   268 	{
   269 		pForward->m_varargs = num_params--;
   270 	} else {
   271 		pForward->m_varargs = false;
   272 	}
   273 
   274 	pForward->m_numparams = num_params;
   275 	pForward->m_errstate = SP_ERROR_NONE;
   276 
   277 	pForward->m_functions.clear();
   278 
   279 	return pForward;
   280 }
   281 
   282 int CForward::Execute(cell_t *result, IForwardFilter *filter)
   283 {
   284 	if (m_errstate)
   285 	{
   286 		int err = m_errstate;
   287 		Cancel();
   288 		return err;
   289 	}
   290 
   291 	FuncIter iter = m_functions.begin();
   292 	IPluginFunction *func;
   293 	cell_t cur_result = 0;
   294 	cell_t high_result = 0;
   295 	cell_t low_result = 0;
   296 	int err;
   297 	unsigned int failed=0, success=0;
   298 	unsigned int num_params = m_curparam;
   299 	FwdParamInfo temp_info[SP_MAX_EXEC_PARAMS];
   300 	FwdParamInfo *param;
   301 	ParamType type;
   302 
   303 	/* Save local, reset */
   304 	memcpy(temp_info, m_params, sizeof(m_params));
   305 	m_curparam = 0;
   306 
   307 	for (iter=m_functions.begin(); iter!=m_functions.end(); iter++)
   308 	{
   309 		func = (*iter);
   310 
   311 		if (filter)
   312 			filter->Preprocess(func, temp_info);
   313 
   314 		for (unsigned int i=0; i<num_params; i++)
   315 		{
   316 			int err = SP_ERROR_PARAM;
   317 			param = &temp_info[i];
   318 
   319 			if (i >= m_numparams || m_types[i] == Param_Any)
   320 			{
   321 				type = param->pushedas;
   322 			}
   323 			else
   324 			{
   325 				type = m_types[i];
   326 			}
   327 
   328 			if ((i >= m_numparams) || (type & SP_PARAMFLAG_BYREF))
   329 			{
   330 				/* If we're byref or we're vararg, we always push everything by ref.
   331 				 * Even if they're byval, we must push them byref.
   332 				 */
   333 				if (type == Param_String)
   334 				{
   335 					err = func->PushStringEx((char *)param->byref.orig_addr, param->byref.cells, param->byref.sz_flags, param->byref.flags);
   336 				}
   337 				else if (type == Param_Float || type == Param_Cell)
   338 				{
   339 					err = func->PushCellByRef(&param->val); 
   340 				}
   341 				else
   342 				{
   343 					err = func->PushArray(param->byref.orig_addr, param->byref.cells, param->byref.flags);
   344 					assert(type == Param_Array || type == Param_FloatByRef || type == Param_CellByRef);
   345 				}
   346 			}
   347 			else
   348 			{
   349 				/* If we're not byref or not vararg, our job is a bit easier. */
   350 				assert(type == Param_Cell || type == Param_Float);
   351 				err = func->PushCell(param->val);
   352 			}
   353 
   354 			if (err != SP_ERROR_NONE)
   355 			{
   356 				g_DbgReporter.GenerateError(func->GetParentContext(), 
   357 					func->GetFunctionID(), 
   358 					err, 
   359 					"Failed to push parameter while executing forward");
   360 				continue;
   361 			}
   362 		}
   363 		
   364 		/* Call the function and deal with the return value. */
   365 		if ((err=func->Execute(&cur_result)) != SP_ERROR_NONE)
   366 		{
   367 			failed++;
   368 		}
   369 		else
   370 		{
   371 			success++;
   372 			switch (m_ExecType)
   373 			{
   374 			case ET_Event:
   375 				{
   376 					if (cur_result > high_result)
   377 					{
   378 						high_result = cur_result;
   379 					}
   380 					break;
   381 				}
   382 			case ET_Hook:
   383 				{
   384 					if (cur_result > high_result)
   385 					{
   386 						high_result = cur_result;
   387 						if ((ResultType)high_result == Pl_Stop)
   388 						{
   389 							goto done;
   390 						}
   391 					}
   392 					break;
   393 				}
   394 			case ET_LowEvent:
   395 				{
   396 					/* Check if the current result is the lowest so far (or if it's the first result) */
   397 					if (cur_result < low_result || success == 1)
   398 					{
   399 						low_result = cur_result;
   400 					}
   401 					break;
   402 				}
   403 			default:
   404 				{
   405 					break;
   406 				}
   407 			}
   408 		}
   409 	}
   410 
   411 done:
   412 
   413 	if (success)
   414 	{
   415 		switch (m_ExecType)
   416 		{
   417 		case ET_Ignore:
   418 			{
   419 				cur_result = 0;
   420 				break;
   421 			}
   422 		case ET_Event:
   423 		case ET_Hook:
   424 			{
   425 				cur_result = high_result;
   426 				break;
   427 			}
   428 		case ET_LowEvent:
   429 			{
   430 				cur_result = low_result;
   431 				break;
   432 			}
   433 		default:
   434 			{
   435 				break;
   436 			}
   437 		}
   438 
   439 		if (result)
   440 		{
   441 			*result = cur_result;
   442 		}
   443 	}
   444 
   445 	return SP_ERROR_NONE;
   446 }
   447 
   448 int CForward::PushCell(cell_t cell)
   449 {
   450 	if (m_curparam < m_numparams)
   451 	{
   452 		if (m_types[m_curparam] == Param_Any)
   453 		{
   454 			m_params[m_curparam].pushedas = Param_Cell;
   455 		} else if (m_types[m_curparam] != Param_Cell) {
   456 			return SetError(SP_ERROR_PARAM);
   457 		}
   458 	} else {
   459 		if (!m_varargs || m_numparams > SP_MAX_EXEC_PARAMS)
   460 		{
   461 			return SetError(SP_ERROR_PARAMS_MAX);
   462 		}
   463 		m_params[m_curparam].pushedas = Param_Cell;
   464 	}
   465 
   466 	m_params[m_curparam++].val = cell;
   467 
   468 	return SP_ERROR_NONE;
   469 }
   470 
   471 int CForward::PushFloat(float number)
   472 {
   473 	if (m_curparam < m_numparams)
   474 	{
   475 		if (m_types[m_curparam] == Param_Any)
   476 		{
   477 			m_params[m_curparam].pushedas = Param_Float;
   478 		} else if (m_types[m_curparam] != Param_Float) {
   479 			return SetError(SP_ERROR_PARAM);
   480 		}
   481 	} else {
   482 		if (!m_varargs || m_numparams > SP_MAX_EXEC_PARAMS)
   483 		{
   484 			return SetError(SP_ERROR_PARAMS_MAX);
   485 		}
   486 		m_params[m_curparam].pushedas = Param_Float;
   487 	}
   488 
   489 	m_params[m_curparam++].val = *(cell_t *)&number;
   490 
   491 	return SP_ERROR_NONE;
   492 }
   493 
   494 int CForward::PushCellByRef(cell_t *cell, int flags)
   495 {
   496 	if (m_curparam < m_numparams)
   497 	{
   498 		if (m_types[m_curparam] == Param_Any)
   499 		{
   500 			m_params[m_curparam].pushedas = Param_CellByRef;
   501 		} else if (m_types[m_curparam] != Param_CellByRef) {
   502 			return SetError(SP_ERROR_PARAM);
   503 		}
   504 	} else {
   505 		if (!m_varargs || m_numparams > SP_MAX_EXEC_PARAMS)
   506 		{
   507 			return SetError(SP_ERROR_PARAMS_MAX);
   508 		}
   509 		m_params[m_curparam].pushedas = Param_CellByRef;
   510 	}
   511 
   512 	_Int_PushArray(cell, 1, flags);
   513 	m_curparam++;
   514 
   515 	return SP_ERROR_NONE;
   516 }
   517 
   518 int CForward::PushFloatByRef(float *num, int flags)
   519 {
   520 	if (m_curparam < m_numparams)
   521 	{
   522 		if (m_types[m_curparam] == Param_Any)
   523 		{
   524 			m_params[m_curparam].pushedas = Param_FloatByRef;
   525 		} else if (m_types[m_curparam] != Param_FloatByRef) {
   526 			return SetError(SP_ERROR_PARAM);
   527 		}
   528 	} else {
   529 		if (!m_varargs || m_numparams > SP_MAX_EXEC_PARAMS)
   530 		{
   531 			return SetError(SP_ERROR_PARAMS_MAX);
   532 		}
   533 		m_params[m_curparam].pushedas = Param_FloatByRef;
   534 	}
   535 
   536 	_Int_PushArray((cell_t *)num, 1, flags);
   537 	m_curparam++;
   538 
   539 	return SP_ERROR_NONE;
   540 }
   541 
   542 void CForward::_Int_PushArray(cell_t *inarray, unsigned int cells, int flags)
   543 {
   544 	m_params[m_curparam].byref.cells = cells;
   545 	m_params[m_curparam].byref.flags = flags;
   546 	m_params[m_curparam].byref.orig_addr = inarray;
   547 }
   548 
   549 int CForward::PushArray(cell_t *inarray, unsigned int cells, int flags)
   550 {
   551 	/* We don't allow this here */
   552 	if (!inarray)
   553 	{
   554 		return SetError(SP_ERROR_PARAM);
   555 	}
   556 
   557 	if (m_curparam < m_numparams)
   558 	{
   559 		if (m_types[m_curparam] == Param_Any)
   560 		{
   561 			m_params[m_curparam].pushedas = Param_Array;
   562 		} else if (m_types[m_curparam] != Param_Array) {
   563 			return SetError(SP_ERROR_PARAM);
   564 		}
   565 	} else {
   566 		if (!m_varargs || m_curparam > SP_MAX_EXEC_PARAMS)
   567 		{
   568 			return SetError(SP_ERROR_PARAMS_MAX);
   569 		}
   570 		m_params[m_curparam].pushedas = Param_Array;
   571 	}
   572 
   573 	_Int_PushArray(inarray, cells, flags);
   574 
   575 	m_curparam++;
   576 
   577 	return SP_ERROR_NONE;
   578 }
   579 
   580 void CForward::_Int_PushString(cell_t *inarray, unsigned int cells, int sz_flags, int cp_flags)
   581 {
   582 	m_params[m_curparam].byref.cells = cells;	/* Notice this contains the char count not cell count */
   583 	m_params[m_curparam].byref.flags = cp_flags;
   584 	m_params[m_curparam].byref.orig_addr = inarray;
   585 	m_params[m_curparam].byref.sz_flags = sz_flags;
   586 }
   587 
   588 int CForward::PushString(const char *string)
   589 {
   590 	if (m_curparam < m_numparams)
   591 	{
   592 		if (m_types[m_curparam] == Param_Any)
   593 		{
   594 			m_params[m_curparam].pushedas = Param_String;
   595 		} else if (m_types[m_curparam] != Param_String) {
   596 			return SetError(SP_ERROR_PARAM);
   597 		}
   598 	} else {
   599 		if (!m_varargs || m_curparam > SP_MAX_EXEC_PARAMS)
   600 		{
   601 			return SetError(SP_ERROR_PARAMS_MAX);
   602 		}
   603 		m_params[m_curparam].pushedas = Param_String;
   604 	}
   605 
   606 	_Int_PushString((cell_t *)string, strlen(string)+1, SM_PARAM_STRING_COPY, 0);
   607 	m_curparam++;
   608 
   609 	return SP_ERROR_NONE;
   610 }
   611 
   612 int CForward::PushStringEx(char *buffer, size_t length, int sz_flags, int cp_flags)
   613 {
   614 	if (m_curparam < m_numparams)
   615 	{
   616 		if (m_types[m_curparam] == Param_Any)
   617 		{
   618 			m_params[m_curparam].pushedas = Param_String;
   619 		} else if (m_types[m_curparam] != Param_String) {
   620 			return SetError(SP_ERROR_PARAM);
   621 		}
   622 	} else {
   623 		if (!m_varargs || m_curparam > SP_MAX_EXEC_PARAMS)
   624 		{
   625 			return SetError(SP_ERROR_PARAMS_MAX);
   626 		}
   627 		m_params[m_curparam].pushedas = Param_String;
   628 	}
   629 
   630 	_Int_PushString((cell_t *)buffer, length, sz_flags, cp_flags);
   631 	m_curparam++;
   632 
   633 	return SP_ERROR_NONE;
   634 }
   635 
   636 void CForward::Cancel()
   637 {
   638 	if (!m_curparam)
   639 	{
   640 		return;
   641 	}
   642 
   643 	m_curparam = 0;
   644 	m_errstate = SP_ERROR_NONE;
   645 }
   646 
   647 bool CForward::AddFunction(IPluginContext *pContext, funcid_t index)
   648 {
   649 	IPluginFunction *pFunc = pContext->GetFunctionById(index);
   650 
   651 	if (!pFunc)
   652 	{
   653 		return false;
   654 	}
   655 
   656 	return AddFunction(pFunc);
   657 }
   658 
   659 bool CForward::RemoveFunction(IPluginContext *pContext, funcid_t index)
   660 {
   661 	IPluginFunction *pFunc = pContext->GetFunctionById(index);
   662 
   663 	if (!pFunc)
   664 	{
   665 		return false;
   666 	}
   667 
   668 	return RemoveFunction(pFunc);
   669 }
   670 
   671 bool CForward::RemoveFunction(IPluginFunction *func)
   672 {
   673 	bool found = false;
   674 	FuncIter iter;
   675 	List<IPluginFunction *> *lst;
   676 
   677 	if (func->IsRunnable())
   678 	{
   679 		lst = &m_functions;
   680 	} else {
   681 		lst = &m_paused;
   682 	}
   683 
   684 	for (iter=m_functions.begin(); iter!=m_functions.end(); iter++)
   685 	{
   686 		if ((*iter) == func)
   687 		{
   688 			found = true;
   689 			lst->erase(iter);
   690 			break;
   691 		}
   692 	}
   693 
   694 	/* Cancel a call, if any */
   695 	if (found || m_curparam)
   696 	{
   697 		func->Cancel();
   698 	}
   699 
   700 	return found;
   701 }
   702 
   703 unsigned int CForward::RemoveFunctionsOfPlugin(IPlugin *plugin)
   704 {
   705 	FuncIter iter;
   706 	IPluginFunction *func;
   707 	unsigned int removed = 0;
   708 	IPluginContext *pContext = plugin->GetBaseContext();
   709 	for (iter=m_functions.begin(); iter!=m_functions.end();)
   710 	{
   711 		func = (*iter);
   712 		if (func->GetParentContext() == pContext)
   713 		{
   714 			iter = m_functions.erase(iter);
   715 			removed++;
   716 		} else {
   717 			iter++;
   718 		}
   719 	}
   720 
   721 	return removed;
   722 }
   723 
   724 bool CForward::AddFunction(IPluginFunction *func)
   725 {
   726 	if (m_curparam)
   727 	{
   728 		return false;
   729 	}
   730 
   731 	if (func->IsRunnable())
   732 	{
   733 		m_functions.push_back(func);
   734 	} else {
   735 		m_paused.push_back(func);
   736 	}
   737 
   738 	return true;
   739 }
   740 
   741 const char *CForward::GetForwardName()
   742 {
   743 	return m_name;
   744 }
   745 
   746 unsigned int CForward::GetFunctionCount()
   747 {
   748 	return m_functions.size();
   749 }
   750 
   751 ExecType CForward::GetExecType()
   752 {
   753 	return m_ExecType;
   754 }