Theodosius  v3.0
Jit linker, mapper, obfuscator, and mutator
theo.hpp
Go to the documentation of this file.
1 // Copyright (c) 2022, _xeroxz
2 // All rights reserved.
3 //
4 // Redistribution and use in source and binary forms, with or without
5 // modification, are permitted provided that the following conditions are met:
6 //
7 // 1. Redistributions of source code must retain the above copyright notice,
8 // this list of conditions and the following disclaimer.
9 //
10 // 2. Redistributions in binary form must reproduce the above copyright notice,
11 // this list of conditions and the following disclaimer in the documentation
12 // and/or other materials provided with the distribution.
13 //
14 // 3. Neither the name of the copyright holder nor the names of its
15 // contributors may be used to endorse or promote products derived from
16 // this software without specific prior written permission.
17 //
18 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19 // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 // ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
22 // LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23 // CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24 // SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25 // INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26 // CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27 // ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28 // POSSIBILITY OF SUCH DAMAGE.
29 //
30 
31 #pragma once
32 #include <spdlog/spdlog.h>
33 #include <decomp/decomp.hpp>
34 #include <obf/engine.hpp>
35 #include <recomp/recomp.hpp>
36 #include <recomp/symbol_table.hpp>
37 
41 
42 #include <optional>
43 #include <tuple>
44 #include <vector>
45 
46 #define XED_ENCODER
47 extern "C" {
48 #include <xed-decode.h>
49 #include <xed-interface.h>
50 }
51 
55 namespace theo {
56 
60 using lnk_fns_t =
61  std::tuple<recomp::allocator_t, recomp::copier_t, recomp::resolver_t>;
62 
70 class theo_t {
71  public:
79  explicit theo_t(std::vector<std::uint8_t>& lib,
80  lnk_fns_t lnkr_fns,
81  const std::string&& entry_sym);
82 
88  std::optional<std::uint32_t> decompose();
89 
95  std::uintptr_t compose();
96 
102  std::uintptr_t resolve(const std::string&& sym);
103 
104  private:
105  std::string m_entry_sym;
106  decomp::decomp_t m_dcmp;
107  recomp::recomp_t m_recmp;
108  recomp::symbol_table_t m_sym_tbl;
109 };
110 } // namespace theo
the main decomposition class which is responsible for breaking down lib file into coff files,...
Definition: decomp.hpp:61
the main class responsible for recomposition
Definition: recomp.hpp:64
this class is a high level wrapper for a hashmap that contains decomp::symbol_t values....
the main class which encapsulates a symbol table, decomp, and recomp objects. This class is a bridge ...
Definition: theo.hpp:70
theo_t(std::vector< std::uint8_t > &lib, lnk_fns_t lnkr_fns, const std::string &&entry_sym)
explicit constructor for theo class.
std::uintptr_t compose()
compose the decomposed module. This will run obfuscation passes, the map and resolve symbols to each ...
std::optional< std::uint32_t > decompose()
decomposes the lib file and return the number of symbols that are used.
std::uintptr_t resolve(const std::string &&sym)
given the name of a symbol, it returns the address of where its mapped.
The outer most encompassing namespace of this project.
Definition: decomp.hpp:49
std::tuple< recomp::allocator_t, recomp::copier_t, recomp::resolver_t > lnk_fns_t
tuple of functions used by theo to allocate, copy, and resolve symbols.
Definition: theo.hpp:61