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
- patch, which can be found (for OpenSSH 1.2.x) at
+ patch, which can be found (for various OpenSSH versions) at
ftp.chiark.greenend.org.uk:/users/ian/openssh+protocolkeepalives.
+ Pre-compiled Debian packages are available there too.
4. Obtain a fresh copy of userv-utils, if you haven't already.
cd to ipif, and run `make' and (as root) `make install'.
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 the author.
-
UDPTUNNEL SETUP TUTORIAL
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
8. Copyright notice
- Copyright (C) 1999-2000 Ian Jackson
+ This file is part of ipif, part of userv-utils
- This 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 of the License, or
- (at your option) any later version.
+ userv-utils are
+ Copyright 1996-2013 Ian Jackson <ijackson@chiark.greenend.org.uk>
+ Copyright 1998 David Damerell <damerell@chiark.greenend.org.uk>
+ Copyright 1999,2003
+ Chancellor Masters and Scholars of the University of Cambridge
+ Copyright 2010 Tony Finch <fanf@dotat.at>
+
+ All the utilities here are 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 3 of the License, 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
General Public License for more details.
You should have received a copy of the GNU General Public License
- along with userv-utils; if not, write to the Free Software
- Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
-
-
-$Id$
+ along with userv-utils; if not, see http://www.gnu.org/licenses/.