Optimize 'string-hash'.
[bpt/guile.git] / libguile / net_db.c
dissimilarity index 75%
index 198b95f..d7a12c5 100644 (file)
-/* "net_db.c" network database support
- *     Copyright (C) 1995,1996,1997 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
- *
- * As a special exception, the Free Software Foundation gives permission
- * for additional uses of the text contained in its release of GUILE.
- *
- * 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 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.  */
-
-/* Written in 1994 by Aubrey Jaffer.
- * Thanks to Hallvard.Tretteberg@si.sintef.no for inspiration and discussion.
- * Rewritten by Gary Houston to be a closer interface to the C socket library.
- * Split into net_db.c and socket.c.
- */
-\f
-
-#include <stdio.h>
-#include "_scm.h"
-#include "feature.h"
-
-#include "net_db.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>
-
-/* Some systems do not declare this.  It seems unlikely to produce a
-   conflict.  */
-extern int h_errno;
-
-\f
-
-#ifndef STDC_HEADERS
-int close ();
-#endif /* STDC_HEADERS */
-
-extern int inet_aton ();
-
-SCM_PROC (s_inet_aton, "inet-aton", 1, 0, 0, scm_inet_aton);
-
-SCM 
-scm_inet_aton (address)
-     SCM address;
-{
-  struct in_addr soka;
-
-  SCM_ASSERT (SCM_NIMP (address) && SCM_ROSTRINGP (address), address, SCM_ARG1, s_inet_aton);
-  if (SCM_SUBSTRP (address))
-    address = scm_makfromstr (SCM_ROCHARS (address), SCM_ROLENGTH (address), 0);
-  if (inet_aton (SCM_ROCHARS (address), &soka) == 0)
-    scm_syserror (s_inet_aton);
-  return scm_ulong2num (ntohl (soka.s_addr));
-}
-
-
-SCM_PROC (s_inet_ntoa, "inet-ntoa", 1, 0, 0, scm_inet_ntoa);
-
-SCM 
-scm_inet_ntoa (inetid)
-     SCM inetid;
-{
-  struct in_addr addr;
-  char *s;
-  SCM answer;
-  addr.s_addr = htonl (scm_num2ulong (inetid, (char *) SCM_ARG1, s_inet_ntoa));
-  SCM_DEFER_INTS;
-  s = inet_ntoa (addr);
-  answer = scm_makfromstr (s, strlen (s), 0);
-  SCM_ALLOW_INTS;
-  return answer;
-}
-
-SCM_PROC (s_inet_netof, "inet-netof", 1, 0, 0, scm_inet_netof);
-
-SCM 
-scm_inet_netof (address)
-     SCM address;
-{
-  struct in_addr addr;
-  addr.s_addr = htonl (scm_num2ulong (address, (char *) SCM_ARG1, s_inet_netof));
-  return scm_ulong2num ((unsigned long) inet_netof (addr));
-}
-
-SCM_PROC (s_lnaof, "inet-lnaof", 1, 0, 0, scm_lnaof);
-
-SCM 
-scm_lnaof (address)
-     SCM address;
-{
-  struct in_addr addr;
-  addr.s_addr = htonl (scm_num2ulong (address, (char *) SCM_ARG1, s_lnaof));
-  return scm_ulong2num ((unsigned long) inet_lnaof (addr));
-}
-
-
-SCM_PROC (s_inet_makeaddr, "inet-makeaddr", 2, 0, 0, scm_inet_makeaddr);
-
-SCM 
-scm_inet_makeaddr (net, lna)
-     SCM net;
-     SCM lna;
-{
-  struct in_addr addr;
-  unsigned long netnum;
-  unsigned long lnanum;
-
-  netnum = scm_num2ulong (net, (char *) SCM_ARG1, s_inet_makeaddr);
-  lnanum = scm_num2ulong (lna, (char *) SCM_ARG2, s_inet_makeaddr);
-  addr = inet_makeaddr (netnum, lnanum);
-  return scm_ulong2num (ntohl (addr.s_addr));
-}
-
-
-/* !!! Doesn't take address format.
- * Assumes hostent stream isn't reused.
- */
-
-SCM_PROC (s_gethost, "gethost", 0, 1, 0, scm_gethost);
-
-SCM 
-scm_gethost (name)
-     SCM name;
-{
-  SCM ans = scm_make_vector (SCM_MAKINUM (5), SCM_UNSPECIFIED, SCM_BOOL_F);
-  SCM *ve = SCM_VELTS (ans);
-  SCM lst = SCM_EOL;
-  struct hostent *entry;
-  struct in_addr inad;
-  char **argv;
-  int i = 0;
-  if (SCM_UNBNDP (name))
-    {
-      SCM_DEFER_INTS;
-#ifdef HAVE_GETHOSTENT
-      entry = gethostent ();
-#else
-      entry = NULL;
-#endif
-      if (! entry)
-       {
-         /* As far as I can tell, there's no good way to tell whether
-             zero means an error or end-of-file.  The trick of
-             clearing errno before calling gethostent and checking it
-             afterwards doesn't cut it, because, on Linux, it seems to
-             try to contact some other server (YP?) and fails, which
-             is a benign failure.  */
-         SCM_ALLOW_INTS;
-         return SCM_BOOL_F;
-       }
-    }
-  else if (SCM_NIMP (name) && SCM_ROSTRINGP (name))
-    {
-      SCM_COERCE_SUBSTR (name);
-      SCM_DEFER_INTS;
-      entry = gethostbyname (SCM_ROCHARS (name));
-    }
-  else
-    {
-      inad.s_addr = htonl (scm_num2ulong (name, (char *) SCM_ARG1, s_gethost));
-      SCM_DEFER_INTS;
-      entry = gethostbyaddr ((char *) &inad, sizeof (inad), AF_INET);
-    }
-  SCM_ALLOW_INTS;
-  if (!entry)
-    {
-      char *errmsg;
-      SCM args;
-      args = scm_listify (name, SCM_UNDEFINED);
-      switch (h_errno)
-       {
-       case HOST_NOT_FOUND: errmsg = "host %s not found"; break;
-       case TRY_AGAIN:      errmsg = "nameserver failure (try later)"; break;
-       case NO_RECOVERY:    errmsg = "non-recoverable error"; break;
-       case NO_DATA:        errmsg = "no address associated with %s"; break;
-       default:             errmsg = "undefined error"; break;
-       }
-      scm_syserror_msg (s_gethost, errmsg, args, h_errno);
-    }
-  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);
-  if (sizeof (struct in_addr) != entry->h_length)
-    {
-      ve[4] = SCM_BOOL_F;
-      return ans;
-    }
-  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);
-    }
-  ve[4] = lst;
-  return ans;
-}
-
-
-/* In all subsequent getMUMBLE functions, when we're called with no
-   arguments, we're supposed to traverse the tables entry by entry.
-   However, there doesn't seem to be any documented way to distinguish
-   between end-of-table and an error; in both cases the functions
-   return zero.  Gotta love Unix.  For the time being, we clear errno,
-   and if we get a zero and errno is set, we signal an error.  This
-   doesn't seem quite right (what if errno gets set as part of healthy
-   operation?), but it seems to work okay.  We'll see.  */
-
-SCM_PROC (s_getnet, "getnet", 0, 1, 0, scm_getnet);
-
-SCM 
-scm_getnet (name)
-     SCM name;
-{
-  SCM ans;
-  SCM *ve;
-  struct netent *entry;
-
-  ans = scm_make_vector (SCM_MAKINUM (4), SCM_UNSPECIFIED, SCM_BOOL_F);
-  ve = SCM_VELTS (ans);
-  if (SCM_UNBNDP (name))
-    {
-      SCM_DEFER_INTS;
-      errno = 0;
-      entry = getnetent ();
-      if (! entry)
-       {
-         SCM_ALLOW_INTS;
-         if (errno)
-           scm_syserror (s_getnet);
-         else 
-           return SCM_BOOL_F;
-       }
-    }
-  else if (SCM_NIMP (name) && SCM_ROSTRINGP (name))
-    {
-      SCM_COERCE_SUBSTR (name);
-      SCM_DEFER_INTS;
-      entry = getnetbyname (SCM_ROCHARS (name));
-    }
-  else
-    {
-      unsigned long netnum;
-      netnum = scm_num2ulong (name, (char *) SCM_ARG1, s_getnet);
-      SCM_DEFER_INTS;
-      entry = getnetbyaddr (netnum, AF_INET);
-    }
-  SCM_ALLOW_INTS;
-  if (!entry)
-    scm_syserror_msg (s_getnet, "no such network %s",
-                     scm_listify (name, 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_PROC (s_getproto, "getproto", 0, 1, 0, scm_getproto);
-
-SCM 
-scm_getproto (name)
-     SCM name;
-{
-  SCM ans;
-  SCM *ve;
-  struct protoent *entry;
-
-  ans = scm_make_vector (SCM_MAKINUM (3), SCM_UNSPECIFIED, SCM_BOOL_F);
-  ve = SCM_VELTS (ans);
-  if (SCM_UNBNDP (name))
-    {
-      SCM_DEFER_INTS;
-      errno = 0;
-      entry = getprotoent ();
-      if (! entry)
-       {
-         SCM_ALLOW_INTS;
-         if (errno)
-           scm_syserror (s_getproto);
-         else
-           return SCM_BOOL_F;
-       }
-    }
-  else if (SCM_NIMP (name) && SCM_ROSTRINGP (name))
-    {
-      SCM_COERCE_SUBSTR (name);
-      SCM_DEFER_INTS;
-      entry = getprotobyname (SCM_ROCHARS (name));
-    }
-  else
-    {
-      unsigned long protonum;
-      protonum = scm_num2ulong (name, (char *) SCM_ARG1, s_getproto);
-      SCM_DEFER_INTS;
-      entry = getprotobynumber (protonum);
-    }
-  SCM_ALLOW_INTS;
-  if (!entry)
-    scm_syserror_msg (s_getproto, "no such protocol %s",
-                     scm_listify (name, 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;
-}
-
-
-static SCM scm_return_entry SCM_P ((struct servent *entry));
-
-static SCM
-scm_return_entry (entry)
-     struct servent *entry;
-{
-  SCM ans;
-  SCM *ve;
-
-  ans = scm_make_vector (SCM_MAKINUM (4), SCM_UNSPECIFIED, SCM_BOOL_F);
-  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);
-  SCM_ALLOW_INTS;
-  return ans;
-}
-
-SCM_PROC (s_getserv, "getserv", 0, 2, 0, scm_getserv);
-
-SCM 
-scm_getserv (name, proto)
-     SCM name;
-     SCM proto;
-{
-  struct servent *entry;
-  if (SCM_UNBNDP (name))
-    {
-      SCM_DEFER_INTS;
-      errno = 0;
-      entry = getservent ();
-      SCM_ALLOW_INTS;
-      if (!entry)
-       {
-         if (errno)
-           scm_syserror (s_getserv);
-         else
-           return SCM_BOOL_F;
-       }
-      return scm_return_entry (entry);
-    }
-  SCM_ASSERT (SCM_NIMP (proto) && SCM_ROSTRINGP (proto), proto, SCM_ARG2, s_getserv);
-  SCM_COERCE_SUBSTR (proto);
-  if (SCM_NIMP (name) && SCM_ROSTRINGP (name))
-    {
-      SCM_COERCE_SUBSTR (name);
-      SCM_DEFER_INTS;
-      entry = getservbyname (SCM_ROCHARS (name), SCM_ROCHARS (proto));
-    }
-  else
-    {
-      SCM_ASSERT (SCM_INUMP (name), name, SCM_ARG1, s_getserv);
-      SCM_DEFER_INTS;
-      entry = getservbyport (htons (SCM_INUM (name)), SCM_ROCHARS (proto));
-    }
-  if (!entry)
-    scm_syserror_msg (s_getserv, "no such service %s",
-                     scm_listify (name, SCM_UNDEFINED), errno);
-  SCM_ALLOW_INTS;
-  return scm_return_entry (entry);
-}
-
-SCM_PROC (s_sethost, "sethost", 0, 1, 0, scm_sethost);
-
-SCM 
-scm_sethost (arg)
-     SCM arg;
-{
-  if (SCM_UNBNDP (arg))
-    endhostent ();
-  else
-    sethostent (SCM_NFALSEP (arg));
-  return SCM_UNSPECIFIED;
-}
-
-SCM_PROC (s_setnet, "setnet", 0, 1, 0, scm_setnet);
-
-SCM 
-scm_setnet (arg)
-     SCM arg;
-{
-  if (SCM_UNBNDP (arg))
-    endnetent ();
-  else
-    setnetent (SCM_NFALSEP (arg));
-  return SCM_UNSPECIFIED;
-}
-
-SCM_PROC (s_setproto, "setproto", 0, 1, 0, scm_setproto);
-
-SCM 
-scm_setproto (arg)
-     SCM arg;
-{
-  if (SCM_UNBNDP (arg))
-    endprotoent ();
-  else
-    setprotoent (SCM_NFALSEP (arg));
-  return SCM_UNSPECIFIED;
-}
-
-SCM_PROC (s_setserv, "setserv", 0, 1, 0, scm_setserv);
-
-SCM 
-scm_setserv (arg)
-     SCM arg;
-{
-  if (SCM_UNBNDP (arg))
-    endservent ();
-  else
-    setservent (SCM_NFALSEP (arg));
-  return SCM_UNSPECIFIED;
-}
-
-
-void 
-scm_init_net_db ()
-{
-#ifdef INADDR_ANY
-  scm_sysintern ("INADDR_ANY", scm_ulong2num (INADDR_ANY));
-#endif
-#ifdef INADDR_BROADCAST
-  scm_sysintern ("INADDR_BROADCAST", scm_ulong2num (INADDR_BROADCAST));
-#endif
-#ifdef INADDR_NONE
-  scm_sysintern ("INADDR_NONE", scm_ulong2num (INADDR_NONE));
-#endif
-#ifdef INADDR_LOOPBACK
-  scm_sysintern ("INADDR_LOOPBACK", scm_ulong2num (INADDR_LOOPBACK));
-#endif
-
-  scm_add_feature ("net-db");
-#include "net_db.x"
-}
+/* "net_db.c" network database support
+ * Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2006, 2009,
+ *   2010, 2011, 2012, 2013 Free Software Foundation, Inc.
+ *
+ * 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.
+ *
+ * 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.
+ *
+ * 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
+ */
+
+
+
+/* Written in 1994 by Aubrey Jaffer.
+ * Thanks to Hallvard.Tretteberg@si.sintef.no for inspiration and discussion.
+ * Rewritten by Gary Houston to be a closer interface to the C socket library.
+ * Split into net_db.c and socket.c.
+ */
+\f
+
+#ifdef HAVE_CONFIG_H
+#  include <config.h>
+#endif
+
+#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>
+
+#include "libguile/_scm.h"
+#include "libguile/feature.h"
+#include "libguile/strings.h"
+#include "libguile/vectors.h"
+#include "libguile/dynwind.h"
+
+#include "libguile/validate.h"
+#include "libguile/net_db.h"
+#include "libguile/socket.h"
+
+
+#if defined (HAVE_H_ERRNO)
+/* Only wrap gethostbyname / gethostbyaddr if h_errno is available.  */
+
+#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");
+SCM_SYMBOL (scm_try_again_key, "try-again");
+SCM_SYMBOL (scm_no_recovery_key, "no-recovery");
+SCM_SYMBOL (scm_no_data_key, "no-data");
+
+static void scm_resolv_error (const char *subr, SCM bad_value)
+{
+#ifdef NETDB_INTERNAL
+  if (h_errno == NETDB_INTERNAL)
+    {
+      /* errno supposedly contains a useful value.  */
+      scm_syserror (subr);
+    }
+  else
+#endif
+    {
+      SCM key;
+      const char *errmsg;
+
+      switch (h_errno)
+       {
+       case HOST_NOT_FOUND:
+         key = scm_host_not_found_key;
+         errmsg = "Unknown host"; 
+         break;
+       case TRY_AGAIN: 
+         key = scm_try_again_key;
+         errmsg = "Host name lookup failure";
+         break;
+       case NO_RECOVERY:
+         key = scm_no_recovery_key;
+         errmsg = "Unknown server error"; 
+         break;
+       case NO_DATA:
+         key = scm_no_data_key;
+         errmsg = "No address associated with name";
+         break;
+       default:
+         scm_misc_error (subr, "Unknown resolver error", SCM_EOL);
+         errmsg = NULL;
+       }
+
+#ifdef HAVE_HSTRERROR
+      errmsg = (const char *) hstrerror (h_errno);
+#endif
+      scm_error (key, subr, errmsg, SCM_BOOL_F, SCM_EOL);
+    }
+}
+
+/* Should take an extra arg for address format (will be needed for IPv6).
+   Should use reentrant facilities if available.
+ */
+
+SCM_DEFINE (scm_gethost, "gethost", 0, 1, 0, 
+            (SCM host),
+           "@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"
+           "below).  If a name or address is supplied but the address can not be\n"
+           "found, an error will be thrown to one of the keys:\n"
+           "@code{host-not-found}, @code{try-again}, @code{no-recovery} or\n"
+           "@code{no-data}, corresponding to the equivalent @code{h_error} values.\n"
+           "Unusual conditions may result in errors thrown to the\n"
+           "@code{system-error} or @code{misc_error} keys.")
+#define FUNC_NAME s_scm_gethost
+{
+  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
+      entry = gethostent ();
+#else
+      entry = NULL;
+#endif
+      if (! entry)
+       {
+         /* As far as I can tell, there's no good way to tell whether
+             zero means an error or end-of-file.  The trick of
+             clearing errno before calling gethostent and checking it
+             afterwards doesn't cut it, because, on Linux, it seems to
+             try to contact some other server (YP?) and fails, which
+             is a benign failure.  */
+         return SCM_BOOL_F;
+       }
+    }
+  else if (scm_is_string (host))
+    {
+      char *str = scm_to_locale_string (host);
+      entry = gethostbyname (str);
+      free (str);
+    }
+  else
+    {
+      inad.s_addr = htonl (scm_to_ulong (host));
+      entry = gethostbyaddr ((char *) &inad, sizeof (inad), AF_INET);
+    }
+
+  if (!entry)
+    scm_resolv_error (FUNC_NAME, host);
+  
+  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)
+    {
+      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_from_ulong (ntohl (inad.s_addr)), lst);
+    }
+  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.
+   However, there doesn't seem to be any documented way to distinguish
+   between end-of-table and an error; in both cases the functions
+   return zero.  Gotta love Unix.  For the time being, we clear errno,
+   and if we get a zero and errno is set, we signal an error.  This
+   doesn't seem quite right (what if errno gets set as part of healthy
+   operation?), but it seems to work okay.  We'll see.  */
+
+#if defined(HAVE_GETNETENT) && defined(HAVE_GETNETBYNAME) && defined(HAVE_GETNETBYADDR)
+SCM_DEFINE (scm_getnet, "getnet", 0, 1, 0, 
+            (SCM net),
+           "@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"
+           "argument, behaving like @code{getnetent} (see below) if no arguments are\n"
+           "given.")
+#define FUNC_NAME s_scm_getnet
+{
+  SCM result = scm_c_make_vector (4, SCM_UNSPECIFIED);
+  struct netent *entry;
+  int eno;
+
+  if (SCM_UNBNDP (net))
+    {
+      entry = getnetent ();
+      if (! entry)
+       {
+         /* 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_is_string (net))
+    {
+      char *str = scm_to_locale_string (net);
+      entry = getnetbyname (str);
+      eno = errno;
+      free (str);
+    }
+  else
+    {
+      unsigned long netnum = scm_to_ulong (net);
+      entry = getnetbyaddr (netnum, AF_INET);
+      eno = errno;
+    }
+
+  if (!entry)
+    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
+
+#if defined (HAVE_GETPROTOENT)
+SCM_DEFINE (scm_getproto, "getproto", 0, 1, 0, 
+            (SCM protocol),
+           "@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 result = scm_c_make_vector (3, SCM_UNSPECIFIED);
+  struct protoent *entry;
+  int eno;
+
+  if (SCM_UNBNDP (protocol))
+    {
+      entry = getprotoent ();
+      if (! entry)
+       {
+         /* 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_is_string (protocol))
+    {
+      char *str = scm_to_locale_string (protocol);
+      entry = getprotobyname (str);
+      eno = errno;
+      free (str);
+    }
+  else
+    {
+      unsigned long protonum = scm_to_ulong (protocol);
+      entry = getprotobynumber (protonum);
+      eno = errno;
+    }
+
+  if (!entry)
+    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 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;
+}
+
+SCM_DEFINE (scm_getserv, "getserv", 0, 2, 0,
+            (SCM name, SCM protocol),
+           "@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"
+           "database does not match this name, a system error is signalled.\n\n"
+           "The @code{getserv} procedure will take either a service name or number\n"
+           "as its first argument; if given no arguments, it behaves like\n"
+           "@code{getservent} (see below).")
+#define FUNC_NAME s_scm_getserv
+{
+  struct servent *entry;
+  char *protoname;
+  int eno;
+
+  if (SCM_UNBNDP (name))
+    {
+      entry = getservent ();
+      if (!entry)
+       {
+         /* 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_dynwind_begin (0);
+
+  protoname = scm_to_locale_string (protocol);
+  scm_dynwind_free (protoname);
+
+  if (scm_is_string (name))
+    {
+      char *str = scm_to_locale_string (name);
+      entry = getservbyname (str, protoname);
+      eno = errno;
+      free (str);
+    }
+  else
+    {
+      entry = getservbyport (htons (scm_to_int (name)), protoname);
+      eno = errno;
+    }
+
+  if (!entry)
+    SCM_SYSERROR_MSG("no such service ~A", scm_list_1 (name), eno);
+
+  scm_dynwind_end ();
+  return scm_return_entry (entry);
+}
+#undef FUNC_NAME
+#endif
+
+#if defined(HAVE_SETHOSTENT) && defined(HAVE_ENDHOSTENT)
+SCM_DEFINE (scm_sethost, "sethost", 0, 1, 0, 
+            (SCM stayopen),
+           "If @var{stayopen} is omitted, this is equivalent to @code{endhostent}.\n"
+           "Otherwise it is equivalent to @code{sethostent stayopen}.")
+#define FUNC_NAME s_scm_sethost
+{
+  if (SCM_UNBNDP (stayopen))
+    endhostent ();
+  else
+    sethostent (scm_is_true (stayopen));
+  return SCM_UNSPECIFIED;
+}
+#undef FUNC_NAME
+#endif
+
+#if defined(HAVE_SETNETENT) && defined(HAVE_ENDNETENT) 
+SCM_DEFINE (scm_setnet, "setnet", 0, 1, 0, 
+            (SCM stayopen),
+           "If @var{stayopen} is omitted, this is equivalent to @code{endnetent}.\n"
+           "Otherwise it is equivalent to @code{setnetent stayopen}.")
+#define FUNC_NAME s_scm_setnet
+{
+  if (SCM_UNBNDP (stayopen))
+    endnetent ();
+  else
+    setnetent (scm_is_true (stayopen));
+  return SCM_UNSPECIFIED;
+}
+#undef FUNC_NAME
+#endif
+
+#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"
+           "Otherwise it is equivalent to @code{setprotoent stayopen}.")
+#define FUNC_NAME s_scm_setproto
+{
+  if (SCM_UNBNDP (stayopen))
+    endprotoent ();
+  else
+    setprotoent (scm_is_true (stayopen));
+  return SCM_UNSPECIFIED;
+}
+#undef FUNC_NAME
+#endif
+
+#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"
+           "Otherwise it is equivalent to @code{setservent stayopen}.")
+#define FUNC_NAME s_scm_setserv
+{
+  if (SCM_UNBNDP (stayopen))
+    endservent ();
+  else
+    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;
+}
+
+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
+{
+  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 EAI_NOTCANCELED
+SCM_VARIABLE_INIT (sym_eai_notcanceled, "EAI_NOTCANCELED",
+                  SCM_I_MAKINUM (EAI_NOTCANCELED));
+#endif
+#ifdef EAI_ALLDONE
+SCM_VARIABLE_INIT (sym_eai_alldone, "EAI_ALLDONE",
+                  SCM_I_MAKINUM (EAI_ALLDONE));
+#endif
+#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"
+}
+
+/*
+  Local Variables:
+  c-file-style: "gnu"
+  End:
+*/