Struct libp2p_mdns::Mdns

pub struct Mdns { /* private fields */ }

A NetworkBehaviour for mDNS. Automatically discovers peers on the local network and adds them to the topology.

Implementations

impl Mdns

pub async fn new(config: MdnsConfig) -> Result<Self>

Builds a new Mdns behaviour.

pub fn has_node(&self, peer_id: &PeerId) -> bool

Returns true if the given PeerId is in the list of nodes discovered through mDNS.

pub fn discovered_nodes(&self) -> impl ExactSizeIterator<Item = &PeerId>

Returns the list of nodes that we have discovered through mDNS and that are not expired.

pub fn expire_node(&mut self, peer_id: &PeerId)

Expires a node before the ttl.

Trait Implementations

impl Debug for Mdns

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

Formats the value using the given formatter.

impl NetworkBehaviour for Mdns

type ConnectionHandler = DummyConnectionHandler

Handler for all the protocols the network behaviour supports.

type OutEvent = MdnsEvent

Event generated by the NetworkBehaviour and that the swarm will report back.

fn new_handler(&mut self) -> Self::ConnectionHandler

Creates a new ConnectionHandler for a connection with a peer.

fn addresses_of_peer(&mut self, peer_id: &PeerId) -> Vec<Multiaddr>

Addresses that this behaviour is aware of for this specific peer, and that may allow reaching the peer.

fn inject_event(
    &mut self,
    _: PeerId,
    _: ConnectionId,
    ev: <Self::ConnectionHandler as ConnectionHandler>::OutEvent
)

Informs the behaviour about an event generated by the handler dedicated to the peer identified by peer_id. for the behaviour.

fn inject_new_listen_addr(&mut self, _id: ListenerId, _addr: &Multiaddr)

Indicates to the behaviour that we have started listening on a new multiaddr.

fn inject_connection_closed(
    &mut self,
    peer: &PeerId,
    _: &ConnectionId,
    _: &ConnectedPoint,
    _: Self::ConnectionHandler,
    remaining_established: usize
)

Informs the behaviour about a closed connection to a peer.

fn poll(
    &mut self,
    cx: &mut Context<'_>,
    params: &mut impl PollParameters
) -> Poll<NetworkBehaviourAction<Self::OutEvent, DummyConnectionHandler>>

Polls for things that swarm should do.

fn inject_connection_established(
    &mut self,
    _peer_id: &PeerId,
    _connection_id: &ConnectionId,
    _endpoint: &ConnectedPoint,
    _failed_addresses: Option<&Vec<Multiaddr, Global>>,
    _other_established: usize
)

Informs the behaviour about a newly established connection to a peer.

fn inject_address_change(
    &mut self,
    _: &PeerId,
    _: &ConnectionId,
    _old: &ConnectedPoint,
    _new: &ConnectedPoint
)

Informs the behaviour that the ConnectedPoint of an existing connection has changed.

fn inject_dial_failure(
    &mut self,
    _peer_id: Option<PeerId>,
    _handler: Self::ConnectionHandler,
    _error: &DialError
)

Indicates to the behaviour that the dial to a known or unknown node failed.

fn inject_listen_failure(
    &mut self,
    _local_addr: &Multiaddr,
    _send_back_addr: &Multiaddr,
    _handler: Self::ConnectionHandler
)

Indicates to the behaviour that an error happened on an incoming connection during its initial handshake.

fn inject_new_listener(&mut self, _id: ListenerId)

Indicates to the behaviour that a new listener was created.

fn inject_expired_listen_addr(&mut self, _id: ListenerId, _addr: &Multiaddr)

Indicates to the behaviour that a multiaddr we were listening on has expired, which means that we are no longer listening in it.

fn inject_listener_error(&mut self, _id: ListenerId, _err: &(dyn Error + 'static))

A listener experienced an error.

fn inject_listener_closed(&mut self, _id: ListenerId, _reason: Result<(), &Error>)

A listener closed.

fn inject_new_external_addr(&mut self, _addr: &Multiaddr)

Indicates to the behaviour that we have discovered a new external address for us.

fn inject_expired_external_addr(&mut self, _addr: &Multiaddr)

Indicates to the behaviour that an external address was removed.