Struct Via 

pub struct Via {
    pub protocol: Vec<u8>,
    pub version: Vec<u8>,
    pub transport: Vec<u8>,
    pub host: Host,
    pub port: Option<u16>,
    pub params: Vec<HeaderParam>,
}

One Via value.

Fields

protocol: Vec<u8>

The protocol name, normally SIP.

version: Vec<u8>

The protocol version, normally 2.0.

transport: Vec<u8>

The transport: UDP, TCP, TLS, SCTP, WS, WSS, or anything else a peer sends — RFC 4475 §3.1.1.10 requires unknown transports to parse.

host: Host

The host this hop wants responses sent to.

port: Option<u16>

The port, if stated.

params: Vec<HeaderParam>

The via parameters.

Implementations

impl Via

pub fn overload(&self) -> Result<ViaOverload, HeaderError>

Decode the RFC 7339/RFC 7415 overload-control parameters on this hop.

Presence and value of oc stay distinct because the client sends the former and only a server may send the latter. Invalid numbers are errors rather than zero: zero has protocol meaning for both loss/rate and validity.

pub fn branch(&self) -> Option<&[u8]>

The branch parameter, which identifies the transaction.

pub fn has_rfc3261_branch(&self) -> bool

Whether the branch carries the RFC 3261 magic cookie.

When it does not, the sender predates RFC 3261 and transaction matching must fall back to the rules in §17.2.3.

pub fn received(&self) -> Option<&[u8]>

The received parameter: the source address the previous hop was actually seen from (RFC 3261 §18.2.1).

pub fn rport(&self) -> Option<Option<&[u8]>>

The rport parameter (RFC 3581). Present with no value in a request means “tell me what port you saw”; present with a value in a response is that port.

pub fn maddr(&self) -> Option<&[u8]>

The maddr parameter.

pub fn ttl(&self) -> Option<&[u8]>

The ttl parameter.

pub fn param(&self, name: &str) -> Option<&[u8]>

Any via parameter, by name.

pub fn parse_one(value: &[u8]) -> Result<Self, HeaderError>

Parse one Via value — a single hop, not a comma-separated list.

pub fn parse_list(value: &[u8]) -> Result<Vec<Self>, HeaderError>

Parse a header value that may carry several comma-separated hops.

Trait Implementations

impl Clone for Via

fn clone(&self) -> Via

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Via

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

Formats the value using the given formatter.

impl TypedHeader for Via

fn decode(value: &[u8]) -> Result<Self, HeaderError>

Decodes the first hop in the value.

A single Via header line may carry several comma-separated hops, so typed::<Via>() gives the topmost one — which is the one that matters for routing a response. Use Via::parse_list when every hop is needed.

const NAME: HeaderName = HeaderName::Via

The header this type reads.

fn decode_list(value: &[u8]) -> Result<Vec<Self>, HeaderError>

Parse every value in one header row.

const VALIDATE_LIST: bool = false

Whether Headers::typed_all must collect and validate the complete field before yielding.

fn validate_list(_values: &[&Self]) -> Result<(), HeaderError>

Validate all decoded values of this field across the complete message.