/* Copyright 2017 - 2022 R. Thomas * Copyright 2017 - 2022 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_PE_RELOCATION_H_ #define LIEF_PE_RELOCATION_H_ #include #include #include #include "LIEF/Object.hpp" #include "LIEF/visibility.h" #include "LIEF/iterators.hpp" #include "LIEF/PE/enums.hpp" namespace LIEF { namespace PE { class Parser; class Builder; namespace details { struct pe_base_relocation_block; } //! Class which represents the *Base Relocation Block* //! Usually, we find this structure in the ``.reloc`` section class LIEF_API Relocation : public Object { friend class Parser; friend class Builder; public: using entries_t = std::vector>; using it_entries = ref_iterator; using it_const_entries = const_ref_iterator; Relocation(); Relocation(const Relocation& other); Relocation& operator=(Relocation other); Relocation(const details::pe_base_relocation_block& header); virtual ~Relocation(); void swap(Relocation& other); //! The RVA for which the offset of the relocation entries (RelocationEntry) is added uint32_t virtual_address() const; //! The total number of bytes in the base relocation block. //! ``block_size = sizeof(BaseRelocationBlock) + nb_of_relocs * sizeof(uint16_t = RelocationEntry)`` uint32_t block_size() const; //! Iterator over the RelocationEntry it_const_entries entries() const; it_entries entries(); void virtual_address(uint32_t virtual_address); void block_size(uint32_t block_size); RelocationEntry& add_entry(const RelocationEntry& entry); void accept(Visitor& visitor) const override; bool operator==(const Relocation& rhs) const; bool operator!=(const Relocation& rhs) const; LIEF_API friend std::ostream& operator<<(std::ostream& os, const Relocation& relocation); private: uint32_t block_size_ = 0; uint32_t virtual_address_ = 0; entries_t entries_; }; } } #endif /* RELOCATION_H_ */