T0b1/test-repo
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

fadec: Deprecate address parameter of fd_decode

Browse Source
This commit is contained in:
Alexis Engelke
2020-06-27 18:45:51 +02:00
parent 7333453a19
commit 9556d34a8a
1 changed files with 7 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
fadec.h
View File

@@ -79,6 +79,7 @@ typedef enum {
FD_RT_MEM = 15, FD_RT_MEM = 15,
} FdRegType; } FdRegType;
/** Internal use only. **/
typedef struct { typedef struct {
uint8_t type; uint8_t type;
uint8_t size; uint8_t size;
@@ -86,6 +87,7 @@ typedef struct {
uint8_t misc; uint8_t misc;
} FdOp; } FdOp;
/** Never(!) access struct fields directly. Use the macros defined below. **/
typedef struct { typedef struct {
uint16_t type; uint16_t type;
uint8_t flags; uint8_t flags;
@@ -117,8 +119,9 @@ typedef enum {
* \param mode Decoding mode, either 32 for protected/compatibility mode or 64 * \param mode Decoding mode, either 32 for protected/compatibility mode or 64
* for long mode. 16-bit mode is not supported. * for long mode. 16-bit mode is not supported.
* \param address Virtual address where the decoded instruction. This is used * \param address Virtual address where the decoded instruction. This is used
* for computing jump targets and segment-offset-relative memory * for computing jump targets. If "0" is passed, operands which require
* operations (MOV with moffs* encoding) and stored in the instruction. * adding EIP/RIP will be stored as FD_OT_OFF operands.
* DEPRECATED: Strongly prefer passing 0 and using FD_OT_OFF operands.
* \param out_instr Pointer to the instruction buffer. Note that this may get * \param out_instr Pointer to the instruction buffer. Note that this may get
* partially written even if an error is returned. * partially written even if an error is returned.
* \return The number of bytes consumed by the instruction, or a negative number * \return The number of bytes consumed by the instruction, or a negative number
@@ -137,7 +140,8 @@ void fd_format(const FdInstr* instr, char* buf, size_t len);
/** Gets the type/mnemonic of the instruction. **/ /** Gets the type/mnemonic of the instruction. **/
#define FD_TYPE(instr) ((FdInstrType) (instr)->type) #define FD_TYPE(instr) ((FdInstrType) (instr)->type)
/** Gets the address of the instruction. **/ /** DEPRECATED: This functionality is obsolete in favor of FD_OT_OFF.
* Gets the address of the instruction. Invalid if decoded address == 0. **/
#define FD_ADDRESS(instr) ((instr)->address) #define FD_ADDRESS(instr) ((instr)->address)
/** Gets the size of the instruction in bytes. **/ /** Gets the size of the instruction in bytes. **/
#define FD_SIZE(instr) ((instr)->size) #define FD_SIZE(instr) ((instr)->size)