README

   1 surgeon v 0.2 by gonzoj
   2
   3
   4 Installation:
   5 -------------
   6
   7 Since this is a complete rewrite of my old injector, I'll recommend the debug
   8 build. If it's crashing, you know why / where at least (theoretically).
   9
  10 Anyway, to build choose between the standard and the debug build. For the
  11 former run:
  12
  13 $ make
  14
  15 For the latter run:
  16
  17 $ make debug
  18
  19 And eventually install:
  20
  21 $ make install
  22
  23 If you got tired of injecting, type:
  24
  25 $ make remove
  26
  27
  28 Usage:
  29 ------
  30
  31 Injecting a shared object OBJECT into a running process PID with surgeon is
  32 easy:
  33
  34 $ surgeon [-i] PID OBJECT
  35
  36 To unload a shared object from a process, use the toggle -u:
  37
  38 $ surgeon [-u] PID OBJECT
  39
  40 In order to work properly, surgeon needs some (internal) libc functions.
  41 Although it has built-in several ways to resolve those functions, it may occur
  42 that the injection fails. In such a situation it can be useful, to set the
  43 location of libc as well as the offsets for those function manually. The
  44 options which allow that are --libc, --malloc, --free, --dlopen and --dlclose.
  45 To obtain offsets manually, you could use readelf, for example. Run surgeon -h
  46 to learn more.
  47
  48
  49 Note:
  50 -----
  51
  52 This release contains as well two simple shell scripts, which inject / unload
  53 snoogans into Diablo II. I won't bother to explain how to use them, I think it
  54 should be clear enough.