Struct DnsSocket

pub struct DnsSocket { /* private fields */ }

Represents a socket transmitting DNS messages.

Implementations

impl DnsSocket

pub fn new() -> Result<DnsSocket>

Returns a DnsSocket, bound to an unspecified address.

pub fn bind<A: ToSocketAddrs>(addr: A) -> Result<DnsSocket>

Returns a DnsSocket, bound to the given address.

pub fn get(&self) -> &UdpSocket

Returns a reference to the wrapped UdpSocket.

pub fn send_message<A: ToSocketAddrs>( &self, message: &Message<'_>, addr: A, ) -> Result<(), Error>

Sends a message to the given address.

pub fn recv_from<'buf>( &self, buf: &'buf mut [u8], ) -> Result<(Message<'buf>, SocketAddr), Error>

Receives a message, returning the address of the sender. The given buffer is used to store and parse message data.

The buffer should be exactly MESSAGE_LIMIT bytes in length.

pub fn recv_message<'buf>( &self, addr: &SocketAddr, buf: &'buf mut [u8], ) -> Result<Option<Message<'buf>>, Error>

Attempts to read a DNS message. The message will only be decoded if the remote address matches addr. If a packet is received from a non-matching address, the message is not decoded and Ok(None) is returned.

The buffer should be exactly MESSAGE_LIMIT bytes in length.