2021-05-25 20:41:23 +01:00
|
|
|
# tor-dirmgr
|
|
|
|
|
2022-12-20 13:31:47 +00:00
|
|
|
Code to fetch, store, and update Tor directory information.
|
2021-05-25 20:41:23 +01:00
|
|
|
|
|
|
|
## Overview
|
|
|
|
|
|
|
|
This crate is part of
|
|
|
|
[Arti](https://gitlab.torproject.org/tpo/core/arti/), a project to
|
|
|
|
implement [Tor](https://www.torproject.org/) in Rust.
|
|
|
|
|
|
|
|
In its current design, Tor requires a set of up-to-date
|
|
|
|
authenticated directory documents in order to build multi-hop
|
|
|
|
anonymized circuits through the network.
|
|
|
|
|
|
|
|
This directory manager crate is responsible for figuring out which
|
|
|
|
directory information we lack, downloading what we're missing, and
|
|
|
|
keeping a cache of it on disk.
|
|
|
|
|
2021-08-26 18:22:41 +01:00
|
|
|
## Compile-time features
|
|
|
|
|
2022-11-16 17:55:03 +00:00
|
|
|
* `mmap` (default) -- Use memory mapping to reduce the memory load for
|
|
|
|
reading large directory objects from disk.
|
2021-08-26 18:22:41 +01:00
|
|
|
|
2022-11-16 17:55:03 +00:00
|
|
|
* `routerdesc` -- (Incomplete) support for downloading and storing
|
|
|
|
router descriptors.
|
2021-08-26 18:22:41 +01:00
|
|
|
|
2022-11-16 17:55:03 +00:00
|
|
|
* `compression` (default) -- Build support for downloading compressed
|
|
|
|
documents. Requires a C compiler.
|
2021-11-29 11:29:28 +00:00
|
|
|
|
2022-11-16 17:55:03 +00:00
|
|
|
* `bridge-client`: Provide APIs used to fetch
|
|
|
|
and use bridge information.
|
|
|
|
|
|
|
|
* `full` -- Enable all features above.
|
|
|
|
|
|
|
|
### Non-additive features
|
|
|
|
|
|
|
|
* `static` -- Try to link with a static copy of sqlite3.
|
2022-11-10 13:34:17 +00:00
|
|
|
|
2022-09-30 19:27:51 +01:00
|
|
|
### Experimental and unstable features
|
|
|
|
|
|
|
|
Note that the APIs enabled by these features are NOT covered by
|
|
|
|
semantic versioning[^1] guarantees: we might break them or remove
|
|
|
|
them between patch versions.
|
|
|
|
|
|
|
|
* `experimental-api`: Add additional non-stable APIs to our public
|
|
|
|
interfaces.
|
|
|
|
|
|
|
|
* `dirfilter`: enable an experimental mechanism to modify incoming
|
2022-10-18 20:39:33 +01:00
|
|
|
directory information before it is used.
|
2022-09-30 19:27:51 +01:00
|
|
|
|
|
|
|
* `experimental`: Enable all the above experimental features.
|
|
|
|
|
|
|
|
[^1]: Remember, semantic versioning is what makes various `cargo`
|
|
|
|
features work reliably. To be explicit: if you want `cargo update`
|
|
|
|
to _only_ make safe changes, then you cannot enable these
|
|
|
|
features.
|
|
|
|
|
2021-05-25 20:41:23 +01:00
|
|
|
License: MIT OR Apache-2.0
|