Struct libp2p_core::network::NetworkConfig

pub struct NetworkConfig { /* private fields */ }

The (optional) configuration for a Network.

The default configuration specifies no dedicated task executor, no connection limits, a connection event buffer size of 32, and a notify_handler buffer size of 8.

Implementations

impl NetworkConfig

pub fn with_executor(self, e: Box<dyn Executor + Send>) -> Self

Configures the executor to use for spawning connection background tasks.

pub fn or_else_with_executor<F>(self, f: F) -> Self where
    F: FnOnce() -> Option<Box<dyn Executor + Send>>, 

Configures the executor to use for spawning connection background tasks, only if no executor has already been configured.

pub fn with_notify_handler_buffer_size(self, n: NonZeroUsize) -> Self

Sets the maximum number of events sent to a connection’s background task that may be buffered, if the task cannot keep up with their consumption and delivery to the connection handler.

When the buffer for a particular connection is full, notify_handler will no longer be able to deliver events to the associated ConnectionHandler, thus exerting back-pressure on the connection and peer API.

pub fn with_connection_event_buffer_size(self, n: usize) -> Self

Sets the maximum number of buffered connection events (beyond a guaranteed buffer of 1 event per connection).

When the buffer is full, the background tasks of all connections will stall. In this way, the consumers of network events exert back-pressure on the network connection I/O.

pub fn with_connection_limits(self, limits: ConnectionLimits) -> Self

Sets the connection limits to enforce.

Trait Implementations

impl Default for NetworkConfig

fn default() -> NetworkConfig

Returns the “default value” for a type.