[153] | 1 | /****************************************************************************************
|
---|
| 2 | mach_inject.h $Revision: 1.1.1.1 $
|
---|
| 3 |
|
---|
| 4 | Copyright (c) 2003 Red Shed Software. All rights reserved.
|
---|
| 5 | by Jonathan 'Wolf' Rentzsch (jon * redshed * net)
|
---|
| 6 |
|
---|
| 7 | ************************************************************************************/
|
---|
| 8 |
|
---|
| 9 | /************************************************************************************/ /**
|
---|
| 10 | @mainpage mach_inject
|
---|
| 11 | @author Jonathan 'Wolf' Rentzsch (jon * redshed * net)
|
---|
| 12 |
|
---|
| 13 | This package, coded in C to the Mach API, allows you to "inject" code into an
|
---|
| 14 | arbitrary process. "Injection" means both 1) copying over the necessary code into the
|
---|
| 15 | target's address space and 2) remotely creating a new thread to execute the code.
|
---|
| 16 |
|
---|
| 17 | ************************************************************************************/
|
---|
| 18 |
|
---|
| 19 | #ifndef _mach_inject_
|
---|
| 20 | #define _mach_inject_
|
---|
| 21 |
|
---|
| 22 | #ifdef __cplusplus
|
---|
| 23 | extern "C" {
|
---|
| 24 | #endif
|
---|
| 25 |
|
---|
| 26 | #include <sys/types.h>
|
---|
| 27 | #include <mach/error.h>
|
---|
| 28 | #include <mach/vm_types.h>
|
---|
| 29 | #include <stddef.h>
|
---|
| 30 |
|
---|
| 31 | #define err_threadEntry_image_not_found (err_local|1)
|
---|
| 32 | #define err_threadEntry_init_failed (err_local|2)
|
---|
| 33 |
|
---|
| 34 | #define INJECT_ENTRY injectEntry
|
---|
| 35 | #define INJECT_ENTRY_SYMBOL "injectEntry"
|
---|
| 36 |
|
---|
| 37 | typedef void (*mach_inject_entry)( ptrdiff_t codeOffset, void *paramBlock, size_t paramSize );
|
---|
| 38 |
|
---|
| 39 | /************************************************************************************//**
|
---|
| 40 | Starts executing threadEntry in a new thread in the process specified by
|
---|
| 41 | targetProcess.
|
---|
| 42 |
|
---|
| 43 | @param threadEntry -> Required pointer to injected thread's entry point.
|
---|
| 44 | @param paramBlock -> Optional pointer to block of memory to pass to the
|
---|
| 45 | injected thread.
|
---|
| 46 | @param paramSize -> Optional size of paramBlock.
|
---|
| 47 | @param targetProcess -> Required target process ID.
|
---|
| 48 | @param stackSize -> Optional stack size of threadEntry's thread. Set to zero
|
---|
| 49 | for default (currently 8K usable).
|
---|
| 50 | @result <- mach_error_t
|
---|
| 51 |
|
---|
| 52 | ************************************************************************************/
|
---|
| 53 |
|
---|
| 54 | mach_error_t
|
---|
| 55 | mach_inject(
|
---|
| 56 | const mach_inject_entry threadEntry,
|
---|
| 57 | const void *paramBlock,
|
---|
| 58 | size_t paramSize,
|
---|
| 59 | pid_t targetProcess,
|
---|
| 60 | vm_size_t stackSize );
|
---|
| 61 |
|
---|
| 62 | /************************************************************************************//**
|
---|
| 63 | Given a pointer, returns its Mach-O image and image size.
|
---|
| 64 |
|
---|
| 65 | @param pointer -> Required pointer.
|
---|
| 66 | @param image <- Optional returned pointer to image (really a mach_header).
|
---|
| 67 | @param size <- Optional returned size of the image.
|
---|
| 68 | @result <- mach_error_t
|
---|
| 69 |
|
---|
| 70 | ************************************************************************************/
|
---|
| 71 |
|
---|
| 72 | mach_error_t
|
---|
| 73 | machImageForPointer(
|
---|
| 74 | const void *pointer,
|
---|
| 75 | const void **image,
|
---|
| 76 | unsigned long *size );
|
---|
| 77 |
|
---|
| 78 | #ifdef __cplusplus
|
---|
| 79 | }
|
---|
| 80 | #endif
|
---|
| 81 |
|
---|
| 82 | #endif // _mach_inject_ |
---|