chiark / gitweb /
ipif: Update docs to reflect fact that we are now using tun/tap.
authorIan Jackson <ijackson@chiark.greenend.org.uk>
Wed, 4 Dec 2013 19:05:35 +0000 (19:05 +0000)
committerIan Jackson <ijackson@chiark.greenend.org.uk>
Wed, 4 Dec 2013 19:05:35 +0000 (19:05 +0000)
debian/changelog
ipif/INSTALL
ipif/README
ipif/slattach.diff [deleted file]

index eddbf114214e9fb70184f293e68524d5907c10d4..200936828db06c8a92697ab8f3317615c2fb575d 100644 (file)
@@ -6,6 +6,7 @@ userv-utils (0.6.0~~iwj1) unstable; urgency=low
   * dyndns: Docuument existence in README.
   * REAMDE, copyright: Correct locations for GPL, and contact info.
   * Update to GPLv3+; update copyright notices everywhere.
   * dyndns: Docuument existence in README.
   * REAMDE, copyright: Correct locations for GPL, and contact info.
   * Update to GPLv3+; update copyright notices everywhere.
+  * ipif: Update docs to reflect fact that we are now using tun/tap.
 
  --
 
 
  --
 
index 397a31d8b6c1753add5960c07b272bb3d3cf9b1c..71ba29d143b7ff62a3c99be516e2b7e9d76b6d42 100644 (file)
@@ -13,8 +13,7 @@ BUILD AND INSTALLATION INSTRUCTIONS
 
 1. Install userv, 1.0.1 or later.  This is in Debian GNU/Linux.
 
 
 1. Install userv, 1.0.1 or later.  This is in Debian GNU/Linux.
 
-2. Make sure your Linux kernel has SLIP and CSLIP compiled in.
-   You will need to be using Linux 2.2 (with Unix98-style ptys).
+2. Make sure your Linux kernel has SLIP and TUN compiled in.
 
 3. udptunnel works best if your ssh can do ssh-protocol-level
    keepalives.  Currently these are only supported by using a special
 
 3. udptunnel works best if your ssh can do ssh-protocol-level
    keepalives.  Currently these are only supported by using a special
@@ -34,18 +33,6 @@ BUILD AND INSTALLATION INSTRUCTIONS
  setting up SLIP interfaces.  It might be possible in principle to
  create alternatives for other platforms.
 
  setting up SLIP interfaces.  It might be possible in principle to
  create alternatives for other platforms.
 
-`slattach' problem:
-
- There is a problem with some versions of `slattach' on Linux.  If you
- see a message from it about being unable to open /dev/2 or some such,
- then you need to upgrade or patch your `slattach'.  In Debian
- GNU/Linux it's in the `netbase' package, and the fix is in Debian 2.1
- in 3.16-3 and later; however the bug has regressed, and is known to
- be in Debian 2.2's 3.18-4 and earlier.  The relevant Debian bug
- reports are #45515 (now closed) and #45944.  A patch to correct
- 3.18-4 is provided here as `slattach.diff', and a fixed binary is
- available from me.
-
 
 
 UDPTUNNEL SETUP TUTORIAL
 
 
 UDPTUNNEL SETUP TUTORIAL
@@ -489,14 +476,6 @@ UDPTUNNEL SETUP TUTORIAL
     invocations (ie, ones with a command specified) often have a
     different PATH.
 
     invocations (ie, ones with a command specified) often have a
     different PATH.
 
-  slattach cannot open /dev/2 (or similar messages)
-    Your slattach is buggy.  See under `slattach problem' in the build
-    and installation instructions, above.
-
-  slattach cannot change line discipline (or some other weird message)
-    Check whether your kernel is compiled with SLIP and/or CSLIP
-    support.
-
  * Other messages:
 
   udptunnel-forwarder: alice: bad packet: blowfish-cbcmac: verify failed
  * Other messages:
 
   udptunnel-forwarder: alice: bad packet: blowfish-cbcmac: verify failed
index 09bf5d935ad65a216467050aa6dfbda2917f3990..39a691a8a3ef144b5ed099c753994cb21dffce97 100644 (file)
@@ -14,8 +14,7 @@ This directory contains:
   With the appropriate configuration in userv ipif, users can be
   allowed to create VPN connections without needing root privilege.
 
   With the appropriate configuration in userv ipif, users can be
   allowed to create VPN connections without needing root privilege.
 
-These tools have only been tested on GNU/Linux, and userv ipif in
-particular uses the Linux-specific `slattach' utility.
+These tools have only been tested on GNU/Linux.
 
 
 The documentation available is:
 
 
 The documentation available is:
diff --git a/ipif/slattach.diff b/ipif/slattach.diff
deleted file mode 100644 (file)
index 2107e2d..0000000
+++ /dev/null
@@ -1,121 +0,0 @@
---- net-tools/slattach.c~      Sun Sep 19 19:04:28 1999
-+++ net-tools/slattach.c       Sun Sep 19 19:35:56 1999
-@@ -451,27 +451,39 @@
- static int
- tty_open(char *name, char *speed)
- {
--  char path[PATH_MAX];
--  register char *sp;
-+  char pathbuf[PATH_MAX];
-+  register char *path_open, *path_lock;
-   int fd;
-   /* Try opening the TTY device. */
-   if (name != NULL) {
--      if ((sp = strrchr(name, '/')) != (char *)NULL) *sp++ = '\0';
--        else sp = name;
--      sprintf(path, "/dev/%s", sp);
--      if (tty_lock(sp, 1)) return(-1); /* can we lock the device? */
--      if ((fd = open(path, O_RDWR)) < 0) {
-+      if (name[0] != '/') {
-+              if (strlen(name) + 6 > sizeof(pathbuf)) {
-+                      if (opt_q == 0) fprintf(stderr,
-+                              _("slattach: tty name too long\n"));
-+                      return(-1);
-+              }
-+              sprintf(pathbuf, "/dev/%s", name);
-+              path_open = pathbuf;
-+              path_lock = name;
-+      } else if (!strncmp(name,"/dev/",5)) {
-+              path_open = name;
-+              path_lock = name+5;
-+      } else {
-+              path_open = name;
-+              path_lock = name;
-+      }
-+      if (tty_lock(path_lock, 1)) return(-1); /* can we lock the device? */
-+      if ((fd = open(path_open, O_RDWR)) < 0) {
-               if (opt_q == 0) fprintf(stderr,
-                       "slattach: tty_open(%s, RW): %s\n",
--                                      path, strerror(errno));
-+                                      path_open, strerror(errno));
-               return(-errno);
-       }
-       tty_fd = fd;
--      if (opt_d) printf("slattach: tty_open: %s (%d) ", path, fd);
-+      if (opt_d) printf("slattach: tty_open: %s (%d) ", path_open, fd);
-   } else {
-       tty_fd = 0;
--      sp = (char *)NULL;
-   }
-   /* Fetch the current state of the terminal. */
-@@ -562,20 +574,21 @@
- int
- main(int argc, char *argv[])
- {
--  char path[128];
-+  char path_buf[128];
-+  char *path_dev;
-   char buff[128];
-   char *speed = NULL;
-   char *proto = DEF_PROTO;
-   char *extcmd = (char *)0;
-   struct hwtype *ht;
--  char *sp;
-   int s;
-   static struct option longopts[] = {
-     { "version", 0, NULL, 'V' },
-     { NULL, 0, NULL, 0 }
-   };
--  strcpy(path, "");
-+  strcpy(path_buf, "");
-+  path_dev= path_buf;
-   /* Scan command line for any arguments. */
-   opterr = 0;
-@@ -649,6 +662,12 @@
-               /*NOTREACHED*/
-   }
-   
-+  if (setvbuf(stdout,0,_IOLBF,0)) {
-+      if (opt_q == 0) fprintf(stderr, _("slattach: setvbuf(stdout,0,_IOLBF,0): %s\n"),
-+                              strerror(errno));
-+      exit(1);
-+  }
-+  
-   activate_init();
-   /* Check the protocol. */
-@@ -660,15 +679,14 @@
-   /* Is a terminal given? */
-   if (optind != (argc - 1)) usage();
--  safe_strncpy(path, argv[optind], sizeof(path));
--  if (!strcmp(path, "-")) {
-+  safe_strncpy(path_buf, argv[optind], sizeof(path_buf));
-+  if (!strcmp(path_buf, "-")) {
-       opt_e = 1;
--      sp = NULL;
-+      path_dev = NULL;
-       if (tty_open(NULL, speed) < 0) { return(3); }
-   } else {
--      if ((sp = strrchr(path, '/')) != NULL) *sp++ = '\0';
--        else sp = path;
--      if (tty_open(sp, speed) < 0) { return(3); }
-+      path_dev = path_buf;
-+      if (tty_open(path_dev, speed) < 0) { return(3); }
-   }
-   /* Start the correct protocol. */
-@@ -681,7 +699,7 @@
-   if (opt_v == 1) {
-       tty_get_name(buff);
-       printf(_("%s started"), proto);
--      if (sp != NULL) printf(_(" on %s"), sp);
-+      if (path_dev != NULL) printf(_(" on %s"), path_dev);
-       printf(_(" interface %s\n"), buff);
-   }
-