// Copyright (c) 2022, _xeroxz // All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are met: // // 1. Redistributions of source code must retain the above copyright notice, // this list of conditions and the following disclaimer. // // 2. Redistributions in binary form must reproduce the above copyright notice, // this list of conditions and the following disclaimer in the documentation // and/or other materials provided with the distribution. // // 3. Neither the name of the copyright holder nor the names of its // contributors may be used to endorse or promote products derived from // this software without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE // ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE // LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR // CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF // SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS // INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN // CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) // ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE // POSSIBILITY OF SUCH DAMAGE. // #pragma once #include #include #include #define XED_ENCODER extern "C" { #include #include } /// /// this is the main namespace for obfuscation related things. /// namespace theo::obf { /// /// a function which is called by recomp_t to copy symbols into memory. /// using copier_t = std::function; /// /// a function which is called to allocate space for a symbol. /// /// the first param is the size of the symbol, the second param is the /// characteristics of the section which the symbol is allocated in. /// using allocator_t = std::function; // symbol table map associated with the symbol table data structure. // using sym_map_t = std::map; /// /// the pass_t class is a base clase for all passes made. you must override the /// pass_t::run virtual function and declare the logic of your pass there. /// /// in the constructor of your pass you must call the super constructor (the /// pass_t constructor) and pass it the type of symbol which you are interesting /// in receiving. /// class pass_t { public: /// /// the explicit constructor of the pass_t base class. /// /// the type of symbol in which the pass will run on. /// every symbol passed to the virtual "run" instruction will be of this /// type. explicit pass_t(decomp::sym_type_t sym_type) : m_sym_type(sym_type){}; /// /// This virtual method is invoked before the recomp stage of Theodosius. This /// allows you to manipulate symbols in a generic manner. /// /// a symbol of the same type of m_sym_type. virtual void generic_pass(decomp::symbol_t* sym, sym_map_t& sym_tbl) = 0; /// /// This virtual method is invoked prior to calling the "copier". This allows /// you to manipulate the symbol prior to it being copied into memory. /// /// Symbol being copied into memory. /// copier lambda that the pass can use. if it does, then /// you must return true. returns true if the copy was done /// by the pass. false if copying still needs to be done. virtual bool copier_pass(decomp::symbol_t* sym, copier_t& copier) = 0; /// /// This virtual method is invoked prior to calling the "allocator". This /// allows you to manipulate the symbol prior to memory being allocated for /// it. /// /// The symbol that memory is being allocated for. /// The size of the symbol that memory is being allocated /// for. /// returns the optional address of the allocation, if the pass didnt /// allocate space for the symbol than this optional value will have no /// value. virtual std::optional allocation_pass( decomp::symbol_t* sym, std::uint32_t size, allocator_t& allocator) = 0; /// /// This virtual method is invoked before the call to the "resolver". This /// allows you the manipulate the relocation address and symbol before /// relocations are made. /// /// The symbol that has the relocation inside of it. /// The relocation be be applied. /// The address of the symbol pointed too by the /// relocation. /// virtual std::optional resolver_pass( decomp::symbol_t* sym, recomp::reloc_t* reloc, std::uintptr_t allocated_t) = 0; /// /// gets the passes symbol type. /// /// the passes symbol type. decomp::sym_type_t sym_type() { return m_sym_type; } private: decomp::sym_type_t m_sym_type; }; /// /// generic pass class overloads non-generic pass methods to return default /// values... this makes it so generic passes dont need to overload all of these /// methods and return default values every single time... /// class generic_pass_t : public pass_t { public: explicit generic_pass_t(decomp::sym_type_t sym_type) : pass_t(sym_type) {} // default non-generic passes to return generic values... // bool copier_pass(decomp::symbol_t* sym, copier_t& copier) { return false; } std::optional allocation_pass(decomp::symbol_t* sym, std::uint32_t size, allocator_t& allocator) { return {}; } std::optional resolver_pass(decomp::symbol_t* sym, recomp::reloc_t* reloc, std::uintptr_t allocated_t) { return {}; } }; } // namespace theo::obf