ipif/README

   1 This directory contains:
   2
   3 * userv ipif
   4
   5   A userv service for allowing users to create network interfaces and
   6   handle the traffic for them.
   7
   8 * udptunnel
   9
  10   A VPN tunnelling system based on userv ipif, which does encryption
  11   and can be used to join two hosts or whole networks.  It uses its
  12   own nonstandard protocols, not IPSEC.  Key setup is done via an ssh
  13   connection, and actual data packets are sent (encrypted) using UDP.
  14   With the appropriate configuration in userv ipif, users can be
  15   allowed to create VPN connections without needing root privilege.
  16
  17 These tools have only been tested on GNU/Linux, and userv ipif in
  18 particular uses the Linux-specific `slattach' utility.
  19
  20
  21 The documentation available is:
  22
  23 INSTALL
  24
  25   Build and install instructions for both ipif and udptunnel, and
  26   tutorial on setting up userv ipif and udptunnel in the usual way.
  27
  28 udptunnel (head comment)
  29
  30   Configuration and invocation reference information for the udptunnel
  31   VPN facility.
  32
  33 service.c (head comment)
  34
  35   Reference information for userv ipif service, including syntax of
  36   /etc/userv/ipif-networks, and command line arguments to userv ipif.
  37
  38 mech-*.c (head comments)
  39
  40   Detailed specifications of encryption, padding,
  41   etc. transformations.  For use by cryptographers only; otherwise,
  42   follow the advice elsewhere about what transformations to use.
  43
  44 forwarder.c (head comment)
  45
  46   Underlying UDP forwarding program invocation details.  This program
  47   is normally invoked correctly by `udptunnel'.  You should not need
  48   to read these details unless you are debugging or modifying udptunnel.
  49
  50
  51 Copyright (C) 1999-2000,2003 Ian Jackson
  52 This file is part of ipif, part of userv-utils
  53
  54 This is free software; you can redistribute it and/or modify it
  55 under the terms of the GNU General Public License as published by
  56 the Free Software Foundation; either version 2 of the License, or
  57 (at your option) any later version.
  58
  59 This program is distributed in the hope that it will be useful, but
  60 WITHOUT ANY WARRANTY; without even the implied warranty of
  61 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  62 General Public License for more details.
  63
  64 You should have received a copy of the GNU General Public License
  65 along with userv-utils; if not, write to the Free Software
  66 Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  67
  68
  69 $Id$