summaryrefslogtreecommitdiff
path: root/tor-circmgr/README.md
blob: 6e6663d263ee873631d8e4dc4c2817cdb21096e1 (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
# tor-circmgr

`tor-circmgr`: circuits through the Tor network on demand.

## Limitations

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 Tor, a circuit is an encrypted multi-hop tunnel over multiple
relays.  This crate's purpose, long-term, is to manage a set of
circuits for a client.  It should construct circuits in response
to a client's needs, and preemptively construct circuits so as to
anticipate those needs.  If a client request can be satisfied with
an existing circuit, it should return that circuit instead of
constructing a new one.

But for now, this `tor-circmgr` code is extremely preliminary; its
data structures are all pretty bad, and it's likely that the API
is wrong too.

The path generation code in this crate is missing a colossal
number of features that you'd probably want in production: the
paths it generates should not be considered secure.

License: MIT OR Apache-2.0