/* "net_db.c" network database support
- * Copyright (C) 1995, 96, 97, 98, 99, 2000 Free Software Foundation, Inc.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2, or (at your option)
- * any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this software; see the file COPYING. If not, write to
- * the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
- * Boston, MA 02111-1307 USA
+ * Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2006, 2009,
+ * 2010, 2011, 2012, 2013 Free Software Foundation, Inc.
*
- * As a special exception, the Free Software Foundation gives permission
- * for additional uses of the text contained in its release of GUILE.
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public License
+ * as published by the Free Software Foundation; either version 3 of
+ * the License, or (at your option) any later version.
*
- * The exception is that, if you link the GUILE library with other files
- * to produce an executable, this does not by itself cause the
- * resulting executable to be covered by the GNU General Public License.
- * Your use of that executable is in no way restricted on account of
- * linking the GUILE library code into it.
+ * This library is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
*
- * This exception does not however invalidate any other reasons why
- * the executable file might be covered by the GNU General Public License.
- *
- * This exception applies only to the code released by the
- * Free Software Foundation under the name GUILE. If you copy
- * code from other Free Software Foundation releases into a copy of
- * GUILE, as the General Public License permits, the exception does
- * not apply to the code that you add in this way. To avoid misleading
- * anyone as to the status of such modified files, you must delete
- * this exception notice from them.
- *
- * If you write modifications of your own for GUILE, it is your choice
- * whether to permit this exception to apply to your modifications.
- * If you do not wish that, delete this exception notice. */
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+ * 02110-1301 USA
+ */
-/* Software engineering face-lift by Greg J. Badros, 11-Dec-1999,
- gjb@cs.washington.edu, http://www.cs.washington.edu/homes/gjb */
/* Written in 1994 by Aubrey Jaffer.
*/
\f
-#include <stdio.h>
-#include "libguile/_scm.h"
-#include "libguile/feature.h"
-#include "libguile/strings.h"
-#include "libguile/vectors.h"
+#ifdef HAVE_CONFIG_H
+# include <config.h>
+#endif
-#include "libguile/validate.h"
-#include "libguile/net_db.h"
+#include <verify.h>
+#include <errno.h>
#ifdef HAVE_STRING_H
#include <string.h>
#endif
#include <sys/types.h>
+
#include <sys/socket.h>
#include <netdb.h>
#include <netinet/in.h>
#include <arpa/inet.h>
-#if !defined (HAVE_H_ERRNO)
-extern int h_errno;
-#endif
-
-\f
-
-#ifndef STDC_HEADERS
-int close ();
-#endif /* STDC_HEADERS */
-
-extern int inet_aton ();
-
-SCM_DEFINE (scm_inet_aton, "inet-aton", 1, 0, 0,
- (SCM address),
- "Converts a string containing an Internet host address in the traditional\n"
- "dotted decimal notation into an integer.\n\n"
- "@smalllisp\n"
- "(inet-aton \"127.0.0.1\") @result{} 2130706433\n\n"
- "@end smalllisp")
-#define FUNC_NAME s_scm_inet_aton
-{
- struct in_addr soka;
-
- SCM_VALIDATE_ROSTRING (1,address);
- if (SCM_SUBSTRP (address))
- address = scm_makfromstr (SCM_ROCHARS (address), SCM_ROLENGTH (address), 0);
- if (inet_aton (SCM_ROCHARS (address), &soka) == 0)
- SCM_MISC_ERROR ("bad address", SCM_EOL);
- return scm_ulong2num (ntohl (soka.s_addr));
-}
-#undef FUNC_NAME
-
-
-SCM_DEFINE (scm_inet_ntoa, "inet-ntoa", 1, 0, 0,
- (SCM inetid),
- "Converts an integer Internet host address into a string with the\n"
- "traditional dotted decimal representation.\n\n"
- "@smalllisp\n"
- "(inet-ntoa 2130706433) @result{} \"127.0.0.1\"\n"
- "@end smalllisp")
-#define FUNC_NAME s_scm_inet_ntoa
-{
- struct in_addr addr;
- char *s;
- SCM answer;
- addr.s_addr = htonl (SCM_NUM2ULONG (1,inetid));
- s = inet_ntoa (addr);
- answer = scm_makfromstr (s, strlen (s), 0);
- return answer;
-}
-#undef FUNC_NAME
+#include "libguile/_scm.h"
+#include "libguile/feature.h"
+#include "libguile/strings.h"
+#include "libguile/vectors.h"
+#include "libguile/dynwind.h"
-#ifdef HAVE_INET_NETOF
-SCM_DEFINE (scm_inet_netof, "inet-netof", 1, 0, 0,
- (SCM address),
- "Returns the network number part of the given integer Internet address.\n\n"
- "@smalllisp\n"
- "(inet-netof 2130706433) @result{} 127\n"
- "@end smalllisp")
-#define FUNC_NAME s_scm_inet_netof
-{
- struct in_addr addr;
- addr.s_addr = htonl (SCM_NUM2ULONG (1,address));
- return scm_ulong2num ((unsigned long) inet_netof (addr));
-}
-#undef FUNC_NAME
-#endif
+#include "libguile/validate.h"
+#include "libguile/net_db.h"
+#include "libguile/socket.h"
-#ifdef HAVE_INET_LNAOF
-SCM_DEFINE (scm_lnaof, "inet-lnaof", 1, 0, 0,
- (SCM address),
- "Returns the local-address-with-network part of the given Internet\n"
- "address.\n\n"
- "@smalllisp\n"
- "(inet-lnaof 2130706433) @result{} 1\n"
- "@end smalllisp")
-#define FUNC_NAME s_scm_lnaof
-{
- struct in_addr addr;
- addr.s_addr = htonl (SCM_NUM2ULONG (1,address));
- return scm_ulong2num ((unsigned long) inet_lnaof (addr));
-}
-#undef FUNC_NAME
-#endif
-#ifdef HAVE_INET_MAKEADDR
-SCM_DEFINE (scm_inet_makeaddr, "inet-makeaddr", 2, 0, 0,
- (SCM net, SCM lna),
- "Makes an Internet host address by combining the network number @var{net}\n"
- "with the local-address-within-network number @var{lna}.\n\n"
- "@smalllisp\n"
- "(inet-makeaddr 127 1) @result{} 2130706433\n"
- "@end smalllisp")
-#define FUNC_NAME s_scm_inet_makeaddr
-{
- struct in_addr addr;
- unsigned long netnum;
- unsigned long lnanum;
+#if defined (HAVE_H_ERRNO)
+/* Only wrap gethostbyname / gethostbyaddr if h_errno is available. */
-#if 0 /* GJB:FIXME:: */
- SCM_VALIDATE_INUM_COPY (1,net,netnum);
- SCM_VALIDATE_INUM_COPY (2,lna,lnanum);
-#else
- netnum = SCM_NUM2ULONG (1, net);
- lnanum = SCM_NUM2ULONG (2, lna);
-#endif
- addr = inet_makeaddr (netnum, lnanum);
- return scm_ulong2num (ntohl (addr.s_addr));
-}
-#undef FUNC_NAME
+#if defined HAVE_HSTRERROR && !HAVE_DECL_HSTRERROR
+/* Some OSes, such as Tru64 5.1b, lack a declaration for hstrerror(3). */
+extern const char *hstrerror (int);
#endif
SCM_SYMBOL (scm_host_not_found_key, "host-not-found");
#ifdef HAVE_HSTRERROR
errmsg = (const char *) hstrerror (h_errno);
#endif
- scm_error (key, subr, errmsg, scm_cons (bad_value, SCM_EOL), SCM_EOL);
+ scm_error (key, subr, errmsg, SCM_BOOL_F, SCM_EOL);
}
}
SCM_DEFINE (scm_gethost, "gethost", 0, 1, 0,
(SCM host),
- "@deffnx procedure gethostbyname hostname\n"
- "@deffnx procedure gethostbyaddr address\n"
+ "@deffnx {Scheme Procedure} gethostbyname hostname\n"
+ "@deffnx {Scheme Procedure} gethostbyaddr address\n"
"Look up a host by name or address, returning a host object. The\n"
"@code{gethost} procedure will accept either a string name or an integer\n"
"address; if given no arguments, it behaves like @code{gethostent} (see\n"
"@code{system-error} or @code{misc_error} keys.")
#define FUNC_NAME s_scm_gethost
{
- SCM ans = scm_make_vector (SCM_MAKINUM (5), SCM_UNSPECIFIED);
- SCM *ve = SCM_VELTS (ans);
+ SCM result = scm_c_make_vector (5, SCM_UNSPECIFIED);
SCM lst = SCM_EOL;
struct hostent *entry;
struct in_addr inad;
char **argv;
int i = 0;
+
if (SCM_UNBNDP (host))
{
#ifdef HAVE_GETHOSTENT
return SCM_BOOL_F;
}
}
- else if (SCM_ROSTRINGP (host))
+ else if (scm_is_string (host))
{
- SCM_COERCE_SUBSTR (host);
- entry = gethostbyname (SCM_ROCHARS (host));
+ char *str = scm_to_locale_string (host);
+ entry = gethostbyname (str);
+ free (str);
}
else
{
- inad.s_addr = htonl (SCM_NUM2ULONG (1,host));
+ inad.s_addr = htonl (scm_to_ulong (host));
entry = gethostbyaddr ((char *) &inad, sizeof (inad), AF_INET);
}
+
if (!entry)
scm_resolv_error (FUNC_NAME, host);
- ve[0] = scm_makfromstr (entry->h_name,
- (scm_sizet) strlen (entry->h_name), 0);
- ve[1] = scm_makfromstrs (-1, entry->h_aliases);
- ve[2] = SCM_MAKINUM (entry->h_addrtype + 0L);
- ve[3] = SCM_MAKINUM (entry->h_length + 0L);
+ SCM_SIMPLE_VECTOR_SET(result, 0, scm_from_locale_string (entry->h_name));
+ SCM_SIMPLE_VECTOR_SET(result, 1, scm_makfromstrs (-1, entry->h_aliases));
+ SCM_SIMPLE_VECTOR_SET(result, 2, scm_from_int (entry->h_addrtype));
+ SCM_SIMPLE_VECTOR_SET(result, 3, scm_from_int (entry->h_length));
if (sizeof (struct in_addr) != entry->h_length)
{
- ve[4] = SCM_BOOL_F;
- return ans;
+ SCM_SIMPLE_VECTOR_SET(result, 4, SCM_BOOL_F);
+ return result;
}
for (argv = entry->h_addr_list; argv[i]; i++);
while (i--)
{
inad = *(struct in_addr *) argv[i];
- lst = scm_cons (scm_ulong2num (ntohl (inad.s_addr)), lst);
+ lst = scm_cons (scm_from_ulong (ntohl (inad.s_addr)), lst);
}
- ve[4] = lst;
- return ans;
+ SCM_SIMPLE_VECTOR_SET(result, 4, lst);
+ return result;
}
#undef FUNC_NAME
+#endif /* HAVE_H_ERRNO */
+
/* In all subsequent getMUMBLE functions, when we're called with no
arguments, we're supposed to traverse the tables entry by entry.
#if defined(HAVE_GETNETENT) && defined(HAVE_GETNETBYNAME) && defined(HAVE_GETNETBYADDR)
SCM_DEFINE (scm_getnet, "getnet", 0, 1, 0,
(SCM net),
- "@deffnx procedure getnetbyname net-name\n"
- "@deffnx procedure getnetbyaddr net-number\n"
+ "@deffnx {Scheme Procedure} getnetbyname net-name\n"
+ "@deffnx {Scheme Procedure} getnetbyaddr net-number\n"
"Look up a network by name or net number in the network database. The\n"
"@var{net-name} argument must be a string, and the @var{net-number}\n"
"argument must be an integer. @code{getnet} will accept either type of\n"
"given.")
#define FUNC_NAME s_scm_getnet
{
- SCM ans;
- SCM *ve;
+ SCM result = scm_c_make_vector (4, SCM_UNSPECIFIED);
struct netent *entry;
+ int eno;
- ans = scm_make_vector (SCM_MAKINUM (4), SCM_UNSPECIFIED);
- ve = SCM_VELTS (ans);
if (SCM_UNBNDP (net))
{
- errno = 0;
entry = getnetent ();
if (! entry)
{
- if (errno)
- SCM_SYSERROR;
- else
- return SCM_BOOL_F;
+ /* There's no good way to tell whether zero means an error
+ or end-of-file, so we always return #f. See `gethost'
+ for details. */
+ return SCM_BOOL_F;
}
}
- else if (SCM_ROSTRINGP (net))
+ else if (scm_is_string (net))
{
- SCM_COERCE_SUBSTR (net);
- entry = getnetbyname (SCM_ROCHARS (net));
+ char *str = scm_to_locale_string (net);
+ entry = getnetbyname (str);
+ eno = errno;
+ free (str);
}
else
{
- unsigned long netnum;
- netnum = SCM_NUM2ULONG (1, net);
+ unsigned long netnum = scm_to_ulong (net);
entry = getnetbyaddr (netnum, AF_INET);
+ eno = errno;
}
+
if (!entry)
- SCM_SYSERROR_MSG ("no such network ~A",
- scm_listify (net, SCM_UNDEFINED), errno);
- ve[0] = scm_makfromstr (entry->n_name, (scm_sizet) strlen (entry->n_name), 0);
- ve[1] = scm_makfromstrs (-1, entry->n_aliases);
- ve[2] = SCM_MAKINUM (entry->n_addrtype + 0L);
- ve[3] = scm_ulong2num (entry->n_net + 0L);
- return ans;
+ SCM_SYSERROR_MSG ("no such network ~A", scm_list_1 (net), eno);
+
+ SCM_SIMPLE_VECTOR_SET(result, 0, scm_from_locale_string (entry->n_name));
+ SCM_SIMPLE_VECTOR_SET(result, 1, scm_makfromstrs (-1, entry->n_aliases));
+ SCM_SIMPLE_VECTOR_SET(result, 2, scm_from_int (entry->n_addrtype));
+ SCM_SIMPLE_VECTOR_SET(result, 3, scm_from_ulong (entry->n_net));
+ return result;
}
#undef FUNC_NAME
#endif
-#ifdef HAVE_GETPROTOENT
+#if defined (HAVE_GETPROTOENT)
SCM_DEFINE (scm_getproto, "getproto", 0, 1, 0,
(SCM protocol),
- "@deffnx procedure getprotobyname name\n"
- "@deffnx procedure getprotobynumber number\n"
+ "@deffnx {Scheme Procedure} getprotobyname name\n"
+ "@deffnx {Scheme Procedure} getprotobynumber number\n"
"Look up a network protocol by name or by number. @code{getprotobyname}\n"
"takes a string argument, and @code{getprotobynumber} takes an integer\n"
"argument. @code{getproto} will accept either type, behaving like\n"
"@code{getprotoent} (see below) if no arguments are supplied.")
#define FUNC_NAME s_scm_getproto
{
- SCM ans;
- SCM *ve;
+ SCM result = scm_c_make_vector (3, SCM_UNSPECIFIED);
struct protoent *entry;
+ int eno;
- ans = scm_make_vector (SCM_MAKINUM (3), SCM_UNSPECIFIED);
- ve = SCM_VELTS (ans);
if (SCM_UNBNDP (protocol))
{
- errno = 0;
entry = getprotoent ();
if (! entry)
{
- if (errno)
- SCM_SYSERROR;
- else
- return SCM_BOOL_F;
+ /* There's no good way to tell whether zero means an error
+ or end-of-file, so we always return #f. See `gethost'
+ for details. */
+ return SCM_BOOL_F;
}
}
- else if (SCM_ROSTRINGP (protocol))
+ else if (scm_is_string (protocol))
{
- SCM_COERCE_SUBSTR (protocol);
- entry = getprotobyname (SCM_ROCHARS (protocol));
+ char *str = scm_to_locale_string (protocol);
+ entry = getprotobyname (str);
+ eno = errno;
+ free (str);
}
else
{
- unsigned long protonum;
- protonum = SCM_NUM2ULONG (1,protocol);
+ unsigned long protonum = scm_to_ulong (protocol);
entry = getprotobynumber (protonum);
+ eno = errno;
}
+
if (!entry)
- SCM_SYSERROR_MSG ("no such protocol ~A",
- scm_listify (protocol, SCM_UNDEFINED), errno);
- ve[0] = scm_makfromstr (entry->p_name, (scm_sizet) strlen (entry->p_name), 0);
- ve[1] = scm_makfromstrs (-1, entry->p_aliases);
- ve[2] = SCM_MAKINUM (entry->p_proto + 0L);
- return ans;
+ SCM_SYSERROR_MSG ("no such protocol ~A", scm_list_1 (protocol), eno);
+
+ SCM_SIMPLE_VECTOR_SET(result, 0, scm_from_locale_string (entry->p_name));
+ SCM_SIMPLE_VECTOR_SET(result, 1, scm_makfromstrs (-1, entry->p_aliases));
+ SCM_SIMPLE_VECTOR_SET(result, 2, scm_from_int (entry->p_proto));
+ return result;
}
#undef FUNC_NAME
#endif
+#if defined (HAVE_GETSERVENT)
static SCM
scm_return_entry (struct servent *entry)
{
- SCM ans;
- SCM *ve;
-
- ans = scm_make_vector (SCM_MAKINUM (4), SCM_UNSPECIFIED);
- ve = SCM_VELTS (ans);
- ve[0] = scm_makfromstr (entry->s_name, (scm_sizet) strlen (entry->s_name), 0);
- ve[1] = scm_makfromstrs (-1, entry->s_aliases);
- ve[2] = SCM_MAKINUM (ntohs (entry->s_port) + 0L);
- ve[3] = scm_makfromstr (entry->s_proto, (scm_sizet) strlen (entry->s_proto), 0);
- return ans;
+ SCM result = scm_c_make_vector (4, SCM_UNSPECIFIED);
+
+ SCM_SIMPLE_VECTOR_SET(result, 0, scm_from_locale_string (entry->s_name));
+ SCM_SIMPLE_VECTOR_SET(result, 1, scm_makfromstrs (-1, entry->s_aliases));
+ SCM_SIMPLE_VECTOR_SET(result, 2, scm_from_uint16 (ntohs (entry->s_port)));
+ SCM_SIMPLE_VECTOR_SET(result, 3, scm_from_locale_string (entry->s_proto));
+ return result;
}
-#ifdef HAVE_GETSERVENT
SCM_DEFINE (scm_getserv, "getserv", 0, 2, 0,
(SCM name, SCM protocol),
- "@deffnx procedure getservbyname name protocol\n"
- "@deffnx procedure getservbyport port protocol\n"
+ "@deffnx {Scheme Procedure} getservbyname name protocol\n"
+ "@deffnx {Scheme Procedure} getservbyport port protocol\n"
"Look up a network service by name or by service number, and return a\n"
"network service object. The @var{protocol} argument specifies the name\n"
"of the desired protocol; if the protocol found in the network service\n"
#define FUNC_NAME s_scm_getserv
{
struct servent *entry;
+ char *protoname;
+ int eno;
+
if (SCM_UNBNDP (name))
{
- errno = 0;
entry = getservent ();
if (!entry)
{
- if (errno)
- SCM_SYSERROR;
- else
- return SCM_BOOL_F;
+ /* There's no good way to tell whether zero means an error
+ or end-of-file, so we always return #f. See `gethost'
+ for details. */
+ return SCM_BOOL_F;
}
return scm_return_entry (entry);
}
- SCM_VALIDATE_ROSTRING (2,protocol);
- SCM_COERCE_SUBSTR (protocol);
- if (SCM_ROSTRINGP (name))
+
+ scm_dynwind_begin (0);
+
+ protoname = scm_to_locale_string (protocol);
+ scm_dynwind_free (protoname);
+
+ if (scm_is_string (name))
{
- SCM_COERCE_SUBSTR (name);
- entry = getservbyname (SCM_ROCHARS (name), SCM_ROCHARS (protocol));
+ char *str = scm_to_locale_string (name);
+ entry = getservbyname (str, protoname);
+ eno = errno;
+ free (str);
}
else
{
- SCM_VALIDATE_INUM (1,name);
- entry = getservbyport (htons (SCM_INUM (name)), SCM_ROCHARS (protocol));
+ entry = getservbyport (htons (scm_to_int (name)), protoname);
+ eno = errno;
}
+
if (!entry)
- SCM_SYSERROR_MSG("no such service ~A",
- scm_listify (name, SCM_UNDEFINED), errno);
+ SCM_SYSERROR_MSG("no such service ~A", scm_list_1 (name), eno);
+
+ scm_dynwind_end ();
return scm_return_entry (entry);
}
#undef FUNC_NAME
if (SCM_UNBNDP (stayopen))
endhostent ();
else
- sethostent (SCM_NFALSEP (stayopen));
+ sethostent (scm_is_true (stayopen));
return SCM_UNSPECIFIED;
}
#undef FUNC_NAME
if (SCM_UNBNDP (stayopen))
endnetent ();
else
- setnetent (SCM_NFALSEP (stayopen));
+ setnetent (scm_is_true (stayopen));
return SCM_UNSPECIFIED;
}
#undef FUNC_NAME
#endif
-#if defined(HAVE_SETPROTOENT) && defined(HAVE_ENDPROTOENT)
+#if defined (HAVE_SETPROTOENT) && defined (HAVE_ENDPROTOENT)
SCM_DEFINE (scm_setproto, "setproto", 0, 1, 0,
(SCM stayopen),
"If @var{stayopen} is omitted, this is equivalent to @code{endprotoent}.\n"
if (SCM_UNBNDP (stayopen))
endprotoent ();
else
- setprotoent (SCM_NFALSEP (stayopen));
+ setprotoent (scm_is_true (stayopen));
return SCM_UNSPECIFIED;
}
#undef FUNC_NAME
#endif
-#if defined(HAVE_SETSERVENT) && defined(HAVE_ENDSERVENT)
+#if defined (HAVE_SETSERVENT) && defined (HAVE_ENDSERVENT)
SCM_DEFINE (scm_setserv, "setserv", 0, 1, 0,
(SCM stayopen),
"If @var{stayopen} is omitted, this is equivalent to @code{endservent}.\n"
if (SCM_UNBNDP (stayopen))
endservent ();
else
- setservent (SCM_NFALSEP (stayopen));
+ setservent (scm_is_true (stayopen));
return SCM_UNSPECIFIED;
}
#undef FUNC_NAME
#endif
+\f
+/* Protocol-independent name resolution with getaddrinfo(3) & co. */
+
+SCM_SYMBOL (sym_getaddrinfo_error, "getaddrinfo-error");
+
+/* Make sure the `AI_*' flags can be stored as INUMs. */
+verify (AI_ALL < SCM_MOST_POSITIVE_FIXNUM);
+
+/* Valid values for the `ai_flags' to `struct addrinfo'. */
+SCM_VARIABLE_INIT (sym_ai_passive, "AI_PASSIVE",
+ SCM_I_MAKINUM (AI_PASSIVE));
+SCM_VARIABLE_INIT (sym_ai_canonname, "AI_CANONNAME",
+ SCM_I_MAKINUM (AI_CANONNAME));
+SCM_VARIABLE_INIT (sym_ai_numerichost, "AI_NUMERICHOST",
+ SCM_I_MAKINUM (AI_NUMERICHOST));
+SCM_VARIABLE_INIT (sym_ai_numericserv, "AI_NUMERICSERV",
+ SCM_I_MAKINUM (AI_NUMERICSERV));
+SCM_VARIABLE_INIT (sym_ai_v4mapped, "AI_V4MAPPED",
+ SCM_I_MAKINUM (AI_V4MAPPED));
+SCM_VARIABLE_INIT (sym_ai_all, "AI_ALL",
+ SCM_I_MAKINUM (AI_ALL));
+SCM_VARIABLE_INIT (sym_ai_addrconfig, "AI_ADDRCONFIG",
+ SCM_I_MAKINUM (AI_ADDRCONFIG));
+
+/* Return a Scheme vector whose elements correspond to the fields of C_AI,
+ ignoring the `ai_next' field. This function is not exported because the
+ definition of `struct addrinfo' is provided by Gnulib. */
+static SCM
+scm_from_addrinfo (const struct addrinfo *c_ai)
+{
+ SCM ai;
+
+ /* Note: The indices here must be kept synchronized with those used by the
+ `addrinfo:' procedures in `networking.scm'. */
+
+ ai = scm_c_make_vector (6, SCM_UNDEFINED);
+ SCM_SIMPLE_VECTOR_SET (ai, 0, scm_from_int (c_ai->ai_flags));
+ SCM_SIMPLE_VECTOR_SET (ai, 1, scm_from_int (c_ai->ai_family));
+ SCM_SIMPLE_VECTOR_SET (ai, 2, scm_from_int (c_ai->ai_socktype));
+ SCM_SIMPLE_VECTOR_SET (ai, 3, scm_from_int (c_ai->ai_protocol));
+ SCM_SIMPLE_VECTOR_SET (ai, 4,
+ scm_from_sockaddr (c_ai->ai_addr, c_ai->ai_addrlen));
+ SCM_SIMPLE_VECTOR_SET (ai, 5,
+ c_ai->ai_canonname != NULL
+ ? scm_from_locale_string (c_ai->ai_canonname)
+ : SCM_BOOL_F);
+
+ return ai;
+}
-void
-scm_init_net_db ()
+SCM_DEFINE (scm_getaddrinfo, "getaddrinfo", 1, 5, 0,
+ (SCM name, SCM service, SCM hint_flags, SCM hint_family,
+ SCM hint_socktype, SCM hint_protocol),
+ "Return a list of @code{addrinfo} structures containing "
+ "a socket address and associated information for host @var{name} "
+ "and/or @var{service} to be used in creating a socket with "
+ "which to address the specified service.\n\n"
+ "@example\n"
+ "(let* ((ai (car (getaddrinfo \"www.gnu.org\" \"http\")))\n"
+ " (s (socket (addrinfo:fam ai) (addrinfo:socktype ai)\n"
+ " (addrinfo:protocol ai))))\n"
+ " (connect s (addrinfo:addr ai))\n"
+ " s)\n"
+ "@end example\n\n"
+ "When @var{service} is omitted or is @code{#f}, return "
+ "network-level addresses for @var{name}. When @var{name} "
+ "is @code{#f} @var{service} must be provided and service "
+ "locations local to the caller are returned.\n"
+ "\n"
+ "Additional hints can be provided. When specified, "
+ "@var{hint_flags} should be a bitwise-or of zero or more "
+ "constants among the following:\n\n"
+ "@table @code\n"
+ "@item AI_PASSIVE\n"
+ "Socket address is intended for @code{bind}.\n\n"
+ "@item AI_CANONNAME\n"
+ "Request for canonical host name, available via "
+ "@code{addrinfo:canonname}. This makes sense mainly when "
+ "DNS lookups are involved.\n\n"
+ "@item AI_NUMERICHOST\n"
+ "Specifies that @var{name} is a numeric host address string "
+ "(e.g., @code{\"127.0.0.1\"}), meaning that name resolution "
+ "will not be used.\n\n"
+ "@item AI_NUMERICSERV\n"
+ "Likewise, specifies that @var{service} is a numeric port "
+ "string (e.g., @code{\"80\"}).\n\n"
+ "@item AI_ADDRCONFIG\n"
+ "Return only addresses configured on the local system. It is "
+ "highly recommended to provide this flag when the returned "
+ "socket addresses are to be used to make connections; "
+ "otherwise, some of the returned addresses could be unreachable "
+ "or use a protocol that is not supported.\n\n"
+ "@item AI_V4MAPPED\n"
+ "When looking up IPv6 addresses, return mapped "
+ "IPv4 addresses if there is no IPv6 address available at all.\n\n"
+ "@item AI_ALL\n"
+ "If this flag is set along with @code{AI_V4MAPPED} when looking "
+ "up IPv6 addresses, return all IPv6 addresses "
+ "as well as all IPv4 addresses, the latter mapped to IPv6 "
+ "format.\n"
+ "@end table\n\n"
+ "When given, @var{hint_family} should specify the requested "
+ "address family, e.g., @code{AF_INET6}. Similarly, "
+ "@var{hint_socktype} should specify the requested socket type "
+ "(e.g., @code{SOCK_DGRAM}), and @var{hint_protocol} should "
+ "specify the requested protocol (its value is interpretered "
+ "as in calls to @code{socket}).\n"
+ "\n"
+ "On error, an exception with key @code{getaddrinfo-error} is "
+ "thrown, with an error code (an integer) as its argument:\n\n"
+ "@example\n"
+ "(catch 'getaddrinfo-error\n"
+ " (lambda ()\n"
+ " (getaddrinfo \"www.gnu.org\" \"gopher\"))\n"
+ " (lambda (key errcode)\n"
+ " (cond ((= errcode EAI_SERVICE)\n"
+ " (display \"doesn't know about Gopher!\\n\"))\n"
+ " ((= errcode EAI_NONAME)\n"
+ " (display \"www.gnu.org not found\\n\"))\n"
+ " (else\n"
+ " (format #t \"something wrong: ~a\\n\"\n"
+ " (gai-strerror errcode))))))\n"
+ "@end example\n"
+ "\n"
+ "Error codes are:\n\n"
+ "@table @code\n"
+ "@item EAI_AGAIN\n"
+ "The name or service could not be resolved at this time. Future "
+ "attempts may succeed.\n\n"
+ "@item EAI_BADFLAGS\n"
+ "@var{hint_flags} contains an invalid value.\n\n"
+ "@item EAI_FAIL\n"
+ "A non-recoverable error occurred when attempting to "
+ "resolve the name.\n\n"
+ "@item EAI_FAMILY\n"
+ "@var{hint_family} was not recognized.\n\n"
+ "@item EAI_NONAME\n"
+ "Either @var{name} does not resolve for the supplied parameters, "
+ "or neither @var{name} nor @var{service} were supplied.\n\n"
+
+ /* See `sysdeps/posix/getaddrinfo.c' in the GNU libc, and
+ <http://www.opensource.apple.com/source/Libinfo/Libinfo-324.1/lookup.subproj/netdb.h>,
+ for details on EAI_NODATA. */
+ "@item EAI_NODATA\n"
+ "This non-POSIX error code can be returned on some systems (GNU "
+ "and Darwin, at least), for example when @var{name} is known "
+ "but requests that were made turned out no data. Error handling\n"
+ "code should be prepared to handle it when it is defined.\n\n"
+ "@item EAI_SERVICE\n"
+ "@var{service} was not recognized for the specified socket type.\n\n"
+ "@item EAI_SOCKTYPE\n"
+ "@var{hint_socktype} was not recognized.\n\n"
+ "@item EAI_SYSTEM\n"
+ "A system error occurred. In C, the error code can be found in "
+ "@code{errno}; this value is not accessible from Scheme, but in\n"
+ "practice it provides little information about the actual error "
+ "cause.\n\n" /* see <http://bugs.gnu.org/13958>. */
+ "@end table\n"
+ "\n"
+ "Users are encouraged to read the "
+ "@url{http://www.opengroup.org/onlinepubs/9699919799/functions/getaddrinfo.html,"
+ "POSIX specification} for more details.\n")
+#define FUNC_NAME s_scm_getaddrinfo
{
-#ifdef INADDR_ANY
- scm_sysintern ("INADDR_ANY", scm_ulong2num (INADDR_ANY));
+ int err;
+ char *c_name, *c_service;
+ struct addrinfo c_hints, *c_result;
+ SCM result = SCM_EOL;
+
+ if (scm_is_true (name))
+ SCM_VALIDATE_STRING (SCM_ARG1, name);
+
+ if (!SCM_UNBNDP (service) && scm_is_true (service))
+ SCM_VALIDATE_STRING (SCM_ARG2, service);
+
+ scm_dynwind_begin (0);
+
+ if (scm_is_string (name))
+ {
+ c_name = scm_to_locale_string (name);
+ scm_dynwind_free (c_name);
+ }
+ else
+ c_name = NULL;
+
+ if (scm_is_string (service))
+ {
+ c_service = scm_to_locale_string (service);
+ scm_dynwind_free (c_service);
+ }
+ else
+ c_service = NULL;
+
+ memset (&c_hints, 0, sizeof (c_hints));
+ if (!SCM_UNBNDP (hint_flags))
+ {
+ c_hints.ai_flags = scm_to_int (hint_flags);
+ if (!SCM_UNBNDP (hint_family))
+ {
+ c_hints.ai_family = scm_to_int (hint_family);
+ if (!SCM_UNBNDP (hint_socktype))
+ {
+ c_hints.ai_socktype = scm_to_int (hint_socktype);
+ if (!SCM_UNBNDP (hint_family))
+ c_hints.ai_family = scm_to_int (hint_family);
+ }
+ }
+ }
+
+ err = getaddrinfo (c_name, c_service, &c_hints, &c_result);
+ if (err == 0)
+ {
+ SCM *prev_addr;
+ struct addrinfo *a;
+
+ for (prev_addr = &result, a = c_result;
+ a != NULL;
+ a = a->ai_next, prev_addr = SCM_CDRLOC (*prev_addr))
+ *prev_addr = scm_list_1 (scm_from_addrinfo (a));
+
+ freeaddrinfo (c_result);
+ }
+ else
+ scm_throw (sym_getaddrinfo_error, scm_list_1 (scm_from_int (err)));
+
+ scm_dynwind_end ();
+
+ return result;
+}
+#undef FUNC_NAME
+
+/* Make sure the `EAI_*' flags can be stored as INUMs. */
+verify (EAI_BADFLAGS < SCM_MOST_POSITIVE_FIXNUM);
+
+/* Error codes returned by `getaddrinfo'. */
+SCM_VARIABLE_INIT (sym_eai_badflags, "EAI_BADFLAGS",
+ SCM_I_MAKINUM (EAI_BADFLAGS));
+SCM_VARIABLE_INIT (sym_eai_noname, "EAI_NONAME",
+ SCM_I_MAKINUM (EAI_NONAME));
+SCM_VARIABLE_INIT (sym_eai_again, "EAI_AGAIN",
+ SCM_I_MAKINUM (EAI_AGAIN));
+SCM_VARIABLE_INIT (sym_eai_fail, "EAI_FAIL",
+ SCM_I_MAKINUM (EAI_FAIL));
+SCM_VARIABLE_INIT (sym_eai_family, "EAI_FAMILY",
+ SCM_I_MAKINUM (EAI_FAMILY));
+SCM_VARIABLE_INIT (sym_eai_socktype, "EAI_SOCKTYPE",
+ SCM_I_MAKINUM (EAI_SOCKTYPE));
+SCM_VARIABLE_INIT (sym_eai_service, "EAI_SERVICE",
+ SCM_I_MAKINUM (EAI_SERVICE));
+SCM_VARIABLE_INIT (sym_eai_memory, "EAI_MEMORY",
+ SCM_I_MAKINUM (EAI_MEMORY));
+SCM_VARIABLE_INIT (sym_eai_system, "EAI_SYSTEM",
+ SCM_I_MAKINUM (EAI_SYSTEM));
+SCM_VARIABLE_INIT (sym_eai_overflow, "EAI_OVERFLOW",
+ SCM_I_MAKINUM (EAI_OVERFLOW));
+
+/* The following values are GNU extensions. */
+#ifdef EAI_NODATA
+SCM_VARIABLE_INIT (sym_eai_nodata, "EAI_NODATA",
+ SCM_I_MAKINUM (EAI_NODATA));
+#endif
+#ifdef EAI_ADDRFAMILY
+SCM_VARIABLE_INIT (sym_eai_addrfamily, "EAI_ADDRFAMILY",
+ SCM_I_MAKINUM (EAI_ADDRFAMILY));
+#endif
+#ifdef EAI_INPROGRESS
+SCM_VARIABLE_INIT (sym_eai_inprogress, "EAI_INPROGRESS",
+ SCM_I_MAKINUM (EAI_INPROGRESS));
+#endif
+#ifdef EAI_CANCELED
+SCM_VARIABLE_INIT (sym_eai_canceled, "EAI_CANCELED",
+ SCM_I_MAKINUM (EAI_CANCELED));
#endif
-#ifdef INADDR_BROADCAST
- scm_sysintern ("INADDR_BROADCAST", scm_ulong2num (INADDR_BROADCAST));
+#ifdef EAI_NOTCANCELED
+SCM_VARIABLE_INIT (sym_eai_notcanceled, "EAI_NOTCANCELED",
+ SCM_I_MAKINUM (EAI_NOTCANCELED));
#endif
-#ifdef INADDR_NONE
- scm_sysintern ("INADDR_NONE", scm_ulong2num (INADDR_NONE));
+#ifdef EAI_ALLDONE
+SCM_VARIABLE_INIT (sym_eai_alldone, "EAI_ALLDONE",
+ SCM_I_MAKINUM (EAI_ALLDONE));
#endif
-#ifdef INADDR_LOOPBACK
- scm_sysintern ("INADDR_LOOPBACK", scm_ulong2num (INADDR_LOOPBACK));
+#ifdef EAI_INTR
+SCM_VARIABLE_INIT (sym_eai_intr, "EAI_INTR",
+ SCM_I_MAKINUM (EAI_INTR));
+#endif
+#ifdef EAI_IDN_ENCODE
+SCM_VARIABLE_INIT (sym_eai_idn_encode, "EAI_IDN_ENCODE",
+ SCM_I_MAKINUM (EAI_IDN_ENCODE));
#endif
+SCM_DEFINE (scm_gai_strerror, "gai-strerror", 1, 0, 0,
+ (SCM error),
+ "Return a string describing @var{error}, an integer error code "
+ "returned by @code{getaddrinfo}.")
+#define FUNC_NAME s_scm_gai_strerror
+{
+ return scm_from_locale_string (gai_strerror (scm_to_int (error)));
+}
+#undef FUNC_NAME
+
+/* TODO: Add a getnameinfo(3) wrapper. */
+
+\f
+void
+scm_init_net_db ()
+{
scm_add_feature ("net-db");
#include "libguile/net_db.x"
}