DynamoRIO API
Multi-Instrumentation Manager

Data Structures

struct  _drmgr_priority_t
 
struct  _emulated_instr_t
 

Typedefs

typedef dr_emit_flags_t(* drmgr_xform_cb_t) (void *drcontext, void *tag, instrlist_t *bb, bool for_trace, bool translating)
 
typedef dr_emit_flags_t(* drmgr_analysis_cb_t) (void *drcontext, void *tag, instrlist_t *bb, bool for_trace, bool translating, OUT void **user_data)
 
typedef drmgr_analysis_cb_t drmgr_app2app_ex_cb_t
 
typedef dr_emit_flags_t(* drmgr_ilist_ex_cb_t) (void *drcontext, void *tag, instrlist_t *bb, bool for_trace, bool translating, void *user_data)
 
typedef dr_emit_flags_t(* drmgr_insertion_cb_t) (void *drcontext, void *tag, instrlist_t *bb, instr_t *inst, bool for_trace, bool translating, void *user_data)
 
typedef dr_emit_flags_t(* drmgr_opcode_insertion_cb_t) (void *drcontext, void *tag, instrlist_t *bb, instr_t *inst, bool for_trace, bool translating, void *user_data)
 
typedef struct _drmgr_priority_t drmgr_priority_t
 
typedef struct _emulated_instr_t emulated_instr_t
 

Enumerations

Functions

DR_EXPORT bool drmgr_init (void)
 
DR_EXPORT void drmgr_exit (void)
 
DR_EXPORT bool drmgr_register_bb_app2app_event (drmgr_xform_cb_t func, drmgr_priority_t *priority)
 
DR_EXPORT bool drmgr_unregister_bb_app2app_event (drmgr_xform_cb_t func)
 
DR_EXPORT bool drmgr_register_bb_instrumentation_event (drmgr_analysis_cb_t analysis_func, drmgr_insertion_cb_t insertion_func, drmgr_priority_t *priority)
 
DR_EXPORT bool drmgr_unregister_bb_instrumentation_event (drmgr_analysis_cb_t func)
 
DR_EXPORT bool drmgr_unregister_bb_insertion_event (drmgr_insertion_cb_t func)
 
DR_EXPORT bool drmgr_register_bb_instru2instru_event (drmgr_xform_cb_t func, drmgr_priority_t *priority)
 
DR_EXPORT bool drmgr_unregister_bb_instru2instru_event (drmgr_xform_cb_t func)
 
DR_EXPORT bool drmgr_register_bb_instrumentation_ex_event (drmgr_app2app_ex_cb_t app2app_func, drmgr_ilist_ex_cb_t analysis_func, drmgr_insertion_cb_t insertion_func, drmgr_ilist_ex_cb_t instru2instru_func, drmgr_priority_t *priority)
 
DR_EXPORT bool drmgr_unregister_bb_instrumentation_ex_event (drmgr_app2app_ex_cb_t app2app_func, drmgr_ilist_ex_cb_t analysis_func, drmgr_insertion_cb_t insertion_func, drmgr_ilist_ex_cb_t instru2instru_func)
 
DR_EXPORT bool drmgr_register_opcode_instrumentation_event (drmgr_opcode_insertion_cb_t func, int opcode, drmgr_priority_t *priority, void *user_data)
 
DR_EXPORT bool drmgr_unregister_opcode_instrumentation_event (drmgr_opcode_insertion_cb_t func, int opcode)
 
DR_EXPORT drmgr_bb_phase_t drmgr_current_bb_phase (void *drcontext)
 
DR_EXPORT bool drmgr_is_first_instr (void *drcontext, instr_t *instr)
 
DR_EXPORT bool drmgr_is_first_nonlabel_instr (void *drcontext, instr_t *instr)
 
DR_EXPORT bool drmgr_is_last_instr (void *drcontext, instr_t *instr)
 
DR_EXPORT int drmgr_register_tls_field (void)
 
DR_EXPORT bool drmgr_unregister_tls_field (int idx)
 
DR_EXPORT void * drmgr_get_tls_field (void *drcontext, int idx)
 
DR_EXPORT bool drmgr_set_tls_field (void *drcontext, int idx, void *value)
 
DR_EXPORT bool drmgr_insert_read_tls_field (void *drcontext, int idx, instrlist_t *ilist, instr_t *where, reg_id_t reg)
 
DR_EXPORT bool drmgr_insert_write_tls_field (void *drcontext, int idx, instrlist_t *ilist, instr_t *where, reg_id_t reg, reg_id_t scratch)
 
DR_EXPORT int drmgr_register_cls_field (void(*cb_init_func)(void *drcontext, bool new_depth), void(*cb_exit_func)(void *drcontext, bool thread_exit))
 
DR_EXPORT bool drmgr_unregister_cls_field (void(*cb_init_func)(void *drcontext, bool new_depth), void(*cb_exit_func)(void *drcontext, bool thread_exit), int idx)
 
DR_EXPORT void * drmgr_get_cls_field (void *drcontext, int idx)
 
DR_EXPORT bool drmgr_set_cls_field (void *drcontext, int idx, void *value)
 
DR_EXPORT bool drmgr_insert_read_cls_field (void *drcontext, int idx, instrlist_t *ilist, instr_t *where, reg_id_t reg)
 
DR_EXPORT bool drmgr_insert_write_cls_field (void *drcontext, int idx, instrlist_t *ilist, instr_t *where, reg_id_t reg, reg_id_t scratch)
 
DR_EXPORT bool drmgr_push_cls (void *drcontext)
 
DR_EXPORT bool drmgr_pop_cls (void *drcontext)
 
DR_EXPORT void * drmgr_get_parent_cls_field (void *drcontext, int idx)
 
DR_EXPORT ptr_uint_t drmgr_reserve_note_range (size_t size)
 
DR_EXPORT bool drmgr_insert_emulation_start (void *drcontext, instrlist_t *ilist, instr_t *where, emulated_instr_t *instr)
 
DR_EXPORT void drmgr_insert_emulation_end (void *drcontext, instrlist_t *ilist, instr_t *where)
 
DR_EXPORT bool drmgr_is_emulation_start (instr_t *instr)
 
DR_EXPORT bool drmgr_is_emulation_end (instr_t *instr)
 
DR_EXPORT bool drmgr_get_emulated_instr_data (instr_t *instr, OUT emulated_instr_t *emulated)
 
DR_EXPORT int drmgr_decode_sysnum_from_wrapper (app_pc entry)
 
DR_EXPORT bool drmgr_register_thread_init_event (void(*func)(void *drcontext))
 
DR_EXPORT bool drmgr_register_thread_init_event_ex (void(*func)(void *drcontext), drmgr_priority_t *priority)
 
DR_EXPORT bool drmgr_register_thread_init_event_user_data (void(*func)(void *drcontext, void *user_data), drmgr_priority_t *priority, void *user_data)
 
DR_EXPORT bool drmgr_unregister_thread_init_event (void(*func)(void *drcontext))
 
DR_EXPORT bool drmgr_unregister_thread_init_event_user_data (void(*func)(void *drcontext, void *user_data))
 
DR_EXPORT bool drmgr_register_thread_exit_event (void(*func)(void *drcontext))
 
DR_EXPORT bool drmgr_register_thread_exit_event_ex (void(*func)(void *drcontext), drmgr_priority_t *priority)
 
DR_EXPORT bool drmgr_register_thread_exit_event_user_data (void(*func)(void *drcontext, void *user_data), drmgr_priority_t *priority, void *user_data)
 
DR_EXPORT bool drmgr_unregister_thread_exit_event (void(*func)(void *drcontext))
 
DR_EXPORT bool drmgr_unregister_thread_exit_event_user_data (void(*func)(void *drcontext, void *user_data))
 
DR_EXPORT bool drmgr_register_pre_syscall_event (bool(*func)(void *drcontext, int sysnum))
 
DR_EXPORT bool drmgr_register_pre_syscall_event_ex (bool(*func)(void *drcontext, int sysnum), drmgr_priority_t *priority)
 
DR_EXPORT bool drmgr_register_pre_syscall_event_user_data (bool(*func)(void *drcontext, int sysnum, void *user_data), drmgr_priority_t *priority, void *user_data)
 
DR_EXPORT bool drmgr_unregister_pre_syscall_event (bool(*func)(void *drcontext, int sysnum))
 
DR_EXPORT bool drmgr_unregister_pre_syscall_event_user_data (bool(*func)(void *drcontext, int sysnum, void *user_data))
 
DR_EXPORT bool drmgr_register_post_syscall_event (void(*func)(void *drcontext, int sysnum))
 
DR_EXPORT bool drmgr_register_post_syscall_event_ex (void(*func)(void *drcontext, int sysnum), drmgr_priority_t *priority)
 
DR_EXPORT bool drmgr_register_post_syscall_event_user_data (void(*func)(void *drcontext, int sysnum, void *user_data), drmgr_priority_t *priority, void *user_data)
 
DR_EXPORT bool drmgr_unregister_post_syscall_event (void(*func)(void *drcontext, int sysnum))
 
DR_EXPORT bool drmgr_unregister_post_syscall_event_user_data (void(*func)(void *drcontext, int sysnum, void *user_data))
 
DR_EXPORT bool drmgr_register_module_load_event (void(*func)(void *drcontext, const module_data_t *info, bool loaded))
 
DR_EXPORT bool drmgr_register_module_load_event_ex (void(*func)(void *drcontext, const module_data_t *info, bool loaded), drmgr_priority_t *priority)
 
DR_EXPORT bool drmgr_register_module_load_event_user_data (void(*func)(void *drcontext, const module_data_t *info, bool loaded, void *user_data), drmgr_priority_t *priority, void *user_data)
 
DR_EXPORT bool drmgr_unregister_module_load_event (void(*func)(void *drcontext, const module_data_t *info, bool loaded))
 
DR_EXPORT bool drmgr_unregister_module_load_event_user_data (void(*func)(void *drcontext, const module_data_t *info, bool loaded, void *user_data))
 
DR_EXPORT bool drmgr_register_module_unload_event (void(*func)(void *drcontext, const module_data_t *info))
 
DR_EXPORT bool drmgr_register_module_unload_event_ex (void(*func)(void *drcontext, const module_data_t *info), drmgr_priority_t *priority)
 
DR_EXPORT bool drmgr_register_module_unload_event_user_data (void(*func)(void *drcontext, const module_data_t *info, void *user_data), drmgr_priority_t *priority, void *user_data)
 
DR_EXPORT bool drmgr_unregister_module_unload_event (void(*func)(void *drcontext, const module_data_t *info))
 
DR_EXPORT bool drmgr_unregister_module_unload_event_user_data (void(*func)(void *drcontext, const module_data_t *info, void *user_data))
 
DR_EXPORT bool drmgr_register_kernel_xfer_event (void(*func)(void *drcontext, const dr_kernel_xfer_info_t *info))
 
DR_EXPORT bool drmgr_register_kernel_xfer_event_ex (void(*func)(void *drcontext, const dr_kernel_xfer_info_t *info), drmgr_priority_t *priority)
 
DR_EXPORT bool drmgr_unregister_kernel_xfer_event (void(*func)(void *drcontext, const dr_kernel_xfer_info_t *info))
 
DR_EXPORT bool drmgr_register_signal_event (dr_signal_action_t(*func)(void *drcontext, dr_siginfo_t *siginfo))
 
DR_EXPORT bool drmgr_register_signal_event_ex (dr_signal_action_t(*func)(void *drcontext, dr_siginfo_t *siginfo), drmgr_priority_t *priority)
 
DR_EXPORT bool drmgr_register_signal_event_user_data (dr_signal_action_t(*func)(void *drcontext, dr_siginfo_t *siginfo, void *user_data), drmgr_priority_t *priority, void *user_data)
 
DR_EXPORT bool drmgr_unregister_signal_event (dr_signal_action_t(*func)(void *drcontext, dr_siginfo_t *siginfo))
 
DR_EXPORT bool drmgr_unregister_signal_event_user_data (dr_signal_action_t(*func)(void *drcontext, dr_siginfo_t *siginfo, void *user_data))
 
DR_EXPORT bool drmgr_register_exception_event (bool(*func)(void *drcontext, dr_exception_t *excpt))
 
DR_EXPORT bool drmgr_register_exception_event_ex (bool(*func)(void *drcontext, dr_exception_t *excpt), drmgr_priority_t *priority)
 
DR_EXPORT bool drmgr_unregister_exception_event (bool(*func)(void *drcontext, dr_exception_t *excpt))
 
DR_EXPORT bool drmgr_register_restore_state_event (void(*func)(void *drcontext, void *tag, dr_mcontext_t *mcontext, bool restore_memory, bool app_code_consistent))
 
DR_EXPORT bool drmgr_register_restore_state_ex_event (bool(*func)(void *drcontext, bool restore_memory, dr_restore_state_info_t *info))
 
DR_EXPORT bool drmgr_register_restore_state_ex_event_ex (bool(*func)(void *drcontext, bool restore_memory, dr_restore_state_info_t *info), drmgr_priority_t *priority)
 
DR_EXPORT bool drmgr_unregister_restore_state_event (void(*func)(void *drcontext, void *tag, dr_mcontext_t *mcontext, bool restore_memory, bool app_code_consistent))
 
DR_EXPORT bool drmgr_unregister_restore_state_ex_event (bool(*func)(void *drcontext, bool restore_memory, dr_restore_state_info_t *info))
 
DR_EXPORT bool drmgr_register_low_on_memory_event (void(*func)())
 
DR_EXPORT bool drmgr_register_low_on_memory_event_ex (void(*func)(), drmgr_priority_t *priority)
 
DR_EXPORT bool drmgr_register_low_on_memory_event_user_data (void(*func)(void *user_data), drmgr_priority_t *priority, void *user_data)
 
DR_EXPORT bool drmgr_unregister_low_on_memory_event (void(*func)())
 
DR_EXPORT bool drmgr_unregister_low_on_memory_event_user_data (void(*func)(void *user_data))
 
DR_EXPORT bool drmgr_disable_auto_predication (void *drcontext, instrlist_t *ilist)
 

Detailed Description

Typedef Documentation

typedef dr_emit_flags_t(* drmgr_analysis_cb_t) (void *drcontext, void *tag, instrlist_t *bb, bool for_trace, bool translating, OUT void **user_data)

Callback function for the second stage: application analysis.

The user_data parameter can be used to pass data from this stage to the third stage.

See dr_emit_flags_t for an explanation of the return value. If any instrumentation pass requests DR_EMIT_STORE_TRANSLATIONS, they will be stored.

Callback function for the first stage when using a user data parameter: app2app transformations on instruction list.

typedef dr_emit_flags_t(* drmgr_ilist_ex_cb_t) (void *drcontext, void *tag, instrlist_t *bb, bool for_trace, bool translating, void *user_data)

Callback function for the second and last stages when using a user data parameter for all four: analysis and instru2instru transformations on the whole instruction list.

See dr_emit_flags_t for an explanation of the return value. If any instrumentation pass requests DR_EMIT_STORE_TRANSLATIONS, they will be stored.

typedef dr_emit_flags_t(* drmgr_insertion_cb_t) (void *drcontext, void *tag, instrlist_t *bb, instr_t *inst, bool for_trace, bool translating, void *user_data)

Callback function for the third stage: instrumentation insertion.

The user_data parameter contains data passed from the second stage to this stage.

See dr_emit_flags_t for an explanation of the return value. If any instrumentation pass requests DR_EMIT_STORE_TRANSLATIONS, they will be stored.

typedef dr_emit_flags_t(* drmgr_opcode_insertion_cb_t) (void *drcontext, void *tag, instrlist_t *bb, instr_t *inst, bool for_trace, bool translating, void *user_data)

Callback function for opcode based instrumentation. In particular, this callback is triggered only for specific instruction opcodes. This is done during the third stage, i.e., instrumentation insertion.

See dr_emit_flags_t for an explanation of the return value. If any instrumentation pass requests DR_EMIT_STORE_TRANSLATIONS, they will be stored.

Specifies the ordering of callbacks for drmgr's events

typedef dr_emit_flags_t(* drmgr_xform_cb_t) (void *drcontext, void *tag, instrlist_t *bb, bool for_trace, bool translating)

Callback function for the first and last stages: app2app and instru2instru transformations on the whole instruction list.

See dr_emit_flags_t for an explanation of the return value. If any instrumentation pass requests DR_EMIT_STORE_TRANSLATIONS, they will be stored.

Holds data about an emulated instruction, typically populated by an emulation client and read by an observational client.

Note
The emulated instr is part of the label represented by emulated_instr_t and as such it will be freed when the label created by drmgr_insert_emulation_start() is freed.

Enumeration Type Documentation

Labels the current bb building phase

Enumerator
DRMGR_PHASE_NONE 

Not currently in a bb building event.

DRMGR_PHASE_APP2APP 

Currently in the app2app phase.

DRMGR_PHASE_ANALYSIS 

Currently in the analysis phase.

DRMGR_PHASE_INSERTION 

Currently in the instrumentation insertion phase.

DRMGR_PHASE_INSTRU2INSTRU 

Currently in the instru2instru phase.

Function Documentation

DR_EXPORT drmgr_bb_phase_t drmgr_current_bb_phase ( void *  drcontext)

Returns which bb phase is the current one, if any.

Note
May be called without calling drmgr_init() to test whether drmgr is in use.
DR_EXPORT int drmgr_decode_sysnum_from_wrapper ( app_pc  entry)

Given a system call wrapper routine entry of the Native API variety, decodes the routine and returns the system call number. Returns -1 on error.

DR_EXPORT bool drmgr_disable_auto_predication ( void *  drcontext,
instrlist_t *  ilist 
)

Disables auto predication globally for this basic block.

Returns
whether successful.
Note
Only to be used in the drmgr insertion event.
DR_EXPORT void drmgr_exit ( void  )

Cleans up the drmgr extension.

DR_EXPORT void* drmgr_get_cls_field ( void *  drcontext,
int  idx 
)

Returns the user-controlled callback-local-storage field for the given index, which was returned by drmgr_register_cls_field(). To generate an instruction sequence that reads the drcontext field inline in the code cache, use drmgr_insert_read_cls_field().

DR_EXPORT bool drmgr_get_emulated_instr_data ( instr_t instr,
OUT emulated_instr_t emulated 
)

Loads emulated with the emulated instruction data from instr set by drmgr_insert_emulation_start().

When calling this function, the size field of emulated should be set using sizeof(). This allows the API to check for compatibility.

Parameters
[in]instrThe label instruction which specifies start of emulation.
[out]emulatedThe emulated instruction data.
Returns
false if the caller's emulated_instr_t is not compatible, true otherwise.
DR_EXPORT void* drmgr_get_parent_cls_field ( void *  drcontext,
int  idx 
)

Returns the user-controlled callback-local-storage field for the given index, which was returned by drmgr_register_cls_field(), for the parent context (i.e., the context most recently pushed either by a Windows callback entry or a call to drmgr_push_cls()). If there is no parent context, returns NULL.

DR_EXPORT void* drmgr_get_tls_field ( void *  drcontext,
int  idx 
)

Returns the user-controlled thread-local-storage field for the given index, which was returned by drmgr_register_tls_field(). To generate an instruction sequence that reads the drcontext field inline in the code cache, use drmgr_insert_read_tls_field().

DR_EXPORT bool drmgr_init ( void  )

Initializes the drmgr extension. Must be called prior to any of the other routines. Can be called multiple times (by separate components, normally) but each call must be paired with a corresponding call to drmgr_exit().

Returns
whether successful.
DR_EXPORT void drmgr_insert_emulation_end ( void *  drcontext,
instrlist_t *  ilist,
instr_t where 
)

Inserts a label into ilist prior to where to indicate the end of a sequence of instructions emulating an instruction, preceded by a label created with drmgr_insert_emulation_start().

DR_EXPORT bool drmgr_insert_emulation_start ( void *  drcontext,
instrlist_t *  ilist,
instr_t where,
emulated_instr_t instr 
)

Inserts a label into ilist prior to where to indicate the start of a sequence of instructions emulating an instruction instr. The label has data attached which describes the instruction being emulated.

A label will also appear at the end of the sequence, added using drmgr_insert_emulation_end(). These start and stop labels can be detected by an observational client using drmgr_is_emulation_start() and drmgr_is_emulation_end() allowing the client to distinguish between native app instructions and instructions used for emulation.

When calling this function, the size field of instr should be set using sizeof(). This allows the API to check for compatibility.

Information about the instruction being emulated can be read from the label using drmgr_get_emulated_instr_data().

If label callbacks are used, please note that the callback will not be cloned and its use is currently not consistent (xref i#3962).

Returns
false if the caller's emulated_instr_t is not compatible, true otherwise.
DR_EXPORT bool drmgr_insert_read_cls_field ( void *  drcontext,
int  idx,
instrlist_t *  ilist,
instr_t where,
reg_id_t  reg 
)

Inserts into ilist prior to where meta-instruction(s) to read into the general-purpose full-size register reg from the user-controlled drcontext field for the current (at execution time) callback and index. Reads from the same field as drmgr_get_cls_field().

Returns
whether successful.
DR_EXPORT bool drmgr_insert_read_tls_field ( void *  drcontext,
int  idx,
instrlist_t *  ilist,
instr_t where,
reg_id_t  reg 
)

Inserts into ilist prior to where meta-instruction(s) to read into the general-purpose full-size register reg from the user-controlled drcontext field for this thread and index. Reads from the same field as drmgr_get_tls_field().

Returns
whether successful.
DR_EXPORT bool drmgr_insert_write_cls_field ( void *  drcontext,
int  idx,
instrlist_t *  ilist,
instr_t where,
reg_id_t  reg,
reg_id_t  scratch 
)

Inserts into ilist prior to where meta-instruction(s) to write the general-purpose full-size register reg to the user-controlled drcontext field for the current (at execution time) callback and index. Writes to the same field as drmgr_set_cls_field(). The register scratch will be overwritten.

Returns
whether successful.
DR_EXPORT bool drmgr_insert_write_tls_field ( void *  drcontext,
int  idx,
instrlist_t *  ilist,
instr_t where,
reg_id_t  reg,
reg_id_t  scratch 
)

Inserts into ilist prior to where meta-instruction(s) to write the general-purpose full-size register reg to the user-controlled drcontext field for this thread and index. Writes to the same field as drmgr_set_tls_field(). The register scratch will be overwritten.

Returns
whether successful.
DR_EXPORT bool drmgr_is_emulation_end ( instr_t instr)

Checks the instruction instr to see if it is an emulation end label created by drmgr_insert_emulation_end(). Typically used in an instrumentation client running with an emulation client.

Returns
true if instr is an emulation end label, false otherwise.
DR_EXPORT bool drmgr_is_emulation_start ( instr_t instr)

Checks the instruction instr to see if it is an emulation start label created by drmgr_insert_emulation_start(). Typically used in an instrumentation client running with an emulation client.

Returns
true if instr is an emulation start label, false otherwise.
DR_EXPORT bool drmgr_is_first_instr ( void *  drcontext,
instr_t instr 
)

Must be called during drmgr's insertion phase. Returns whether instr is the first instruction (of any type) in the instruction list (as of immediately after the analysis phase).

DR_EXPORT bool drmgr_is_first_nonlabel_instr ( void *  drcontext,
instr_t instr 
)

Must be called during drmgr's insertion phase. Returns whether instr is the first non-label instruction in the instruction list (as of immediately after the analysis phase).

DR_EXPORT bool drmgr_is_last_instr ( void *  drcontext,
instr_t instr 
)

Must be called during drmgr's insertion phase. Returns whether instr is the last instruction (of any type) in the instruction list (as of immediately after the analysis phase).

DR_EXPORT bool drmgr_pop_cls ( void *  drcontext)

Pops a callback context from the callback-local storage (cls) context stack for the given thread. This function is automatically called on exit from a Windows callback. Users can invoke it to provide context stacks for their own uses, including Linux signals or layered wrapped functions. Invoking this function will trigger the cb_exit_func passed to drmgr_register_cls_field().

Returns false if the context stack has only one entry.

DR_EXPORT bool drmgr_push_cls ( void *  drcontext)

Pushes a new callback context onto the callback-local storage (cls) context stack for the given thread. This function is automatically called on entry to a new Windows callback. Users can invoke it to provide context stacks for their own uses, including Linux signals or layered wrapped functions. Invoking this function will trigger the cb_init_func passed to drmgr_register_cls_field().

Returns
whether successful.
DR_EXPORT bool drmgr_register_bb_app2app_event ( drmgr_xform_cb_t  func,
drmgr_priority_t priority 
)

Registers a callback function for the first instrumentation stage: application-to-application ("app2app") transformations on each basic block. drmgr will call func as the first of four instrumentation stages for each dynamic application basic block. Examples of app2app transformations include replacing one function with another or replacing one instruction with another throughout an application.

The app2app passes are allowed to modify and insert non-meta (i.e., application) instructions and are intended for application code transformations. These passes should avoid adding meta instructions other than label instructions.

All instrumentation must follow the guidelines for dr_register_bb_event() with the exception that multiple application control transfer instructions are supported so long as all but one have intra-block instr_t targets. This is to support internal control flow that may be necessary for some application-to-application transformations. These control transfer instructions should have a translation set so that later passes know which application address they correspond to. drmgr will mark all of the extra non-meta control transfers as meta, and clear their translation fields, right before passing to DynamoRIO, in order to satisfy DynamoRIO's constraints. This allows all of the instrumentation passes to see these instructions as application instructions, which is how they should be treated.

Returns
false if the given priority request cannot be satisfied (e.g., priority->before is already ordered after priority->after) or the given name is already taken.
Parameters
[in]funcThe callback to be called.
[in]prioritySpecifies the relative ordering of the callback. Can be NULL, in which case a default priority is used.
DR_EXPORT bool drmgr_register_bb_instru2instru_event ( drmgr_xform_cb_t  func,
drmgr_priority_t priority 
)

Registers a callback function for the fourth instrumentation stage: instrumentation-to-instrumentation transformations on each basic block. drmgr will call func as the fourth of four instrumentation stages for each dynamic application basic block. Instrumentation-to-instrumentation passes are allowed to insert meta instructions but not non-meta instructions, and are intended for optimization of prior instrumentation passes.

All instrumentation must follow the guidelines for dr_register_bb_event().

Returns
false if the given priority request cannot be satisfied (e.g., priority->before is already ordered after priority->after) or the given name is already taken.
Parameters
[in]funcThe callback to be called.
[in]prioritySpecifies the relative ordering of the callback. Can be NULL, in which case a default priority is used.
DR_EXPORT bool drmgr_register_bb_instrumentation_event ( drmgr_analysis_cb_t  analysis_func,
drmgr_insertion_cb_t  insertion_func,
drmgr_priority_t priority 
)

Registers callback functions for the second and third instrumentation stages: application analysis and instrumentation insertion. drmgr will call func as the second of four instrumentation stages for each dynamic application basic block.

The first stage performed any changes to the original application code, and later stages are not allowed to change application code. Application analysis passes in the second stage are not allowed to add to or change the instruction list other than adding label instructions, and are intended for analysis of application code either for immediate use or for use by the third stage. Label instructions can be used to store data for use in subsequent stages with custom tags inserted as notes via drmgr_reserve_note_range() and custom data stored via instr_get_label_data_area().

The third instrumentation stage is instrumentation insertion. Unlike the other stages, this one passes only one instruction to the callback, allowing each registered component to act on one instruction before moving to the next instruction. Instrumentation insertion passes are allowed to insert meta instructions only immediately prior to the passed-in instruction: not before any prior non-meta instruction nor after any subsequent non-meta instruction. They are not allowed to insert new non-meta instructions or change existing non-meta instructions. Because other components may have already acted on the instruction list, be sure to ignore already existing meta instructions.

The analysis_func and insertion_func share the same priority. Their user_data parameter can be used to pass data from the analysis stage to the insertion stage.

All instrumentation must follow the guidelines for dr_register_bb_event().

On ARM, for the instrumentation insertion event, drmgr does not set the predicate for all meta instructions inserted by each callback to match the predicate of the corresponding application instruction. It is the client's responsibility to set proper predicates for all meta instructions. At the end of all instrumentation stages, drmgr automatically adds enough IT instructions to create legal IT blocks in Thumb mode.

Returns
false if the given priority request cannot be satisfied (e.g., priority->before is already ordered after priority->after) or the given name is already taken.
Parameters
[in]analysis_funcThe analysis callback to be called for the second stage. Can be NULL if insertion_func is non-NULL, in which case the user_data passed to insertion_func is NULL and drmgr_unregister_bb_insertion_event() must be used to unregister.
[in]insertion_funcThe insertion callback to be called for the third stage. Can be NULL if analysis_func is non-NULL.
[in]prioritySpecifies the relative ordering of both callbacks. Can be NULL, in which case a default priority is used.
Note
It is possible for meta instructions to be present and passed to the analysis and/or insertion stages, if they were added in the app2app or analysis stages. While this is discouraged, it is sometimes unavoidable, such as for drwrap_replace_native(). We recommend that all instrumentation stages check for meta instructions (and ignore them, typically).
DR_EXPORT bool drmgr_register_bb_instrumentation_ex_event ( drmgr_app2app_ex_cb_t  app2app_func,
drmgr_ilist_ex_cb_t  analysis_func,
drmgr_insertion_cb_t  insertion_func,
drmgr_ilist_ex_cb_t  instru2instru_func,
drmgr_priority_t priority 
)

Registers callbacks for all four instrumentation passes at once, with a user_data parameter passed among them all, enabling data sharing for all four. See the documentation for drmgr_register_bb_app2app_event(), drmgr_register_bb_instrumentation_event(), and drmgr_register_bb_instru2instru_event() for further details of each pass. The aforemented routines are identical to this with the exception of the extra user_data parameter, which is an OUT parameter to the app2app_func and passed in to the three subsequent callbacks. The priority param can be NULL, in which case a default priority is used.

DR_EXPORT int drmgr_register_cls_field ( void(*)(void *drcontext, bool new_depth)  cb_init_func,
void(*)(void *drcontext, bool thread_exit)  cb_exit_func 
)

Reserves a callback-local storage (cls) slot. Thread-local storage (tls) is callback-shared. Callbacks interrupt thread execution to execute arbitrary amounts of code in a new context before returning to the interrupted context. Thread-local storage fields that persist across application execution can be overwritten during callback execution, resulting in incorrect values when returning to the original context. Callback-local storage, rather than thread-local storage, should be used for any fields that store information specific to the application's execution.

Returns the index of the slot, which should be passed to drmgr_get_cls_field() and drmgr_set_cls_field(). Returns -1 if there are no more slots available.

Callbacks are frequent, but normally the stack of callback contexts is only a few entries deep. It is most efficient to re-use cls data from prior callbacks, only allocating new memory when entering a new context stack depth. The cb_init_func parameter is invoked on each new callback context, with new_depth set to true only when entering a new callback context stack depth. When new_depth is false, drmgr_get_cls_field() will return the value set at that depth the last time it was reached, and the client would normally not need to allocate memory but would only need to initialize it. When new_depth is true, drmgr_get_cls_field() will return NULL, and the user should use drmgr_set_cls_field() to initialize the slot itself as well as whatever it points to.

Similarly, normal usage should ignore cb_exit_func unless it is called with thread_exit set to true, in which case any memory in the cls slot should be de-allocated.

Callbacks are Windows-specific. The cls interfaces are not marked for Windows-only, however, to facilitate cross-platform code. We recommend that cross-plaform code be written using cls fields on both platforms; the fields on Linux will never be stacked and will function as tls fields. Technically the same context interruption can occur with a Linux signal, but Linux signals typically execute small amounts of code and avoid making stateful changes; furthermore, there is no guaranteed end point to a signal. The drmgr_push_cls() and drmgr_pop_cls() interface can be used to provide a stack of contexts on Linux, or to provide a stack of contexts for any other purpose such as layered wrapped functions. These push and pop functions are automatically called on Windows callback entry and exit, with the push called in DR's kernel xfer event prior to any client callback for that event, and pop called in the same event but after any client callback.

DR_EXPORT bool drmgr_register_exception_event ( bool(*)(void *drcontext, dr_exception_t *excpt)  func)

Registers a callback function for the exception event, which behaves just like DR's exception event dr_register_exception_event().

Returns
whether successful.
DR_EXPORT bool drmgr_register_exception_event_ex ( bool(*)(void *drcontext, dr_exception_t *excpt)  func,
drmgr_priority_t priority 
)

Registers a callback function for the exception event, which behaves just like DR's exception event dr_register_exception_event(), except that it is ordered according to priority. A default priority of 0 is used for events registered via drmgr_register_exception_event(). Just like for DR, the first callback to return false will short-circuit event delivery to later callbacks.

Returns
whether successful.
DR_EXPORT bool drmgr_register_kernel_xfer_event ( void(*)(void *drcontext, const dr_kernel_xfer_info_t *info)  func)

Registers a callback function for the kernel transfer event, which behaves just like DR's kernel transfer event dr_register_kernel_xfer_event().

Returns
whether successful.
DR_EXPORT bool drmgr_register_kernel_xfer_event_ex ( void(*)(void *drcontext, const dr_kernel_xfer_info_t *info)  func,
drmgr_priority_t priority 
)

Registers a callback function for the kernel transfer event, which behaves just like DR's kernel transfer event dr_register_kernel_xfer_event(), except that it is ordered according to priority. A default priority of 0 is used for events registered via drmgr_register_module_unload_event().

Returns
whether successful.
DR_EXPORT bool drmgr_register_low_on_memory_event ( void(*)()  func)

Registers a callback function func for the low-on-memory event. The callback provides a means for the client to free any non-critical data found on the heap, which could avoid a potential out-of-memory crash (particularly on 32-bit).

Returns
whether successful.
DR_EXPORT bool drmgr_register_low_on_memory_event_ex ( void(*)()  func,
drmgr_priority_t priority 
)

Registers a callback function func for the low-on-memory event just like drmgr_register_low_on_memory_event(), but the callback is prioritised according to priority.

Returns
whether successful.
DR_EXPORT bool drmgr_register_low_on_memory_event_user_data ( void(*)(void *user_data)  func,
drmgr_priority_t priority,
void *  user_data 
)

Registers a callback function func for the low-on-memory event just like drmgr_register_low_on_memory_event(), but allows the passing of user data user_data. The callback is prioritised according to priority.

Returns
whether successful.
DR_EXPORT bool drmgr_register_module_load_event ( void(*)(void *drcontext, const module_data_t *info, bool loaded)  func)

Registers a callback function for the module load event, which behaves just like DR's module load event dr_register_module_load_event().

Returns
whether successful.
DR_EXPORT bool drmgr_register_module_load_event_ex ( void(*)(void *drcontext, const module_data_t *info, bool loaded)  func,
drmgr_priority_t priority 
)

Registers a callback function for the module load event, which behaves just like DR's module load event dr_register_module_load_event(), except that it is ordered according to priority. A default priority of 0 is used for events registered via drmgr_register_module_load_event().

Returns
whether successful.
DR_EXPORT bool drmgr_register_module_load_event_user_data ( void(*)(void *drcontext, const module_data_t *info, bool loaded, void *user_data)  func,
drmgr_priority_t priority,
void *  user_data 
)

Registers a callback function for the module load event, which behaves just like DR's module load event dr_register_module_load_event(). Allows for the passing of user input user_data, which is available upon the execution of the callback.

Returns
whether successful.

See also drmgr_register_module_load_event_ex().

DR_EXPORT bool drmgr_register_module_unload_event ( void(*)(void *drcontext, const module_data_t *info)  func)

Registers a callback function for the module unload event, which behaves just like DR's module unload event dr_register_module_unload_event().

Returns
whether successful.
DR_EXPORT bool drmgr_register_module_unload_event_ex ( void(*)(void *drcontext, const module_data_t *info)  func,
drmgr_priority_t priority 
)

Registers a callback function for the module unload event, which behaves just like DR's module unload event dr_register_module_unload_event(), except that it is ordered according to priority. A default priority of 0 is used for events registered via drmgr_register_module_unload_event().

Returns
whether successful.
DR_EXPORT bool drmgr_register_module_unload_event_user_data ( void(*)(void *drcontext, const module_data_t *info, void *user_data)  func,
drmgr_priority_t priority,
void *  user_data 
)

Registers a callback function for the module unload event, which behaves just like DR's module unload event dr_register_module_unload_event(). Allows for the passing of user data, user_data, which is available upon the execution of the callback.

Returns
whether successful.

See also drmgr_register_module_unload_event_ex().

DR_EXPORT bool drmgr_register_opcode_instrumentation_event ( drmgr_opcode_insertion_cb_t  func,
int  opcode,
drmgr_priority_t priority,
void *  user_data 
)

Registers callback functions for the third instrumentation stage: instrumentation insertion. drmgr will call func for each instruction with the specific opcode opcode.

More than one callback function can be mapped to the same opcode. Their execution sequence is determined by their priority priority (if set). Ordering based on priority is also taken into account with respect to insert per instr events.

Since this callback is triggered during instrumentation insertion, same usage rules apply. The callback is allowed to insert meta instructions only immediately prior to the passed-in instruction. New non-meta instructions cannot be inserted.

Returns
false upon failure.
Parameters
[in]funcThe opcode insertion callback to be called for the third stage for a specific opcode instruction. Cannot be NULL.
[in]opcodeThe opcode to associate with the insertion callback.
[in]prioritySpecifies the relative ordering of both callbacks. Can be NULL, in which case a default priority is used.
[in]user_dataUser data made available when triggering the callback func. Can be NULL.
Note
It is possible that this callback will be triggered for meta instructions. Therefore, we recommend that the callback check for meta instructions (and ignore them, typically).
DR_EXPORT bool drmgr_register_post_syscall_event ( void(*)(void *drcontext, int sysnum)  func)

Registers a callback function for the post-syscall event, which behaves just like DR's post-syscall event dr_register_post_syscall_event().

Returns
whether successful.
DR_EXPORT bool drmgr_register_post_syscall_event_ex ( void(*)(void *drcontext, int sysnum)  func,
drmgr_priority_t priority 
)

Registers a callback function for the post-syscall event, which behaves just like DR's post-syscall event dr_register_post_syscall_event(), except that it is ordered according to priority. A default priority of 0 is used for events registered via drmgr_register_post_syscall_event().

Returns
whether successful.
DR_EXPORT bool drmgr_register_post_syscall_event_user_data ( void(*)(void *drcontext, int sysnum, void *user_data)  func,
drmgr_priority_t priority,
void *  user_data 
)

Registers a callback function for the post-syscall event, ordered by priority. Allows for the passing of user data user_data which is available upon the execution of the callback.

Returns
whether successful.

See also drmgr_register_post_syscall_event_ex().

DR_EXPORT bool drmgr_register_pre_syscall_event ( bool(*)(void *drcontext, int sysnum)  func)

Registers a callback function for the pre-syscall event, which behaves just like DR's pre-syscall event dr_register_pre_syscall_event(). In particular, a filter event is still needed to ensure that a pre- or post-syscall event is actually called: use dr_register_filter_syscall_event().

Returns
whether successful.
DR_EXPORT bool drmgr_register_pre_syscall_event_ex ( bool(*)(void *drcontext, int sysnum)  func,
drmgr_priority_t priority 
)

Registers a callback function for the pre-syscall event, which behaves just like DR's pre-syscall event dr_register_pre_syscall_event(), except that it is ordered according to priority. A default priority of 0 is used for events registered via drmgr_register_pre_syscall_event(). A filter event is still needed to ensure that a pre- or post-syscall event is actually called: use dr_register_filter_syscall_event().

Returns
whether successful.
DR_EXPORT bool drmgr_register_pre_syscall_event_user_data ( bool(*)(void *drcontext, int sysnum, void *user_data)  func,
drmgr_priority_t priority,
void *  user_data 
)

Registers a callback function for the pre-syscall event, ordered by priority. Allows for the passing of user data user_data which is available upon the execution of the callback.

Returns
whether successful.

See also drmgr_register_pre_syscall_event_ex().

DR_EXPORT bool drmgr_register_restore_state_event ( void(*)(void *drcontext, void *tag, dr_mcontext_t *mcontext, bool restore_memory, bool app_code_consistent)  func)

Registers a callback function for the restore state event, which behaves just like DR's restore state event dr_register_restore_state_event().

Returns
whether successful.
DR_EXPORT bool drmgr_register_restore_state_ex_event ( bool(*)(void *drcontext, bool restore_memory, dr_restore_state_info_t *info)  func)

Registers a callback function for the restore state extended event, which behaves just like DR's restore state event dr_register_restore_state_ex_event().

Returns
whether successful.
DR_EXPORT bool drmgr_register_restore_state_ex_event_ex ( bool(*)(void *drcontext, bool restore_memory, dr_restore_state_info_t *info)  func,
drmgr_priority_t priority 
)

Registers a callback function for the restore state extended event, which behaves just like DR's restore state event dr_register_restore_state_ex_event(), except that it is ordered according to priority among both extended and regular callbacks. A default priority of 0 is used for events registered via drmgr_register_restore_state_event() or drmgr_register_restore_state_ex_event(). Just like for DR, the first callback to return false will short-circuit event delivery to later callbacks.

Returns
whether successful.
DR_EXPORT bool drmgr_register_signal_event ( dr_signal_action_t(*)(void *drcontext, dr_siginfo_t *siginfo)  func)

Registers a callback function for the signal event, which behaves just like DR's signal event dr_register_signal_event().

Returns
whether successful.
DR_EXPORT bool drmgr_register_signal_event_ex ( dr_signal_action_t(*)(void *drcontext, dr_siginfo_t *siginfo)  func,
drmgr_priority_t priority 
)

Registers a callback function for the signal event, which behaves just like DR's signal event dr_register_signal_event(), except that it is ordered according to priority. A default priority of 0 is used for events registered via drmgr_register_signal_event(). Just like for DR, the first callback to return other than DR_SIGNAL_DELIVER will short-circuit event delivery to later callbacks.

Returns
whether successful.
DR_EXPORT bool drmgr_register_signal_event_user_data ( dr_signal_action_t(*)(void *drcontext, dr_siginfo_t *siginfo, void *user_data)  func,
drmgr_priority_t priority,
void *  user_data 
)

Registers a callback function for the signal event, which behaves just like DR's module load event dr_register_signal_event(). Allows for the passing of user input user_data, which is available upon the execution of the callback.

Returns
whether successful.

See also drmgr_register_signal_event_ex().

DR_EXPORT bool drmgr_register_thread_exit_event ( void(*)(void *drcontext)  func)

Registers a callback function for the thread exit event. drmgr calls func whenever DR would, when an application thread exits. All the constraints of dr_register_thread_exit_event() apply.

Returns
whether successful.
DR_EXPORT bool drmgr_register_thread_exit_event_ex ( void(*)(void *drcontext)  func,
drmgr_priority_t priority 
)

Registers a callback function for the thread exit event, ordered by priority. drmgr calls func whenever DR would, when an application thread exits. All the constraints of dr_register_thread_exit_event() apply.

Returns
whether successful.
DR_EXPORT bool drmgr_register_thread_exit_event_user_data ( void(*)(void *drcontext, void *user_data)  func,
drmgr_priority_t priority,
void *  user_data 
)

Registers a callback function for the thread exit event, ordered by priority. Allows for the passing of user data user_data which is available upon the execution of the callback. drmgr calls func when an application thread exits.

Returns
whether successful.

See also drmgr_register_thread_exit_event_ex().

DR_EXPORT bool drmgr_register_thread_init_event ( void(*)(void *drcontext)  func)

Registers a callback function for the thread initialization event. drmgr calls func whenever the application creates a new thread.

Returns
whether successful.
DR_EXPORT bool drmgr_register_thread_init_event_ex ( void(*)(void *drcontext)  func,
drmgr_priority_t priority 
)

Registers a callback function for the thread initialization event, ordered by priority. drmgr calls func whenever the application creates a new thread.

Returns
whether successful.
DR_EXPORT bool drmgr_register_thread_init_event_user_data ( void(*)(void *drcontext, void *user_data)  func,
drmgr_priority_t priority,
void *  user_data 
)

Registers a callback function for the thread initialization event, ordered by priority. Allows for the passing of user data user_data which is available upon the execution of the callback. drmgr calls func whenever the application creates a new thread.

Returns
whether successful.

See also drmgr_register_thread_init_event_ex().

DR_EXPORT int drmgr_register_tls_field ( void  )

Reserves a thread-local storage (tls) slot for every thread. Returns the index of the slot, which should be passed to drmgr_get_tls_field() and drmgr_set_tls_field(). Returns -1 if there are no more slots available. Each slot is initialized to NULL for each thread and should be properly initialized with drmgr_set_tls_field() in the thread initialization event (see dr_register_thread_init_event()).

DR_EXPORT ptr_uint_t drmgr_reserve_note_range ( size_t  size)

Reserves size values in the namespace for use in the note field of instructions. The reserved range starts at the return value and is contiguous. Returns DRMGR_NOTE_NONE on failure. Un-reserving is not supported.

DR_EXPORT bool drmgr_set_cls_field ( void *  drcontext,
int  idx,
void *  value 
)

Sets the user-controlled callback-local-storage field for the given index, which was returned by drmgr_register_cls_field(). To generate an instruction sequence that writes the drcontext field inline in the code cache, use drmgr_insert_write_cls_field().

Returns
whether successful.
DR_EXPORT bool drmgr_set_tls_field ( void *  drcontext,
int  idx,
void *  value 
)

Sets the user-controlled thread-local-storage field for the given index, which was returned by drmgr_register_tls_field(). To generate an instruction sequence that writes the drcontext field inline in the code cache, use drmgr_insert_write_tls_field().

Returns
whether successful.
DR_EXPORT bool drmgr_unregister_bb_app2app_event ( drmgr_xform_cb_t  func)

Unregisters a callback function for the first instrumentation stage.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).

The recommendations for dr_unregister_bb_event() about when it is safe to unregister apply here as well.

DR_EXPORT bool drmgr_unregister_bb_insertion_event ( drmgr_insertion_cb_t  func)

Unregisters func from the second and third instrumentation stages. If an analysis callback was passed to drmgr_register_bb_instrumentation_event(), use drmgr_unregister_bb_instrumentation_event() instead.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).

The recommendations for dr_unregister_bb_event() about when it is safe to unregister apply here as well.

DR_EXPORT bool drmgr_unregister_bb_instru2instru_event ( drmgr_xform_cb_t  func)

Unregisters a callback function for the fourth instrumentation stage.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).

The recommendations for dr_unregister_bb_event() about when it is safe to unregister apply here as well.

DR_EXPORT bool drmgr_unregister_bb_instrumentation_event ( drmgr_analysis_cb_t  func)

Unregisters func and its corresponding insertion callback from the second and third instrumentation stages.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).

The recommendations for dr_unregister_bb_event() about when it is safe to unregister apply here as well.

DR_EXPORT bool drmgr_unregister_bb_instrumentation_ex_event ( drmgr_app2app_ex_cb_t  app2app_func,
drmgr_ilist_ex_cb_t  analysis_func,
drmgr_insertion_cb_t  insertion_func,
drmgr_ilist_ex_cb_t  instru2instru_func 
)

Unregisters the given four callbacks that were registered via drmgr_register_bb_instrumentation_ex_event().

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).

The recommendations for dr_unregister_bb_event() about when it is safe to unregister apply here as well.

DR_EXPORT bool drmgr_unregister_cls_field ( void(*)(void *drcontext, bool new_depth)  cb_init_func,
void(*)(void *drcontext, bool thread_exit)  cb_exit_func,
int  idx 
)

Frees a previously reserved callback-local storage (cls) slot index and unregisters its event callbacks. Returns false if the slot was not actually reserved.

DR_EXPORT bool drmgr_unregister_exception_event ( bool(*)(void *drcontext, dr_exception_t *excpt)  func)

Unregister a callback function for the exception event.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).
DR_EXPORT bool drmgr_unregister_kernel_xfer_event ( void(*)(void *drcontext, const dr_kernel_xfer_info_t *info)  func)

Unregister a callback function for the kernel transfer event.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).
DR_EXPORT bool drmgr_unregister_low_on_memory_event ( void(*)()  func)

Unregister a callback function for the low-on-memory event.

Returns
true if the unregistration of func is successful.
DR_EXPORT bool drmgr_unregister_low_on_memory_event_user_data ( void(*)(void *user_data)  func)

Unregister a callback function that accepts user-data for the low-on-memory event.

Returns
true if the unregistration of func is successful.
DR_EXPORT bool drmgr_unregister_module_load_event ( void(*)(void *drcontext, const module_data_t *info, bool loaded)  func)

Unregister a callback function for the module load event.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).
DR_EXPORT bool drmgr_unregister_module_load_event_user_data ( void(*)(void *drcontext, const module_data_t *info, bool loaded, void *user_data)  func)

Unregister a callback function, which takes user data as a parameter for the module load event.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).

See also drmgr_unregister_module_load_event().

DR_EXPORT bool drmgr_unregister_module_unload_event ( void(*)(void *drcontext, const module_data_t *info)  func)

Unregister a callback function for the module unload event.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).
DR_EXPORT bool drmgr_unregister_module_unload_event_user_data ( void(*)(void *drcontext, const module_data_t *info, void *user_data)  func)

Unregister a callback function, that takes user data as a parameter, for the module unload event.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).

See also drmgr_unregister_module_unload_event().

DR_EXPORT bool drmgr_unregister_opcode_instrumentation_event ( drmgr_opcode_insertion_cb_t  func,
int  opcode 
)

Unregisters the opcode-specific callback that was registered via drmgr_register_opcode_instrumentation_event().

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered for the passed opcode opcode).

The recommendations for dr_unregister_bb_event() about when it is safe to unregister apply here as well.

DR_EXPORT bool drmgr_unregister_post_syscall_event ( void(*)(void *drcontext, int sysnum)  func)

Unregister a callback function for the post-syscall event.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).
DR_EXPORT bool drmgr_unregister_post_syscall_event_user_data ( void(*)(void *drcontext, int sysnum, void *user_data)  func)

Unregister a callback function, which takes user data, for the post-syscall event.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).

See also drmgr_unregister_post_syscall_event().

DR_EXPORT bool drmgr_unregister_pre_syscall_event ( bool(*)(void *drcontext, int sysnum)  func)

Unregister a callback function for the pre-syscall event.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).
DR_EXPORT bool drmgr_unregister_pre_syscall_event_user_data ( bool(*)(void *drcontext, int sysnum, void *user_data)  func)

Unregister a callback function, which takes user data, for the pre-syscall event.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).

See also drmgr_unregister_pre_syscall_event().

DR_EXPORT bool drmgr_unregister_restore_state_event ( void(*)(void *drcontext, void *tag, dr_mcontext_t *mcontext, bool restore_memory, bool app_code_consistent)  func)

Unregister a callback function for the restore state event.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).
DR_EXPORT bool drmgr_unregister_restore_state_ex_event ( bool(*)(void *drcontext, bool restore_memory, dr_restore_state_info_t *info)  func)

Unregister a callback function for the restore state extended event.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).
DR_EXPORT bool drmgr_unregister_signal_event ( dr_signal_action_t(*)(void *drcontext, dr_siginfo_t *siginfo)  func)

Unregister a callback function for the signal event.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).
DR_EXPORT bool drmgr_unregister_signal_event_user_data ( dr_signal_action_t(*)(void *drcontext, dr_siginfo_t *siginfo, void *user_data)  func)

Unregister a callback function for the signal event which also has user data passed to the callback.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).

See also drmgr_unregister_signal_event().

DR_EXPORT bool drmgr_unregister_thread_exit_event ( void(*)(void *drcontext)  func)

Unregister a callback function for the thread exit event.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).
DR_EXPORT bool drmgr_unregister_thread_exit_event_user_data ( void(*)(void *drcontext, void *user_data)  func)

Unregister a callback function for the thread exit event which also has user data passed to the callback.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).

See also drmgr_unregister_thread_exit_event().

DR_EXPORT bool drmgr_unregister_thread_init_event ( void(*)(void *drcontext)  func)

Unregister a callback function for the thread initialization event.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).
DR_EXPORT bool drmgr_unregister_thread_init_event_user_data ( void(*)(void *drcontext, void *user_data)  func)

Unregister a callback function for the thread initialization event which also has user data passed to the callback.

Returns
true if unregistration is successful and false if it is not (e.g., func was not registered).

See also drmgr_unregister_thread_init_event().

DR_EXPORT bool drmgr_unregister_tls_field ( int  idx)

Frees a previously reserved thread-local storage (tls) slot index. Returns false if the slot was not actually reserved.