sourcehook/sh_memfuncinfo.h
author Pavol Marko <pavolmarko@gmail.com>
Sun May 01 14:30:52 2005 +0000 (2005-05-01)
changeset 49 ec95d7681407
parent 37 f4d069676dc2
child 58 71016f952503
permissions -rw-r--r--
Vafmt works now
pavolmarko@1
     1
/* ======== SourceHook ========
dvander@10
     2
* Copyright (C) 2004-2005 Metamod:Source Development Team
pavolmarko@1
     3
* No warranties of any kind
pavolmarko@1
     4
*
dvander@10
     5
* License: zlib/libpng
dvander@10
     6
*
dvander@10
     7
* Author(s): Pavol "PM OnoTo" Marko
pavolmarko@1
     8
* ============================
pavolmarko@1
     9
*/
pavolmarko@1
    10
dvander@10
    11
/**
dvander@10
    12
 * @brief This file provides a way for getting information about a member function.
dvander@10
    13
 * @file sh_memfuncinfo.h
dvander@10
    14
 */
pavolmarko@1
    15
pavolmarko@1
    16
#ifndef __SHINT_MEMFUNC_INFO_H__
pavolmarko@1
    17
#define __SHINT_MEMFUNC_INFO_H__
pavolmarko@1
    18
pavolmarko@1
    19
namespace SourceHook
pavolmarko@1
    20
{
pavolmarko@1
    21
pavolmarko@1
    22
	// Don Clugston:
pavolmarko@1
    23
	//		implicit_cast< >
pavolmarko@1
    24
	// I believe this was originally going to be in the C++ standard but 
pavolmarko@1
    25
	// was left out by accident. It's even milder than static_cast.
pavolmarko@1
    26
	// I use it instead of static_cast<> to emphasize that I'm not doing
pavolmarko@1
    27
	// anything nasty. 
pavolmarko@1
    28
	// Usage is identical to static_cast<>
pavolmarko@1
    29
	template <class OutputClass, class InputClass>
pavolmarko@1
    30
	inline OutputClass implicit_cast(InputClass input){
pavolmarko@1
    31
		return input;
pavolmarko@1
    32
	}
pavolmarko@1
    33
pavolmarko@1
    34
pavolmarko@1
    35
	struct MemFuncInfo
pavolmarko@1
    36
	{
pavolmarko@1
    37
		bool isVirtual;		// Is the function virtual?
pavolmarko@1
    38
		int thisptroffs;	// The this pointer the function expects to be called with
pavolmarko@1
    39
							// If -1, you need to call the GetFuncInfo_GetThisPtr function
pavolmarko@1
    40
		int vtblindex;		// The function's index in the vtable (0-based, 1=second entry, 2=third entry, ...)
pavolmarko@1
    41
		int vtbloffs;		// The vtable pointer
pavolmarko@1
    42
	};
pavolmarko@1
    43
pavolmarko@1
    44
	// Ideas by Don Clugston.
pavolmarko@1
    45
	// Check out his excellent paper: http://www.codeproject.com/cpp/FastDelegate.asp
pavolmarko@1
    46
pavolmarko@1
    47
	template<int N> struct MFI_Impl
pavolmarko@1
    48
	{
pavolmarko@1
    49
		template<class MFP> static inline void GetFuncInfo(MFP *mfp, MemFuncInfo &out)
pavolmarko@1
    50
		{
pavolmarko@1
    51
			static char weird_memfunc_pointer_exclamation_mark_arrow_error[N-1000];
pavolmarko@1
    52
		}
pavolmarko@1
    53
	}; 
pavolmarko@1
    54
pavolmarko@1
    55
# if SH_COMP == SH_COMP_GCC
pavolmarko@1
    56
pavolmarko@1
    57
	template<> struct MFI_Impl<8>   // All of these have size==8
pavolmarko@1
    58
	{
pavolmarko@1
    59
		struct GCC_MemFunPtr
pavolmarko@1
    60
		{
pavolmarko@1
    61
			union
pavolmarko@1
    62
			{
pavolmarko@1
    63
				void *funcadr;				// always even
pavolmarko@1
    64
				int vtable_index_plus1;		//  = vindex+1, always odd
pavolmarko@1
    65
			};
pavolmarko@1
    66
			int delta;
pavolmarko@1
    67
		};
dvander@37
    68
		template<class MFP> static inline void GetFuncInfo(MFP mfp, MemFuncInfo &out)
pavolmarko@1
    69
		{
dvander@37
    70
			GCC_MemFunPtr *mfp_detail = (GCC_MemFunPtr*)&mfp;
pavolmarko@1
    71
			out.thisptroffs = mfp_detail->delta;
pavolmarko@1
    72
			if (mfp_detail->vtable_index_plus1 & 1)
pavolmarko@1
    73
			{
pavolmarko@1
    74
				out.vtblindex = (mfp_detail->vtable_index_plus1 - 1) / 4;
pavolmarko@1
    75
				out.vtbloffs = 0;
pavolmarko@1
    76
				out.isVirtual = true;
pavolmarko@1
    77
			}
pavolmarko@1
    78
			else
pavolmarko@1
    79
				out.isVirtual = false;
pavolmarko@1
    80
		}
pavolmarko@1
    81
	}; 
pavolmarko@1
    82
pavolmarko@1
    83
# elif SH_COMP == SH_COMP_MSVC
pavolmarko@1
    84
pavolmarko@1
    85
	namespace
pavolmarko@1
    86
	{
pavolmarko@1
    87
		int MFI_GetVtblOffset(void *mfp)
pavolmarko@1
    88
		{
pavolmarko@1
    89
			unsigned char *addr = (unsigned char*)mfp;
pavolmarko@1
    90
			if (*addr == 0xE9)		// Jmp
pavolmarko@1
    91
			{
pavolmarko@1
    92
				// May or may not be!
pavolmarko@1
    93
				// Check where it'd jump
pavolmarko@1
    94
				addr += 5 /*size of the instruction*/ + *(unsigned long*)(addr + 1);
pavolmarko@1
    95
			}
pavolmarko@1
    96
	
pavolmarko@1
    97
			// Check whether it's a virtual function call
pavolmarko@1
    98
			// They look like this:
pavolmarko@1
    99
			// 004125A0 8B 01            mov         eax,dword ptr [ecx] 
pavolmarko@1
   100
			// 004125A2 FF 60 04         jmp         dword ptr [eax+4]
pavolmarko@1
   101
			//		==OR==
pavolmarko@1
   102
			// 00411B80 8B 01            mov         eax,dword ptr [ecx] 
pavolmarko@49
   103
			// 00411B82 FF A0 18 03 00 00 jmp         dword ptr [eax+318h]
pavolmarko@49
   104
pavolmarko@49
   105
			// However, for vararg functions, they look like this:
pavolmarko@49
   106
			// 0048F0B0 8B 44 24 04      mov         eax,dword ptr [esp+4]
pavolmarko@49
   107
			// 0048F0B4 8B 00            mov         eax,dword ptr [eax]
pavolmarko@49
   108
			// 0048F0B6 FF 60 08         jmp         dword ptr [eax+8]
pavolmarko@49
   109
			//		==OR==
pavolmarko@49
   110
			// 0048F0B0 8B 44 24 04      mov         eax,dword ptr [esp+4]
pavolmarko@49
   111
			// 0048F0B4 8B 00            mov         eax,dword ptr [eax]
pavolmarko@49
   112
			// 00411B82 FF A0 18 03 00 00 jmp         dword ptr [eax+318h]
pavolmarko@49
   113
			
pavolmarko@49
   114
			// With varargs, the this pointer is passed as if it was the first argument
pavolmarko@49
   115
pavolmarko@49
   116
			bool ok = false;
pavolmarko@49
   117
			if (addr[0] == 0x8B && addr[1] == 0x44 && addr[2] == 0x24 && addr[3] == 0x04 &&
pavolmarko@49
   118
				addr[4] == 0x8B && addr[5] == 0x00)
pavolmarko@49
   119
			{
pavolmarko@49
   120
				addr += 6;
pavolmarko@49
   121
				ok = true;
pavolmarko@49
   122
			}
pavolmarko@49
   123
			else if (addr[0] == 0x8B && addr[1] == 0x01)
pavolmarko@49
   124
			{
pavolmarko@49
   125
				addr += 2;
pavolmarko@49
   126
				ok = true;
pavolmarko@49
   127
			}
pavolmarko@49
   128
			if (!ok)
pavolmarko@49
   129
				return -1;
pavolmarko@49
   130
pavolmarko@49
   131
			if (*addr++ == 0xFF)
pavolmarko@1
   132
			{
pavolmarko@1
   133
				if (*addr == 0x60)
pavolmarko@1
   134
				{
pavolmarko@1
   135
					return *++addr / 4;
pavolmarko@1
   136
				}
pavolmarko@1
   137
				else if (*addr == 0xA0)
pavolmarko@1
   138
				{
pavolmarko@1
   139
					return *((unsigned int*)++addr) / 4;
pavolmarko@1
   140
				}
pavolmarko@1
   141
				else if (*addr == 0x20)
pavolmarko@1
   142
					return 0;
pavolmarko@1
   143
				else
pavolmarko@1
   144
					return -1;
pavolmarko@1
   145
			}
pavolmarko@1
   146
			return -1;
pavolmarko@1
   147
		}
pavolmarko@1
   148
	}
pavolmarko@1
   149
pavolmarko@1
   150
	template<> struct MFI_Impl<4>   // simple ones
pavolmarko@1
   151
	{
pavolmarko@1
   152
		template<class MFP> static inline void GetFuncInfo(MFP mfp, MemFuncInfo &out)
pavolmarko@1
   153
		{
pavolmarko@1
   154
			out.vtblindex = MFI_GetVtblOffset(*(void**)&mfp);
pavolmarko@1
   155
			out.isVirtual = out.vtblindex >= 0 ? true : false;
pavolmarko@1
   156
			out.thisptroffs = 0;
pavolmarko@1
   157
			out.vtbloffs = 0;
pavolmarko@1
   158
		}
pavolmarko@1
   159
	};
pavolmarko@1
   160
pavolmarko@1
   161
	template<> struct MFI_Impl<8>   // more complicated ones!
pavolmarko@1
   162
	{
pavolmarko@1
   163
		struct MSVC_MemFunPtr2
pavolmarko@1
   164
		{
pavolmarko@1
   165
			void *funcadr;
pavolmarko@1
   166
			int delta;
pavolmarko@1
   167
		};
pavolmarko@1
   168
		template<class MFP> static inline void GetFuncInfo(MFP mfp, MemFuncInfo &out)
pavolmarko@1
   169
		{
pavolmarko@1
   170
			out.vtblindex = MFI_GetVtblOffset(*(void**)&mfp);
pavolmarko@1
   171
			out.isVirtual = out.vtblindex >= 0 ? true : false;
pavolmarko@3
   172
			out.thisptroffs = reinterpret_cast<MSVC_MemFunPtr2*>(&mfp)->delta;
pavolmarko@1
   173
			out.vtbloffs = 0;
pavolmarko@1
   174
		}
pavolmarko@1
   175
	};
pavolmarko@1
   176
pavolmarko@1
   177
	// By Don Clugston, adapted
pavolmarko@1
   178
	template<> struct MFI_Impl<12>   // WOW IT"S GETTING BIGGER OMGOMOGMG
pavolmarko@1
   179
	{
pavolmarko@1
   180
		class __single_inheritance GenericClass;
pavolmarko@1
   181
		class GenericClass {};
pavolmarko@1
   182
pavolmarko@1
   183
		struct MicrosoftVirtualMFP {
pavolmarko@1
   184
			void (GenericClass::*codeptr)(); // points to the actual member function
pavolmarko@1
   185
			int delta;		// #bytes to be added to the 'this' pointer
pavolmarko@1
   186
			int vtable_index; // or 0 if no virtual inheritance
pavolmarko@1
   187
		};
pavolmarko@1
   188
pavolmarko@1
   189
		struct GenericVirtualClass : virtual public GenericClass
pavolmarko@1
   190
		{
pavolmarko@1
   191
			typedef GenericVirtualClass * (GenericVirtualClass::*ProbePtrType)();
pavolmarko@1
   192
			GenericVirtualClass * GetThis() { return this; }
pavolmarko@1
   193
		};
pavolmarko@1
   194
pavolmarko@1
   195
		template<class MFP> static inline void GetFuncInfo(MFP mfp, MemFuncInfo &out)
pavolmarko@1
   196
		{
pavolmarko@1
   197
			out.vtblindex = MFI_GetVtblOffset(*(void**)&mfp);
pavolmarko@1
   198
			out.isVirtual = out.vtblindex >= 0 ? true : false;
pavolmarko@1
   199
			// This pointer
pavolmarko@3
   200
			/*
pavolmarko@1
   201
			union {
pavolmarko@1
   202
				MFP func;
pavolmarko@1
   203
				GenericClass* (T::*ProbeFunc)();
pavolmarko@1
   204
				MicrosoftVirtualMFP s;
pavolmarko@1
   205
			} u;
pavolmarko@1
   206
			u.func = mfp;
pavolmarko@1
   207
			union {
pavolmarko@1
   208
				GenericVirtualClass::ProbePtrType virtfunc;
pavolmarko@1
   209
				MicrosoftVirtualMFP s;
pavolmarko@1
   210
			} u2;
pavolmarko@1
   211
pavolmarko@1
   212
			// Check that the horrible_cast<>s will work
pavolmarko@1
   213
			typedef int ERROR_CantUsehorrible_cast[sizeof(mfp)==sizeof(u.s)
pavolmarko@1
   214
				&& sizeof(mfp)==sizeof(u.ProbeFunc)
pavolmarko@1
   215
				&& sizeof(u2.virtfunc)==sizeof(u2.s) ? 1 : -1];
pavolmarko@1
   216
			// Unfortunately, taking the address of a MF prevents it from being inlined, so 
pavolmarko@1
   217
			// this next line can't be completely optimised away by the compiler.
pavolmarko@1
   218
			u2.virtfunc = &GenericVirtualClass::GetThis;
pavolmarko@1
   219
			u.s.codeptr = u2.s.codeptr;
pavolmarko@1
   220
			out.thisptroffs = (reinterpret_cast<T*>(NULL)->*u.ProbeFunc)();
pavolmarko@3
   221
			*/
pavolmarko@3
   222
			out.thisptroffs = -1;
pavolmarko@1
   223
			out.vtbloffs = 0;
pavolmarko@1
   224
		}
pavolmarko@1
   225
	};
pavolmarko@1
   226
pavolmarko@1
   227
	// Don: Nasty hack for Microsoft and Intel (IA32 and Itanium)
pavolmarko@1
   228
	// unknown_inheritance classes go here 
pavolmarko@1
   229
	// This is probably the ugliest bit of code I've ever written. Look at the casts!
pavolmarko@1
   230
	// There is a compiler bug in MSVC6 which prevents it from using this code.
pavolmarko@1
   231
	template<> struct MFI_Impl<16>   // THE BIGGEST ONE!!!1GABEN
pavolmarko@1
   232
	{
pavolmarko@1
   233
		template<class MFP> static inline void GetFuncInfo(MFP mfp, MemFuncInfo &out)
pavolmarko@1
   234
		{
pavolmarko@1
   235
			out.vtblindex = MFI_GetVtblOffset(*(void**)&mfp);
pavolmarko@1
   236
			out.isVirtual = out.vtblindex >= 0 ? true : false;
pavolmarko@1
   237
pavolmarko@1
   238
			// The member function pointer is 16 bytes long. We can't use a normal cast, but
pavolmarko@1
   239
			// we can use a union to do the conversion.
pavolmarko@1
   240
			union {
pavolmarko@1
   241
				MFP func;
pavolmarko@1
   242
				// In VC++ and ICL, an unknown_inheritance member pointer 
pavolmarko@1
   243
				// is internally defined as:
pavolmarko@1
   244
				struct {
pavolmarko@1
   245
					void *m_funcaddress; // points to the actual member function
pavolmarko@1
   246
					int delta;		// #bytes to be added to the 'this' pointer
pavolmarko@1
   247
					int vtordisp;		// #bytes to add to 'this' to find the vtable
pavolmarko@1
   248
					int vtable_index; // or 0 if no virtual inheritance
pavolmarko@1
   249
				} s;
pavolmarko@1
   250
			} u;
pavolmarko@1
   251
			// Check that the horrible_cast will work
pavolmarko@1
   252
			typedef int ERROR_CantUsehorrible_cast[sizeof(u.func)==sizeof(u.s)? 1 : -1];
pavolmarko@1
   253
			u.func = mfp;
pavolmarko@1
   254
			int virtual_delta = 0;
pavolmarko@1
   255
			if (u.s.vtable_index) { // Virtual inheritance is used
pavolmarko@1
   256
				/*
pavolmarko@1
   257
				// First, get to the vtable. 
pavolmarko@1
   258
				// It is 'vtordisp' bytes from the start of the class.
pavolmarko@1
   259
				int * vtable = *reinterpret_cast<int **>(
pavolmarko@1
   260
					reinterpret_cast<char *>(thisptr) + u.s.vtordisp );
pavolmarko@1
   261
pavolmarko@1
   262
				// 'vtable_index' tells us where in the table we should be looking.
pavolmarko@1
   263
				virtual_delta = u.s.vtordisp + *reinterpret_cast<const int *>( 
pavolmarko@1
   264
					reinterpret_cast<const char *>(vtable) + u.s.vtable_index);
pavolmarko@1
   265
			// The int at 'virtual_delta' gives us the amount to add to 'this'.
pavolmarko@1
   266
			// Finally we can add the three components together. Phew!
pavolmarko@1
   267
			out.thisptr = reinterpret_cast<void *>(
pavolmarko@1
   268
				reinterpret_cast<char *>(thisptr) + u.s.delta + virtual_delta);
pavolmarko@1
   269
				*/
pavolmarko@1
   270
				out.vtbloffs = u.s.vtordisp;
pavolmarko@1
   271
				out.thisptroffs = -1;
pavolmarko@1
   272
			}
pavolmarko@1
   273
			else
pavolmarko@1
   274
			{
pavolmarko@1
   275
				out.vtbloffs = out.vtblindex < 0 ? 0 : u.s.delta;
pavolmarko@1
   276
				out.thisptroffs = u.s.delta;
pavolmarko@1
   277
			}
pavolmarko@1
   278
		};
pavolmarko@1
   279
	};
pavolmarko@1
   280
# else
pavolmarko@1
   281
#  error Unsupported compiler
pavolmarko@1
   282
# endif
pavolmarko@1
   283
pavolmarko@1
   284
	template<class X> inline void GetFuncInfo(X mfp, MemFuncInfo &out)
pavolmarko@1
   285
	{
pavolmarko@1
   286
		MFI_Impl<sizeof(mfp)>::GetFuncInfo(mfp, out);
pavolmarko@1
   287
	}
pavolmarko@1
   288
pavolmarko@1
   289
}
pavolmarko@1
   290
dvander@34
   291
#endif
dvander@34
   292