/*************************************************************************/ /* Copyright (c) 2015 dx, http://kaimi.ru */ /* */ /* Permission is hereby granted, free of charge, to any person */ /* obtaining a copy of this software and associated documentation */ /* files (the "Software"), to deal in the Software without */ /* restriction, including without limitation the rights to use, */ /* copy, modify, merge, publish, distribute, sublicense, and/or */ /* sell copies of the Software, and to permit persons to whom the */ /* Software is furnished to do so, subject to the following conditions: */ /* The above copyright notice and this permission notice shall be */ /* included in all copies or substantial portions of the Software. */ /* */ /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */ /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */ /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/ /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */ /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */ /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */ /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ /*************************************************************************/ #pragma once #include #include "pe_structures.h" namespace pe_bliss { class pe_properties { public: //Constructors virtual std::auto_ptr duplicate() const = 0; //Fills properly PE structures virtual void create_pe(uint32_t section_alignment, uint16_t subsystem) = 0; public: //Destructor virtual ~pe_properties(); public: //DIRECTORIES //Returns true if directory exists virtual bool directory_exists(uint32_t id) const = 0; //Removes directory virtual void remove_directory(uint32_t id) = 0; //Returns directory RVA virtual uint32_t get_directory_rva(uint32_t id) const = 0; //Returns directory size virtual uint32_t get_directory_size(uint32_t id) const = 0; //Sets directory RVA (just a value of PE header, no moving occurs) virtual void set_directory_rva(uint32_t id, uint32_t rva) = 0; //Sets directory size (just a value of PE header, no moving occurs) virtual void set_directory_size(uint32_t id, uint32_t size) = 0; //Strips only zero DATA_DIRECTORY entries to count = min_count //Returns resulting number of data directories //strip_iat_directory - if true, even not empty IAT directory will be stripped virtual uint32_t strip_data_directories(uint32_t min_count = 1, bool strip_iat_directory = true) = 0; public: //IMAGE //Returns PE type of this image virtual pe_type get_pe_type() const = 0; public: //PE HEADER //Returns image base for PE32 and PE64 respectively virtual uint32_t get_image_base_32() const = 0; virtual uint64_t get_image_base_64() const = 0; //Sets new image base for PE32 virtual void set_image_base(uint32_t base) = 0; //Sets new image base for PE32/PE+ virtual void set_image_base_64(uint64_t base) = 0; //Returns image entry point virtual uint32_t get_ep() const = 0; //Sets image entry point virtual void set_ep(uint32_t new_ep) = 0; //Returns file alignment virtual uint32_t get_file_alignment() const = 0; //Returns section alignment virtual uint32_t get_section_alignment() const = 0; //Sets heap size commit for PE32 and PE64 respectively virtual void set_heap_size_commit(uint32_t size) = 0; virtual void set_heap_size_commit(uint64_t size) = 0; //Sets heap size reserve for PE32 and PE64 respectively virtual void set_heap_size_reserve(uint32_t size) = 0; virtual void set_heap_size_reserve(uint64_t size) = 0; //Sets stack size commit for PE32 and PE64 respectively virtual void set_stack_size_commit(uint32_t size) = 0; virtual void set_stack_size_commit(uint64_t size) = 0; //Sets stack size reserve for PE32 and PE64 respectively virtual void set_stack_size_reserve(uint32_t size) = 0; virtual void set_stack_size_reserve(uint64_t size) = 0; //Returns heap size commit for PE32 and PE64 respectively virtual uint32_t get_heap_size_commit_32() const = 0; virtual uint64_t get_heap_size_commit_64() const = 0; //Returns heap size reserve for PE32 and PE64 respectively virtual uint32_t get_heap_size_reserve_32() const = 0; virtual uint64_t get_heap_size_reserve_64() const = 0; //Returns stack size commit for PE32 and PE64 respectively virtual uint32_t get_stack_size_commit_32() const = 0; virtual uint64_t get_stack_size_commit_64() const = 0; //Returns stack size reserve for PE32 and PE64 respectively virtual uint32_t get_stack_size_reserve_32() const = 0; virtual uint64_t get_stack_size_reserve_64() const = 0; //Returns virtual size of image virtual uint32_t get_size_of_image() const = 0; //Returns number of RVA and sizes (number of DATA_DIRECTORY entries) virtual uint32_t get_number_of_rvas_and_sizes() const = 0; //Sets number of RVA and sizes (number of DATA_DIRECTORY entries) virtual void set_number_of_rvas_and_sizes(uint32_t number) = 0; //Returns PE characteristics virtual uint16_t get_characteristics() const = 0; //Sets PE characteristics virtual void set_characteristics(uint16_t ch) = 0; //Clears PE characteristics flag void clear_characteristics_flags(uint16_t flags); //Sets PE characteristics flag void set_characteristics_flags(uint16_t flags); //Returns size of headers virtual uint32_t get_size_of_headers() const = 0; //Returns subsystem virtual uint16_t get_subsystem() const = 0; //Sets subsystem virtual void set_subsystem(uint16_t subsystem) = 0; //Returns size of optional header virtual uint16_t get_size_of_optional_header() const = 0; //Returns PE signature virtual uint32_t get_pe_signature() const = 0; //Returns PE magic value virtual uint32_t get_magic() const = 0; //Returns checksum of PE file from header virtual uint32_t get_checksum() const = 0; //Sets checksum of PE file virtual void set_checksum(uint32_t checksum) = 0; //Returns timestamp of PE file from header virtual uint32_t get_time_date_stamp() const = 0; //Sets timestamp of PE file virtual void set_time_date_stamp(uint32_t timestamp) = 0; //Returns Machine field value of PE file from header virtual uint16_t get_machine() const = 0; //Sets Machine field value of PE file virtual void set_machine(uint16_t machine) = 0; //Returns DLL Characteristics virtual uint16_t get_dll_characteristics() const = 0; //Sets DLL Characteristics virtual void set_dll_characteristics(uint16_t characteristics) = 0; //Sets required operation system version virtual void set_os_version(uint16_t major, uint16_t minor) = 0; //Returns required operation system version (minor word) virtual uint16_t get_minor_os_version() const = 0; //Returns required operation system version (major word) virtual uint16_t get_major_os_version() const = 0; //Sets required subsystem version virtual void set_subsystem_version(uint16_t major, uint16_t minor) = 0; //Returns required subsystem version (minor word) virtual uint16_t get_minor_subsystem_version() const = 0; //Returns required subsystem version (major word) virtual uint16_t get_major_subsystem_version() const = 0; public: //ADDRESS CONVERTIONS //Virtual Address (VA) to Relative Virtual Address (RVA) convertions //for PE32 and PE64 respectively //bound_check checks integer overflow virtual uint32_t va_to_rva(uint32_t va, bool bound_check = true) const = 0; virtual uint32_t va_to_rva(uint64_t va, bool bound_check = true) const = 0; //Relative Virtual Address (RVA) to Virtual Address (VA) convertions //for PE32 and PE64 respectively virtual uint32_t rva_to_va_32(uint32_t rva) const = 0; virtual uint64_t rva_to_va_64(uint32_t rva) const = 0; public: //SECTIONS //Returns number of sections virtual uint16_t get_number_of_sections() const = 0; public: //Sets number of sections virtual void set_number_of_sections(uint16_t number) = 0; //Sets virtual size of image virtual void set_size_of_image(uint32_t size) = 0; //Sets size of headers virtual void set_size_of_headers(uint32_t size) = 0; //Sets size of optional headers virtual void set_size_of_optional_header(uint16_t size) = 0; //Returns nt headers data pointer virtual char* get_nt_headers_ptr() = 0; //Returns nt headers data pointer virtual const char* get_nt_headers_ptr() const = 0; //Returns size of NT header virtual uint32_t get_sizeof_nt_header() const = 0; //Returns size of optional headers virtual uint32_t get_sizeof_opt_headers() const = 0; //Sets file alignment (no checks) virtual void set_file_alignment_unchecked(uint32_t alignment) = 0; //Sets base of code virtual void set_base_of_code(uint32_t base) = 0; //Returns base of code virtual uint32_t get_base_of_code() const = 0; //Returns needed PE magic for PE or PE+ (from template parameters) virtual uint32_t get_needed_magic() const = 0; }; }