Dynamic Instrumentation Tool Platform
Data Structures | Macros | Typedefs | Enumerations | Functions
drwrap.h File Reference

Header for DynamoRIO Function Wrapping and Replacing Extension. More...

#include "drext.h"

Data Structures

struct  _drwrap_stats_t
 

Macros

#define DRMGR_PRIORITY_NAME_DRWRAP   "drwrap"
 
#define DRWRAP_REPLACE_NATIVE_DATA_SLOT   SPILL_SLOT_2
 
#define DRWRAP_REPLACE_NATIVE_SP_SLOT   SPILL_SLOT_3
 

Typedefs

typedef ptr_int_t atomic_int_t
 
typedef struct _drwrap_stats_t drwrap_stats_t
 

Enumerations

enum  {
  DRMGR_PRIORITY_APP2APP_DRWRAP = -500,
  DRMGR_PRIORITY_INSERT_DRWRAP = 500,
  DRMGR_PRIORITY_FAULT_DRWRAP = 500
}
 
enum  drwrap_wrap_flags_t {
  DRWRAP_FLAGS_NONE = 0x00,
  DRWRAP_UNWIND_ON_EXCEPTION = 0x01,
  DRWRAP_NO_DYNAMIC_RETADDRS = 0x02,
  DRWRAP_REPLACE_RETADDR = 0x04
}
 
enum  drwrap_callconv_t {
  DRWRAP_CALLCONV_AMD64 = 0x01000000,
  DRWRAP_CALLCONV_MICROSOFT_X64 = 0x02000000,
  DRWRAP_CALLCONV_ARM = 0x03000000,
  DRWRAP_CALLCONV_CDECL = 0x04000000,
  DRWRAP_CALLCONV_STDCALL = DRWRAP_CALLCONV_CDECL,
  DRWRAP_CALLCONV_FASTCALL = 0x05000000,
  DRWRAP_CALLCONV_THISCALL = 0x06000000,
  DRWRAP_CALLCONV_AARCH64 = 0x07000000,
  DRWRAP_CALLCONV_RISCV_LP64 = 0x08000000,
  DRWRAP_CALLCONV_DEFAULT = DRWRAP_CALLCONV_AARCH64,
  DRWRAP_CALLCONV_VARARG = DRWRAP_CALLCONV_DEFAULT,
  DRWRAP_CALLCONV_MASK = 0xff000000
}
 
enum  drwrap_global_flags_t {
  DRWRAP_SAFE_READ_RETADDR = 0x01,
  DRWRAP_SAFE_READ_ARGS = 0x02,
  DRWRAP_NO_FRILLS = 0x04,
  DRWRAP_FAST_CLEANCALLS = 0x08,
  DRWRAP_INVERT_CONTROL = 0x10
}
 

Functions

DR_EXPORT bool drwrap_init (void)
 
DR_EXPORT void drwrap_exit (void)
 
DR_EXPORT dr_emit_flags_t drwrap_invoke_insert (void *drcontext, void *tag, instrlist_t *bb, instr_t *inst, instr_t *where, bool for_trace, bool translating, void *user_data)
 
DR_EXPORT dr_emit_flags_t drwrap_invoke_insert_cleanup_only (void *drcontext, void *tag, instrlist_t *bb, instr_t *inst, instr_t *where, bool for_trace, bool translating, void *user_data)
 
DR_EXPORT bool drwrap_replace (app_pc original, app_pc replacement, bool override)
 
DR_EXPORT bool drwrap_replace_native (app_pc original, app_pc replacement, bool at_entry, uint stack_adjust, void *user_data, bool override)
 
DR_EXPORT bool drwrap_is_replaced (app_pc func)
 
DR_EXPORT bool drwrap_is_replaced_native (app_pc func)
 
DR_EXPORT void drwrap_replace_native_fini (void *drcontext)
 
DR_EXPORT bool drwrap_wrap (app_pc func, void(*pre_func_cb)(void *wrapcxt, DR_PARAM_OUT void **user_data), void(*post_func_cb)(void *wrapcxt, void *user_data))
 
DR_EXPORT bool drwrap_wrap_ex (app_pc func, void(*pre_func_cb)(void *wrapcxt, DR_PARAM_INOUT void **user_data), void(*post_func_cb)(void *wrapcxt, void *user_data), void *user_data, uint flags)
 
DR_EXPORT bool drwrap_unwrap (app_pc func, void(*pre_func_cb)(void *wrapcxt, DR_PARAM_OUT void **user_data), void(*post_func_cb)(void *wrapcxt, void *user_data))
 
DR_EXPORT app_pc drwrap_get_drcontext (void *wrapcxt)
 
DR_EXPORT app_pc drwrap_get_func (void *wrapcxt)
 
DR_EXPORT dr_mcontext_t * drwrap_get_mcontext (void *wrapcxt)
 
DR_EXPORT dr_mcontext_t * drwrap_get_mcontext_ex (void *wrapcxt, dr_mcontext_flags_t flags)
 
DR_EXPORT bool drwrap_set_mcontext (void *wrapcxt)
 
DR_EXPORT app_pc drwrap_get_retaddr (void *wrapcxt)
 
DR_EXPORT void * drwrap_get_arg (void *wrapcxt, int arg)
 
DR_EXPORT bool drwrap_set_arg (void *wrapcxt, int arg, void *val)
 
DR_EXPORT void * drwrap_get_retval (void *wrapcxt)
 
DR_EXPORT bool drwrap_set_retval (void *wrapcxt, void *val)
 
DR_EXPORT bool drwrap_skip_call (void *wrapcxt, void *retval, size_t stdcall_args_size)
 
DR_EXPORT drext_status_t drwrap_redirect_execution (void *wrapcxt)
 
DR_EXPORT bool drwrap_is_redirect_requested (void *wrapcxt)
 
DR_EXPORT bool drwrap_register_post_call_notify (void(*cb)(app_pc pc))
 
DR_EXPORT bool drwrap_unregister_post_call_notify (void(*cb)(app_pc pc))
 
DR_EXPORT bool drwrap_mark_as_post_call (app_pc pc)
 
DR_EXPORT bool drwrap_set_global_flags (drwrap_global_flags_t flags)
 
DR_EXPORT bool drwrap_is_wrapped (app_pc func, void(*pre_func_cb)(void *wrapcxt, DR_PARAM_OUT void **user_data), void(*post_func_cb)(void *wrapcxt, void *user_data))
 
DR_EXPORT bool drwrap_is_post_wrap (app_pc pc)
 
DR_EXPORT bool drwrap_get_stats (DR_PARAM_OUT drwrap_stats_t *stats)
 
DR_EXPORT void drwrap_get_retaddr_if_sentinel (void *drcontext, DR_PARAM_INOUT app_pc *possibly_sentinel)
 

Detailed Description

Header for DynamoRIO Function Wrapping and Replacing Extension.