tor-dirmgr

用于获取、存储和更新Tor目录信息的代码。

概述

此crate是Arti项目的一部分，该项目旨在用Rust实现Tor。

在其当前设计中，Tor需要一组最新的已验证目录文档，以便在网络中构建多跳匿名电路。

此目录管理crate负责确定我们缺少哪些目录信息，下载我们缺少的内容，并在磁盘上缓存它。

编译时功能

• mmap（默认）-- 使用内存映射来减少从磁盘读取大目录对象时的内存负载。

• routerdesc--（不完整）支持下载和存储路由描述符。

• compression（默认）-- 建立下载压缩文档的支持。需要C编译器。

• bridge-client：提供用于获取和使用桥信息的API。

• full-- 启用上述所有功能。

非增量功能

• static-- 尝试与sqlite3的静态副本链接。

实验性和不稳定的功能

请注意，由这些功能启用的API不受语义版本控制[^1]保证：我们可能在补丁版本之间破坏它们或删除它们。

• experimental-api：向我们的公共接口添加额外的非稳定API。

• dirfilter：启用在目录信息被使用之前修改它的实验机制。

• experimental：启用上述所有实验功能。

[^1]：请记住，语义化版本控制是使各种cargo功能可靠工作的关键。明确来说：如果你想使cargo update只进行安全更改，则不能启用这些功能。

许可证：MIT 或 Apache-2.0