2021-05-25 20:41:23 +01:00
|
|
|
# tor-circmgr
|
|
|
|
|
2022-12-20 13:31:47 +00:00
|
|
|
circuits through the Tor network on demand.
|
2021-05-25 20:41:23 +01:00
|
|
|
|
2021-08-12 14:36:34 +01:00
|
|
|
## Overview
|
2021-05-25 20:41:23 +01:00
|
|
|
|
|
|
|
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.
|
|
|
|
|
2022-10-21 15:04:35 +01:00
|
|
|
## Compile-time features
|
|
|
|
|
2022-11-16 17:35:01 +00:00
|
|
|
* `specific-relay`: Support for connecting to a relay via
|
|
|
|
specifically provided connection instructions, rather than
|
|
|
|
using information from a Tor network directory.
|
|
|
|
|
|
|
|
* `full`: Enable all features above.
|
|
|
|
|
2022-10-21 15:04:35 +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.
|
|
|
|
|
|
|
|
* `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
|