Tor启动流程源码解析

Tor笔记目录索引

Tor的程序分布比较散，经常会跨着多层文件夹互相引用，可以活用编辑器的跳转以及GDB调试等手段找到运行逻辑

这里使用的Tor版本为：Tor version 0.4.4.0-alpha-dev (git-a6509cb86744f8f2).

main()

主函数int main()位于src/app/main/tor_main.c中，并且完全独立于别的模块，以便于各模块单独进行测试
启动时需要注意的是，为了解决Ticket #23847 Make sure Tor can shut down via control port, and start again in same process，这里使用--enable_restart_debugging开启自动重启，程序将从环境变量TOR_DEBUG_RESTART读取重启次数，同时可以使用环境变量TOR_DEBUG_RESTART_AFTER_SECONDS来设置重启时间

tor_main()

int main()函数会调用位于src/feature/api/tor_api.c的int tor_main(int argc, char *argv[])
整个src/feature/api文件夹内的程序都是对外开放的接口，用以外部调用Tor，同时不带有注释的函数不应该被外部调用
这里tor_main()中的操作为将命令行参数转换为内部格式，并调用tor_run_main()函数（这也是整个src/feature/api的所有功能）

尽管这个属于对外接口，但是要拓展Tor不应该调用它，而应该直接调用下面的tor_run_main()

tor_run_main()

接着调用位于src/app/main/main.c的int tor_run_main(const tor_main_configuration_t *tor_cfg)
在这个函数里会按照顺序执行以下任务：

• 如果libevent库存在，便会使用设置libevent内存分配函数event_set_mem_functions()，使用Tor的内存分配、重分配、释放函数接管libevent的对应函数
• 启动所有的子系统
• 解析命令行参数
• 初始化子系统订阅、广播
• Tor主程序初始化(从torrc读入配置项等操作)
• 链接子系统订阅、广播
• 使用get_options()获得一个or_options_t类型的结构体，用于记录torrc的一些配置项
• 根据运行模式执行对应的功能

在这里，比较重要的是Tor主程序本身的初始化，因为各个子系统本身是类似插件的模块，虽然有一些依赖关系，但是不是程序的主体

tor_init()

在这个函数中，对各种Tor的全局变量进行配置

• 初始化history、cache等内容
• 初始化Hidden Server(匿名网络服务端)
• 设置日志等级
• 初始化Rust的日志输出（如果编译时开启了Rust）
• 从配置项及torrc读入配置（src/app/config/config.c中的int options_init_from_torrc(int argc, char **argv)）
• 初始化流量填充功能¹
• 初始化Hidden Server的拒绝服务子系统
• 清除无法解析的描述符

运行模式

typedef enum {
  CMD_RUN_TOR=0, /* 默认模式，启动一个Tor守护进程 */
  CMD_LIST_FINGERPRINT, /* 使用参数 --list-fingerprint. */
  CMD_HASH_PASSWORD, /* 使用参数 --hash-password. */
  CMD_VERIFY_CONFIG, /* 使用参数 --verify-config. */
  CMD_DUMP_CONFIG, /* 使用参数 --dump-config. */
  CMD_KEYGEN, /* 使用参数 --keygen */
  CMD_KEY_EXPIRATION, /* 使用参数 --key-expiration */
  CMD_IMMEDIATE, /* 配置项处理模式 */
  CMD_RUN_UNITTESTS, /* 特殊模式 单例测试模式 */
} tor_cmdline_mode_t;