* Deprecated scm_makfromstr and added scm_mem2string as a replacement.
[bpt/guile.git] / libguile / socket.c
dissimilarity index 84%
index 2c3c571..1eacf9f 100644 (file)
-/* "socket.c" internet socket support for client/server in SCM
-    Copyright (C) 1994 Aubrey Jaffer.
-    Thanks to Hallvard.Tretteberg@si.sintef.no
-    who credits NCSA httpd software by Rob McCool 3/21/93.
-    Rewritten by Gary Houston to be a closer interface to the C
-    socket library.
-    */
-\f
-
-#include <stdio.h>
-#include "_scm.h"
-
-#ifdef HAVE_STRING_H
-#include <string.h>
-#endif
-
-#include <sys/types.h>
-#include <sys/socket.h>
-#include <sys/un.h>
-#include <netinet/in.h>
-#include <netdb.h>
-#include <arpa/inet.h>
-
-\f
-
-#ifndef STDC_HEADERS
-int close P ((int fd));
-#endif /* STDC_HEADERS */
-
-SCM_PROC (s_sys_inet_aton, "inet-aton", 1, 0, 0, scm_sys_inet_aton);
-#ifdef __STDC__
-SCM 
-scm_sys_inet_aton (SCM address)
-#else
-SCM 
-scm_sys_inet_aton (address)
-     SCM address;
-#endif
-{
-  struct in_addr soka;
-
-  SCM_ASSERT (SCM_NIMP (address) && SCM_ROSTRINGP (address), address, SCM_ARG1, s_sys_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_sys_inet_aton);
-  return scm_ulong2num (ntohl (soka.s_addr));
-}
-
-
-SCM_PROC (s_inet_ntoa, "inet-ntoa", 1, 0, 0, scm_inet_ntoa);
-#ifdef __STDC__
-SCM 
-scm_inet_ntoa (SCM inetid)
-#else
-SCM 
-scm_inet_ntoa (inetid)
-     SCM inetid;
-#endif
-{
-  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);
-#ifdef __STDC__
-SCM 
-scm_inet_netof (SCM address)
-#else
-SCM 
-scm_inet_netof (address)
-     SCM address;
-#endif
-{
-  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, "lnaof", 1, 0, 0, scm_lnaof);
-#ifdef __STDC__
-SCM 
-scm_lnaof (SCM address)
-#else
-SCM 
-scm_lnaof (address)
-     SCM address;
-#endif
-{
-  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);
-#ifdef __STDC__
-SCM 
-scm_inet_makeaddr (SCM net, SCM lna)
-#else
-SCM 
-scm_inet_makeaddr (net, lna)
-     SCM net;
-     SCM lna;
-#endif
-{
-  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_sys_gethost, "gethost", 0, 1, 0, scm_sys_gethost);
-#ifdef __STDC__
-SCM 
-scm_sys_gethost (SCM name)
-#else
-SCM 
-scm_sys_gethost (name)
-     SCM name;
-#endif
-{
-  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;
-#ifdef HAVE_GETHOSTENT
-  if (SCM_UNBNDP (name))
-    {
-      SCM_DEFER_INTS;
-      entry = gethostent ();
-    }
-  else
-#endif
-  if (SCM_NIMP (name) && SCM_STRINGP (name))
-    {
-      SCM_DEFER_INTS;
-      entry = gethostbyname (SCM_CHARS (name));
-    }
-  else
-    {
-      inad.s_addr = htonl (scm_num2ulong (name, (char *) SCM_ARG1, s_sys_gethost));
-      SCM_DEFER_INTS;
-      entry = gethostbyaddr ((char *) &inad, sizeof (inad), AF_INET);
-    }
-  SCM_ALLOW_INTS;
-  if (!entry)
-    SCM_SYSERROR (s_sys_gethost);
-  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;
-}
-
-
-SCM_PROC (s_sys_getnet, "getnet", 0, 1, 0, scm_sys_getnet);
-#ifdef __STDC__
-SCM 
-scm_sys_getnet (SCM name)
-#else
-SCM 
-scm_sys_getnet (name)
-     SCM name;
-#endif
-{
-  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;
-      entry = getnetent ();
-    }
-  else if (SCM_NIMP (name) && SCM_STRINGP (name))
-    {
-      SCM_DEFER_INTS;
-      entry = getnetbyname (SCM_CHARS (name));
-    }
-  else
-    {
-      unsigned long netnum;
-      netnum = scm_num2ulong (name, (char *) SCM_ARG1, s_sys_getnet);
-      SCM_DEFER_INTS;
-      entry = getnetbyaddr (netnum, AF_INET);
-    }
-  SCM_ALLOW_INTS;
-  if (!entry)
-    SCM_SYSERROR (s_sys_getnet);
-  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_sys_getproto, "getproto", 0, 1, 0, scm_sys_getproto);
-#ifdef __STDC__
-SCM 
-scm_sys_getproto (SCM name)
-#else
-SCM 
-scm_sys_getproto (name)
-     SCM name;
-#endif
-{
-  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;
-      entry = getprotoent ();
-    }
-  else if (SCM_NIMP (name) && SCM_STRINGP (name))
-    {
-      SCM_DEFER_INTS;
-      entry = getprotobyname (SCM_CHARS (name));
-    }
-  else
-    {
-      unsigned long protonum;
-      protonum = scm_num2ulong (name, (char *) SCM_ARG1, s_sys_getproto);
-      SCM_DEFER_INTS;
-      entry = getprotobynumber (protonum);
-    }
-  SCM_ALLOW_INTS;
-  if (!entry)
-    SCM_SYSERROR (s_sys_getproto);
-  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;
-}
-
-#ifdef __STDC__
-static SCM
-scm_return_entry (struct servent *entry)
-#else
-static SCM
-scm_return_entry (entry)
-     struct servent *entry;
-#endif
-{
-  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_sys_getserv, "getserv", 0, 2, 0, scm_sys_getserv);
-#ifdef __STDC__
-SCM 
-scm_sys_getserv (SCM name, SCM proto)
-#else
-SCM 
-scm_sys_getserv (name, proto)
-     SCM name;
-     SCM proto;
-#endif
-{
-  struct servent *entry;
-  if (SCM_UNBNDP (name))
-    {
-      SCM_DEFER_INTS;
-      entry = getservent ();
-      if (!entry)
-       SCM_SYSERROR (s_sys_getserv);
-      return scm_return_entry (entry);
-    }
-  SCM_ASSERT (SCM_NIMP (proto) && SCM_STRINGP (proto), proto, SCM_ARG2, s_sys_getserv);
-  if (SCM_NIMP (name) && SCM_STRINGP (name))
-    {
-      SCM_DEFER_INTS;
-      entry = getservbyname (SCM_CHARS (name), SCM_CHARS (proto));
-    }
-  else
-    {
-      SCM_ASSERT (SCM_INUMP (name), name, SCM_ARG1, s_sys_getserv);
-      SCM_DEFER_INTS;
-      entry = getservbyport (SCM_INUM (name), SCM_CHARS (proto));
-    }
-  if (!entry)
-    SCM_SYSERROR (s_sys_getserv);
-  return scm_return_entry (entry);
-}
-
-SCM_PROC (s_sethost, "sethost", 0, 1, 0, scm_sethost);
-#ifdef __STDC__
-SCM 
-scm_sethost (SCM arg)
-#else
-SCM 
-scm_sethost (arg)
-     SCM arg;
-#endif
-{
-  if (SCM_UNBNDP (arg))
-    endhostent ();
-  else
-    sethostent (SCM_NFALSEP (arg));
-  return SCM_UNSPECIFIED;
-}
-
-SCM_PROC (s_setnet, "setnet", 0, 1, 0, scm_setnet);
-#ifdef __STDC__
-SCM 
-scm_setnet (SCM arg)
-#else
-SCM 
-scm_setnet (arg)
-     SCM arg;
-#endif
-{
-  if (SCM_UNBNDP (arg))
-    endnetent ();
-  else
-    setnetent (SCM_NFALSEP (arg));
-  return SCM_UNSPECIFIED;
-}
-
-SCM_PROC (s_setproto, "setproto", 0, 1, 0, scm_setproto);
-#ifdef __STDC__
-SCM 
-scm_setproto (SCM arg)
-#else
-SCM 
-scm_setproto (arg)
-     SCM arg;
-#endif
-{
-  if (SCM_UNBNDP (arg))
-    endprotoent ();
-  else
-    setprotoent (SCM_NFALSEP (arg));
-  return SCM_UNSPECIFIED;
-}
-
-SCM_PROC (s_setserv, "setserv", 0, 1, 0, scm_setserv);
-#ifdef __STDC__
-SCM 
-scm_setserv (SCM arg)
-#else
-SCM 
-scm_setserv (arg)
-     SCM arg;
-#endif
-{
-  if (SCM_UNBNDP (arg))
-    endservent ();
-  else
-    setservent (SCM_NFALSEP (arg));
-  return SCM_UNSPECIFIED;
-}
-
-#ifdef __STDC__
-void 
-scm_init_socket (void)
-#else
-void 
-scm_init_socket ()
-#endif
-{
-  scm_add_feature ("socket");
-#include "socket.x"
-}
-
-
+/* Copyright (C) 1996,1997,1998,2000,2001 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.  */
+
+/* Software engineering face-lift by Greg J. Badros, 11-Dec-1999,
+   gjb@cs.washington.edu, http://www.cs.washington.edu/homes/gjb */
+
+\f
+
+#include <errno.h>
+
+#include "libguile/_scm.h"
+#include "libguile/unif.h"
+#include "libguile/feature.h"
+#include "libguile/fports.h"
+#include "libguile/strings.h"
+#include "libguile/vectors.h"
+
+#include "libguile/validate.h"
+#include "libguile/socket.h"
+
+#ifdef HAVE_STRING_H
+#include <string.h>
+#endif
+#ifdef HAVE_UNISTD_H
+#include <unistd.h>
+#endif
+#include <sys/types.h>
+#include <sys/socket.h>
+#ifdef HAVE_UNIX_DOMAIN_SOCKETS
+#include <sys/un.h>
+#endif
+#include <netinet/in.h>
+#include <netdb.h>
+#include <arpa/inet.h>
+
+#if defined (HAVE_UNIX_DOMAIN_SOCKETS) && !defined (SUN_LEN)
+#define SUN_LEN(ptr) ((size_t) (((struct sockaddr_un *) 0)->sun_path) \
+                     + strlen ((ptr)->sun_path))
+#endif
+
+#if !defined (HAVE_UINT32_T)
+#if SIZEOF_INT == 4
+typedef unsigned int uint32_t;
+#elif SIZEOF_LONG == 4
+typedef unsigned long uint32_t;
+#else
+#error can not define uint32_t
+#endif
+#endif
+
+/* we are not currently using socklen_t.  it's not defined on all systems,
+   so would need to be checked by configure.  in the meantime, plain
+   int is the best alternative.  */
+
+\f
+
+SCM_DEFINE (scm_htons, "htons", 1, 0, 0, 
+            (SCM value),
+           "Convert a 16 bit quantity from host to network byte ordering.\n"
+           "@var{value} is packed into 2 bytes, which are then converted\n"
+           "and returned as a new integer.")
+#define FUNC_NAME s_scm_htons
+{
+  unsigned short c_in;
+
+  SCM_VALIDATE_INUM_COPY (1, value, c_in);
+  if (c_in != SCM_INUM (value))
+    SCM_OUT_OF_RANGE (1, value);
+
+  return SCM_MAKINUM (htons (c_in));
+}
+#undef FUNC_NAME
+
+SCM_DEFINE (scm_ntohs, "ntohs", 1, 0, 0, 
+            (SCM value),
+           "Convert a 16 bit quantity from network to host byte ordering.\n"
+           "@var{value} is packed into 2 bytes, which are then converted\n"
+           "and returned as a new integer.")
+#define FUNC_NAME s_scm_ntohs
+{
+  unsigned short c_in;
+
+  SCM_VALIDATE_INUM_COPY (1, value, c_in);
+  if (c_in != SCM_INUM (value))
+    SCM_OUT_OF_RANGE (1, value);
+
+  return SCM_MAKINUM (ntohs (c_in));
+}
+#undef FUNC_NAME
+
+SCM_DEFINE (scm_htonl, "htonl", 1, 0, 0, 
+            (SCM value),
+           "Convert a 32 bit quantity from host to network byte ordering.\n"
+           "@var{value} is packed into 4 bytes, which are then converted\n"
+           "and returned as a new integer.")
+#define FUNC_NAME s_scm_htonl
+{
+  uint32_t c_in = SCM_NUM2ULONG (1, value);
+
+  return scm_ulong2num (htonl (c_in));
+}
+#undef FUNC_NAME
+
+SCM_DEFINE (scm_ntohl, "ntohl", 1, 0, 0, 
+            (SCM value),
+           "Convert a 32 bit quantity from network to host byte ordering.\n"
+           "@var{value} is packed into 4 bytes, which are then converted\n"
+           "and returned as a new integer.")
+#define FUNC_NAME s_scm_ntohl
+{
+  uint32_t c_in = SCM_NUM2ULONG (1, value);
+
+  return scm_ulong2num (ntohl (c_in));
+}
+#undef FUNC_NAME
+
+#ifndef HAVE_INET_ATON
+/* for our definition in inet_aton.c, not usually needed.  */
+extern int inet_aton ();
+#endif
+
+SCM_DEFINE (scm_inet_aton, "inet-aton", 1, 0, 0, 
+            (SCM address),
+           "Convert an IPv4 Internet address from printable string\n"
+           "(dotted decimal notation) to an integer.  E.g.,\n\n"
+           "@lisp\n"
+           "(inet-aton \"127.0.0.1\") @result{} 2130706433\n"
+           "@end lisp")
+#define FUNC_NAME s_scm_inet_aton
+{
+  struct in_addr soka;
+
+  SCM_VALIDATE_STRING (1, address);
+  SCM_STRING_COERCE_0TERMINATION_X (address);
+  if (inet_aton (SCM_STRING_CHARS (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),
+           "Convert an IPv4 Internet address to a printable\n"
+           "(dotted decimal notation) string.  E.g.,\n\n"
+           "@lisp\n"
+           "(inet-ntoa 2130706433) @result{} \"127.0.0.1\"\n"
+           "@end lisp")
+#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_mem2string (s, strlen (s));
+  return answer;
+}
+#undef FUNC_NAME
+
+#ifdef HAVE_INET_NETOF
+SCM_DEFINE (scm_inet_netof, "inet-netof", 1, 0, 0, 
+            (SCM address),
+           "Return the network number part of the given IPv4\n"
+           "Internet address.  E.g.,\n\n"
+           "@lisp\n"
+           "(inet-netof 2130706433) @result{} 127\n"
+           "@end lisp")
+#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
+
+#ifdef HAVE_INET_LNAOF
+SCM_DEFINE (scm_lnaof, "inet-lnaof", 1, 0, 0, 
+            (SCM address),
+           "Return the local-address-with-network part of the given\n"
+           "IPv4 Internet address, using the obsolete class A/B/C system.\n"
+           "E.g.,\n\n"
+           "@lisp\n"
+           "(inet-lnaof 2130706433) @result{} 1\n"
+           "@end lisp")
+#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),
+           "Make an IPv4 Internet address by combining the network number\n"
+           "@var{net} with the local-address-within-network number\n"
+           "@var{lna}.  E.g.,\n\n"
+           "@lisp\n"
+           "(inet-makeaddr 127 1) @result{} 2130706433\n"
+           "@end lisp")
+#define FUNC_NAME s_scm_inet_makeaddr
+{
+  struct in_addr addr;
+  unsigned long netnum;
+  unsigned long lnanum;
+
+  netnum = SCM_NUM2ULONG (1, net);
+  lnanum = SCM_NUM2ULONG (2, lna);
+  addr = inet_makeaddr (netnum, lnanum);
+  return scm_ulong2num (ntohl (addr.s_addr));
+}
+#undef FUNC_NAME
+#endif
+
+#ifdef HAVE_IPV6
+
+/* flip a 128 bit IPv6 address between host and network order.  */
+#ifdef WORDS_BIGENDIAN
+#define FLIP_NET_HOST_128(addr)
+#else
+#define FLIP_NET_HOST_128(addr)\
+{\
+  int i;\
+  \
+  for (i = 0; i < 8; i++)\
+    {\
+      char c = (addr)[i];\
+      \
+      (addr)[i] = (addr)[15 - i];\
+      (addr)[15 - i] = c;\
+    }\
+}
+#endif
+
+/* convert a 128 bit IPv6 address in network order to a host ordered
+   SCM integer.  */
+static SCM ipv6_net_to_num (const char *src)
+{
+  int big_digits = 128 / SCM_BITSPERDIG;
+  const int bytes_per_dig = SCM_BITSPERDIG / 8;
+  char addr[16];
+  char *ptr = addr;
+  SCM result;
+
+  memcpy (addr, src, 16);
+  /* get rid of leading zeros.  */ 
+  while (big_digits > 0)
+    {
+      long test = 0;
+
+      memcpy (&test, ptr, bytes_per_dig);
+      if (test != 0)
+       break;
+      ptr += bytes_per_dig;
+      big_digits--;
+    }
+  FLIP_NET_HOST_128 (addr);
+  if (big_digits * bytes_per_dig <= sizeof (unsigned long))
+    {
+      /* this is just so that we use INUM where possible.  */
+      unsigned long l_addr;
+
+      memcpy (&l_addr, addr, sizeof (unsigned long));
+      result = scm_ulong2num (l_addr);
+    }
+  else
+    {
+      result = scm_i_mkbig (big_digits, 0);
+      memcpy (SCM_BDIGITS (result), addr, big_digits * bytes_per_dig);
+    }
+  return result;
+}  
+
+/* convert a host ordered SCM integer to a 128 bit IPv6 address in
+   network order.  */
+static void ipv6_num_to_net (SCM src, char *dst)
+{
+  if (SCM_INUMP (src))
+    {
+      uint32_t addr = htonl (SCM_INUM (src));
+
+      memset (dst, 0, 12);
+      memcpy (dst + 12, &addr, 4);
+    }
+  else
+    {
+      memset (dst, 0, 16);
+      memcpy (dst, SCM_BDIGITS (src),
+             SCM_NUMDIGS (src) * (SCM_BITSPERDIG / 8));
+      FLIP_NET_HOST_128 (dst);
+    }
+}
+
+/* check that an SCM variable contains an IPv6 integer address.  */
+#define VALIDATE_INET6(which_arg, address)\
+   if (SCM_INUMP (address))\
+      SCM_ASSERT_RANGE (which_arg, address, SCM_INUM (address) >= 0);\
+   else\
+   {\
+      SCM_VALIDATE_BIGINT (which_arg, address);\
+      SCM_ASSERT_RANGE (which_arg, address,\
+                       !SCM_BIGSIGN (address)\
+                       && (SCM_BITSPERDIG\
+                           * SCM_NUMDIGS (address) <= 128));\
+   }
+
+#ifdef HAVE_INET_PTON
+SCM_DEFINE (scm_inet_pton, "inet-pton", 2, 0, 0,
+            (SCM family, SCM address),
+           "Convert a string containing a printable network address to\n"
+           "an integer address.  Note that unlike the C version of this\n"
+           "function,\n"
+           "the result is an integer with normal host byte ordering.\n"
+           "@var{family} can be @code{AF_INET} or @code{AF_INET6}.  E.g.,\n\n"
+           "@lisp\n"
+           "(inet-pton AF_INET \"127.0.0.1\") @result{} 2130706433\n"
+           "(inet-pton AF_INET6 \"::1\") @result{} 1\n"
+           "@end lisp")
+#define FUNC_NAME s_scm_inet_pton
+{
+  int af;
+  char *src;
+  char dst[16];
+  int rv;
+
+  SCM_VALIDATE_INUM_COPY (1, family, af);
+  SCM_ASSERT_RANGE (1, family, af == AF_INET || af == AF_INET6);
+  SCM_VALIDATE_STRING_COPY (2, address, src);
+  rv = inet_pton (af, src, dst);
+  if (rv == -1)
+    SCM_SYSERROR;
+  else if (rv == 0)
+    SCM_MISC_ERROR ("Bad address", SCM_EOL);
+  if (af == AF_INET)
+    return scm_ulong2num (ntohl (*(uint32_t *) dst));
+  else
+    return ipv6_net_to_num ((char *) dst);
+}
+#undef FUNC_NAME
+#endif
+
+#ifdef HAVE_INET_NTOP
+SCM_DEFINE (scm_inet_ntop, "inet-ntop", 2, 0, 0,
+            (SCM family, SCM address),
+           "Convert a network address into a printable string.\n"
+           "Note that unlike the C version of this function,\n"
+           "the input is an integer with normal host byte ordering.\n"
+           "@var{family} can be @code{AF_INET} or @code{AF_INET6}.  E.g.,\n\n"
+           "@lisp\n"
+           "(inet-ntop AF_INET 2130706433) @result{} \"127.0.0.1\"\n"
+           "(inet-ntop AF_INET6 (- (expt 2 128) 1)) @result{}\n"
+           "ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff\n"
+           "@end lisp")
+#define FUNC_NAME s_scm_inet_ntop
+{
+  int af;
+#ifdef INET6_ADDRSTRLEN
+  char dst[INET6_ADDRSTRLEN];
+#else
+  char dst[46];
+#endif
+  char addr6[16];
+
+  SCM_VALIDATE_INUM_COPY (1, family, af);
+  SCM_ASSERT_RANGE (1, family, af == AF_INET || af == AF_INET6);
+  if (af == AF_INET)
+    *(uint32_t *) addr6 = htonl (SCM_NUM2ULONG (2, address));
+  else
+    {
+      VALIDATE_INET6 (2, address);
+      ipv6_num_to_net (address, addr6);
+    }
+  if (inet_ntop (af, &addr6, dst, sizeof dst) == NULL)
+    SCM_SYSERROR;
+  return scm_makfrom0str (dst);
+}
+#undef FUNC_NAME
+#endif
+
+#endif  /* HAVE_IPV6 */
+
+SCM_SYMBOL (sym_socket, "socket");
+
+#define SCM_SOCK_FD_TO_PORT(fd) scm_fdes_to_port (fd, "r+0", sym_socket)
+
+SCM_DEFINE (scm_socket, "socket", 3, 0, 0,
+            (SCM family, SCM style, SCM proto),
+           "Return a new socket port of the type specified by @var{family},\n"
+           "@var{style} and @var{proto}.  All three parameters are\n"
+           "integers.  Supported values for @var{family} are\n"
+           "@code{AF_UNIX}, @code{AF_INET} and @code{AF_INET6}.\n"
+           "Typical values for @var{style} are @code{SOCK_STREAM},\n"
+           "@code{SOCK_DGRAM} and @code{SOCK_RAW}.\n\n"
+           "@var{proto} can be obtained from a protocol name using\n"
+           "@code{getprotobyname}.  A value of zero specifies the default\n"
+           "protocol, which is usually right.\n\n"
+           "A single socket port cannot by used for communication until it\n"
+           "has been connected to another socket.")
+#define FUNC_NAME s_scm_socket
+{
+  int fd;
+
+  SCM_VALIDATE_INUM (1, family);
+  SCM_VALIDATE_INUM (2, style);
+  SCM_VALIDATE_INUM (3, proto);
+  fd = socket (SCM_INUM (family), SCM_INUM (style), SCM_INUM (proto));
+  if (fd == -1)
+    SCM_SYSERROR;
+  return SCM_SOCK_FD_TO_PORT (fd);
+}
+#undef FUNC_NAME
+
+#ifdef HAVE_SOCKETPAIR
+SCM_DEFINE (scm_socketpair, "socketpair", 3, 0, 0,
+            (SCM family, SCM style, SCM proto),
+           "Return a pair of connected (but unnamed) socket ports of the\n"
+           "type specified by @var{family}, @var{style} and @var{proto}.\n"
+           "Many systems support only socket pairs of the @code{AF_UNIX}\n"
+           "family.  Zero is likely to be the only meaningful value for\n"
+           "@var{proto}.")
+#define FUNC_NAME s_scm_socketpair
+{
+  int fam;
+  int fd[2];
+
+  SCM_VALIDATE_INUM (1,family);
+  SCM_VALIDATE_INUM (2,style);
+  SCM_VALIDATE_INUM (3,proto);
+
+  fam = SCM_INUM (family);
+
+  if (socketpair (fam, SCM_INUM (style), SCM_INUM (proto), fd) == -1)
+    SCM_SYSERROR;
+
+  return scm_cons (SCM_SOCK_FD_TO_PORT (fd[0]), SCM_SOCK_FD_TO_PORT (fd[1]));
+}
+#undef FUNC_NAME
+#endif
+
+SCM_DEFINE (scm_getsockopt, "getsockopt", 3, 0, 0,
+            (SCM sock, SCM level, SCM optname),
+           "Return the value of a particular socket option for the socket\n"
+           "port @var{sock}.  @var{level} is an integer code for type of\n"
+           "option being requested, e.g., @code{SOL_SOCKET} for\n"
+           "socket-level options.  @var{optname} is an integer code for the\n"
+           "option required and should be specified using one of the\n"
+           "symbols @code{SO_DEBUG}, @code{SO_REUSEADDR} etc.\n\n"
+           "The returned value is typically an integer but @code{SO_LINGER}\n"
+           "returns a pair of integers.")
+#define FUNC_NAME s_scm_getsockopt
+{
+  int fd;
+  /* size of optval is the largest supported option.  */
+#ifdef HAVE_STRUCT_LINGER
+  char optval[sizeof (struct linger)];
+  int optlen = sizeof (struct linger);
+#else
+  char optval[sizeof (size_t)];
+  int optlen = sizeof (size_t);
+#endif
+  int ilevel;
+  int ioptname;
+
+  sock = SCM_COERCE_OUTPORT (sock);
+  SCM_VALIDATE_OPFPORT (1, sock);
+  SCM_VALIDATE_INUM_COPY (2, level, ilevel);
+  SCM_VALIDATE_INUM_COPY (3, optname, ioptname);
+
+  fd = SCM_FPORT_FDES (sock);
+  if (getsockopt (fd, ilevel, ioptname, (void *) optval, &optlen) == -1)
+    SCM_SYSERROR;
+
+  if (ilevel == SOL_SOCKET)
+    {
+#ifdef SO_LINGER
+      if (ioptname == SO_LINGER)
+       {
+#ifdef HAVE_STRUCT_LINGER
+         struct linger *ling = (struct linger *) optval;
+
+         return scm_cons (scm_long2num (ling->l_onoff),
+                          scm_long2num (ling->l_linger));
+#else
+         return scm_cons (scm_long2num (*(int *) optval)
+                          SCM_MAKINUM (0));
+#endif
+       }
+      else
+#endif
+       if (0
+#ifdef SO_SNDBUF
+           || ioptname == SO_SNDBUF
+#endif
+#ifdef SO_RCVBUF
+           || ioptname == SO_RCVBUF
+#endif
+           )
+         {
+           return scm_long2num (*(size_t *) optval);
+         }
+    }
+  return scm_long2num (*(int *) optval);
+}
+#undef FUNC_NAME
+
+SCM_DEFINE (scm_setsockopt, "setsockopt", 4, 0, 0,
+            (SCM sock, SCM level, SCM optname, SCM value),
+           "Set the value of a particular socket option for the socket\n"
+           "port @var{sock}.  @var{level} is an integer code for type of option\n"
+           "being set, e.g., @code{SOL_SOCKET} for socket-level options.\n"
+           "@var{optname} is an\n"
+           "integer code for the option to set and should be specified using one of\n"
+           "the symbols @code{SO_DEBUG}, @code{SO_REUSEADDR} etc.\n"
+           "@var{value} is the value to which the option should be set.  For\n"
+           "most options this must be an integer, but for @code{SO_LINGER} it must\n"
+           "be a pair.\n\n"
+           "The return value is unspecified.")
+#define FUNC_NAME s_scm_setsockopt
+{
+  int fd;
+  int optlen = -1;
+  /* size of optval is the largest supported option.  */
+#ifdef HAVE_STRUCT_LINGER
+  char optval[sizeof (struct linger)];
+#else
+  char optval[sizeof (size_t)];
+#endif
+  int ilevel, ioptname;
+
+  sock = SCM_COERCE_OUTPORT (sock);
+
+  SCM_VALIDATE_OPFPORT (1, sock);
+  SCM_VALIDATE_INUM_COPY (2, level, ilevel);
+  SCM_VALIDATE_INUM_COPY (3, optname, ioptname);
+
+  fd = SCM_FPORT_FDES (sock);
+
+  if (ilevel == SOL_SOCKET)
+    {
+#ifdef SO_LINGER
+      if (ioptname == SO_LINGER)
+       {
+#ifdef HAVE_STRUCT_LINGER
+         struct linger ling;
+         long lv;
+
+         SCM_ASSERT (SCM_CONSP (value), value, SCM_ARG4, FUNC_NAME);
+         lv = SCM_NUM2LONG (4, SCM_CAR (value));
+         ling.l_onoff = (int) lv;
+         SCM_ASSERT_RANGE (SCM_ARG4, value, ling.l_onoff == lv);
+         lv = SCM_NUM2LONG (4, SCM_CDR (value));
+         ling.l_linger = (int) lv;
+         SCM_ASSERT_RANGE (SCM_ARG4, value, ling.l_linger == lv);
+         optlen = (int) sizeof (struct linger);
+         memcpy (optval, (void *) &ling, optlen);
+#else
+         int ling;
+         long lv;
+
+         SCM_ASSERT (SCM_CONSP (value), value, SCM_ARG4, FUNC_NAME);
+         /* timeout is ignored, but may as well validate it.  */
+         lv = SCM_NUM2LONG (4, SCM_CDR (value));
+         ling = (int) lv;
+         SCM_ASSERT_RANGE (SCM_ARG4, value, ling == lv);
+         lv = SCM_NUM2LONG (4, SCM_CAR (value));
+         ling = (int) lv;
+         SCM_ASSERT_RANGE (SCM_ARG4, value, ling == lv);
+         optlen = (int) sizeof (int);
+         (*(int *) optval) = ling;
+#endif
+       }
+      else
+#endif
+       if (0
+#ifdef SO_SNDBUF
+           || ioptname == SO_SNDBUF
+#endif
+#ifdef SO_RCVBUF
+           || ioptname == SO_RCVBUF
+#endif
+           )
+         {
+           long lv = SCM_NUM2LONG (4, value);
+
+           optlen = (int) sizeof (size_t);
+           (*(size_t *) optval) = (size_t) lv;
+         }
+    }
+  if (optlen == -1)
+    {
+      /* Most options take an int.  */
+      long lv = SCM_NUM2LONG (4, value);
+      int val = (int) lv;
+
+      SCM_ASSERT_RANGE (SCM_ARG4, value, val == lv);
+      optlen = (int) sizeof (int);
+      (*(int *) optval) = val;
+    }
+  if (setsockopt (fd, ilevel, ioptname, (void *) optval, optlen) == -1)
+    SCM_SYSERROR;
+  return SCM_UNSPECIFIED;
+}
+#undef FUNC_NAME
+
+SCM_DEFINE (scm_shutdown, "shutdown", 2, 0, 0,
+          (SCM sock, SCM how),
+           "Sockets can be closed simply by using @code{close-port}. The\n"
+           "@code{shutdown} procedure allows reception or tranmission on a\n"
+           "connection to be shut down individually, according to the parameter\n"
+           "@var{how}:\n\n"
+           "@table @asis\n"
+           "@item 0\n"
+           "Stop receiving data for this socket.  If further data arrives,  reject it.\n"
+           "@item 1\n"
+           "Stop trying to transmit data from this socket.  Discard any\n"
+           "data waiting to be sent.  Stop looking for acknowledgement of\n"
+           "data already sent; don't retransmit it if it is lost.\n"
+           "@item 2\n"
+           "Stop both reception and transmission.\n"
+           "@end table\n\n"
+           "The return value is unspecified.")
+#define FUNC_NAME s_scm_shutdown
+{
+  int fd;
+  sock = SCM_COERCE_OUTPORT (sock);
+  SCM_VALIDATE_OPFPORT (1,sock);
+  SCM_VALIDATE_INUM (2,how);
+  SCM_ASSERT_RANGE(2,how,0 <= SCM_INUM (how) && 2 >= SCM_INUM (how));
+  fd = SCM_FPORT_FDES (sock);
+  if (shutdown (fd, SCM_INUM (how)) == -1)
+    SCM_SYSERROR;
+  return SCM_UNSPECIFIED;
+}
+#undef FUNC_NAME
+
+/* convert fam/address/args into a sockaddr of the appropriate type.
+   args is modified by removing the arguments actually used.
+   which_arg and proc are used when reporting errors:
+   which_arg is the position of address in the original argument list.
+   proc is the name of the original procedure.
+   size returns the size of the structure allocated.  */
+
+static struct sockaddr *
+scm_fill_sockaddr (int fam, SCM address, SCM *args, int which_arg,
+                  const char *proc, int *size)
+#define FUNC_NAME proc
+{
+  switch (fam)
+    {
+    case AF_INET:
+      {
+       struct sockaddr_in *soka;
+       unsigned long addr;
+       int port;
+
+       SCM_VALIDATE_ULONG_COPY (which_arg, address, addr);
+       SCM_VALIDATE_CONS (which_arg + 1, *args);
+       SCM_VALIDATE_INUM_COPY (which_arg + 1, SCM_CAR (*args), port);
+       *args = SCM_CDR (*args);
+       soka = (struct sockaddr_in *) malloc (sizeof (struct sockaddr_in));
+       if (!soka)
+         scm_memory_error (proc);
+       /* 4.4BSD-style interface includes sin_len member and defines SIN_LEN,
+          4.3BSD  does not.  */
+#ifdef SIN_LEN
+       soka->sin_len = sizeof (struct sockaddr_in);
+#endif
+       soka->sin_family = AF_INET;
+       soka->sin_addr.s_addr = htonl (addr);
+       soka->sin_port = htons (port);
+       *size = sizeof (struct sockaddr_in);
+       return (struct sockaddr *) soka;
+      }
+#ifdef HAVE_IPV6
+    case AF_INET6:
+      {
+       /* see RFC2553.  */
+       int port;
+       struct sockaddr_in6 *soka;
+       unsigned long flowinfo = 0;
+       unsigned long scope_id = 0;
+
+       VALIDATE_INET6 (which_arg, address);
+       SCM_VALIDATE_CONS (which_arg + 1, *args);
+       SCM_VALIDATE_INUM_COPY (which_arg + 1, SCM_CAR (*args), port);
+       *args = SCM_CDR (*args);
+       if (SCM_CONSP (*args))
+         {
+           SCM_VALIDATE_ULONG_COPY (which_arg + 2, SCM_CAR (*args), flowinfo);
+           *args = SCM_CDR (*args);
+           if (SCM_CONSP (*args))
+             {
+               SCM_VALIDATE_ULONG_COPY (which_arg + 3, SCM_CAR (*args),
+                                        scope_id);
+               *args = SCM_CDR (*args);
+             }
+         }
+       soka = (struct sockaddr_in6 *) malloc (sizeof (struct sockaddr_in6));
+       if (!soka)
+         scm_memory_error (proc);
+#ifdef SIN_LEN6
+       soka->sin6_len = sizeof (struct sockaddr_in6);
+#endif
+       soka->sin6_family = AF_INET6;
+       ipv6_num_to_net (address, soka->sin6_addr.s6_addr);
+       soka->sin6_port = htons (port);
+       soka->sin6_flowinfo = flowinfo;
+#ifdef HAVE_SIN6_SCOPE_ID
+       soka->sin6_scope_id = scope_id;
+#endif
+       *size = sizeof (struct sockaddr_in6);
+       return (struct sockaddr *) soka;
+      }
+#endif
+#ifdef HAVE_UNIX_DOMAIN_SOCKETS
+    case AF_UNIX:
+      {
+       struct sockaddr_un *soka;
+       int addr_size;
+
+       SCM_ASSERT (SCM_STRINGP (address), address, which_arg, proc);
+       /* the static buffer size in sockaddr_un seems to be arbitrary
+          and not necessarily a hard limit.  e.g., the glibc manual
+          suggests it may be possible to declare it size 0.  let's
+          ignore it.  if the O/S doesn't like the size it will cause
+          connect/bind etc., to fail.  sun_path is always the last
+          member of the structure.  */
+       addr_size = sizeof (struct sockaddr_un)
+         + max (0, SCM_STRING_LENGTH (address) + 1 - (sizeof soka->sun_path));
+       soka = (struct sockaddr_un *) malloc (addr_size);
+       if (!soka)
+         scm_memory_error (proc);
+       memset (soka, 0, addr_size);  /* for sun_len: see sin_len above. */
+       soka->sun_family = AF_UNIX;
+       memcpy (soka->sun_path, SCM_STRING_CHARS (address),
+               SCM_STRING_LENGTH (address));
+       *size = SUN_LEN (soka);
+       return (struct sockaddr *) soka;
+      }
+#endif
+    default:
+      scm_out_of_range (proc, SCM_MAKINUM (fam));
+    }
+}
+#undef FUNC_NAME
+  
+SCM_DEFINE (scm_connect, "connect", 3, 0, 1,
+            (SCM sock, SCM fam, SCM address, SCM args),
+           "Initiate a connection from a socket using a specified address\n"
+           "family to the address\n"
+           "specified by @var{address} and possibly @var{args}.\n"
+           "The format required for @var{address}\n"
+           "and @var{args} depends on the family of the socket.\n\n"
+           "For a socket of family @code{AF_UNIX},\n"
+           "only @var{address} is specified and must be a string with the\n"
+           "filename where the socket is to be created.\n\n"
+           "For a socket of family @code{AF_INET},\n"
+           "@var{address} must be an integer IPv4 host address and\n"
+           "@var{args} must be a single integer port number.\n\n"
+           "For a socket of family @code{AF_INET6},\n"
+           "@var{address} must be an integer IPv6 host address and\n"
+           "@var{args} may be up to three integers:\n"
+           "port [flowinfo] [scope_id],\n"
+           "where flowinfo and scope_id default to zero.\n\n"
+           "The return value is unspecified.")
+#define FUNC_NAME s_scm_connect
+{
+  int fd;
+  struct sockaddr *soka;
+  int size;
+
+  sock = SCM_COERCE_OUTPORT (sock);
+  SCM_VALIDATE_OPFPORT (1,sock);
+  SCM_VALIDATE_INUM (2,fam);
+  fd = SCM_FPORT_FDES (sock);
+  soka = scm_fill_sockaddr (SCM_INUM (fam), address, &args, 3, FUNC_NAME,
+                           &size);
+  if (connect (fd, soka, size) == -1)
+    {
+      int save_errno = errno;
+      
+      free (soka);
+      errno = save_errno;
+      SCM_SYSERROR;
+    }
+  free (soka);
+  return SCM_UNSPECIFIED;
+}
+#undef FUNC_NAME
+
+SCM_DEFINE (scm_bind, "bind", 3, 0, 1,
+            (SCM sock, SCM fam, SCM address, SCM args),
+           "Assign an address to the socket port @var{sock}.\n"
+           "Generally this only needs to be done for server sockets,\n"
+           "so they know where to look for incoming connections.  A socket\n"
+           "without an address will be assigned one automatically when it\n"
+           "starts communicating.\n\n"
+           "The format of @var{address} and @var{args} depends\n"
+           "on the family of the socket.\n\n"
+           "For a socket of family @code{AF_UNIX}, only @var{address}\n"
+           "is specified and must be a string with the filename where\n"
+           "the socket is to be created.\n\n"
+           "For a socket of family @code{AF_INET}, @var{address}\n"
+           "must be an integer IPv4 address and @var{args}\n"
+           "must be a single integer port number.\n\n"
+           "The values of the following variables can also be used for\n"
+           "@var{address}:\n\n"
+           "@defvar INADDR_ANY\n"
+           "Allow connections from any address.\n"
+           "@end defvar\n\n"
+           "@defvar INADDR_LOOPBACK\n"
+           "The address of the local host using the loopback device.\n"
+           "@end defvar\n\n"
+           "@defvar INADDR_BROADCAST\n"
+           "The broadcast address on the local network.\n"
+           "@end defvar\n\n"
+           "@defvar INADDR_NONE\n"
+           "No address.\n"
+           "@end defvar\n\n"
+           "For a socket of family @code{AF_INET6}, @var{address}\n"
+           "must be an integer IPv6 address and @var{args}\n"
+           "may be up to three integers:\n"
+           "port [flowinfo] [scope_id],\n"
+           "where flowinfo and scope_id default to zero.\n\n"
+           "The return value is unspecified.")
+#define FUNC_NAME s_scm_bind
+{
+  struct sockaddr *soka;
+  int size;
+  int fd;
+
+  sock = SCM_COERCE_OUTPORT (sock);
+  SCM_VALIDATE_OPFPORT (1, sock);
+  SCM_VALIDATE_INUM (2, fam);
+  soka = scm_fill_sockaddr (SCM_INUM (fam), address, &args, 3, FUNC_NAME,
+                           &size);
+  fd = SCM_FPORT_FDES (sock);
+  if (bind (fd, soka, size) == -1)
+  {
+    int save_errno = errno;
+      
+    free (soka);
+    errno = save_errno;
+    SCM_SYSERROR;
+  }
+  free (soka);
+  return SCM_UNSPECIFIED;
+}
+#undef FUNC_NAME
+
+SCM_DEFINE (scm_listen, "listen", 2, 0, 0,
+            (SCM sock, SCM backlog),
+           "Enable @var{sock} to accept connection\n"
+           "requests.  @var{backlog} is an integer specifying\n"
+           "the maximum length of the queue for pending connections.\n"
+           "If the queue fills, new clients will fail to connect until\n"
+           "the server calls @code{accept} to accept a connection from\n"
+           "the queue.\n\n"
+           "The return value is unspecified.")
+#define FUNC_NAME s_scm_listen
+{
+  int fd;
+  sock = SCM_COERCE_OUTPORT (sock);
+  SCM_VALIDATE_OPFPORT (1,sock);
+  SCM_VALIDATE_INUM (2,backlog);
+  fd = SCM_FPORT_FDES (sock);
+  if (listen (fd, SCM_INUM (backlog)) == -1)
+    SCM_SYSERROR;
+  return SCM_UNSPECIFIED;
+}
+#undef FUNC_NAME
+
+/* Put the components of a sockaddr into a new SCM vector.  */
+static SCM
+scm_addr_vector (const struct sockaddr *address, const char *proc)
+{
+  short int fam = address->sa_family;
+  SCM result;
+  SCM *ve;
+
+  switch (fam)
+    {
+    case AF_INET:
+      {
+       const struct sockaddr_in *nad = (struct sockaddr_in *) address;
+
+       result = scm_c_make_vector (3, SCM_UNSPECIFIED);
+       ve = SCM_VELTS (result);
+       ve[0] = scm_ulong2num ((unsigned long) fam);
+       ve[1] = scm_ulong2num (ntohl (nad->sin_addr.s_addr));
+       ve[2] = scm_ulong2num ((unsigned long) ntohs (nad->sin_port));
+      }
+      break;
+#ifdef HAVE_IPV6
+    case AF_INET6:
+      {
+       const struct sockaddr_in6 *nad = (struct sockaddr_in6 *) address;
+
+       result = scm_c_make_vector (5, SCM_UNSPECIFIED);
+       ve = SCM_VELTS (result);
+       ve[0] = scm_ulong2num ((unsigned long) fam);
+       ve[1] = ipv6_net_to_num (nad->sin6_addr.s6_addr);
+       ve[2] = scm_ulong2num ((unsigned long) ntohs (nad->sin6_port));
+       ve[3] = scm_ulong2num ((unsigned long) nad->sin6_flowinfo);
+#ifdef HAVE_SIN6_SCOPE_ID
+       ve[4] = scm_ulong2num ((unsigned long) nad->sin6_scope_id);
+#else
+       ve[4] = SCM_INUM0;
+#endif
+      }
+      break;
+#endif
+#ifdef HAVE_UNIX_DOMAIN_SOCKETS
+    case AF_UNIX:
+      {
+       const struct sockaddr_un *nad = (struct sockaddr_un *) address;
+
+       result = scm_c_make_vector (2, SCM_UNSPECIFIED);
+       ve = SCM_VELTS (result);
+       ve[0] = scm_ulong2num ((unsigned long) fam);
+       ve[1] = scm_mem2string (nad->sun_path, strlen (nad->sun_path));
+      }
+      break;
+#endif
+    default:
+      scm_misc_error (proc, "Unrecognised address family: ~A",
+                     SCM_LIST1 (SCM_MAKINUM (fam)));
+    }
+  return result;
+}
+
+/* calculate the size of a buffer large enough to hold any supported
+   sockaddr type.  if the buffer isn't large enough, certain system
+   calls will return a truncated address.  */
+
+#if defined (HAVE_UNIX_DOMAIN_SOCKETS)
+#define MAX_SIZE_UN sizeof (struct sockaddr_un)
+#else
+#define MAX_SIZE_UN 0
+#endif
+
+#if defined (HAVE_IPV6)
+#define MAX_SIZE_IN6 sizeof (struct sockaddr_in6)
+#else
+#define MAX_SIZE_IN6 0
+#endif
+
+#define MAX_ADDR_SIZE max (max (sizeof (struct sockaddr_in), MAX_SIZE_IN6),\
+                           MAX_SIZE_UN)
+
+SCM_DEFINE (scm_accept, "accept", 1, 0, 0, 
+            (SCM sock),
+           "Accept a connection on a bound, listening socket.\n"
+           "If there\n"
+           "are no pending connections in the queue, wait until\n"
+           "one is available unless the non-blocking option has been\n"
+           "set on the socket.\n\n"
+           "The return value is a\n"
+           "pair in which the @emph{car} is a new socket port for the\n"
+           "connection and\n"
+           "the @emph{cdr} is an object with address information about the\n"
+           "client which initiated the connection.\n\n"
+           "@var{sock} does not become part of the\n"
+           "connection and will continue to accept new requests.")
+#define FUNC_NAME s_scm_accept
+{
+  int fd;
+  int newfd;
+  SCM address;
+  SCM newsock;
+  int addr_size = MAX_ADDR_SIZE;
+  char max_addr[MAX_ADDR_SIZE];
+  struct sockaddr *addr = (struct sockaddr *) max_addr;
+
+  sock = SCM_COERCE_OUTPORT (sock);
+  SCM_VALIDATE_OPFPORT (1, sock);
+  fd = SCM_FPORT_FDES (sock);
+  newfd = accept (fd, addr, &addr_size);
+  if (newfd == -1)
+    SCM_SYSERROR;
+  newsock = SCM_SOCK_FD_TO_PORT (newfd);
+  address = scm_addr_vector (addr, FUNC_NAME);
+  return scm_cons (newsock, address);
+}
+#undef FUNC_NAME
+
+SCM_DEFINE (scm_getsockname, "getsockname", 1, 0, 0, 
+            (SCM sock),
+           "Return the address of @var{sock}, in the same form as the\n"
+           "object returned by @code{accept}.  On many systems the address\n"
+           "of a socket in the @code{AF_FILE} namespace cannot be read.")
+#define FUNC_NAME s_scm_getsockname
+{
+  int fd;
+  int addr_size = MAX_ADDR_SIZE;
+  char max_addr[MAX_ADDR_SIZE];
+  struct sockaddr *addr = (struct sockaddr *) max_addr;
+
+  sock = SCM_COERCE_OUTPORT (sock);
+  SCM_VALIDATE_OPFPORT (1,sock);
+  fd = SCM_FPORT_FDES (sock);
+  if (getsockname (fd, addr, &addr_size) == -1)
+    SCM_SYSERROR;
+  return scm_addr_vector (addr, FUNC_NAME);
+}
+#undef FUNC_NAME
+
+SCM_DEFINE (scm_getpeername, "getpeername", 1, 0, 0, 
+            (SCM sock),
+           "Return the address that @var{sock}\n"
+           "is connected to, in the same form as the object returned by\n"
+           "@code{accept}.  On many systems the address of a socket in the\n"
+           "@code{AF_FILE} namespace cannot be read.")
+#define FUNC_NAME s_scm_getpeername
+{
+  int fd;
+  int addr_size = MAX_ADDR_SIZE;
+  char max_addr[MAX_ADDR_SIZE];
+  struct sockaddr *addr = (struct sockaddr *) max_addr;
+
+  sock = SCM_COERCE_OUTPORT (sock);
+  SCM_VALIDATE_OPFPORT (1,sock);
+  fd = SCM_FPORT_FDES (sock);
+  if (getpeername (fd, addr, &addr_size) == -1)
+    SCM_SYSERROR;
+  return scm_addr_vector (addr, FUNC_NAME);
+}
+#undef FUNC_NAME
+
+SCM_DEFINE (scm_recv, "recv!", 2, 1, 0,
+            (SCM sock, SCM buf, SCM flags),
+           "Receive data from a socket port.\n"
+           "@var{sock} must already\n"
+           "be bound to the address from which data is to be received.\n"
+           "@var{buf} is a string into which\n"
+           "the data will be written.  The size of @var{buf} limits\n"
+           "the amount of\n"
+           "data which can be received: in the case of packet\n"
+           "protocols, if a packet larger than this limit is encountered\n"
+           "then some data\n"
+           "will be irrevocably lost.\n\n"
+           "The optional @var{flags} argument is a value or\n"
+           "bitwise OR of MSG_OOB, MSG_PEEK, MSG_DONTROUTE etc.\n\n"
+           "The value returned is the number of bytes read from the\n"
+           "socket.\n\n"
+           "Note that the data is read directly from the socket file\n"
+           "descriptor:\n"
+           "any unread buffered port data is ignored.")
+#define FUNC_NAME s_scm_recv
+{
+  int rv;
+  int fd;
+  int flg;
+
+  SCM_VALIDATE_OPFPORT (1,sock);
+  SCM_VALIDATE_STRING (2,buf);
+  SCM_VALIDATE_INUM_DEF_COPY (3,flags,0,flg);
+  fd = SCM_FPORT_FDES (sock);
+
+  SCM_SYSCALL (rv = recv (fd, SCM_STRING_CHARS (buf), SCM_STRING_LENGTH (buf), flg));
+  if (rv == -1)
+    SCM_SYSERROR;
+
+  return SCM_MAKINUM (rv);
+}
+#undef FUNC_NAME
+
+SCM_DEFINE (scm_send, "send", 2, 1, 0,
+            (SCM sock, SCM message, SCM flags),
+           "Transmit the string @var{message} on a socket port @var{sock}.\n"
+           "@var{sock} must already be bound to a destination address.  The\n"
+           "value returned is the number of bytes transmitted --\n"
+           "it's possible for\n"
+           "this to be less than the length of @var{message}\n"
+           "if the socket is\n"
+           "set to be non-blocking.  The optional @var{flags} argument\n"
+           "is a value or\n"
+           "bitwise OR of MSG_OOB, MSG_PEEK, MSG_DONTROUTE etc.\n\n"
+           "Note that the data is written directly to the socket\n"
+           "file descriptor:\n"
+           "any unflushed buffered port data is ignored.")
+#define FUNC_NAME s_scm_send
+{
+  int rv;
+  int fd;
+  int flg;
+
+  sock = SCM_COERCE_OUTPORT (sock);
+  SCM_VALIDATE_OPFPORT (1,sock);
+  SCM_VALIDATE_STRING (2, message);
+  SCM_VALIDATE_INUM_DEF_COPY (3,flags,0,flg);
+  fd = SCM_FPORT_FDES (sock);
+
+  SCM_SYSCALL (rv = send (fd, SCM_STRING_CHARS (message), SCM_STRING_LENGTH (message), flg));
+  if (rv == -1)
+    SCM_SYSERROR;
+  return SCM_MAKINUM (rv);
+}
+#undef FUNC_NAME
+
+SCM_DEFINE (scm_recvfrom, "recvfrom!", 2, 3, 0,
+            (SCM sock, SCM str, SCM flags, SCM start, SCM end),
+           "Return data from the socket port @var{sock} and also\n"
+           "information about where the data was received from.\n"
+           "@var{sock} must already be bound to the address from which\n"
+           "data is to be received.  @code{str}, is a string into which the\n"
+           "data will be written.  The size of @var{str} limits the amount\n"
+           "of data which can be received: in the case of packet protocols,\n"
+           "if a packet larger than this limit is encountered then some\n"
+           "data will be irrevocably lost.\n\n"
+           "The optional @var{flags} argument is a value or bitwise OR of\n"
+           "@code{MSG_OOB}, @code{MSG_PEEK}, @code{MSG_DONTROUTE} etc.\n\n"
+           "The value returned is a pair: the @emph{car} is the number of\n"
+           "bytes read from the socket and the @emph{cdr} an address object\n"
+           "in the same form as returned by @code{accept}.  The address\n"
+           "will given as @code{#f} if not available, as is usually the\n"
+           "case for stream sockets.\n\n"
+           "The @var{start} and @var{end} arguments specify a substring of\n"
+           "@var{str} to which the data should be written.\n\n"
+           "Note that the data is read directly from the socket file\n"
+           "descriptor: any unread buffered port data is ignored.")
+#define FUNC_NAME s_scm_recvfrom
+{
+  int rv;
+  int fd;
+  int flg;
+  char *buf;
+  int offset;
+  int cend;
+  SCM address;
+  int addr_size = MAX_ADDR_SIZE;
+  char max_addr[MAX_ADDR_SIZE];
+  struct sockaddr *addr = (struct sockaddr *) max_addr;
+
+  SCM_VALIDATE_OPFPORT (1,sock);
+  fd = SCM_FPORT_FDES (sock);
+  SCM_VALIDATE_SUBSTRING_SPEC_COPY (2, str, buf, 4, start, offset,
+                                   5, end, cend);
+  if (SCM_UNBNDP (flags))
+    flg = 0;
+  else
+    SCM_VALIDATE_ULONG_COPY (3, flags, flg);
+
+  /* recvfrom will not necessarily return an address.  usually nothing
+     is returned for stream sockets.  */
+  addr->sa_family = AF_UNSPEC;
+  SCM_SYSCALL (rv = recvfrom (fd, buf + offset,
+                             cend - offset, flg,
+                             addr, &addr_size));
+  if (rv == -1)
+    SCM_SYSERROR;
+  if (addr->sa_family != AF_UNSPEC)
+    address = scm_addr_vector (addr, FUNC_NAME);
+  else
+    address = SCM_BOOL_F;
+
+  return scm_cons (SCM_MAKINUM (rv), address);
+}
+#undef FUNC_NAME
+
+SCM_DEFINE (scm_sendto, "sendto", 4, 0, 1,
+            (SCM sock, SCM message, SCM fam, SCM address, SCM args_and_flags),
+           "Transmit the string @var{message} on the socket port\n"
+           "@var{sock}.  The\n"
+           "destination address is specified using the @var{fam},\n"
+           "@var{address} and\n"
+           "@var{args_and_flags} arguments, in a similar way to the\n"
+           "@code{connect} procedure.  @var{args_and_flags} contains\n"
+           "the usual connection arguments optionally followed by\n"
+           "a flags argument, which is a value or\n"
+           "bitwise OR of MSG_OOB, MSG_PEEK, MSG_DONTROUTE etc.\n\n"
+           "The value returned is the number of bytes transmitted --\n"
+           "it's possible for\n"
+           "this to be less than the length of @var{message} if the\n"
+           "socket is\n"
+           "set to be non-blocking.\n"
+           "Note that the data is written directly to the socket\n"
+           "file descriptor:\n"
+           "any unflushed buffered port data is ignored.")
+#define FUNC_NAME s_scm_sendto
+{
+  int rv;
+  int fd;
+  int flg;
+  struct sockaddr *soka;
+  int size;
+
+  sock = SCM_COERCE_OUTPORT (sock);
+  SCM_VALIDATE_FPORT (1,sock);
+  SCM_VALIDATE_STRING (2, message);
+  SCM_VALIDATE_INUM (3,fam);
+  fd = SCM_FPORT_FDES (sock);
+  soka = scm_fill_sockaddr (SCM_INUM (fam), address, &args_and_flags, 4,
+                           FUNC_NAME, &size);
+  if (SCM_NULLP (args_and_flags))
+    flg = 0;
+  else
+    {
+      SCM_VALIDATE_CONS (5,args_and_flags);
+      flg = SCM_NUM2ULONG (5, SCM_CAR (args_and_flags));
+    }
+  SCM_SYSCALL (rv = sendto (fd, SCM_STRING_CHARS (message),
+                           SCM_STRING_LENGTH (message),
+                           flg, soka, size));
+  if (rv == -1)
+    {
+      int save_errno = errno;
+      free (soka);
+      errno = save_errno;
+      SCM_SYSERROR;
+    }
+  free (soka);
+  return SCM_MAKINUM (rv);
+}
+#undef FUNC_NAME
+\f
+
+
+void
+scm_init_socket ()
+{
+  /* protocol families.  */
+#ifdef AF_UNSPEC
+  scm_c_define ("AF_UNSPEC", SCM_MAKINUM (AF_UNSPEC));
+#endif
+#ifdef AF_UNIX
+  scm_c_define ("AF_UNIX", SCM_MAKINUM (AF_UNIX));
+#endif
+#ifdef AF_INET
+  scm_c_define ("AF_INET", SCM_MAKINUM (AF_INET));
+#endif
+#ifdef AF_INET6
+  scm_c_define ("AF_INET6", SCM_MAKINUM (AF_INET6));
+#endif
+
+#ifdef PF_UNSPEC
+  scm_c_define ("PF_UNSPEC", SCM_MAKINUM (PF_UNSPEC));
+#endif
+#ifdef PF_UNIX
+  scm_c_define ("PF_UNIX", SCM_MAKINUM (PF_UNIX));
+#endif
+#ifdef PF_INET
+  scm_c_define ("PF_INET", SCM_MAKINUM (PF_INET));
+#endif
+#ifdef PF_INET6
+  scm_c_define ("PF_INET6", SCM_MAKINUM (PF_INET6));
+#endif
+
+  /* standard addresses.  */
+#ifdef INADDR_ANY
+  scm_c_define ("INADDR_ANY", scm_ulong2num (INADDR_ANY));
+#endif
+#ifdef INADDR_BROADCAST
+  scm_c_define ("INADDR_BROADCAST", scm_ulong2num (INADDR_BROADCAST));
+#endif
+#ifdef INADDR_NONE
+  scm_c_define ("INADDR_NONE", scm_ulong2num (INADDR_NONE));
+#endif
+#ifdef INADDR_LOOPBACK
+  scm_c_define ("INADDR_LOOPBACK", scm_ulong2num (INADDR_LOOPBACK));
+#endif
+
+  /* socket types.  */
+#ifdef SOCK_STREAM
+  scm_c_define ("SOCK_STREAM", SCM_MAKINUM (SOCK_STREAM));
+#endif
+#ifdef SOCK_DGRAM
+  scm_c_define ("SOCK_DGRAM", SCM_MAKINUM (SOCK_DGRAM));
+#endif
+#ifdef SOCK_RAW
+  scm_c_define ("SOCK_RAW", SCM_MAKINUM (SOCK_RAW));
+#endif
+
+  /* setsockopt level.  */
+#ifdef SOL_SOCKET
+  scm_c_define ("SOL_SOCKET", SCM_MAKINUM (SOL_SOCKET));
+#endif
+#ifdef SOL_IP
+  scm_c_define ("SOL_IP", SCM_MAKINUM (SOL_IP));
+#endif
+#ifdef SOL_TCP
+  scm_c_define ("SOL_TCP", SCM_MAKINUM (SOL_TCP));
+#endif
+#ifdef SOL_UDP
+  scm_c_define ("SOL_UDP", SCM_MAKINUM (SOL_UDP));
+#endif
+
+  /* setsockopt names.  */
+#ifdef SO_DEBUG
+  scm_c_define ("SO_DEBUG", SCM_MAKINUM (SO_DEBUG));
+#endif
+#ifdef SO_REUSEADDR
+  scm_c_define ("SO_REUSEADDR", SCM_MAKINUM (SO_REUSEADDR));
+#endif
+#ifdef SO_STYLE
+  scm_c_define ("SO_STYLE", SCM_MAKINUM (SO_STYLE));
+#endif
+#ifdef SO_TYPE
+  scm_c_define ("SO_TYPE", SCM_MAKINUM (SO_TYPE));
+#endif
+#ifdef SO_ERROR
+  scm_c_define ("SO_ERROR", SCM_MAKINUM (SO_ERROR));
+#endif
+#ifdef SO_DONTROUTE
+  scm_c_define ("SO_DONTROUTE", SCM_MAKINUM (SO_DONTROUTE));
+#endif
+#ifdef SO_BROADCAST
+  scm_c_define ("SO_BROADCAST", SCM_MAKINUM (SO_BROADCAST));
+#endif
+#ifdef SO_SNDBUF
+  scm_c_define ("SO_SNDBUF", SCM_MAKINUM (SO_SNDBUF));
+#endif
+#ifdef SO_RCVBUF
+  scm_c_define ("SO_RCVBUF", SCM_MAKINUM (SO_RCVBUF));
+#endif
+#ifdef SO_KEEPALIVE
+  scm_c_define ("SO_KEEPALIVE", SCM_MAKINUM (SO_KEEPALIVE));
+#endif
+#ifdef SO_OOBINLINE
+  scm_c_define ("SO_OOBINLINE", SCM_MAKINUM (SO_OOBINLINE));
+#endif
+#ifdef SO_NO_CHECK
+  scm_c_define ("SO_NO_CHECK", SCM_MAKINUM (SO_NO_CHECK));
+#endif
+#ifdef SO_PRIORITY
+  scm_c_define ("SO_PRIORITY", SCM_MAKINUM (SO_PRIORITY));
+#endif
+#ifdef SO_LINGER
+  scm_c_define ("SO_LINGER", SCM_MAKINUM (SO_LINGER));
+#endif
+
+  /* recv/send options.  */
+#ifdef MSG_OOB
+  scm_c_define ("MSG_OOB", SCM_MAKINUM (MSG_OOB));
+#endif
+#ifdef MSG_PEEK
+  scm_c_define ("MSG_PEEK", SCM_MAKINUM (MSG_PEEK));
+#endif
+#ifdef MSG_DONTROUTE
+  scm_c_define ("MSG_DONTROUTE", SCM_MAKINUM (MSG_DONTROUTE));
+#endif
+
+  scm_add_feature ("socket");
+
+#ifndef SCM_MAGIC_SNARFER
+#include "libguile/socket.x"
+#endif
+}
+
+
+/*
+  Local Variables:
+  c-file-style: "gnu"
+  End:
+*/