Struct Pinger 

pub struct Pinger { /* private fields */ }

A Ping struct represents the state of one particular ping instance.

Implementations

impl Pinger

pub fn new(host: IpAddr) -> Result<Pinger, Error>

Creates a new raw-socket ping instance from IpAddr.

pub fn with_socket_type( host: IpAddr, socket_type: SocketType, ) -> Result<Pinger, Error>

Creates a new ping instance using a specific socket type.

pub fn socket_type( &mut self, socket_type: SocketType, ) -> Result<&mut Pinger, Error>

Changes the socket type and recreates the underlying socket.

pub fn active_socket_type(&self) -> SocketType

Returns the active socket type.

pub fn bind_device( &mut self, interface: Option<&[u8]>, ) -> Result<&mut Pinger, Error>

Sets the value for the SO_BINDTODEVICE option on this socket.

If a socket is bound to an interface, only packets received from that particular interface are processed by the socket. Note that this only works for some socket types, particularly AF_INET sockets.

If interface is None or an empty string it removes the binding.

This function is only available on Fuchsia and Linux.

pub fn ident(&mut self, val: u16) -> &mut Pinger

Set the identification of ICMP.

pub fn size(&mut self, size: usize) -> &mut Pinger

Set the packet payload size in bytes. (default: 56)

pub fn timeout(&mut self, timeout: Duration) -> &mut Pinger

Set the timeout of each ping. (default: 2s)

pub fn ttl(&mut self, ttl: u32) -> Result<&mut Pinger, Error>

Set the outgoing IPv4 TTL or IPv6 unicast hop limit.

pub async fn ping(&self, seq_cnt: u16) -> Result<PingResult, Error>

Send a ping request with sequence number.

Trait Implementations

impl Clone for Pinger

fn clone(&self) -> Pinger

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Pinger

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

Formats the value using the given formatter.