core/UserMessages.cpp
author Scott Ehlert <ds@alliedmods.net>
Sun Aug 24 04:35:48 2008 +0000 (2008-08-24)
changeset 2237 4403a982ec91
parent 1952 b7aa2b626807
child 2289 44045ead61cd
permissions -rw-r--r--
Improved bot detection slightly. This was meant to go along with the fix for amb1801.
ds@1952
     1
/**
ds@1952
     2
 * vim: set ts=4 :
ds@1952
     3
 * =============================================================================
ds@1952
     4
 * SourceMod
ds@1952
     5
 * Copyright (C) 2004-2008 AlliedModders LLC.  All rights reserved.
ds@1952
     6
 * =============================================================================
ds@1952
     7
 *
ds@1952
     8
 * This program is free software; you can redistribute it and/or modify it under
ds@1952
     9
 * the terms of the GNU General Public License, version 3.0, as published by the
ds@1952
    10
 * Free Software Foundation.
ds@1952
    11
 * 
ds@1952
    12
 * This program is distributed in the hope that it will be useful, but WITHOUT
ds@1952
    13
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
ds@1952
    14
 * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
ds@1952
    15
 * details.
ds@1952
    16
 *
ds@1952
    17
 * You should have received a copy of the GNU General Public License along with
ds@1952
    18
 * this program.  If not, see <http://www.gnu.org/licenses/>.
ds@1952
    19
 *
ds@1952
    20
 * As a special exception, AlliedModders LLC gives you permission to link the
ds@1952
    21
 * code of this program (as well as its derivative works) to "Half-Life 2," the
ds@1952
    22
 * "Source Engine," the "SourcePawn JIT," and any Game MODs that run on software
ds@1952
    23
 * by the Valve Corporation.  You must obey the GNU General Public License in
ds@1952
    24
 * all respects for all other code used.  Additionally, AlliedModders LLC grants
ds@1952
    25
 * this exception to all derivative works.  AlliedModders LLC defines further
ds@1952
    26
 * exceptions, found in LICENSE.txt (as of this writing, version JULY-31-2007),
ds@1952
    27
 * or <http://www.sourcemod.net/license.php>.
ds@1952
    28
 *
ds@1952
    29
 * Version: $Id$
ds@1952
    30
 */
ds@1952
    31
ds@1952
    32
#include "UserMessages.h"
ds@1952
    33
#include "sm_stringutil.h"
ds@1952
    34
ds@1952
    35
UserMessages g_UserMsgs;
ds@1952
    36
ds@1952
    37
SH_DECL_HOOK2(IVEngineServer, UserMessageBegin, SH_NOATTRIB, 0, bf_write *, IRecipientFilter *, int);
ds@1952
    38
SH_DECL_HOOK0_void(IVEngineServer, MessageEnd, SH_NOATTRIB, 0);
ds@1952
    39
ds@1952
    40
UserMessages::UserMessages() : m_InterceptBuffer(m_pBase, 2500)
ds@1952
    41
{
ds@1952
    42
	m_Names = sm_trie_create();
ds@1952
    43
	m_HookCount = 0;
ds@1952
    44
	m_InExec = false;
ds@1952
    45
	m_InHook = false;
ds@1952
    46
	m_CurFlags = 0;
ds@1952
    47
	m_CurId = INVALID_MESSAGE_ID;
ds@1952
    48
}
ds@1952
    49
ds@1952
    50
UserMessages::~UserMessages()
ds@1952
    51
{
ds@1952
    52
	sm_trie_destroy(m_Names);
ds@1952
    53
ds@1952
    54
	CStack<ListenerInfo *>::iterator iter;
ds@1952
    55
	for (iter=m_FreeListeners.begin(); iter!=m_FreeListeners.end(); iter++)
ds@1952
    56
	{
ds@1952
    57
		delete (*iter);
ds@1952
    58
	}
ds@1952
    59
	m_FreeListeners.popall();
ds@1952
    60
}
ds@1952
    61
ds@1952
    62
void UserMessages::OnSourceModStartup(bool late)
ds@1952
    63
{
ds@1952
    64
	/* -1 means SourceMM was unable to get the user message list */
ds@1952
    65
	m_FallbackSearch = (g_SMAPI->GetUserMessageCount() == -1);
ds@1952
    66
}
ds@1952
    67
ds@1952
    68
void UserMessages::OnSourceModAllInitialized()
ds@1952
    69
{
ds@1952
    70
	g_ShareSys.AddInterface(NULL, this);
ds@1952
    71
}
ds@1952
    72
ds@1952
    73
void UserMessages::OnSourceModAllShutdown()
ds@1952
    74
{
ds@1952
    75
	if (m_HookCount)
ds@1952
    76
	{
ds@1952
    77
		SH_REMOVE_HOOK_MEMFUNC(IVEngineServer, UserMessageBegin, engine, this, &UserMessages::OnStartMessage_Pre, false);
ds@1952
    78
		SH_REMOVE_HOOK_MEMFUNC(IVEngineServer, UserMessageBegin, engine, this, &UserMessages::OnStartMessage_Post, true);
ds@1952
    79
		SH_REMOVE_HOOK_MEMFUNC(IVEngineServer, MessageEnd, engine, this, &UserMessages::OnMessageEnd_Pre, false);
ds@1952
    80
		SH_REMOVE_HOOK_MEMFUNC(IVEngineServer, MessageEnd, engine, this, &UserMessages::OnMessageEnd_Post, true);
ds@1952
    81
	}
ds@1952
    82
	m_HookCount = 0;
ds@1952
    83
}
ds@1952
    84
ds@1952
    85
int UserMessages::GetMessageIndex(const char *msg)
ds@1952
    86
{
ds@1952
    87
	int msgid;
ds@1952
    88
ds@1952
    89
	if (!sm_trie_retrieve(m_Names, msg, reinterpret_cast<void **>(&msgid)))
ds@1952
    90
	{
ds@1952
    91
		if (m_FallbackSearch)
ds@1952
    92
		{
ds@1952
    93
			char msgbuf[64];
ds@1952
    94
			int size;
ds@1952
    95
			msgid = 0;
ds@1952
    96
ds@1952
    97
			while (gamedll->GetUserMessageInfo(msgid, msgbuf, sizeof(msgbuf), size))
ds@1952
    98
			{
ds@1952
    99
				if (strcmp(msgbuf, msg) == 0)
ds@1952
   100
				{
ds@1952
   101
					sm_trie_insert(m_Names, msg, reinterpret_cast<void *>(msgid));
ds@1952
   102
					return msgid;
ds@1952
   103
				}
ds@1952
   104
				msgid++;
ds@1952
   105
			}
ds@1952
   106
		}
ds@1952
   107
ds@1952
   108
		msgid = g_SMAPI->FindUserMessage(msg);
ds@1952
   109
ds@1952
   110
		if (msgid != INVALID_MESSAGE_ID)
ds@1952
   111
		{
ds@1952
   112
			sm_trie_insert(m_Names, msg, reinterpret_cast<void *>(msgid));
ds@1952
   113
		}
ds@1952
   114
	}
ds@1952
   115
ds@1952
   116
	return msgid;
ds@1952
   117
}
ds@1952
   118
ds@1952
   119
bool UserMessages::GetMessageName(int msgid, char *buffer, size_t maxlength) const
ds@1952
   120
{
ds@1952
   121
	if (m_FallbackSearch)
ds@1952
   122
	{
ds@1952
   123
		int size;
ds@1952
   124
		return gamedll->GetUserMessageInfo(msgid, buffer, maxlength, size);
ds@1952
   125
	}
ds@1952
   126
ds@1952
   127
	const char *msg = g_SMAPI->GetUserMessage(msgid);
ds@1952
   128
ds@1952
   129
	if (msg)
ds@1952
   130
	{
ds@1952
   131
		strncopy(buffer, msg, maxlength);
ds@1952
   132
		return true;
ds@1952
   133
	}
ds@1952
   134
ds@1952
   135
	return false;
ds@1952
   136
}
ds@1952
   137
ds@1952
   138
bf_write *UserMessages::StartMessage(int msg_id, const cell_t players[], unsigned int playersNum, int flags)
ds@1952
   139
{
ds@1952
   140
	bf_write *buffer;
ds@1952
   141
ds@1952
   142
	if (m_InExec || m_InHook)
ds@1952
   143
	{
ds@1952
   144
		return NULL;
ds@1952
   145
	}
ds@1952
   146
	if (msg_id < 0 || msg_id >= 255)
ds@1952
   147
	{
ds@1952
   148
		return NULL;
ds@1952
   149
	}
ds@1952
   150
ds@1952
   151
	m_CellRecFilter.Initialize(players, playersNum);
ds@1952
   152
ds@1952
   153
	m_CurFlags = flags;
ds@1952
   154
	if (m_CurFlags & USERMSG_INITMSG)
ds@1952
   155
	{
ds@1952
   156
		m_CellRecFilter.SetToInit(true);
ds@1952
   157
	}
ds@1952
   158
	if (m_CurFlags & USERMSG_RELIABLE)
ds@1952
   159
	{
ds@1952
   160
		m_CellRecFilter.SetToReliable(true);
ds@1952
   161
	}
ds@1952
   162
ds@1952
   163
	m_InExec = true;
ds@1952
   164
ds@1952
   165
	if (m_CurFlags & USERMSG_BLOCKHOOKS)
ds@1952
   166
	{
ds@1952
   167
		buffer = ENGINE_CALL(UserMessageBegin)(static_cast<IRecipientFilter *>(&m_CellRecFilter), msg_id);
ds@1952
   168
	} else {
ds@1952
   169
		buffer = engine->UserMessageBegin(static_cast<IRecipientFilter *>(&m_CellRecFilter), msg_id);
ds@1952
   170
	}
ds@1952
   171
ds@1952
   172
	return buffer;
ds@1952
   173
}
ds@1952
   174
ds@1952
   175
bool UserMessages::EndMessage()
ds@1952
   176
{
ds@1952
   177
	if (!m_InExec)
ds@1952
   178
	{
ds@1952
   179
		return false;
ds@1952
   180
	}
ds@1952
   181
ds@1952
   182
	if (m_CurFlags & USERMSG_BLOCKHOOKS)
ds@1952
   183
	{
ds@1952
   184
		ENGINE_CALL(MessageEnd)();
ds@1952
   185
	} else {
ds@1952
   186
		engine->MessageEnd();
ds@1952
   187
	}
ds@1952
   188
ds@1952
   189
	m_InExec = false;
ds@1952
   190
	m_CurFlags = 0;
ds@1952
   191
	m_CellRecFilter.Reset();
ds@1952
   192
ds@1952
   193
	return true;
ds@1952
   194
}
ds@1952
   195
ds@1952
   196
bool UserMessages::HookUserMessage(int msg_id, IUserMessageListener *pListener, bool intercept)
ds@1952
   197
{
ds@1952
   198
	if (msg_id < 0 || msg_id >= 255)
ds@1952
   199
	{
ds@1952
   200
		return false;
ds@1952
   201
	}
ds@1952
   202
ds@1952
   203
	ListenerInfo *pInfo;
ds@1952
   204
	if (m_FreeListeners.empty())
ds@1952
   205
	{
ds@1952
   206
		pInfo = new ListenerInfo;
ds@1952
   207
	} else {
ds@1952
   208
		pInfo = m_FreeListeners.front();
ds@1952
   209
		m_FreeListeners.pop();
ds@1952
   210
	}
ds@1952
   211
ds@1952
   212
	pInfo->Callback = pListener;
ds@1952
   213
	pInfo->IsHooked = false;
ds@1952
   214
	pInfo->KillMe = false;
ds@1952
   215
ds@1952
   216
	if (!m_HookCount++)
ds@1952
   217
	{
ds@1952
   218
		SH_ADD_HOOK_MEMFUNC(IVEngineServer, UserMessageBegin, engine, this, &UserMessages::OnStartMessage_Pre, false);
ds@1952
   219
		SH_ADD_HOOK_MEMFUNC(IVEngineServer, UserMessageBegin, engine, this, &UserMessages::OnStartMessage_Post, true);
ds@1952
   220
		SH_ADD_HOOK_MEMFUNC(IVEngineServer, MessageEnd, engine, this, &UserMessages::OnMessageEnd_Pre, false);
ds@1952
   221
		SH_ADD_HOOK_MEMFUNC(IVEngineServer, MessageEnd, engine, this, &UserMessages::OnMessageEnd_Post, true);
ds@1952
   222
	}
ds@1952
   223
ds@1952
   224
	if (intercept)
ds@1952
   225
	{
ds@1952
   226
		m_msgIntercepts[msg_id].push_back(pInfo);
ds@1952
   227
	} else {
ds@1952
   228
		m_msgHooks[msg_id].push_back(pInfo);
ds@1952
   229
	}
ds@1952
   230
ds@1952
   231
	return true;
ds@1952
   232
}
ds@1952
   233
ds@1952
   234
bool UserMessages::UnhookUserMessage(int msg_id, IUserMessageListener *pListener, bool intercept)
ds@1952
   235
{	
ds@1952
   236
	MsgList *pList;
ds@1952
   237
	MsgIter iter;
ds@1952
   238
	ListenerInfo *pInfo;
ds@1952
   239
	bool deleted = false;
ds@1952
   240
ds@1952
   241
	if (msg_id < 0 || msg_id >= 255)
ds@1952
   242
	{
ds@1952
   243
		return false;
ds@1952
   244
	}
ds@1952
   245
ds@1952
   246
	pList = (intercept) ? &m_msgIntercepts[msg_id] : &m_msgHooks[msg_id];
ds@1952
   247
	for (iter=pList->begin(); iter!=pList->end(); iter++)
ds@1952
   248
	{
ds@1952
   249
		pInfo = (*iter);
ds@1952
   250
		if (pInfo->Callback == pListener)
ds@1952
   251
		{
ds@1952
   252
			if (pInfo->IsHooked)
ds@1952
   253
			{
ds@1952
   254
				pInfo->KillMe = true;
ds@1952
   255
				return true;
ds@1952
   256
			}
ds@1952
   257
			pList->erase(iter);
ds@1952
   258
			deleted = true;
ds@1952
   259
			break;
ds@1952
   260
		}
ds@1952
   261
	}
ds@1952
   262
ds@1952
   263
	if (deleted)
ds@1952
   264
	{
ds@1952
   265
		_DecRefCounter();
ds@1952
   266
	}
ds@1952
   267
ds@1952
   268
	return deleted;
ds@1952
   269
}
ds@1952
   270
ds@1952
   271
void UserMessages::_DecRefCounter()
ds@1952
   272
{
ds@1952
   273
	if (--m_HookCount == 0)
ds@1952
   274
	{
ds@1952
   275
		SH_REMOVE_HOOK_MEMFUNC(IVEngineServer, UserMessageBegin, engine, this, &UserMessages::OnStartMessage_Pre, false);
ds@1952
   276
		SH_REMOVE_HOOK_MEMFUNC(IVEngineServer, UserMessageBegin, engine, this, &UserMessages::OnStartMessage_Post, true);
ds@1952
   277
		SH_REMOVE_HOOK_MEMFUNC(IVEngineServer, MessageEnd, engine, this, &UserMessages::OnMessageEnd_Pre, false);
ds@1952
   278
		SH_REMOVE_HOOK_MEMFUNC(IVEngineServer, MessageEnd, engine, this, &UserMessages::OnMessageEnd_Post, true);
ds@1952
   279
	}
ds@1952
   280
}
ds@1952
   281
ds@1952
   282
bf_write *UserMessages::OnStartMessage_Pre(IRecipientFilter *filter, int msg_type)
ds@1952
   283
{
ds@1952
   284
	bool is_intercept_empty = m_msgIntercepts[msg_type].empty();
ds@1952
   285
	bool is_hook_empty = m_msgHooks[msg_type].empty();
ds@1952
   286
ds@1952
   287
	if ((is_intercept_empty && is_hook_empty)
ds@1952
   288
		|| (m_InExec && (m_CurFlags & USERMSG_BLOCKHOOKS)))
ds@1952
   289
	{
ds@1952
   290
		m_InHook = false;
ds@1952
   291
		RETURN_META_VALUE(MRES_IGNORED, NULL);
ds@1952
   292
	}
ds@1952
   293
ds@1952
   294
	m_CurId = msg_type;
ds@1952
   295
	m_CurRecFilter = filter;
ds@1952
   296
	m_InHook = true;
ds@1952
   297
	m_BlockEndPost = false;
ds@1952
   298
ds@1952
   299
	if (!is_intercept_empty)
ds@1952
   300
	{
ds@1952
   301
		m_InterceptBuffer.Reset();
ds@1952
   302
		RETURN_META_VALUE(MRES_SUPERCEDE, &m_InterceptBuffer);
ds@1952
   303
	}
ds@1952
   304
ds@1952
   305
	RETURN_META_VALUE(MRES_IGNORED, NULL);
ds@1952
   306
}
ds@1952
   307
ds@1952
   308
bf_write *UserMessages::OnStartMessage_Post(IRecipientFilter *filter, int msg_type)
ds@1952
   309
{
ds@1952
   310
	if (!m_InHook)
ds@1952
   311
	{
ds@1952
   312
		RETURN_META_VALUE(MRES_IGNORED, NULL);
ds@1952
   313
	}
ds@1952
   314
ds@1952
   315
	m_OrigBuffer = META_RESULT_ORIG_RET(bf_write *);
ds@1952
   316
ds@1952
   317
	RETURN_META_VALUE(MRES_IGNORED, NULL);
ds@1952
   318
}
ds@1952
   319
ds@1952
   320
void UserMessages::OnMessageEnd_Post()
ds@1952
   321
{
ds@1952
   322
	if (!m_InHook || m_BlockEndPost)
ds@1952
   323
	{
ds@1952
   324
		RETURN_META(MRES_IGNORED);
ds@1952
   325
	}
ds@1952
   326
ds@1952
   327
	MsgList *pList;
ds@1952
   328
	MsgIter iter;
ds@1952
   329
	ListenerInfo *pInfo;
ds@1952
   330
ds@1952
   331
	pList = &m_msgIntercepts[m_CurId];
ds@1952
   332
	for (iter=pList->begin(); iter!=pList->end(); )
ds@1952
   333
	{
ds@1952
   334
		pInfo = (*iter);
ds@1952
   335
		pInfo->IsHooked = true;
ds@1952
   336
		pInfo->Callback->OnUserMessageSent(m_CurId);
ds@1952
   337
ds@1952
   338
		if (pInfo->KillMe)
ds@1952
   339
		{
ds@1952
   340
			iter = pList->erase(iter);
ds@1952
   341
			m_FreeListeners.push(pInfo);
ds@1952
   342
			_DecRefCounter();
ds@1952
   343
			continue;
ds@1952
   344
		}
ds@1952
   345
ds@1952
   346
		pInfo->IsHooked = false;
ds@1952
   347
		iter++;
ds@1952
   348
	}
ds@1952
   349
ds@1952
   350
	m_InHook = false;
ds@1952
   351
ds@1952
   352
	pList = &m_msgHooks[m_CurId];
ds@1952
   353
	for (iter=pList->begin(); iter!=pList->end(); )
ds@1952
   354
	{
ds@1952
   355
		pInfo = (*iter);
ds@1952
   356
		pInfo->IsHooked = true;
ds@1952
   357
		pInfo->Callback->OnUserMessageSent(m_CurId);
ds@1952
   358
ds@1952
   359
		if (pInfo->KillMe)
ds@1952
   360
		{
ds@1952
   361
			iter = pList->erase(iter);
ds@1952
   362
			m_FreeListeners.push(pInfo);
ds@1952
   363
			_DecRefCounter();
ds@1952
   364
			continue;
ds@1952
   365
		}
ds@1952
   366
ds@1952
   367
		pInfo->IsHooked = false;
ds@1952
   368
		iter++;
ds@1952
   369
	}
ds@1952
   370
}
ds@1952
   371
ds@1952
   372
void UserMessages::OnMessageEnd_Pre()
ds@1952
   373
{
ds@1952
   374
	if (!m_InHook)
ds@1952
   375
	{
ds@1952
   376
		RETURN_META(MRES_IGNORED);
ds@1952
   377
	}
ds@1952
   378
ds@1952
   379
	MsgList *pList;
ds@1952
   380
	MsgIter iter;
ds@1952
   381
	ListenerInfo *pInfo;
ds@1952
   382
ds@1952
   383
	ResultType res;
ds@1952
   384
	bool intercepted = false;
ds@1952
   385
	bool handled = false;
ds@1952
   386
ds@1952
   387
	pList = &m_msgIntercepts[m_CurId];
ds@1952
   388
	for (iter=pList->begin(); iter!=pList->end(); )
ds@1952
   389
	{
ds@1952
   390
		pInfo = (*iter);
ds@1952
   391
		pInfo->IsHooked = true;
ds@1952
   392
		res = pInfo->Callback->InterceptUserMessage(m_CurId, &m_InterceptBuffer, m_CurRecFilter);
ds@1952
   393
ds@1952
   394
		intercepted = true;
ds@1952
   395
ds@1952
   396
		switch (res)
ds@1952
   397
		{
ds@1952
   398
		case Pl_Stop:
ds@1952
   399
			{
ds@1952
   400
				if (pInfo->KillMe)
ds@1952
   401
				{
ds@1952
   402
					pList->erase(iter);
ds@1952
   403
					m_FreeListeners.push(pInfo);
ds@1952
   404
					_DecRefCounter();
ds@1952
   405
					goto supercede;
ds@1952
   406
				}
ds@1952
   407
				pInfo->IsHooked = false;
ds@1952
   408
				goto supercede;
ds@1952
   409
			}
ds@1952
   410
		case Pl_Handled:
ds@1952
   411
			{
ds@1952
   412
				handled = true;
ds@1952
   413
				if (pInfo->KillMe)
ds@1952
   414
				{
ds@1952
   415
					iter = pList->erase(iter);
ds@1952
   416
					m_FreeListeners.push(pInfo);
ds@1952
   417
					_DecRefCounter();
ds@1952
   418
					continue;
ds@1952
   419
				}
ds@1952
   420
				break;
ds@1952
   421
			}
ds@1952
   422
		default:
ds@1952
   423
			{
ds@1952
   424
				if (pInfo->KillMe)
ds@1952
   425
				{
ds@1952
   426
					iter = pList->erase(iter);
ds@1952
   427
					m_FreeListeners.push(pInfo);
ds@1952
   428
					_DecRefCounter();
ds@1952
   429
					continue;
ds@1952
   430
				}
ds@1952
   431
				break;
ds@1952
   432
			}
ds@1952
   433
		}
ds@1952
   434
		pInfo->IsHooked = false;
ds@1952
   435
		iter++;
ds@1952
   436
	}
ds@1952
   437
ds@1952
   438
	if (handled)
ds@1952
   439
	{
ds@1952
   440
		goto supercede;
ds@1952
   441
	}
ds@1952
   442
ds@1952
   443
	if (intercepted)
ds@1952
   444
	{
ds@1952
   445
		bf_write *engine_bfw;
ds@1952
   446
ds@1952
   447
		engine_bfw = ENGINE_CALL(UserMessageBegin)(m_CurRecFilter, m_CurId);
ds@1952
   448
		m_ReadBuffer.StartReading(m_InterceptBuffer.GetBasePointer(), m_InterceptBuffer.GetNumBytesWritten());
ds@1952
   449
		engine_bfw->WriteBitsFromBuffer(&m_ReadBuffer, m_InterceptBuffer.GetNumBitsWritten());
ds@1952
   450
		ENGINE_CALL(MessageEnd)();
ds@1952
   451
	}
ds@1952
   452
ds@1952
   453
	pList = &m_msgHooks[m_CurId];
ds@1952
   454
	for (iter=pList->begin(); iter!=pList->end(); )
ds@1952
   455
	{
ds@1952
   456
		pInfo = (*iter);
ds@1952
   457
		pInfo->IsHooked = true;
ds@1952
   458
		pInfo->Callback->OnUserMessage(m_CurId, m_OrigBuffer, m_CurRecFilter);
ds@1952
   459
ds@1952
   460
		if (pInfo->KillMe)
ds@1952
   461
		{
ds@1952
   462
			iter = pList->erase(iter);
ds@1952
   463
			m_FreeListeners.push(pInfo);
ds@1952
   464
			_DecRefCounter();
ds@1952
   465
			continue;
ds@1952
   466
		}
ds@1952
   467
ds@1952
   468
		pInfo->IsHooked = false;
ds@1952
   469
		iter++;
ds@1952
   470
	}
ds@1952
   471
ds@1952
   472
	RETURN_META((intercepted) ? MRES_SUPERCEDE : MRES_IGNORED);
ds@1952
   473
supercede:
ds@1952
   474
	m_InHook = false;
ds@1952
   475
	m_BlockEndPost = true;
ds@1952
   476
	RETURN_META(MRES_SUPERCEDE);
ds@1952
   477
}