sourcehook/sourcehook_impl.h
author Scott Ehlert <ds@alliedmods.net>
Thu Jul 07 18:41:08 2005 +0000 (2005-07-07)
changeset 88 2586c2eb900e
parent 86 0c0c0ab2e9ba
child 90 828fa4d35bdf
permissions -rw-r--r--
One last oops. I really need to install Linux again SOON :(
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
pavolmarko@1
    11
#ifndef __SOURCEHOOK_IMPL_H__
pavolmarko@1
    12
#define __SOURCEHOOK_IMPL_H__
pavolmarko@1
    13
pavolmarko@1
    14
#include "sourcehook.h"
pavolmarko@1
    15
ds@86
    16
#ifdef __linux__
ds@86
    17
#include <signal.h>
ds@86
    18
#include <setjmp.h>
ds@86
    19
#endif
ds@86
    20
pavolmarko@1
    21
// Set this to 1 to enable runtime code generation (faster)
pavolmarko@1
    22
#define SH_RUNTIME_CODEGEN 1
pavolmarko@1
    23
pavolmarko@1
    24
namespace SourceHook
pavolmarko@1
    25
{
pavolmarko@1
    26
	/**
pavolmarko@1
    27
	*	@brief The SourceHook implementation class
pavolmarko@1
    28
	*/
pavolmarko@1
    29
	class CSourceHookImpl : public ISourceHook
pavolmarko@1
    30
	{
pavolmarko@1
    31
		/**
pavolmarko@6
    32
		*	@brief A hook can be removed if you have this information
pavolmarko@1
    33
		*/
pavolmarko@6
    34
		struct RemoveHookInfo
pavolmarko@6
    35
		{
pavolmarko@58
    36
			RemoveHookInfo(Plugin pplug, void *piface, int tpo, HookManagerPubFunc phookman,
pavolmarko@41
    37
				ISHDelegate *phandler, bool ppost)
pavolmarko@58
    38
				: plug(pplug), iface(piface), thisptr_offs(tpo),
pavolmarko@58
    39
				hookman(phookman), handler(phandler), post(ppost)
pavolmarko@6
    40
			{
pavolmarko@6
    41
			}
pavolmarko@6
    42
pavolmarko@6
    43
			Plugin plug;
pavolmarko@6
    44
			void *iface;
pavolmarko@58
    45
			int thisptr_offs;
pavolmarko@41
    46
			HookManagerPubFunc hookman;
pavolmarko@6
    47
			ISHDelegate *handler;
pavolmarko@6
    48
			bool post;
pavolmarko@6
    49
		};
pavolmarko@6
    50
pavolmarko@6
    51
		/**
pavolmarko@6
    52
		*	@brief A list of HookManagerInfo structures
pavolmarko@6
    53
		*/
pavolmarko@6
    54
		typedef std::list<HookManagerInfo> HookManInfoList;
pavolmarko@1
    55
pavolmarko@41
    56
		struct CallClassInfo
pavolmarko@41
    57
		{
pavolmarko@41
    58
			GenericCallClass cc;
pavolmarko@41
    59
			int refcounter;
pavolmarko@41
    60
			bool operator==(void *other)
pavolmarko@41
    61
			{
pavolmarko@41
    62
				return cc.ptr == other;
pavolmarko@41
    63
			}
pavolmarko@41
    64
		};
pavolmarko@1
    65
		/**
pavolmarko@41
    66
		*	@brief A list of CallClass structures
pavolmarko@1
    67
		*/
pavolmarko@41
    68
		typedef std::list<CallClassInfo> Impl_CallClassList;
pavolmarko@1
    69
pavolmarko@1
    70
		Impl_CallClassList m_CallClasses;			//!< A list of already generated callclasses
pavolmarko@6
    71
		HookManInfoList m_HookMans;					//!< A list of hook managers
pavolmarko@1
    72
pavolmarko@1
    73
		/**
pavolmarko@6
    74
		*	@brief Finds a hook manager for a function based on a text-prototype, a vtable offset and a vtable index
pavolmarko@1
    75
		*/
pavolmarko@6
    76
		HookManInfoList::iterator FindHookMan(HookManInfoList::iterator begin, HookManInfoList::iterator end, 
pavolmarko@41
    77
			const char *proto, int vtblofs, int vtblidx);
pavolmarko@1
    78
pavolmarko@41
    79
		void ApplyCallClassPatch(CallClassInfo &cc, int vtbl_offs, int vtbl_idx, void *orig_entry);
pavolmarko@58
    80
		void ApplyCallClassPatches(CallClassInfo &cc);
pavolmarko@58
    81
		void ApplyCallClassPatches(void *ifaceptr, int vtbl_offs, int vtbl_idx, void *orig_entry);
pavolmarko@42
    82
		void RemoveCallClassPatch(CallClassInfo &cc, int vtbl_offs, int vtbl_idx);
pavolmarko@58
    83
		void RemoveCallClassPatches(void *ifaceptr, int vtbl_offs, int vtbl_idx);
pavolmarko@1
    84
ds@86
    85
#ifdef __linux__
ds@86
    86
		/**
ds@86
    87
		*	@brief Checks to see if a memory value can be read from a given pointer.
ds@86
    88
		*
ds@86
    89
		*	@return True if the value can be read and false if it cannot.
ds@86
    90
		*
ds@86
    91
		*	@param ptr The pointer to the memory value.
ds@86
    92
		*	@param len The length of the memory value to be read from the pointer.
ds@86
    93
		*/
ds@86
    94
		static bool IsBadReadPtr(const void *ptr, size_t len);
ds@86
    95
		static void BadReadHandler(int sig);
ds@86
    96
ds@86
    97
		bool m_BadReadCalled;
ds@86
    98
		jmp_buf m_BadReadJmpBuf;
ds@86
    99
#endif
ds@86
   100
pavolmarko@1
   101
		META_RES m_Status, m_PrevRes, m_CurRes;
pavolmarko@1
   102
		const void *m_OrigRet;
pavolmarko@1
   103
		const void *m_OverrideRet;
pavolmarko@1
   104
		void *m_IfacePtr;
pavolmarko@1
   105
	public:
pavolmarko@1
   106
		CSourceHookImpl();
pavolmarko@1
   107
		~CSourceHookImpl();
pavolmarko@1
   108
pavolmarko@1
   109
		/**
pavolmarko@58
   110
		*	@brief Returns the interface version
pavolmarko@58
   111
		*/
pavolmarko@58
   112
		int GetIfaceVersion();
pavolmarko@58
   113
pavolmarko@58
   114
		/**
pavolmarko@58
   115
		*	@brief Returns the implemnetation version
pavolmarko@58
   116
		*/
pavolmarko@58
   117
		int GetImplVersion();
pavolmarko@58
   118
pavolmarko@58
   119
		/**
pavolmarko@6
   120
		*	@brief Make sure that a plugin is not used by any other plugins anymore, and unregister all its hook managers
pavolmarko@1
   121
		*/
pavolmarko@1
   122
		void UnloadPlugin(Plugin plug);
pavolmarko@1
   123
pavolmarko@1
   124
		/**
pavolmarko@6
   125
		*	@brief Shut down the whole system, unregister all hook managers
pavolmarko@1
   126
		*/
pavolmarko@1
   127
		void CompleteShutdown();
pavolmarko@1
   128
pavolmarko@1
   129
		/**
pavolmarko@1
   130
		*	@brief Add a hook.
pavolmarko@1
   131
		*
pavolmarko@1
   132
		*	@return True if the function succeeded, false otherwise
pavolmarko@1
   133
		*
pavolmarko@1
   134
		*	@param plug The unique identifier of the plugin that calls this function
pavolmarko@1
   135
		*	@param iface The interface pointer
pavolmarko@6
   136
		*	@param ifacesize The size of the class iface points to
pavolmarko@6
   137
		*	@param myHookMan A hook manager function that should be capable of handling the function
pavolmarko@1
   138
		*	@param handler A pointer to a FastDelegate containing the hook handler
pavolmarko@1
   139
		*	@param post Set to true if you want a post handler
pavolmarko@1
   140
		*/
pavolmarko@41
   141
		bool AddHook(Plugin plug, void *iface, int thisptr_offs, HookManagerPubFunc myHookMan, ISHDelegate *handler, bool post);
pavolmarko@1
   142
pavolmarko@1
   143
		/**
pavolmarko@1
   144
		*	@brief Removes a hook.
pavolmarko@1
   145
		*
pavolmarko@1
   146
		*	@return True if the function succeeded, false otherwise
pavolmarko@1
   147
		*
pavolmarko@1
   148
		*	@param plug The unique identifier of the plugin that calls this function
pavolmarko@1
   149
		*	@param iface The interface pointer
pavolmarko@41
   150
		*	@param thisptr_offs This pointer adjuster
pavolmarko@41
   151
		*	@param myHookMan A hook manager function that should be capable of handling the function
pavolmarko@41
   152
		*	@param handler A pointer to a FastDelegate containing the hook handler
pavolmarko@41
   153
		*	@param post Set to true if you want a post handler
pavolmarko@41
   154
		*/
pavolmarko@41
   155
		bool RemoveHook(Plugin plug, void *iface, int thisptr_offs, HookManagerPubFunc myHookMan, ISHDelegate *handler, bool post);
pavolmarko@41
   156
pavolmarko@41
   157
		/**
pavolmarko@41
   158
		*	@brief Removes a hook.
pavolmarko@41
   159
		*
pavolmarko@41
   160
		*	@ return True if the function succeeded, false otherwise
pavolmarko@41
   161
		*
pavolmarko@41
   162
		*	@param info A RemoveHookInfo structure, describing the hook
pavolmarko@41
   163
		*/
pavolmarko@41
   164
		bool RemoveHook(RemoveHookInfo info);
pavolmarko@41
   165
pavolmarko@41
   166
		/**
pavolmarko@6
   167
		*	@brief Checks whether a plugin has (a) hook manager(s) that is/are currently used by other plugins
pavolmarko@1
   168
		*
pavolmarko@1
   169
		*	@param plug The unique identifier of the plugin in question
pavolmarko@1
   170
		*/
pavolmarko@1
   171
		bool IsPluginInUse(Plugin plug);
pavolmarko@1
   172
pavolmarko@1
   173
		/**
pavolmarko@8
   174
		*	@brief Pauses all hooks of a plugin
pavolmarko@8
   175
		*
pavolmarko@8
   176
		*	@param plug The unique identifier of the plugin
pavolmarko@8
   177
		*/
pavolmarko@8
   178
		void PausePlugin(Plugin plug);
pavolmarko@8
   179
pavolmarko@8
   180
		/**
pavolmarko@8
   181
		*	@brief Unpauses all hooks of a plugin
pavolmarko@8
   182
		*
pavolmarko@8
   183
		*	@param plug The unique identifier of the plugin
pavolmarko@8
   184
		*/
pavolmarko@8
   185
		void UnpausePlugin(Plugin plug);
pavolmarko@8
   186
pavolmarko@8
   187
		/**
pavolmarko@1
   188
		*	@brief Return a pointer to a callclass. Generate a new one if required.
pavolmarko@1
   189
		*
pavolmarko@1
   190
		*	@param iface The interface pointer
pavolmarko@58
   191
		*	@param size Size of the class instance
pavolmarko@1
   192
		*/
pavolmarko@58
   193
		GenericCallClass *GetCallClass(void *iface, size_t size);
pavolmarko@1
   194
pavolmarko@1
   195
		/**
pavolmarko@1
   196
		*	@brief Release a callclass
pavolmarko@1
   197
		*
pavolmarko@1
   198
		*	@param ptr Pointer to the callclass
pavolmarko@1
   199
		*/
pavolmarko@41
   200
		virtual void ReleaseCallClass(GenericCallClass *ptr);
pavolmarko@1
   201
pavolmarko@1
   202
		virtual void SetRes(META_RES res);				//!< Sets the meta result
pavolmarko@1
   203
		virtual META_RES GetPrevRes();					//!< Gets the meta result of the previously called handler
pavolmarko@1
   204
		virtual META_RES GetStatus();					//!< Gets the highest meta result
pavolmarko@1
   205
		virtual const void *GetOrigRet();				//!< Gets the original result. If not in post function, undefined
pavolmarko@1
   206
		virtual const void *GetOverrideRet();			//!< Gets the override result. If none is specified, NULL
pavolmarko@1
   207
		virtual void *GetIfacePtr();					//!< Gets the interface pointer
pavolmarko@1
   208
pavolmarko@1
   209
		//////////////////////////////////////////////////////////////////////////
pavolmarko@6
   210
		// For hook managers
pavolmarko@58
   211
		virtual META_RES &GetCurResRef();				//!< Gets the reference to the current meta result
pavolmarko@58
   212
		virtual META_RES &GetPrevResRef();				//!< Gets the reference to the previous meta result
pavolmarko@58
   213
		virtual META_RES &GetStatusRef();				//!< Gets the reference to the status variable
pavolmarko@58
   214
		virtual void* &GetIfacePtrRef();				//!< Gets the reference to the iface ptr
pavolmarko@1
   215
		virtual void SetOrigRet(const void *ptr);		//!< Sets the original return pointer
pavolmarko@1
   216
		virtual void SetOverrideRet(const void *ptr);	//!< Sets the override result pointer
pavolmarko@1
   217
	};
pavolmarko@1
   218
}
pavolmarko@1
   219
dvander@34
   220
#endif
dvander@34
   221