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)

A Padding message

Tuple Fields of Padding

0: Padding

VPadding(VPadding)

Variable-length padding message

Tuple Fields of VPadding

0: VPadding

Create(Create)

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

Tuple Fields of Create

0: Create

CreateFast(CreateFast)

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

Tuple Fields of CreateFast

0: CreateFast

Create2(Create2)

Cell to create a new circuit

Tuple Fields of Create2

0: Create2

Created(Created)

(Deprecated) Answer to a Create cell

Tuple Fields of Created

0: Created

CreatedFast(CreatedFast)

(Mostly Deprecated) Answer to a CreateFast cell

Tuple Fields of CreatedFast

0: CreatedFast

Created2(Created2)

Answer to a Create2 cell

Tuple Fields of Created2

0: Created2

Relay(Relay)

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

Tuple Fields of Relay

0: Relay

RelayEarly(Relay)

A message sent along a circuit (limited supply)

Tuple Fields of RelayEarly

0: Relay

Destroy(Destroy)

Tear down a circuit

Tuple Fields of Destroy

0: Destroy

Netinfo(Netinfo)

Part of channel negotiation: describes our position on the network

Tuple Fields of Netinfo

0: Netinfo

Versions(Versions)

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

Tuple Fields of Versions

0: Versions

PaddingNegotiate(PaddingNegotiate)

Negotiates what kind of channel padding to send

Tuple Fields of PaddingNegotiate

0: PaddingNegotiate

Certs(Certs)

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

Tuple Fields of Certs

0: Certs

AuthChallenge(AuthChallenge)

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

Tuple Fields of AuthChallenge

0: AuthChallenge

Authenticate(Authenticate)

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

Tuple Fields of Authenticate

0: Authenticate

Authorize(Authorize)

Not yet used

Tuple Fields of Authorize

0: Authorize

Unrecognized(Unrecognized)

Any cell whose command we don’t recognize

Tuple Fields of Unrecognized

0: Unrecognized

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.