summaryrefslogtreecommitdiff
path: root/ipif/README
blob: 9557961599a1d92630bf80affc984ac1169d5175 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
This directory contains:

* userv ipif

  A userv service for allowing users to create network interfaces and
  handle the traffic for them.

* udptunnel

  This is deprecated.

  A VPN tunnelling system based on userv ipif, which does encryption
  and can be used to join two hosts or whole networks.  It uses its
  own nonstandard protocols, not IPSEC.  Key setup is done via an ssh
  connection, and actual data packets are sent (encrypted) using UDP.
  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.


The documentation available is:

INSTALL.udptunnel

  Build and install instructions for both ipif and udptunnel, and
  tutorial on setting up userv ipif and udptunnel in the usual way.

udptunnel (head comment)

  Configuration and invocation reference information for the udptunnel
  VPN facility.

service.c (head comment)

  Reference information for userv ipif service, including syntax of
  /etc/userv/ipif-networks, and command line arguments to userv ipif.

mech-*.c (head comments)

  Detailed specifications of encryption, padding,
  etc. transformations.  For use by cryptographers only; otherwise,
  follow the advice elsewhere about what transformations to use.

forwarder.c (head comment)

  Underlying UDP forwarding program invocation details.  This program
  is normally invoked correctly by `udptunnel'.  You should not need
  to read these details unless you are debugging or modifying udptunnel.


This file is part of ipif, part of userv-utils

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
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 userv-utils; if not, see http://www.gnu.org/licenses/.