dynamorio::drmemtrace::pt2ir_t Class Reference

#include <pt2ir.h>

Public Member Functions
bool	init (IN pt2ir_config_t &pt2ir_config, IN int verbosity=0)
pt2ir_convert_status_t	convert (IN const uint8_t *pt_data, IN size_t pt_data_size, INOUT drir_t &drir)
bool	init (IN pt2ir_config_t &pt2ir_config, IN int verbosity=0)
pt2ir_convert_status_t	convert (IN const uint8_t *pt_data, IN size_t pt_data_size, INOUT drir_t &drir)

Detailed Description

pt2ir_t is a class that can convert PT raw trace to DynamoRIO's IR.

Member Function Documentation

convert() [1/2]

pt2ir_convert_status_t dynamorio::drmemtrace::pt2ir_t::convert	(	IN const uint8_t *	pt_data,
		IN size_t	pt_data_size,
		INOUT drir_t &	drir
	)

The convert function performs two processes: (1) decode the PT raw trace into libipt's IR format pt_insn; (2) convert pt_insn into the DynamoRIO's IR format instr_t and append it to ilist inside the drir object.

Parameters

pt_data	The PT raw trace.
pt_data_size	The size of PT raw trace.
drir	The drir object.

Returns

pt2ir_convert_status_t. If the conversion is successful, the function returns PT2IR_CONV_SUCCESS. Otherwise, the function returns the corresponding error code.

convert() [2/2]

pt2ir_convert_status_t dynamorio::drmemtrace::pt2ir_t::convert	(	IN const uint8_t *	pt_data,
		IN size_t	pt_data_size,
		INOUT drir_t &	drir
	)

The convert function performs two processes: (1) decode the PT raw trace into libipt's IR format pt_insn; (2) convert pt_insn into the DynamoRIO's IR format instr_t and append it to ilist inside the drir object.

Parameters

pt_data	The PT raw trace.
pt_data_size	The size of PT raw trace.
drir	The drir object.

Returns

pt2ir_convert_status_t. If the conversion is successful, the function returns PT2IR_CONV_SUCCESS. Otherwise, the function returns the corresponding error code.

init() [1/2]

bool dynamorio::drmemtrace::pt2ir_t::init	(	IN pt2ir_config_t &	pt2ir_config,
		IN int	verbosity = 0
	)

Initialize the PT instruction decoder and the sideband session.

Parameters

pt2ir_config	The configuration of PT raw trace.
verbosity	The verbosity level for notifications. If set to 0, only error logs are printed. If set to 1, all logs are printed. Default value is 0.

Returns

true if the instance is successfully initialized.

init() [2/2]

bool dynamorio::drmemtrace::pt2ir_t::init	(	IN pt2ir_config_t &	pt2ir_config,
		IN int	verbosity = 0
	)

Initialize the PT instruction decoder and the sideband session.

Parameters

pt2ir_config	The configuration of PT raw trace.
verbosity	The verbosity level for notifications. If set to 0, only error logs are printed. If set to 1, all logs are printed. Default value is 0.

Returns

true if the instance is successfully initialized.

---

The documentation for this class was generated from the following file:

• /home/runner/work/dynamorio/dynamorio/build_release-64/clients/include/drmemtrace/pt2ir.h