Enum libp2p_swarm::DialPeerCondition

#[non_exhaustive]pub enum DialPeerCondition {
    Disconnected,
    NotDialing,
    Always,
}

The available conditions under which a new dialing attempt to a peer is initiated when requested by NetworkBehaviourAction::DialPeer.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Disconnected

A new dialing attempt is initiated only if the peer is currently considered disconnected, i.e. there is no established connection and no ongoing dialing attempt.

If there is an ongoing dialing attempt, the addresses reported by NetworkBehaviour::addresses_of_peer are added to the ongoing dialing attempt, ignoring duplicates.

NotDialing

A new dialing attempt is initiated only if there is currently no ongoing dialing attempt, i.e. the peer is either considered disconnected or connected but without an ongoing dialing attempt.

If there is an ongoing dialing attempt, the addresses reported by NetworkBehaviour::addresses_of_peer are added to the ongoing dialing attempt, ignoring duplicates.

Always

A new dialing attempt is always initiated, only subject to the configured connection limits.

Trait Implementations

impl Clone for DialPeerCondition

fn clone(&self) -> DialPeerCondition

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for DialPeerCondition

impl Debug for DialPeerCondition

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

Formats the value using the given formatter.

impl Default for DialPeerCondition

fn default() -> Self

Returns the "default value" for a type.