LIEF: Library to Instrument Executable Formats Version 0.17.0
|
Loading...
Searching...
No Matches
Go to the documentation of this file.
16#ifndef LIEF_COFF_BINARY_H
17#define LIEF_COFF_BINARY_H
28#include <unordered_map>
47 using sections_t = std::vector<std::unique_ptr<Section>>;
50 using it_sections = ref_iterator<sections_t&, Section*>;
53 using it_const_sections = const_ref_iterator<const sections_t&, const Section*>;
56 using relocations_t = std::vector<std::unique_ptr<Relocation>>;
59 using it_relocations = ref_iterator<relocations_t&, Relocation*>;
62 using it_const_relocations = const_ref_iterator<const relocations_t&, const Relocation*>;
65 using strings_table_t = std::vector<String>;
68 using it_strings_table = ref_iterator<strings_table_t&>;
71 using it_const_strings_table = const_ref_iterator<const strings_table_t&>;
74 using symbols_t = std::vector<std::unique_ptr<Symbol>>;
77 using it_symbols = ref_iterator<symbols_t&, Symbol*>;
80 using it_const_symbols = const_ref_iterator<const symbols_t&, const Symbol*>;
83 using instructions_it = iterator_range<assembly::Instruction::Iterator>;
86 using it_functions = filter_iterator<symbols_t&, Symbol*>;
89 using it_const_function = const_filter_iterator<const symbols_t&, const Symbol*>;
92 const Header&
header()
const {
131 return strings_table_;
135 return strings_table_;
143 auto it = std::find_if(strings_table_.begin(), strings_table_.end(),
144 [offset] (
const String& item) {
145 return offset == item.offset();
148 return it == strings_table_.end() ? nullptr : &*it;
152 return const_cast<Binary*
>(
this)->find_string(offset);
164 return const_cast<Symbol*
>(
static_cast<const Binary*
>(
this)->find_function(name));
171 return const_cast<Symbol*
>(
static_cast<const Binary*
>(
this)->find_demangled_function(name));
173 instructions_it
disassemble(
const Symbol& symbol)
const;
186 instructions_it
disassemble(
const std::string& symbol)
const;
198 instructions_it
disassemble(
const uint8_t* buffer,
size_t size,
204 uint64_t address = 0)
const;
206 instructions_it
disassemble(
const std::vector<uint8_t>& buffer,
212 uint64_t address = 0)
const {
213 return disassemble(buffer.data(), buffer.size(), address);
217 uint64_t address = 0)
const {
218 return disassemble(buffer.data(), buffer.size(), address);
222 return disassemble(buffer.data(), buffer.size(), address);
236 std::unique_ptr<Header> header_;
237 sections_t sections_;
238 relocations_t relocations_;
239 strings_table_t strings_table_;
242 mutable std::unordered_map<uint32_t, std::unique_ptr<assembly::Engine>> engines_;
244 assembly::Engine* get_engine(uint64_t address)
const;
246 template<u
int32_t Key,
class F>
247 LIEF_LOCAL assembly::Engine* get_cache_engine(uint64_t address, F&& f)
const;
Class that represents a COFF Binary.
Definition COFF/Binary.hpp:44
const Header & header() const
The COFF header.
Definition COFF/Binary.hpp:94
it_symbols symbols()
Iterator over the COFF's symbols.
Definition COFF/Binary.hpp:121
const String * find_string(uint32_t offset) const
Definition COFF/Binary.hpp:151
instructions_it disassemble(LIEF::span< uint8_t > buffer, uint64_t address=0) const
Definition COFF/Binary.hpp:221
instructions_it disassemble(LIEF::span< const uint8_t > buffer, uint64_t address=0) const
Definition COFF/Binary.hpp:216
Symbol * find_function(const std::string &name)
Definition COFF/Binary.hpp:163
it_sections sections()
Iterator over the different sections located in this COFF binary.
Definition COFF/Binary.hpp:103
it_const_symbols symbols() const
Definition COFF/Binary.hpp:125
it_const_strings_table string_table() const
Iterator over the COFF's strings.
Definition COFF/Binary.hpp:130
Symbol * find_demangled_function(const std::string &name)
Definition COFF/Binary.hpp:170
instructions_it disassemble(const uint8_t *buffer, size_t size, uint64_t address=0) const
Disassemble code provided by the given buffer at the specified address parameter.
it_strings_table string_table()
Definition COFF/Binary.hpp:134
it_const_relocations relocations() const
Definition COFF/Binary.hpp:116
it_const_function functions() const
Iterator over the functions implemented in this COFF.
const Symbol * find_demangled_function(const std::string &name) const
Try to find the function (symbol) with the given demangled name.
std::string to_string() const
it_const_sections sections() const
Definition COFF/Binary.hpp:107
Header & header()
Definition COFF/Binary.hpp:98
instructions_it disassemble(const std::vector< uint8_t > &buffer, uint64_t address=0) const
Disassemble code provided by the given vector of bytes at the specified address parameter.
Definition COFF/Binary.hpp:211
String * find_string(uint32_t offset)
Try to find the COFF string at the given offset in the COFF string table.
Definition COFF/Binary.hpp:142
instructions_it disassemble(const Symbol &symbol) const
Disassemble code for the given symbol.
const Symbol * find_function(const std::string &name) const
Try to find the function (symbol) with the given name.
instructions_it disassemble(const std::string &symbol) const
Disassemble code for the given symbol name.
friend std::ostream & operator<<(std::ostream &os, const Binary &bin)
Definition COFF/Binary.hpp:227
it_relocations relocations()
Iterator over all the relocations used by this COFF binary.
Definition COFF/Binary.hpp:112
Definition COFF/Parser.hpp:34
This class represents a COFF relocation.
Definition COFF/Relocation.hpp:34
This class represents a COFF section.
Definition COFF/Section.hpp:39
This class represents a COFF symbol.
Definition COFF/Symbol.hpp:35
This class interfaces the assembler/disassembler support.
Definition Engine.hpp:34
Definition AuxiliarySymbol.hpp:29
Namespace related to assembly/disassembly support.
Definition Abstract/Binary.hpp:46
LIEF namespace.
Definition Abstract/Binary.hpp:39
tcb::span< ElementType, Extent > span
Definition span.hpp:22
#define LIEF_API
Definition visibility.h:41
#define LIEF_LOCAL
Definition visibility.h:42