Struct arti_client::StreamPrefs

pub struct StreamPrefs { /* private fields */ }

Preferences for how to route a stream over the Tor network.

Implementations

impl StreamPrefs

pub fn new() -> Self

Construct a new StreamPrefs.

pub fn ipv6_preferred(&mut self) -> &mut Self

Indicate that a stream may be made over IPv4 or IPv6, but that we’d prefer IPv6.

pub fn ipv6_only(&mut self) -> &mut Self

Indicate that a stream may only be made over IPv6.

When this option is set, we will only pick exit relays that support IPv6, and we will tell them to only give us IPv6 connections.

pub fn ipv4_preferred(&mut self) -> &mut Self

Indicate that a stream may be made over IPv4 or IPv6, but that we’d prefer IPv4.

This is the default.

pub fn ipv4_only(&mut self) -> &mut Self

Indicate that a stream may only be made over IPv4.

When this option is set, we will only pick exit relays that support IPv4, and we will tell them to only give us IPv4 connections.

pub fn optimistic(&mut self) -> &mut Self

Indicate that the stream should be opened “optimistically”.

By default, streams are not “optimistic”. When you call TorClient::connect(), it won’t give you a stream until the exit node has confirmed that it has successfully opened a connection to your target address. It’s safer to wait in this way, but it is slower: it takes an entire round trip to get your confirmation.

If a stream is configured to be “optimistic”, on the other hand, then TorClient::connect() will return the stream immediately, without waiting for an answer from the exit. You can start sending data on the stream right away, though of course this data will be lost if the connection is not actually successful.

pub fn set_isolation_group(
    &mut self,
    isolation_group: IsolationToken
) -> &mut Self

Indicate which other connections might use the same circuit as this one.

By default all connections made on all clones of a TorClient may share connections. Connections made with a particular isolation_group may share circuits with each other.

This connection preference is orthogonal to isolation established by TorClient::isolated_client. Connections made with an isolated_client (and its clones) will not share circuits with the original client, even if the same isolation_group is specified via the ConnectionPrefs in force.

pub fn new_isolation_group(&mut self) -> &mut Self

Indicate that connections with these preferences should have their own isolation group

This is a convenience method which creates a fresh IsolationToken and sets it for these preferences.

This connection preference is orthogonal to isolation established by TorClient::isolated_client. Connections made with an isolated_client (and its clones) will not share circuits with the original client, even if the same isolation_group is specified via the ConnectionPrefs in force.

pub fn isolate_every_stream(&mut self) -> &mut Self

Indicate that no connection should share a circuit with any other.

Use with care: This is likely to have poor performance, and imposes a much greater load on the Tor network. Use this option only to make small numbers of connections each of which needs to be isolated from all other connections.

(Don’t just use this as a “get more privacy!!” method: the circuits that it put connections on will have no more privacy than any other circuits. The only benefit is that these circuits will not be shared by multiple streams.)

This can be undone by calling set_isolation_group or new_isolation_group on these preferences.

Trait Implementations

impl Clone for StreamPrefs

fn clone(&self) -> StreamPrefs

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StreamPrefs

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for StreamPrefs

fn default() -> StreamPrefs

Returns the “default value” for a type.