Struct NetStack

pub struct NetStack<R: ScopedRawMutex, P: Profile> { /* private fields */ }

The Ergot Netstack

Implementations

impl<R, P> NetStack<R, P>

where R: ScopedRawMutex + ConstInit, P: Profile + ConstInit,

pub const fn new() -> Self

Create a new, uninitialized NetStack.

Requires that the ScopedRawMutex implements the mutex::ConstInit trait, and the Profile implements the interface_manager::ConstInit trait.

Example

use mutex::raw_impls::cs::CriticalSectionRawMutex as CSRMutex;
use ergot_base::NetStack;
use ergot_base::interface_manager::profiles::null::Null;

static STACK: NetStack<CSRMutex, Null> = NetStack::new();

impl<R, P> NetStack<R, P>

where R: ScopedRawMutex + ConstInit, P: Profile,

pub const fn new_with_profile(p: P) -> Self

impl<R, P> NetStack<R, P>

where R: ScopedRawMutex + ConstInit, P: Profile,

pub fn new_arc(p: P) -> Arc<Self>

impl<R, P> NetStack<R, P>

where R: ScopedRawMutex, P: Profile,

pub const fn const_new(r: R, p: P) -> Self

Manually create a new, uninitialized NetStack.

This method is useful if your ScopedRawMutex or Profile do not implement their corresponding ConstInit trait.

In general, this is most often only needed for loom testing, and NetStack::new() should be used when possible.

pub fn manage_profile<F: FnOnce(&mut P) -> U, U>(&self, f: F) -> U

Access the contained Profile.

Access to the Profile is made via the provided closure. The BlockingMutex is locked for the duration of this access, inhibiting all other usage of this NetStack.

This can be used to add new interfaces, obtain metadata, or other actions supported by the chosen Profile.

Example

static STACK: NetStack<CSRMutex, Null> = NetStack::new();

let res = STACK.manage_profile(|im| {
   // The mutex is locked for the full duration of this closure.
   // We can return whatever we want from this context, though not
   // anything borrowed from `im`.
   42
});
assert_eq!(res, 42);

pub fn send_raw( &self, hdr: &Header, hdr_raw: &[u8], body: &[u8], ) -> Result<(), NetStackSendError>

Send a raw (pre-serialized) message.

This interface should almost never be used by end-users, and is instead typically used by interfaces to feed received messages into the NetStack.

pub fn send_ty<T: 'static + Serialize + Clone>( &self, hdr: &Header, t: &T, ) -> Result<(), NetStackSendError>

Send a typed message

pub fn send_err( &self, hdr: &Header, err: ProtocolError, ) -> Result<(), NetStackSendError>

Trait Implementations

impl<R, P> Default for NetStack<R, P>

where R: ScopedRawMutex + ConstInit, P: Profile + ConstInit,

fn default() -> Self

Returns the “default value” for a type.

impl<R, P> NetStackHandle for &NetStack<R, P>

where R: ScopedRawMutex, P: Profile,

type Mutex = R

type Profile = P

type Target = &NetStack<R, P>

fn stack(&self) -> Self::Target