Struct HaProxyTlvs 

pub struct HaProxyTlvs { /* private fields */ }

A snapshot of the PROXY protocol v2 TLVs attached to the incoming connection, exposed as an extension on the IO stream so downstream services can inspect them.

Only present for v2 headers — v1 has no TLV concept. Typical PROXY v2 senders attach 0–4 TLVs (CRC32C, NOOP padding, AUTHORITY/SNI, UNIQUE_ID, occasionally a vendor TLV); this type keeps them in iteration order.

Implementations

impl HaProxyTlvs

pub fn entries(&self) -> &[HaProxyTlv]

All TLV entries in iteration order.

pub fn get(&self, kind: Type) -> Option<&Bytes>

Returns the value of the first TLV with the given kind, if any.

pub fn authority(&self) -> Option<Domain>

Returns the value of the PP2_TYPE_AUTHORITY TLV (host name carried through the proxy, e.g. SNI) parsed as a Domain, when present and well-formed.

Per PROXY protocol spec section 2.2.5, this TLV “is typically passed by the client to indicate the original host it was trying to connect to” — i.e. a hostname. Returning a typed Domain both validates the value and surfaces it in a form ready to be plugged into rama’s addressing/DNS plumbing.

Use Self::get with v2::Type::Authority if you need the raw bytes (e.g. to round-trip a non-domain value some non-spec sender might have placed there).

pub fn unique_id(&self) -> Option<&Bytes>

Returns the value of the PP2_TYPE_UNIQUE_ID TLV, when present.

Trait Implementations

impl Clone for HaProxyTlvs

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HaProxyTlvs

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

Formats the value using the given formatter.

impl Default for HaProxyTlvs

fn default() -> Self

Returns the “default value” for a type.

impl Extension for HaProxyTlvs

impl ProxyExtension for HaProxyTlvs