<h1 id="tor">Tor启动流程源码解析</h1>
<p><a href="/post/note_tor_index"><strong>Tor笔记目录索引</strong></a></p>
<p>Tor的程序分布比较散，经常会跨着多层文件夹互相引用，可以活用编辑器的跳转以及GDB调试等手段找到运行逻辑</p>
<p>这里使用的Tor版本为：Tor version 0.4.4.0-alpha-dev (git-a6509cb86744f8f2).</p>
<h2 id="main">main()</h2>
<p>主函数<code>int main()</code>位于<code>src/app/main/tor_main.c</code>中，并且完全独立于别的模块，以便于各模块单独进行测试<br>
启动时需要注意的是，为了解决<a href="https://trac.torproject.org/projects/tor/ticket/23847">Ticket #23847 Make sure Tor can shut down via control port, and start again in same process</a>，这里使用<code>--enable_restart_debugging</code>开启自动重启，程序将从环境变量<code>TOR_DEBUG_RESTART</code>读取重启次数，同时可以使用环境变量<code>TOR_DEBUG_RESTART_AFTER_SECONDS</code>来设置重启时间</p>
<h2 id="tor-main">tor_main()</h2>
<p><code>int main()</code>函数会调用位于<code>src/feature/api/tor_api.c</code>的<code>int tor_main(int argc, char *argv[])</code><br>
整个<code>src/feature/api</code>文件夹内的程序都是对外开放的接口，用以外部调用Tor，同时不带有注释的函数不应该被外部调用<br>
这里<code>tor_main()</code>中的操作为将命令行参数转换为内部格式，并调用<code>tor_run_main()</code>函数（这也是整个<code>src/feature/api</code>的所有功能）</p>
<p>尽管这个属于对外接口，但是要拓展Tor不应该调用它，而应该直接调用下面的<code>tor_run_main()</code></p>
<h2 id="tor-run-main">tor_run_main()</h2>
<p>接着调用位于<code>src/app/main/main.c</code>的<code>int tor_run_main(const tor_main_configuration_t *tor_cfg)</code><br>
在这个函数里会按照顺序执行以下任务：</p>
<ul>
<li>如果<code>libevent</code>库存在，便会使用设置libevent内存分配函数<code>event_set_mem_functions()</code>，使用Tor的内存分配、重分配、释放函数接管<code>libevent</code>的对应函数</li>
<li>启动所有的子系统</li>
<li>解析命令行参数</li>
<li>初始化子系统订阅、广播</li>
<li><strong>Tor主程序初始化</strong>(从torrc读入配置项等操作)</li>
<li>链接子系统订阅、广播</li>
<li>使用<code>get_options()</code>获得一个<code>or_options_t</code>类型的结构体，用于记录torrc的一些配置项</li>
<li>根据运行模式执行对应的功能</li>
</ul>
<p>在这里，比较重要的是Tor主程序本身的初始化，因为各个子系统本身是类似插件的模块，虽然有一些依赖关系，但是不是程序的主体</p>
<h2 id="tor-init">tor_init()</h2>
<p>在这个函数中，对各种Tor的全局变量进行配置</p>
<ul>
<li>初始化history、cache等内容</li>
<li>初始化Hidden Server(匿名网络服务端)</li>
<li>设置日志等级</li>
<li>初始化Rust的日志输出（如果编译时开启了Rust）</li>
<li><strong>从配置项及torrc读入配置</strong>（<code>src/app/config/config.c</code>中的<code>int options_init_from_torrc(int argc, char **argv)</code>）</li>
<li>初始化流量填充功能<sup id="fnref:1"><a href="#fn:1" class="footnote-ref" role="doc-noteref">1</a></sup></li>
<li>初始化Hidden Server的拒绝服务子系统</li>
<li>清除无法解析的描述符</li>
</ul>
<h3 id="heading">运行模式</h3>
<pre style="background-color:#fff"><span style="font-weight:bold">typedef</span> <span style="font-weight:bold">enum</span> {
  CMD_RUN_TOR<span style="font-weight:bold">=</span><span style="color:#099">0</span>, <span style="color:#998;font-style:italic">/* 默认模式，启动一个Tor守护进程 */</span>
  CMD_LIST_FINGERPRINT, <span style="color:#998;font-style:italic">/* 使用参数 --list-fingerprint. */</span>
  CMD_HASH_PASSWORD, <span style="color:#998;font-style:italic">/* 使用参数 --hash-password. */</span>
  CMD_VERIFY_CONFIG, <span style="color:#998;font-style:italic">/* 使用参数 --verify-config. */</span>
  CMD_DUMP_CONFIG, <span style="color:#998;font-style:italic">/* 使用参数 --dump-config. */</span>
  CMD_KEYGEN, <span style="color:#998;font-style:italic">/* 使用参数 --keygen */</span>
  CMD_KEY_EXPIRATION, <span style="color:#998;font-style:italic">/* 使用参数 --key-expiration */</span>
  CMD_IMMEDIATE, <span style="color:#998;font-style:italic">/* 配置项处理模式 */</span>
  CMD_RUN_UNITTESTS, <span style="color:#998;font-style:italic">/* 特殊模式 单例测试模式 */</span>
} tor_cmdline_mode_t;
</pre><section class="footnotes" role="doc-endnotes">
<hr>
<ol>
<li id="fn:1" role="doc-endnote">
<p><a href="https://blog.csdn.net/LHF_debug/article/details/79768940">TOR原生数据填充方式（Channel Padding）</a> <a href="#fnref:1" class="footnote-backref" role="doc-backlink">&#x21a9;&#xfe0e;</a></p>
</li>
</ol>
</section>
