2013-02-20 14:35:19 +00:00
|
|
|
This is the README file for tinc version 1.1pre6. Installation
|
2000-11-09 20:42:16 +00:00
|
|
|
instructions may be found in the INSTALL file.
|
2000-03-26 00:33:07 +00:00
|
|
|
|
2013-01-20 20:03:22 +00:00
|
|
|
tinc is Copyright (C) 1998-2013 by:
|
2001-01-07 17:09:07 +00:00
|
|
|
|
2006-04-26 13:52:58 +00:00
|
|
|
Ivo Timmermans,
|
2004-03-21 14:21:22 +00:00
|
|
|
Guus Sliepen <guus@tinc-vpn.org>,
|
2001-01-07 17:09:07 +00:00
|
|
|
and others.
|
|
|
|
|
|
|
|
|
|
For a complete list of authors see the AUTHORS file.
|
2000-03-26 00:33:07 +00:00
|
|
|
|
2000-11-09 20:42:16 +00:00
|
|
|
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 of the License, or (at
|
|
|
|
|
your option) any later version. See the file COPYING for more details.
|
2000-03-26 00:33:07 +00:00
|
|
|
|
2000-10-13 23:30:11 +00:00
|
|
|
|
2011-06-25 13:28:54 +00:00
|
|
|
This is a pre-release
|
|
|
|
|
---------------------
|
|
|
|
|
|
|
|
|
|
Please note that this is NOT a stable release. Until version 1.1.0 is released,
|
|
|
|
|
please use one of the 1.0.x versions if you need a stable version of tinc.
|
|
|
|
|
|
|
|
|
|
Although tinc 1.1 will be protocol compatible with tinc 1.0.x, the
|
|
|
|
|
functionality of the tincctl program may still change, and the control socket
|
|
|
|
|
protocol is not fixed yet.
|
|
|
|
|
|
|
|
|
|
|
2000-10-31 16:10:17 +00:00
|
|
|
Security statement
|
|
|
|
|
------------------
|
|
|
|
|
|
2012-10-14 17:22:30 +00:00
|
|
|
This version uses an experimental and unfinished cryptographic protocol. Use it
|
|
|
|
|
at your own risk.
|
2000-10-31 16:10:17 +00:00
|
|
|
|
|
|
|
|
|
2002-09-15 22:34:25 +00:00
|
|
|
Compatibility
|
|
|
|
|
-------------
|
|
|
|
|
|
2013-02-20 14:35:19 +00:00
|
|
|
Version 1.1pre6 is compatible with 1.0pre8, 1.0 and later, but not with older
|
2004-11-11 19:42:25 +00:00
|
|
|
versions of tinc.
|
2002-09-15 22:34:25 +00:00
|
|
|
|
2011-07-17 18:09:08 +00:00
|
|
|
When the ExperimentalProtocol option is used, tinc is still compatible with
|
2013-02-20 14:35:19 +00:00
|
|
|
1.0.X and 1.1pre6 itself, but not with any other 1.1preX version.
|
2011-07-17 18:09:08 +00:00
|
|
|
|
2002-02-10 21:57:54 +00:00
|
|
|
|
2000-10-13 23:30:11 +00:00
|
|
|
Requirements
|
|
|
|
|
------------
|
|
|
|
|
|
2012-10-14 17:22:30 +00:00
|
|
|
In order to compile tinc, you will need a GNU C compiler environment. Please
|
|
|
|
|
ensure you have the latest stable versions of all the required libraries:
|
2002-03-27 16:26:26 +00:00
|
|
|
|
2012-10-14 17:22:30 +00:00
|
|
|
- OpenSSL (http://www.openssl.org/) version 1.0.0 or later.
|
2003-08-08 11:45:37 +00:00
|
|
|
|
2012-10-14 17:22:30 +00:00
|
|
|
The following libraries are used by default, but can be disabled if necessary:
|
2007-05-18 11:54:16 +00:00
|
|
|
|
2012-10-14 17:22:30 +00:00
|
|
|
- zlib (http://www.gzip.org/zlib/)
|
|
|
|
|
- lzo (http://www.oberhumer.com/opensource/lzo/)
|
|
|
|
|
- ncurses (http://invisible-island.net/ncurses/)
|
|
|
|
|
- readline (ftp://ftp.gnu.org/pub/gnu/readline/)
|
2002-02-10 21:57:54 +00:00
|
|
|
|
2000-10-13 23:30:11 +00:00
|
|
|
|
|
|
|
|
Features
|
|
|
|
|
--------
|
2000-03-26 00:33:07 +00:00
|
|
|
|
2012-10-14 17:22:30 +00:00
|
|
|
Tinc is a peer-to-peer VPN daemon that supports VPNs with an arbitrary number
|
|
|
|
|
of nodes. Instead of configuring tunnels, you give tinc the location and
|
|
|
|
|
public key of a few nodes in the VPN. After making the initial connections to
|
|
|
|
|
those nodes, tinc will learn about all other nodes on the VPN, and will make
|
|
|
|
|
connections automatically. When direct connections are not possible, data will
|
|
|
|
|
be forwarded by intermediate nodes.
|
|
|
|
|
|
|
|
|
|
By default, nodes authenticate each other using 2048 bit RSA (or 521 bit
|
|
|
|
|
ECDSA*) keys. Traffic is encrypted using Blowfish in CBC mode (or AES-256 in
|
|
|
|
|
CTR mode*), authenticated using HMAC-SHA1 (or HMAC-SHA-256*), and is protected
|
|
|
|
|
against replay attacks.
|
|
|
|
|
|
|
|
|
|
*) When using the ExperimentalProtocol option.
|
|
|
|
|
|
|
|
|
|
Tinc fully supports IPv6.
|
|
|
|
|
|
|
|
|
|
Tinc can operate in several routing modes. In the default mode, "router", every
|
|
|
|
|
node is associated with one or more IPv4 and/or IPv6 Subnets. The other two
|
|
|
|
|
modes, "switch" and "hub", let the tinc daemons work together to form a virtual
|
|
|
|
|
Ethernet network switch or hub.
|
2003-08-08 11:45:37 +00:00
|
|
|
|
|
|
|
|
Normally, when started tinc will detach and run in the background. In a native
|
|
|
|
|
Windows environment this means tinc will intall itself as a service, which will
|
|
|
|
|
restart after reboots. To prevent tinc from detaching or running as a service,
|
|
|
|
|
use the -D option.
|
|
|
|
|
|
2012-10-14 17:22:30 +00:00
|
|
|
The status of the VPN can be queried using the "tincctl" tool, which connects
|
|
|
|
|
to a running tinc daemon via a control connection. The same tool also makes it
|
|
|
|
|
easy to start and stop tinc, and to change its configuration.
|
