Library: Net
Package: NetCore
Header: Poco/Net/DNS.h
This class provides an interface to the domain name service.
An internal DNS cache is used to speed up name lookups.
Member Functions: aierror, error, flushCache, hostByAddress, hostByName, hostName, lastError, resolve, resolveOne, thisHost
static void flushCache();
Deprecated. This function is deprecated and should no longer be used.
Flushes the internal DNS cache.
As of 1.4.2, the DNS cache is no longer used and this method does not do anything.
static HostEntry hostByAddress(
const IPAddress & address
);
Returns a HostEntry object containing the DNS information for the host with the given IP address.
Throws a HostNotFoundException if a host with the given name cannot be found.
Throws a DNSException in case of a general DNS error.
Throws an IOException in case of any other error.
static HostEntry hostByName(
const std::string & hostname
);
Returns a HostEntry object containing the DNS information for the host with the given name.
Throws a HostNotFoundException if a host with the given name cannot be found.
Throws a NoAddressFoundException if no address can be found for the hostname.
Throws a DNSException in case of a general DNS error.
Throws an IOException in case of any other error.
static std::string hostName();
Returns the host name of this host.
static HostEntry resolve(
const std::string & address
);
Returns a HostEntry object containing the DNS information for the host with the given IP address or host name.
Throws a HostNotFoundException if a host with the given name cannot be found.
Throws a NoAddressFoundException if no address can be found for the hostname.
Throws a DNSException in case of a general DNS error.
Throws an IOException in case of any other error.
static IPAddress resolveOne(
const std::string & address
);
Convenience method that calls resolve(address) and returns the first address from the HostInfo.
static HostEntry thisHost();
Returns a HostEntry object containing the DNS information for this host.
Throws a HostNotFoundException if DNS information for this host cannot be found.
Throws a NoAddressFoundException if no address can be found for this host.
Throws a DNSException in case of a general DNS error.
Throws an IOException in case of any other error.
static void aierror(
int code,
const std::string & arg
);
Throws an exception according to the getaddrinfo() error code.
static void error(
int code,
const std::string & arg
);
Throws an exception according to the error code.
static int lastError();
Returns the code of the last error.