Socket::GetAddrInfo::Emul - Pure Perl emulation of getaddrinfo and getnameinfo using IPv4-only legacy resolvers
Socket::GetAddrInfo attempts to provide the getaddrinfo and getnameinfo functions as specified by RFC 2553.
Ideally this is done by some XS code that calls the real functions in libc.
If for some reason this cannot be done; either there is no C compiler,
or libc does not provide these functions,
then they will be emulated using the legacy resolvers gethostbyname,
etc...
These emulations are not a complete replacement of the real functions,
because they only support IPv4 (the AF_INET socket family).
In this case,
the following restrictions will apply.
family hint is supplied,
it must be AF_INET.
Any other value will result in an error thrown by croak.flags hint values are AI_PASSIVE,
AI_CANONNAME,
AI_NUMERICSERV and AI_NUMERICHOST.
Note that AI_NUMERICSERV is an extension not defined by RFC 2553,
but is provided by most OSes.
It is possible (though unlikely) that even the native XS implementation does not recognise this constant.
$addr is anything other than AF_INET,
an error will be thrown with croak.$flags values are NI_NUMERICHOST,
NI_NUMERICSERV,
NI_NAMEREQD and NI_DGRAM.Paul Evans <leonerd@leonerd.org.uk>
