LiftingUnit (B2R2)

LiftingUnit Type

Namespace: B2R2.FrontEnd
Assembly: B2R2.FrontEnd.Core.dll
Base Type: obj

Lifting unit is responsible for parsing/lifting binary instructions. To lift a binary file in parallel, one needs to create multiple lifting units.

Constructors

Constructor Description

Constructor	Description
`LiftingUnit(binFile, parser)` Full Usage: `LiftingUnit(binFile, parser)` Parameters: binFile : `IBinFile` parser : `IInstructionParsable` Returns: `LiftingUnit`	binFile : `IBinFile` parser : `IInstructionParsable` Returns: `LiftingUnit`


                
                  
                    
                      LiftingUnit(binFile, parser)

Full Usage: LiftingUnit(binFile, parser)

Parameters:

binFile : IBinFile

parser : IInstructionParsable

Returns: LiftingUnit

binFile : IBinFile
parser : IInstructionParsable

Returns: LiftingUnit

Instance members

Instance member	Description
`this.DisasmInstruction` Full Usage: `this.DisasmInstruction` Parameters: ptr : `BinFilePointer` - The binary file pointer. Returns: `string` Disassembled string.	Disassemble an instruction pointed to by the given pointer (ptr) and return the disassembled string. The output does not show the address of the instruction nor resolve the symbols of references. ptr : `BinFilePointer` The binary file pointer. Returns: `string` Disassembled string.
`this.DisasmInstruction` Full Usage: `this.DisasmInstruction` Parameters: addr : `Addr` - The instruction address. Returns: `string` Disassembled string.	Disassemble an instruction at the given address (addr) and return the disassembled string. The output does not show the address of the instruction nor resolve the symbols of references. addr : `Addr` The instruction address. Returns: `string` Disassembled string.
`this.DisasmInstruction` Full Usage: `this.DisasmInstruction` Parameters: ins : `Instruction` - The instruction to disassemble. showAddr : `bool` - Whether to show the address of the instruction in the output or not. resolveSymbol : `bool` - Whether to resolve the symbols of references (e.g., jump target) in the output or not. Returns: `string` Disassembled string.	Disassemble the given instruction and return the disassembled string. ins : `Instruction` The instruction to disassemble. showAddr : `bool` Whether to show the address of the instruction in the output or not. resolveSymbol : `bool` Whether to resolve the symbols of references (e.g., jump target) in the output or not. Returns: `string` Disassembled string.
`this.File` Full Usage: `this.File` Returns: `IBinFile`	Binary file to be lifted. Returns: `IBinFile`
`this.LiftBBlock` Full Usage: `this.LiftBBlock` Parameters: ptr : `BinFilePointer` - The binary file pointer. Returns: `Result<Stmt array, Stmt array>` Lifted IR statements.	Lift a basic block starting from the given pointer (ptr) and return the lifted IR statements. This function returns an incomplete list of IR statments if the parsing process fails. ptr : `BinFilePointer` The binary file pointer. Returns: `Result<Stmt array, Stmt array>` Lifted IR statements.
`this.LiftBBlock` Full Usage: `this.LiftBBlock` Parameters: addr : `Addr` - The start address. Returns: `Result<Stmt array, Stmt array>` Lifted IR statements.	Lift a basic block starting from the given address (addr) and return the lifted IR statements. This function returns an incomplete list of IR statments if the parsing process fails. addr : `Addr` The start address. Returns: `Result<Stmt array, Stmt array>` Lifted IR statements.
`this.LiftInstruction` Full Usage: `this.LiftInstruction` Parameters: ins : `Instruction` - The instruction to be lifted. optimize : `bool` - Whether to optimize the lifted IR statements or not. Returns: `Stmt array` Lifted IR statements.	Lift the given instruction and return the lifted IR statements. ins : `Instruction` The instruction to be lifted. optimize : `bool` Whether to optimize the lifted IR statements or not. Returns: `Stmt array` Lifted IR statements.
`this.LiftInstruction` Full Usage: `this.LiftInstruction` Parameters: ins : `Instruction` - The instruction to be lifted. Returns: `Stmt[]` Lifted IR statements.	Lift the given instruction and return the lifted IR statements. ins : `Instruction` The instruction to be lifted. Returns: `Stmt[]` Lifted IR statements.
`this.LiftInstruction` Full Usage: `this.LiftInstruction` Parameters: ptr : `BinFilePointer` - The binary file pointer. optimize : `bool` - Whether to optimize the lifted IR statements or not. Returns: `Stmt array` Lifted IR statements.	Lift an instruction pointed to by the given pointer and return the lifted IR statements. ptr : `BinFilePointer` The binary file pointer. optimize : `bool` Whether to optimize the lifted IR statements or not. Returns: `Stmt array` Lifted IR statements.
`this.LiftInstruction` Full Usage: `this.LiftInstruction` Parameters: ptr : `BinFilePointer` - The binary file pointer. Returns: `Stmt[]` Lifted IR statements.	Lift an instruction pointed to by the given pointer and return the lifted IR statements. ptr : `BinFilePointer` The binary file pointer. Returns: `Stmt[]` Lifted IR statements.
`this.LiftInstruction` Full Usage: `this.LiftInstruction` Parameters: addr : `Addr` - The instruction address. optimize : `bool` - Whether to optimize the lifted IR statements or not. Returns: `Stmt array` Lifted IR statements.	Lift an instruction at the given address (addr) and return the lifted IR statements. addr : `Addr` The instruction address. optimize : `bool` Whether to optimize the lifted IR statements or not. Returns: `Stmt array` Lifted IR statements.
`this.LiftInstruction` Full Usage: `this.LiftInstruction` Parameters: addr : `Addr` - The instruction address. Returns: `Stmt[]` Lifted IR statements.	Lift an instruction at the given address (addr) and return the lifted IR statements. addr : `Addr` The instruction address. Returns: `Stmt[]` Lifted IR statements.
`this.ParseBBlock` Full Usage: `this.ParseBBlock` Parameters: ptr : `BinFilePointer` - The binary file pointer. Returns: `Result<Instruction array, Instruction array>` Parsed basic block (i.e., an array of instructions).	Parse a basic block pointed to by the given binary file pointer (ptr), and return the corresponding array of instructions. This function returns an incomplete list of instructions if the parsing process fails. ptr : `BinFilePointer` The binary file pointer. Returns: `Result<Instruction array, Instruction array>` Parsed basic block (i.e., an array of instructions).
`this.ParseBBlock` Full Usage: `this.ParseBBlock` Parameters: addr : `Addr` - The basic block address. Returns: `Result<Instruction array, Instruction array>` Parsed basic block (i.e., an array of instructions).	Parse a basic block starting from the given address (addr), and return the corresponding array of instructions. This function returns an incomplete list of instructions if the parsing process fails. addr : `Addr` The basic block address. Returns: `Result<Instruction array, Instruction array>` Parsed basic block (i.e., an array of instructions).
`this.ParseInstruction` Full Usage: `this.ParseInstruction` Parameters: ptr : `BinFilePointer` - BinFilePointer. Returns: `Instruction` Parsed instruction.	Parse one instruction pointed to by the binary file pointer (ptr), and return the corresponding instruction. This function raises an exception if the parsing process fails. ptr : `BinFilePointer` BinFilePointer. Returns: `Instruction` Parsed instruction.
`this.ParseInstruction` Full Usage: `this.ParseInstruction` Parameters: addr : `Addr` - The instruction address. Returns: `Instruction` Parsed instruction.	Parse one instruction at the given address (addr), and return the corresponding instruction. This function raises an exception if the parsing process fails. addr : `Addr` The instruction address. Returns: `Instruction` Parsed instruction.
`this.Parser` Full Usage: `this.Parser` Returns: `IInstructionParsable`	Parser of this lifting unit. Returns: `IInstructionParsable`
`this.TranslationContext` Full Usage: `this.TranslationContext` Returns: `TranslationContext`	Translation context. Returns: `TranslationContext`
`this.TryParseInstruction` Full Usage: `this.TryParseInstruction` Parameters: ptr : `BinFilePointer` - BinFilePointer. Returns: `Result<Instruction, ErrorCase>` Parsed instruction if succeeded, ErrorCase if otherwise.	Try to parse one instruction pointed to by the binary file pointer (ptr), and return the corresponding instruction. ptr : `BinFilePointer` BinFilePointer. Returns: `Result<Instruction, ErrorCase>` Parsed instruction if succeeded, ErrorCase if otherwise.
`this.TryParseInstruction` Full Usage: `this.TryParseInstruction` Parameters: addr : `Addr` - The instruction address. Returns: `Result<Instruction, ErrorCase>` Parsed instruction if succeeded, ErrorCase if otherwise.	Try to parse one instruction at the given address (addr), and return the corresponding instruction. addr : `Addr` The instruction address. Returns: `Result<Instruction, ErrorCase>` Parsed instruction if succeeded, ErrorCase if otherwise.