blob: 7aeb2c5f65bbd96902e91a9c6425915d68cb2d38 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
# tor-dirmgr
`tor-dirmgr`: Code to fetch, store, and update Tor directory information.
## 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.
## Compile-time features
`mmap` (default) -- Use memory mapping to reduce the memory load for
reading large directory objects from disk.
`static` -- Try to link with a static copy of sqlite3.
`routerdesc` -- (Incomplete) support for downloading and storing
router descriptors.
### Experimental features
## Compile-time features
### 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
directory informatoin before it is used.
* `bridge-client`: Provide (as yet unimplented) APIs used to fetch
and use bridge information.
* `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.
License: MIT OR Apache-2.0
|
