uvco::Resolver Class Reference

Asynchronous name resolution using the libuv getaddrinfo(3) interface. More...

#include <name_resolution.h>

Collaboration diagram for uvco::Resolver:

Classes
struct	AddrinfoAwaiter_

Public Member Functions
	Resolver (const Loop &loop)
	Instantiate a resolver based on an event loop.
Promise< AddressHandle >	gai (std::string_view host, std::string_view port, int af_hint=AF_UNSPEC)
	Resolve a host and port string. Throws an UvcoException upon error.
Promise< AddressHandle >	gai (std::string_view host, uint16_t port, int af_hint=AF_UNSPEC)

Static Private Member Functions
static void	onAddrinfo (uv_getaddrinfo_t *req, uv_status status, struct addrinfo *result)

Private Attributes
const Loop *	loop_

Detailed Description

Asynchronous name resolution using the libuv getaddrinfo(3) interface.

Constructor & Destructor Documentation

Resolver()

uvco::Resolver::Resolver ( const Loop &  loop )

inlineexplicit

Instantiate a resolver based on an event loop.

: loop_{&loop} {}

Member Function Documentation

gai() [1/2]

Promise< AddressHandle > uvco::Resolver::gai	(	std::string_view	host,
		std::string_view	port,
		int	af_hint = AF_UNSPEC
	)

Resolve a host and port string. Throws an UvcoException upon error.

                                                                       {
  AddrinfoAwaiter_ awaiter;
  awaiter.req_.data = &awaiter;
  struct addrinfo hints {};
  hints.ai_family = af_hint;
  hints.ai_socktype = SOCK_STREAM;
 
  uv_getaddrinfo(loop_->uvloop(), &awaiter.req_, onAddrinfo, host.data(),
                 port.data(), &hints);
  // Npte: we rely on libuv not resuming before awaiting the result.
  struct addrinfo *result = co_await awaiter;
 
  uv_status status = awaiter.status_.value();
  if (status != 0) {
    throw UvcoException{status, "getaddrinfo()"};
  }
 
  AddressHandle address{result};
  uv_freeaddrinfo(result);
 
  co_return address;
}

gai() [2/2]

Promise< AddressHandle > uvco::Resolver::gai	(	std::string_view	host,
		uint16_t	port,
		int	af_hint = AF_UNSPEC
	)

Resolve a host string and numeric port. Throws an UvcoException upon error.

                                                  {
  const std::string portStr = std::to_string(port);
  return gai(host, portStr, af_hint);
}

onAddrinfo()

void uvco::Resolver::onAddrinfo ( uv_getaddrinfo_t *  req, uv_status  status, struct addrinfo *  result  )

staticprivate

                                                   {
  auto *awaiter = getRequestData<AddrinfoAwaiter_>(req);
  awaiter->addrinfo_ = result;
  awaiter->status_ = status;
  BOOST_ASSERT(awaiter->handle_);
  Loop::enqueue(*awaiter->handle_);
}

Member Data Documentation

loop_

const Loop* uvco::Resolver::loop_

private

---

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

• uvco/name_resolution.h
• uvco/name_resolution.cc