Struct TlType

pub struct TlType<'s> { /* private fields */ }

A root (main) TLV writer.

Implementations

impl<'s> TlType<'s>

pub fn add_alpn<'a>( &mut self, alpns: impl Iterator<Item = &'a [u8]>, ) -> HaProxRes<()>

Adds the Application-Layer Protocol Negotiation (ALPN)

pub fn add_noop(&mut self) -> HaProxRes<()>

Adds padding 3 bytes.

pub fn add_netns(&mut self, ns: impl Into<String>) -> HaProxRes<()>

Adds US-ASCII string representation of the namespace’s name

pub fn add_crc32(&mut self) -> HaProxRes<()>

Adds a 32-bit number storing the CRC32c checksum of the PROXY protocol header

It will be calculated after finalization.

pub fn add_uniq_id<ID: PP2TlvUniqId>(&mut self, au: ID) -> HaProxRes<()>

Adds a uniqID. See PP2TlvUniqId. 128 bytes max.

pub fn add_authority(&mut self, authority: impl Into<String>) -> HaProxRes<()>

Adds “SNI” i.e the “server_name” extension as defined by RFC3546.

pub fn add_ssl( self, client: PP2TlvClient, verify: u32, ) -> HaProxRes<TlvSubTypeSsl<'s>>

Adds SSL properties.

Examples found in repository

examples/example_custom_composer.rs (line 55)

fn main()
{
    let addr = ProxyV2Addr::try_from(("127.0.0.1:39754", "127.0.0.67:11883")).unwrap();
        
    let mut comp = 
        ProxyHdrV2::<HdrV2OpProxy>::new(ProxyTransportFam::STREAM, addr).unwrap();

    let plts = comp.set_plts();

    let mut ssl = plts.add_ssl(PP2TlvClient::PP2_CLIENT_SSL, 0).unwrap();

    ssl.add_ssl_sub_version("TLSv1.2").unwrap();
    
    let mut plts = ssl.done().unwrap();


    let cust_plt = ProxyV2Dummy2::SomeTlvName(0x01020304, 0x05060708);

    plts.add_tlv(cust_plt, Some(&[0xE0..=0xE0])).unwrap();

    drop(plts);

    let pkt: Vec<u8> = comp.try_into().unwrap();

    let ctrl = 
b"\x0d\x0a\x0d\x0a\x00\x0d\x0a\x51\x55\x49\x54\x0a\x21\x11\x00\x29\
\x7f\x00\x00\x01\x7f\x00\x00\x43\x9b\x4a\x2e\x6b\x20\x00\x0f\x01\
\x00\x00\x00\x00\x21\x00\x07\x54\x4c\x53\x76\x31\x2e\x32\xE0\x00\
\x08\x01\x02\x03\x04\x05\x06\x07\x08";

    assert_eq!(pkt.as_slice(), ctrl.as_slice());
}

pub fn add_tlv<TLV: PP2TlvDump>( &mut self, tlv: TLV, opt_constr: Option<&'static [RangeInclusive<u8>]>, ) -> HaProxRes<()>

Adding external TLV. The adding instance should implement PP2TlvDump.

Examples found in repository

examples/example_custom_composer.rs (line 64)

fn main()
{
    let addr = ProxyV2Addr::try_from(("127.0.0.1:39754", "127.0.0.67:11883")).unwrap();
        
    let mut comp = 
        ProxyHdrV2::<HdrV2OpProxy>::new(ProxyTransportFam::STREAM, addr).unwrap();

    let plts = comp.set_plts();

    let mut ssl = plts.add_ssl(PP2TlvClient::PP2_CLIENT_SSL, 0).unwrap();

    ssl.add_ssl_sub_version("TLSv1.2").unwrap();
    
    let mut plts = ssl.done().unwrap();


    let cust_plt = ProxyV2Dummy2::SomeTlvName(0x01020304, 0x05060708);

    plts.add_tlv(cust_plt, Some(&[0xE0..=0xE0])).unwrap();

    drop(plts);

    let pkt: Vec<u8> = comp.try_into().unwrap();

    let ctrl = 
b"\x0d\x0a\x0d\x0a\x00\x0d\x0a\x51\x55\x49\x54\x0a\x21\x11\x00\x29\
\x7f\x00\x00\x01\x7f\x00\x00\x43\x9b\x4a\x2e\x6b\x20\x00\x0f\x01\
\x00\x00\x00\x00\x21\x00\x07\x54\x4c\x53\x76\x31\x2e\x32\xE0\x00\
\x08\x01\x02\x03\x04\x05\x06\x07\x08";

    assert_eq!(pkt.as_slice(), ctrl.as_slice());
}

Trait Implementations

impl<'s> Debug for TlType<'s>

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

Formats the value using the given formatter.