------ Tor(洋葱路由器)匿名网络源码分析——主程序入口点(一)------

————————————————————————————————————————————————————————
《概览》

tor 的源码包可以从官网下载,可能需要预先利用其它=*翻^=*墙*软件才能访问该站点。分析 tor 源码有助于我们理解当代最强大之一的

互联网匿名、隐身、审查规避软件的运作原理。

为了从整体上把握住程序的逻辑与功能,本系列会将源码重要部分通过函数调用流程图总结,以便站在设计思想的高度来考察 tor。

《约定》

当引用函数/结构体/宏/定义/声明时,我会在圆括号内给出它所在源文件的完整路径,必要时还会给出代码行号,例如:

tor_main()(\tor-0.3.1.8\src\or\main.c)——3682

中间的路径省略掉解压至磁盘上的驱动器号,假定存放于根目录下

源码的版本为 0.3.1.8(引用代码片段的截图中也会在右下角给出完整路径,以及代码行号)

《要求》

tor 以 C 编程语言开发,故需要各位具备关于 C 的基本知识和开发经验,才能有较佳的源码分析体验。

此外,tor 为了实现跨 OS 平台兼容性,源码中经常出现 OS 相关的“条件编译”代码块,因此也要求各位对主流操作系统的用户态编程接口有一定程度的了

解。

《反馈》

由于本人知识水平有限,加上工作的关系,本系列内容可能存在谬误之处,且会不定期更新。

欢迎反馈任何勘误,或者加入行列提高分析进展,可在评论处提交自己感兴趣分析的模块和自己的分析博文 URL!

————————————————————————————————————————————————————————

tor 主程序的入口点从 tor_main()(\tor-0.3.1.8\src\or\main.c)开始,实际上它是被 main()(\tor-0.3.1.8\src\or\tor_main.c)所调用的。

把 main() 从 main.c 中分离的原因在于——其它实现单元测试的源文件(test_*.c)中的 main() 函数,就可以链接 main.c ,

因为后者中不存在同名的 main() 函数,不会产生名称冲突。三者的关系请参考下图:

------ Tor(洋葱路由器)匿名网络源码分析——主程序入口点(一)------

首先来看 main(),它把调用 tor_main() 返回的整型值保存到局部变量 r 中,然后根据 r 的值来作出相应处理:

如果 0 <= r <= 255 ,则返回 r 的具体值到 main() 的调用者(通常会是负责初始化 Tor 进程运行环境的 CRT 启动例程),否则返回 1。

进一步而言,tor_main() 的开头部分就定义了一个整型变量 result,并初始化为 0, tor_main() 的内部逻辑会根据不同场景把

result 设定为相应的值然后返回给 main()。相关的代码片段如下:

------ Tor(洋葱路由器)匿名网络源码分析——主程序入口点(一)------

------ Tor(洋葱路由器)匿名网络源码分析——主程序入口点(一)------

从上两张图可知,main() 把自己收到的两个参数:argc(执行 tor 命令时的参数数量)和 argv(包含具体参数的列表/数组)原封不动的传递给

tor_main(),后者会在特定情况下用到这两个参数,比如调用 tor_init() 时传递过去,而 tor_init() 的主要任务之一,就是通过解析 argv 中携带的命令行

参数信息,来按照用户的意图初始化 tor 系统。

关于 Tor 命令行参数字串与个数的传递部分流程,请参考下图:

------ Tor(洋葱路由器)匿名网络源码分析——主程序入口点(一)------

tor_main() 初始化自身的返回值后,我们遇到了第一个代码条件编译块,它是与 Windows 平台相关的。块中的内容仅在满足

特定条件时才被构建为可执行代码。相关的代码片段如下:

------ Tor(洋葱路由器)匿名网络源码分析——主程序入口点(一)------

对于 32 位 windows 平台,且没有定义“当堆数据损坏时,终止进程的功能(HeapEnableTerminationOnCorruption)”,则按照

MSDN 文档的描述,将其枚举常量的值定义为 1

(HeapEnableTerminationOnCorruption 的作用是,假设 OS 的堆管理器检测到由进程使用的任意堆中有错误,

堆管理器会调用 WER 服务[Windows 错误报告],然后终止进程,该功能打开后,无法由进程关闭)

若已定义该功能,则调用 HeapSetInformation() ,为它的第二个参数传入 HeapEnableTerminationOnCorruption,来打开该功能;

HeapSetInformation() 的第一个参数是到要设置的堆句柄,通常由 HeapCreate() 或 GetProcessHeap() 返回;

由于在此之前,tor_main() 并没有创建堆,所以堆句柄为 NULL;从 Windows Vista 开始,默认就启用了“低碎片堆”

(low-fragmenation heap,LFH),所以应用程序会使用或创建 LFH;关于 LFH,请参考:

https://msdn.microsoft.com/en-us/library/windows/desktop/aa366750(v=vs.85).aspx

注意,即便 HeapSetInformation() 调用失败, OS 也会让应用程序继续运行,所以应该对 HeapSetInformation() 的返回值进行

检测:如果无法打开该功能,则 Tor 进程应该返回失败并退出——这正是源码中所遗漏的逻辑。

例如,在 Windows 平台,更健壮的代码如下:

 BOOL bResult;
bResult = HeapSetInformation(NULL,
HeapEnableTerminationOnCorruption,
NULL,
); if (bResult != FALSE) {
_tprintf(TEXT("Heap terminate-on-corruption has been enabled.\n"));
}
else {
_tprintf(TEXT("Failed to enable heap terminate-on-corruption with LastError %d.\n"),
GetLastError());
return ;
}

上图关键之处在于调用 SetProcessDEPPolicy(),永久打开 Tor 主进程的数据执行保护(DEP)功能,

因为 Tor 是一个网络应用程序,需要通过网络频繁收发数据,程序中的任何编码缺陷,都可能导致远程代码执行,所以

添加此一调用可以缓解缓冲区溢出/堆栈溢出攻击造成的危害。

SetProcessDEPPolicy() 是位于 Kernel32.dll 中的 API 函数(参见相关 MSDN 文档中的“系统要求”),

而 Kernel32.dll 采用“加载时动态连接”到 Tor 进程的内存映射中,所以首先要以 GetModuleHandleA() 取得该模块的句柄,

(采用“运行时动态链接”的应用程序会调用 LoadLibrary/Ex())

在成功获取的前提下,以 GetProcAddress() 取得 SetProcessDEPPolicy() 函数的地址,将其赋给以“typedef”类型定义和

声明的函数指针“setdeppolicy”,如能解析到该函数的地址,就可以直接通过调用 setdeppolicy 来“尝试”打开 DEP。

为啥我要强调“尝试”呢?

在较早版本的 Windows 中,通过 GetProcAddress() 来获取 SetProcessDEPPolicy() 的地址会解析失败,所以需要对返回的函数

指针进行检查,如果为空,就不该,也无法对 Tor 主进程启动数据执行保护(DEP);另外,假使系统能够解析到

SetProcessDEPPolicy() 的地址,而对它的调用失败却不会导致危险,所以无需错误处理,只管调用即可——就算无法

开启 DEP,Tor 也要继续运行下去,这就完全依赖于安全的编码意识了。。。。。

而根据 MSDN 文档的描述,为 SetProcessDEPPolicy() 的 DWORD 型参数 dwFlags 传入 0x3 

表明 PROCESS_DEP_ENABLE(0x00000001)与 PROCESS_DEP_DISABLE_ATL_THUNK_EMULATION(0x00000002)特性被同时打开,这与

源码中的注解相符。

最后,PROCESS_DEP_ENABLE(0x00000001)标志的设定,意味着在整个 Tor 进程的生命周期内,都无法关闭 DEP(如果成功启用)。

第一个条件编译块到此结束,其充分利用了 Windows 平台为应用程序提供的额外安全机制。

经过平台特定的代码块后,为了让 Tor 进程在崩溃时转储栈信息,以便后续的调试分析?调用了 configure_backtrace_handler()

函数(\tor-0.3.1.8\src\common\backtrace.c),来配置回溯处理程序。相关的代码片段如下:

------ Tor(洋葱路由器)匿名网络源码分析——主程序入口点(一)------

configure_backtrace_handler() 接受一个指向字符常量的指针,这可以通过 get_version() 辅助例程获取到 Tor 应用程序的版本信息。

configure_backtrace_handler() 首先调用宏 tor_free()(\tor-0.3.1.8\src\common\util.h——83),来释放由 backtrace.c 静态

分配的全局变量 bt_version,它是一个 NULL 指针,而 tor_free() 可以安全地释放 NULL 指针,而且把它引用的内存位置也设为

NULL。

根据是否获取到版本信息,它调用 tor_asprintf() 向控制台/shell 输出相应的程序启动信息,然后调用

install_bt_handler() (在同一份源文件内),并将其返回值传递给 tor_main()。

如果注册崩溃回调函数失败,install_bt_handler() 返回 -1;否则返回 0,最终通知 tor_main() 成功“挂钩”!

阅读 backtrace.c 我们可以了解到:如果没有在编译时指定 USE_BACKTRACE 选项,则 install_bt_handler() 仅仅只是返回 0 到

调用者——不会实际注册回溯处理程序。否则,install_bt_handler() 将针对包含崩溃在内的一些信号

(SIGSEGV, SIGILL, SIGFPE, SIGBUS, SIGSYS, SIGIO),安装一致的回溯处理程序 crash_handler(),

后者调用 backtrace() ,最终成生栈回溯信息。

这里我们要明确一点,当程序启动并正常运行时,只会调用 configure_backtrace_handler() 与 install_bt_handler();当程序

崩溃或收到上述六种信号之一,crash_handler() 与 backtrace() 就会被调用(因此后两者才是 CallBack)。

我们可以从 crash_handler() 内部最后的 abort() 调用逻辑得证——只有在崩溃时才需要中止继续运行。

相关的代码片段如下:

------ Tor(洋葱路由器)匿名网络源码分析——主程序入口点(一)------

------ Tor(洋葱路由器)匿名网络源码分析——主程序入口点(一)------

------ Tor(洋葱路由器)匿名网络源码分析——主程序入口点(一)------

上面的长篇大论用下面一张图清晰地总结:

------ Tor(洋葱路由器)匿名网络源码分析——主程序入口点(一)------

至此,我们解剖了 tor 程序入口点 tor_main() 中,到 configure_backtrace_handler() 为止的代码意图,但这仅仅只是开场白

而已,在后面的博文我将继续分析与 tor 业务逻辑相关的代码,这才是“干货”所在!

(未完待续。。。。。。)

上一篇:在纯C工程的main函数之前跑代码(手工找到程序入口点, 替换为我们自己的函数)


下一篇:Android程序的入口点和全局变量设置--application