You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Theodosius/doxygen/html/d9/dbc/classtheo_1_1theo__t.html

287 lines
20 KiB

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
<meta name="generator" content="Doxygen 1.9.3"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Theodosius: theo::theo_t Class Reference</title>
<link href="../../tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="../../jquery.js"></script>
<script type="text/javascript" src="../../dynsections.js"></script>
<link href="../../search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="../../search/searchdata.js"></script>
<script type="text/javascript" src="../../search/search.js"></script>
<link href="../../doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr id="projectrow">
<td id="projectlogo"><img alt="Logo" src="../../icon.png"/></td>
<td id="projectalign">
<div id="projectname">Theodosius<span id="projectnumber">&#160;v3.0</span>
</div>
<div id="projectbrief">Jit linker, symbol mapper, and obfuscator</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.3 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
var searchBox = new SearchBox("searchBox", "../../search",'Search','.html');
/* @license-end */
</script>
<script type="text/javascript" src="../../menudata.js"></script>
<script type="text/javascript" src="../../menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function() {
initMenu('../../',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
/* @license-end */
</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="../../da/de6/namespacetheo.html">theo</a></li><li class="navelem"><a class="el" href="../../d9/dbc/classtheo_1_1theo__t.html">theo_t</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> </div>
<div class="headertitle"><div class="title">theo::theo_t Class Reference</div></div>
</div><!--header-->
<div class="contents">
<p>the main class which encapsulates a symbol table, decomp, and recomp objects. This class is a bridge that connects all three: decomp, obf, recomp.
<a href="../../d9/dbc/classtheo_1_1theo__t.html#details">More...</a></p>
<p><code>#include &quot;<a class="el" href="../../d2/d24/theo_8hpp_source.html">theo.hpp</a>&quot;</code></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="pub-methods" name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr class="memitem:a0a9ae3322261b97cf1dc47c908ef3c6d"><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="../../d9/dbc/classtheo_1_1theo__t.html#a0a9ae3322261b97cf1dc47c908ef3c6d">theo_t</a> (std::vector&lt; std::uint8_t &gt; &amp;lib, <a class="el" href="../../da/de6/namespacetheo.html#a66efe2c63e06764fb2d9a378c688c680">lnk_fns_t</a> lnkr_fns, const std::string &amp;&amp;entry_sym)</td></tr>
<tr class="memdesc:a0a9ae3322261b97cf1dc47c908ef3c6d"><td class="mdescLeft">&#160;</td><td class="mdescRight">explicit constructor for theo class. <a href="../../d9/dbc/classtheo_1_1theo__t.html#a0a9ae3322261b97cf1dc47c908ef3c6d">More...</a><br /></td></tr>
<tr class="separator:a0a9ae3322261b97cf1dc47c908ef3c6d"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a66257ff5d9825483d85e58384a12760a"><td class="memItemLeft" align="right" valign="top">std::optional&lt; std::uint32_t &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="../../d9/dbc/classtheo_1_1theo__t.html#a66257ff5d9825483d85e58384a12760a">decompose</a> ()</td></tr>
<tr class="memdesc:a66257ff5d9825483d85e58384a12760a"><td class="mdescLeft">&#160;</td><td class="mdescRight">decomposes the lib file and return the number of symbols that are used. <a href="../../d9/dbc/classtheo_1_1theo__t.html#a66257ff5d9825483d85e58384a12760a">More...</a><br /></td></tr>
<tr class="separator:a66257ff5d9825483d85e58384a12760a"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a39e067dd71f82b437c6a418d41e38b27"><td class="memItemLeft" align="right" valign="top">std::uintptr_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="../../d9/dbc/classtheo_1_1theo__t.html#a39e067dd71f82b437c6a418d41e38b27">compose</a> ()</td></tr>
<tr class="memdesc:a39e067dd71f82b437c6a418d41e38b27"><td class="mdescLeft">&#160;</td><td class="mdescRight">compose the decomposed module. This will run obfuscation passes, the map and resolve symbols to each other. <a href="../../d9/dbc/classtheo_1_1theo__t.html#a39e067dd71f82b437c6a418d41e38b27">More...</a><br /></td></tr>
<tr class="separator:a39e067dd71f82b437c6a418d41e38b27"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a97c52bda4b07a456ff1ea6f3c1cdbe24"><td class="memItemLeft" align="right" valign="top">std::uintptr_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="../../d9/dbc/classtheo_1_1theo__t.html#a97c52bda4b07a456ff1ea6f3c1cdbe24">resolve</a> (const std::string &amp;&amp;sym)</td></tr>
<tr class="memdesc:a97c52bda4b07a456ff1ea6f3c1cdbe24"><td class="mdescLeft">&#160;</td><td class="mdescRight">given the name of a symbol, it returns the address of where its mapped. <a href="../../d9/dbc/classtheo_1_1theo__t.html#a97c52bda4b07a456ff1ea6f3c1cdbe24">More...</a><br /></td></tr>
<tr class="separator:a97c52bda4b07a456ff1ea6f3c1cdbe24"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p >the main class which encapsulates a symbol table, decomp, and recomp objects. This class is a bridge that connects all three: decomp, obf, recomp. </p>
<p >You will create an object of this type when using theo. </p>
<p class="definition">Definition at line <a class="el" href="../../d2/d24/theo_8hpp_source.html#l00070">70</a> of file <a class="el" href="../../d2/d24/theo_8hpp_source.html">theo.hpp</a>.</p>
</div><h2 class="groupheader">Constructor &amp; Destructor Documentation</h2>
<a id="a0a9ae3322261b97cf1dc47c908ef3c6d" name="a0a9ae3322261b97cf1dc47c908ef3c6d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a0a9ae3322261b97cf1dc47c908ef3c6d">&#9670;&nbsp;</a></span>theo_t()</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">theo::theo_t::theo_t </td>
<td>(</td>
<td class="paramtype">std::vector&lt; std::uint8_t &gt; &amp;&#160;</td>
<td class="paramname"><em>lib</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="../../da/de6/namespacetheo.html#a66efe2c63e06764fb2d9a378c688c680">lnk_fns_t</a>&#160;</td>
<td class="paramname"><em>lnkr_fns</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::string &amp;&amp;&#160;</td>
<td class="paramname"><em>entry_sym</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">explicit</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>explicit constructor for theo class. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">lib</td><td>a vector of bytes consisting of a lib</td></tr>
<tr><td class="paramname">lnkr_fns</td><td></td></tr>
<tr><td class="paramname">entry_sym</td><td>the name of the function which will be used as the entry point</td></tr>
</table>
</dd>
</dl>
<p class="definition">Definition at line <a class="el" href="../../d2/d26/theo_8cpp_source.html#l00034">34</a> of file <a class="el" href="../../d2/d26/theo_8cpp_source.html">theo.cpp</a>.</p>
<div class="fragment"><div class="line"><span class="lineno"> 37</span> : m_dcmp(lib, &amp;m_sym_tbl),</div>
<div class="line"><span class="lineno"> 38</span> m_recmp(&amp;m_dcmp, {}, {}, {}),</div>
<div class="line"><span class="lineno"> 39</span> m_entry_sym(entry_sym) {</div>
<div class="line"><span class="lineno"> 40</span> m_recmp.<a class="code hl_function" href="../../d5/d05/classtheo_1_1recomp_1_1recomp__t.html#a0da9a904b0057c14190218592aff0f07" title="setter for the allocater lambda function.">allocator</a>(std::get&lt;0&gt;(lnkr_fns));</div>
<div class="line"><span class="lineno"> 41</span> m_recmp.<a class="code hl_function" href="../../d5/d05/classtheo_1_1recomp_1_1recomp__t.html#aa6fecf752d4c5bc211e164d8496724b1" title="setter for the copier lambda function.">copier</a>(std::get&lt;1&gt;(lnkr_fns));</div>
<div class="line"><span class="lineno"> 42</span> m_recmp.<a class="code hl_function" href="../../d5/d05/classtheo_1_1recomp_1_1recomp__t.html#a1be6d0cdb57565c31b138248c8b2d470" title="setter for the resolve lambda function.">resolver</a>(std::get&lt;2&gt;(lnkr_fns));</div>
<div class="line"><span class="lineno"> 43</span>}</div>
</div><!-- fragment -->
</div>
</div>
<h2 class="groupheader">Member Function Documentation</h2>
<a id="a39e067dd71f82b437c6a418d41e38b27" name="a39e067dd71f82b437c6a418d41e38b27"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a39e067dd71f82b437c6a418d41e38b27">&#9670;&nbsp;</a></span>compose()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::uintptr_t theo::theo_t::compose </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>compose the decomposed module. This will run obfuscation passes, the map and resolve symbols to each other. </p>
<dl class="section return"><dt>Returns</dt><dd>returns the address of the entry point symbol</dd></dl>
<p class="definition">Definition at line <a class="el" href="../../d2/d26/theo_8cpp_source.html#l00056">56</a> of file <a class="el" href="../../d2/d26/theo_8cpp_source.html">theo.cpp</a>.</p>
<div class="fragment"><div class="line"><span class="lineno"> 56</span> {</div>
<div class="line"><span class="lineno"> 57</span> <span class="comment">// run obfuscation engine on all symbols...</span></div>
<div class="line"><span class="lineno"> 58</span> <span class="comment">//</span></div>
<div class="line"><span class="lineno"> 59</span> <span class="keyword">auto</span> engine = <a class="code hl_function" href="../../d9/d18/classtheo_1_1obf_1_1engine__t.html#a58715f5c3ade824a65e602aba570040e" title="get the singleton object of this class.">obf::engine_t::get</a>();</div>
<div class="line"><span class="lineno"> 60</span> m_sym_tbl.<a class="code hl_function" href="../../db/d77/classtheo_1_1recomp_1_1symbol__table__t.html#a35008ba37814a94209cf979302e13e6d" title="this function is a wrapper function that allows you to get at each entry in the symbol table by refer...">for_each</a>([&amp;](decomp::symbol_t&amp; sym) { engine-&gt;run(&amp;sym); });</div>
<div class="line"><span class="lineno"> 61</span> </div>
<div class="line"><span class="lineno"> 62</span> m_recmp.<a class="code hl_function" href="../../d5/d05/classtheo_1_1recomp_1_1recomp__t.html#a78502665e218d3addca9b1e5e3875f39" title="when called, this function allocates space for every symbol.">allocate</a>();</div>
<div class="line"><span class="lineno"> 63</span> m_recmp.<a class="code hl_function" href="../../d5/d05/classtheo_1_1recomp_1_1recomp__t.html#a299fbede378f04991df2e39293307094" title="when called, this function resolves all relocations in every symbol.">resolve</a>();</div>
<div class="line"><span class="lineno"> 64</span> m_recmp.<a class="code hl_function" href="../../d5/d05/classtheo_1_1recomp_1_1recomp__t.html#a080d88f122d12faf2e328c9bdd10be6e" title="when called, this function copies symbols into allocations.">copy_syms</a>();</div>
<div class="line"><span class="lineno"> 65</span> <span class="keywordflow">return</span> m_recmp.<a class="code hl_function" href="../../d5/d05/classtheo_1_1recomp_1_1recomp__t.html#a299fbede378f04991df2e39293307094" title="when called, this function resolves all relocations in every symbol.">resolve</a>(m_entry_sym.data());</div>
<div class="line"><span class="lineno"> 66</span>}</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="../../db/d55/recomp_8cpp_source.html#l00040">theo::recomp::recomp_t::allocate()</a>, <a class="el" href="../../db/d55/recomp_8cpp_source.html#l00155">theo::recomp::recomp_t::copy_syms()</a>, <a class="el" href="../../da/d0c/symbol__table_8cpp_source.html#l00049">theo::recomp::symbol_table_t::for_each()</a>, <a class="el" href="../../da/d5c/engine_8cpp_source.html#l00034">theo::obf::engine_t::get()</a>, and <a class="el" href="../../db/d55/recomp_8cpp_source.html#l00092">theo::recomp::recomp_t::resolve()</a>.</p>
<p class="reference">Referenced by <a class="el" href="../../df/d0a/main_8cpp_source.html#l00057">main()</a>.</p>
</div>
</div>
<a id="a66257ff5d9825483d85e58384a12760a" name="a66257ff5d9825483d85e58384a12760a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a66257ff5d9825483d85e58384a12760a">&#9670;&nbsp;</a></span>decompose()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::optional&lt; std::uint32_t &gt; theo::theo_t::decompose </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>decomposes the lib file and return the number of symbols that are used. </p>
<dl class="section return"><dt>Returns</dt><dd>optional amount of symbols that are used. no value if decomposition fails.</dd></dl>
<p class="definition">Definition at line <a class="el" href="../../d2/d26/theo_8cpp_source.html#l00045">45</a> of file <a class="el" href="../../d2/d26/theo_8cpp_source.html">theo.cpp</a>.</p>
<div class="fragment"><div class="line"><span class="lineno"> 45</span> {</div>
<div class="line"><span class="lineno"> 46</span> <span class="keyword">auto</span> res = m_dcmp.<a class="code hl_function" href="../../d6/d0e/classtheo_1_1decomp_1_1decomp__t.html#ae23353a4293aa30969b6d3fa37359469" title="decomposes (extracts) the symbols used. this function determines all used symbols given the entry poi...">decompose</a>(m_entry_sym);</div>
<div class="line"><span class="lineno"> 47</span> <span class="keywordflow">if</span> (!res.has_value()) {</div>
<div class="line"><span class="lineno"> 48</span> spdlog::error(<span class="stringliteral">&quot;failed to decompose...\n&quot;</span>);</div>
<div class="line"><span class="lineno"> 49</span> <span class="keywordflow">return</span> {};</div>
<div class="line"><span class="lineno"> 50</span> }</div>
<div class="line"><span class="lineno"> 51</span> </div>
<div class="line"><span class="lineno"> 52</span> spdlog::info(<span class="stringliteral">&quot;decompose successful... {} symbols&quot;</span>, res.value()-&gt;size());</div>
<div class="line"><span class="lineno"> 53</span> <span class="keywordflow">return</span> res.value()-&gt;size();</div>
<div class="line"><span class="lineno"> 54</span>}</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="../../dc/d83/decomp_8cpp_source.html#l00037">theo::decomp::decomp_t::decompose()</a>.</p>
<p class="reference">Referenced by <a class="el" href="../../df/d0a/main_8cpp_source.html#l00057">main()</a>.</p>
</div>
</div>
<a id="a97c52bda4b07a456ff1ea6f3c1cdbe24" name="a97c52bda4b07a456ff1ea6f3c1cdbe24"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a97c52bda4b07a456ff1ea6f3c1cdbe24">&#9670;&nbsp;</a></span>resolve()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::uintptr_t theo::theo_t::resolve </td>
<td>(</td>
<td class="paramtype">const std::string &amp;&amp;&#160;</td>
<td class="paramname"><em>sym</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>given the name of a symbol, it returns the address of where its mapped. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">sym</td><td>the name of the symbol</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>the address of the symbol</dd></dl>
<p class="definition">Definition at line <a class="el" href="../../d2/d26/theo_8cpp_source.html#l00068">68</a> of file <a class="el" href="../../d2/d26/theo_8cpp_source.html">theo.cpp</a>.</p>
<div class="fragment"><div class="line"><span class="lineno"> 68</span> {</div>
<div class="line"><span class="lineno"> 69</span> <span class="keyword">auto</span> val = m_sym_tbl.<a class="code hl_function" href="../../db/d77/classtheo_1_1recomp_1_1symbol__table__t.html#a308c0dbcc4d569467e0986b32ef30db5" title="returns an optional pointer to a symbol from the symbol table given the symbols hash (hash of its nam...">sym_from_hash</a>(<a class="code hl_function" href="../../d9/dd5/classtheo_1_1decomp_1_1symbol__t.html#a8695d75670cc4d61d275464e9109ff06" title="gets the hash of the symbol name.">decomp::symbol_t::hash</a>(sym));</div>
<div class="line"><span class="lineno"> 70</span> <span class="keywordflow">if</span> (!val.has_value())</div>
<div class="line"><span class="lineno"> 71</span> <span class="keywordflow">return</span> {};</div>
<div class="line"><span class="lineno"> 72</span> </div>
<div class="line"><span class="lineno"> 73</span> <span class="keywordflow">return</span> val.value()-&gt;allocated_at();</div>
<div class="line"><span class="lineno"> 74</span>}</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="../../d8/d67/symbol_8cpp_source.html#l00088">theo::decomp::symbol_t::hash()</a>, and <a class="el" href="../../da/d0c/symbol__table_8cpp_source.html#l00054">theo::recomp::symbol_table_t::sym_from_hash()</a>.</p>
</div>
</div>
<hr/>The documentation for this class was generated from the following files:<ul>
<li>include/<a class="el" href="../../d2/d24/theo_8hpp_source.html">theo.hpp</a></li>
<li>src/<a class="el" href="../../d2/d26/theo_8cpp_source.html">theo.cpp</a></li>
</ul>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="../../doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.3
</small></address>
</body>
</html>