Enum tor_cell::chancell::msg::ChanMsg

#[non_exhaustive]
pub enum ChanMsg {
    Padding(Padding),
    VPadding(VPadding),
    Create(Create),
    CreateFast(CreateFast),
    Create2(Create2),
    Created(Created),
    CreatedFast(CreatedFast),
    Created2(Created2),
    Relay(Relay),
    RelayEarly(Relay),
    Destroy(Destroy),
    Netinfo(Netinfo),
    Versions(Versions),
    PaddingNegotiate(PaddingNegotiate),
    Certs(Certs),
    AuthChallenge(AuthChallenge),
    Authenticate(Authenticate),
    Authorize(Authorize),
    Unrecognized(Unrecognized),
}

Decoded message from a channel.

A ChanMsg is an item received on a channel – a message from another Tor client or relay that we are connected to directly over a TLS connection.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Padding(Padding)

Tuple Fields

0: Padding

A Padding message

VPadding(VPadding)

Tuple Fields

0: VPadding

Variable-length padding message

Create(Create)

Tuple Fields

0: Create

(Deprecated) TAP-based cell to create a new circuit.

CreateFast(CreateFast)

Tuple Fields

0: CreateFast

(Mostly deprecated) HMAC-based cell to create a new circuit.

Create2(Create2)

Tuple Fields

0: Create2

Cell to create a new circuit

Created(Created)

Tuple Fields

0: Created

(Deprecated) Answer to a Create cell

CreatedFast(CreatedFast)

Tuple Fields

0: CreatedFast

(Mostly Deprecated) Answer to a CreateFast cell

Created2(Created2)

Tuple Fields

0: Created2

Answer to a Create2 cell

Relay(Relay)

Tuple Fields

0: Relay

A message sent along a circuit, likely to a more-distant relay.

RelayEarly(Relay)

Tuple Fields

0: Relay

A message sent along a circuit (limited supply)

Destroy(Destroy)

Tuple Fields

0: Destroy

Tear down a circuit

Netinfo(Netinfo)

Tuple Fields

0: Netinfo

Part of channel negotiation: describes our position on the network

Versions(Versions)

Tuple Fields

0: Versions

Part of channel negotiation: describes what link protocol versions we support

PaddingNegotiate(PaddingNegotiate)

Tuple Fields

0: PaddingNegotiate

Negotiates what kind of channel padding to send

Certs(Certs)

Tuple Fields

0: Certs

Part of channel negotiation: additional certificates not in the TLS handshake

AuthChallenge(AuthChallenge)

Tuple Fields

0: AuthChallenge

Part of channel negotiation: additional random material to be used as part of authentication

Authenticate(Authenticate)

Tuple Fields

0: Authenticate

Part of channel negotiation: used to authenticate relays when they initiate the channel.

Authorize(Authorize)

Tuple Fields

0: Authorize

Not yet used

Unrecognized(Unrecognized)

Tuple Fields

0: Unrecognized

Any cell whose command we don’t recognize

Implementations

impl ChanMsg

pub fn cmd(&self) -> ChanCmd

Return the ChanCmd for this message.

pub fn write_body_onto<W: Writer + ?Sized>(self, w: &mut W)

Write the body of this message (not including length or command).

pub fn take(r: &mut Reader<'_>, cmd: ChanCmd) -> Result<Self>

Decode this message from a given reader, according to a specified command value. The reader must be truncated to the exact length of the body.

Trait Implementations

impl Clone for ChanMsg

fn clone(&self) -> ChanMsg

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ChanMsg

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

Formats the value using the given formatter.

impl<B: Body> From<B> for ChanMsg

fn from(body: B) -> Self

Performs the conversion.