Crate trippy_dns 

This crate provides a cheaply cloneable, non-blocking, caching, forward and reverse DNS resolver which support the ability to lookup Autonomous System (AS) information.

Only a single reverse DNS lookup is performed (lazily) regardless of how often the lookup is performed unless:

• the previous lookup failed with DnsEntry::Timeout(_)
• the previous lookup is older than the configured time-to-live (TTL)

Example

The following example perform a reverse DNS lookup and loop until it is resolved or fails. The lookup uses the Cloudflare 1.1.1.1 public DNS service.

use trippy_dns::{
    Config, DnsEntry, DnsResolver, IpAddrFamily, ResolveMethod, Resolved, Resolver, Unresolved,
};

let config = Config::new(
    ResolveMethod::Cloudflare,
    IpAddrFamily::Ipv4Only,
    Duration::from_secs(5),
    Duration::from_secs(300),
);
let resolver = DnsResolver::start(config)?;
let addr = IpAddr::from_str("1.1.1.1")?;
loop {
    let entry = resolver.lazy_reverse_lookup_with_asinfo(addr);
    match entry {
        DnsEntry::Pending(ip) => {
            println!("lookup of {ip} is pending, sleeping for 1 sec");
            sleep(Duration::from_secs(1));
        }
        DnsEntry::Resolved(Resolved::Normal(ip, addrs)) => {
            println!("lookup of {ip} resolved to {addrs:?}");
            return Ok(());
        }
        DnsEntry::Resolved(Resolved::WithAsInfo(ip, addrs, as_info)) => {
            println!("lookup of {ip} resolved to {addrs:?} with AS information {as_info:?}");
            return Ok(());
        }
        DnsEntry::NotFound(Unresolved::Normal(ip)) => {
            println!("lookup of {ip} did not match any records");
            return Ok(());
        }
        DnsEntry::NotFound(Unresolved::WithAsInfo(ip, as_info)) => {
            println!(
                "lookup of {ip} did not match any records with AS information {as_info:?}"
            );
            return Ok(());
        }
        DnsEntry::Timeout(ip) => {
            println!("lookup of {ip} timed out");
            return Ok(());
        }
        DnsEntry::Failed(ip) => {
            println!("lookup of {ip} failed");
            return Ok(());
        }
    }
}

Structs

AsInfo

Information about an autonomous System (AS).

Builder

A builder for DNS Config.

Config

Configuration for the DnsResolver.

DnsResolver

A cheaply cloneable, non-blocking, caching, forward and reverse DNS resolver.

Enums

DnsEntry

The state of reverse DNS resolution.

Error

A DNS resolver error.

IpAddrFamily

How to resolve IP addresses.

ResolveMethod

How DNS queries will be resolved.

Resolved

Information about a resolved IpAddr.

Unresolved

Information about an unresolved IpAddr.

Traits

Resolver

A DNS resolver.

Type Aliases

Result

A DNS resolver error result.