Struct WeakConntrackConnection

pub struct WeakConntrackConnection(/* private fields */);

A type-erased weak handle to a connection tracking entry.

We use type erasure here to get rid of the parameterization on IP version; this handle is meant to be able to transit the device layer and at that point things are not parameterized on IP version (IPv4 and IPv6 packets both end up in the same device queue, for example).

When this is received for incoming packets, WeakConnection::into_inner can be used to downcast to the expected concrete [Connection] type.

Implementations

impl WeakConnection

pub fn new<I: IpExt, BT: FilterBindingsTypes + 'static, E: Send + Sync + 'static>( conn: &Connection<I, E, BT>, ) -> Option<Self>

Creates a new type-erased weak handle to the provided conntrack entry, provided it is a shared entry.

pub fn into_inner<I: IpExt, BT: FilterBindingsTypes + 'static, E: Send + Sync + 'static>( self, ) -> Result<Connection<I, E, BT>, WeakConnectionError>

Attempts to upgrade the provided weak handle to the conntrack entry and downcast it to the specified concrete [Connection] type.

Fails if either the weak handle cannot be upgraded (because the conntrack entry has since been removed), or the type-erased handle cannot be downcast to the concrete type (because the packet was modified after the creation of this handle such that it no longer matches, e.g. the IP version of the connection).

Trait Implementations

impl Clone for WeakConnection

fn clone(&self) -> WeakConnection

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for WeakConnection

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

Formats the value using the given formatter.