address-info

<h1>Address Info API</h1>

This CHICKEN module exposes <tt>getaddrinfo(3)</tt> functionality to Scheme.

<verbatim>
  (require-extension address-info)
</verbatim>

<h2>Address Info Record</h2>

<verbatim>
  (define-record-type address-info
    (make-address-info family type host port)
    address-info?
    [family address-info-family]
    [type address-info-type]
    [host address-info-host]
    [port address-info-port])
</verbatim>

Descriptor for an internet socket address. The family is either
<tt>'ipv4</tt> or <tt>'ipv6</tt>. The type is either <tt>'tcp</tt>,
<tt>'udp</tt> or <tt>'raw</tt>. The host is a numeric address encoded as
a string. The port is a either a positive integer or <tt>#f</tt>.

<h2>Address Info Lookup</h2>

<verbatim>
  (address-infos
   HOST [#:port PORT]
   [#:family FAMILY] [#:type TYPE]
   [#:server? BOOLEAN] [#:numeric? BOOLEAN])
  => (list ADDRESS-INFO ...) | #f
</verbatim>

Tries to lookup socket addresses for the given host and/or port. If the
lookup is successful, the procedure returns a list of address
information records. Otherwise it returns <tt>#f</tt>.

For a successful lookup you must at least specify a hostname or a port.
If no hostname is specified, the function defaults to server mode lookup
and will return wildcard addresses. This behaviour can be changed using
the <tt>#:server?</tt> flag.

By default, the procedure will return address information records for
all suitable supported protocol families and socket types. The
<tt>#:family</tt> argument may be used to filter for <tt>'ipv4</tt> or
<tt>'ipv6</tt> addresses. The <tt>#:type</tt> argument may be used to
filter for <tt>'tcp</tt> / <tt>'stream</tt>, <tt>'udp</tt> /
<tt>'datagram</tt> or <tt>'raw</tt> socket types.

Unless the <tt>#:numeric?</tt> flag is set to a true value, the
procedure will convert hostnames into numeric network addresses.