manes/ods/injector.h

   1 /* Quarn OS / Manes / ODS
   2  *
   3  * Injector
   4  *
   5  * Copyright (C) 2008-2009 Pawel Dziepak
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation; either version 2 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License along
  18  * with this program; if not, write to the Free Software Foundation, Inc.,
  19  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  */
  22
  23 #ifndef _INJECTOR_H_
  24 #define _INJECTOR_H_
  25
  26 namespace manes {
  27         namespace ods {
  28                 /**
  29                  * @brief Procedure Call Injector
  30                  * @details This is a base class for procedure call injectors, which
  31                  * allow to modify object vtable in the way that makes it easy
  32                  * to observe and catch all invocations of its methods.
  33                  */
  34                 class injector {
  35                 protected:
  36                         delegate<void*,unsigned char*> catcher;
  37
  38                 public:
  39 #if __GNUC__ == 4
  40                         typedef gcc4_x86_injector default_injector;
  41 #else
  42 #error No injector found for your version of GCC.
  43 #endif
  44
  45                         /**
  46                          * Set function to be called after caught invocation */
  47                         virtual void set_catcher(delegate<unsigned int,unsigned char*>);
  48
  49                         /**
  50                          * @brief Inject catcher functions
  51                          *
  52                          * Inject catcher functions into each invocation of obj method in order
  53                          * to allow transport them through ODS network.
  54                          */
  55                         virtual void inject(void *obj) = 0;
  56                 };
  57         }
  58 }
  59
  60 #endif