NNet::TResolver Class Reference

Resolves hostnames into IP addresses using a custom poller. More...

#include <resolver.hpp>

Public Member Functions
template<typename TPoller >
	TResolver (TPoller &poller, EDNSType defaultType=EDNSType::A)
	Constructs a TResolver using the default resolv configuration.
template<typename TPoller >
	TResolver (const TResolvConf &conf, TPoller &poller, EDNSType defaultType=EDNSType::A)
	Constructs a TResolver with a specified DNS configuration.
template<typename TPoller >
	TResolver (TAddress dnsAddr, TPoller &poller, EDNSType defaultType=EDNSType::A)
	Constructs a TResolver using a specific DNS address.
TFuture< std::vector< TAddress > >	Resolve (const std::string &hostname, EDNSType type=EDNSType::DEFAULT)
	Resolves a hostname to a list of addresses.

Detailed Description

Resolves hostnames into IP addresses using a custom poller.

The TResolver class provides DNS resolution functionality by sending DNS queries to a nameserver. It supports different DNS record types as specified by EDNSType. Internally, it uses a polling mechanism (provided by the template parameter) for asynchronous operations.

Template Parameters

TPoller

The type of the poller used to manage asynchronous operations.

Example Usage

// Assume TSelect is a poller type with methods Poll() and WakeupReadyHandles()
TSelect poller;
 
// Create a resolver using the default nameserver specified in /etc/resolv.conf
TResolver resolver(poller);
 
// Asynchronously resolve a hostname (IPv4 resolution by default)
TFuture<std::vector<TAddress>> futureAddresses = resolver.Resolve("example.com");
// Later (in an asynchronous context) use:
// auto addresses = co_await futureAddresses;

Constructor & Destructor Documentation

TResolver() [1/3]

template<typename TPoller >

NNet::TResolver::TResolver	(	TPoller &	poller,
		EDNSType	defaultType = EDNSType::A
	)

Constructs a TResolver using the default resolv configuration.

The resolver uses DNS nameservers from the default configuration file or as determined by the system.

Parameters

poller	Reference to a poller used for asynchronous operations.
defaultType	The default DNS record type to use if none is specified in a request.

TResolver() [2/3]

template<typename TPoller >

NNet::TResolver::TResolver	(	const TResolvConf &	conf,
		TPoller &	poller,
		EDNSType	defaultType = EDNSType::A
	)

Constructs a TResolver with a specified DNS configuration.

This constructor initializes the resolver with nameservers from a given TResolvConf object.

Parameters

conf	A TResolvConf object containing DNS configuration.
poller	Reference to a poller for asynchronous operations.
defaultType	The default DNS record type to use for resolution.

TResolver() [3/3]

template<typename TPoller >

NNet::TResolver::TResolver	(	TAddress	dnsAddr,
		TPoller &	poller,
		EDNSType	defaultType = EDNSType::A
	)

Constructs a TResolver using a specific DNS address.

This variant allows specifying a single DNS nameserver for resolution.

Parameters

dnsAddr	The address of the DNS server.
poller	Reference to a poller used for asynchronous operations.
defaultType	The default DNS record type for resolution.

Member Function Documentation

Resolve()

TFuture< std::vector< TAddress > > NNet::TResolver::Resolve	(	const std::string &	hostname,
		EDNSType	type = EDNSType::DEFAULT
	)

Resolves a hostname to a list of addresses.

Sends a DNS query for the specified hostname. If the request type is set to EDNSType::DEFAULT, the default DNS record type (specified in the constructor) is used.

Parameters

hostname	The name to be resolved.
type	The DNS record type to query. If EDNSType::DEFAULT is specified, the default type provided to the constructor is used.

Returns

A TFuture containing a vector of TAddress objects with the resolved addresses.

---

The documentation for this class was generated from the following files:

• coroio/dns/resolver.hpp
• coroio/dns/resolver.cpp