-*- text -*-
gogoCLIENT v1.2-RELEASE
============================
                                     Current Web home: http://gogo6.com/

What's New
----------

Take a look at the release notes on http://gogonet.gogo6.com to know which 
bugs have been resolved, what are the known issues and what new 
features are included in this version:


Description
-----------

TSP is a control protocol used to establish and maintain static 
tunnels. The gogoCLIENT is used on the host computer to connect 
to a tunnel broker using the TSP protocol and to get the information 
for its tunnel. When it receives the information for the tunnel, the 
gogoCLIENT creates the static tunnel on its operating system.

The gogoCLIENT code is mostly identical for all client platforms.
However, creating the static tunnel is operating system dependent and 
is done by a script called by the gogoCLIENT. These scripts are 
located under the template directory in the gogoCLIENT 
installation directory.

The script executed by the gogoCLIENT to configure the tunnel 
interface is customized for each type of supported operating system 
and takes care of all specifics for the target operating system. 
On Unix systems, it is a shell script. This separation of the binary 
and script enables fast and easy additions of new operating systems, 
as has been shown by the community contributions for many operating 
systems.

Packaging
---------

The gogoCLIENT is available either as part of the operating system
distributions, such as Linux or FreeBSD; as downloadable software from 
the Web site of the tunnel broker service, such as Freenet6 
(http://gogonet.gogo6.com); as included in the gogoSERVER CD-ROM; or directly 
from gogo6 (http://www.gogo6.com).

Multi-site operation
--------------------

The gogoCLIENT may be used to connect to a single gogoSERVER 
or to multiple servers across different locations. This serves two 
purposes: providing better quality of service by having users connect 
to the closest server and also provide redundancy if one site is 
unavailable. The mechanism used by TSP to announce multiple sites is 
called a broker list or broker redirection (in the case there's only 
one element in the list). The client receiving a broker list will test 
which sites are available and their respective topological distance 
using echo messages. The client then connects to each broker in the 
list, the closest one first, until a successful connection is 
established.


Executing the gogoCLIENT
-----------------------------

The gogoCLIENT is executed manually by typing the command gogoc. 
If no keepalive is negotiated, the gogoCLIENT program exits after 
setting up the tunnel. If the keepalive mechanism is negotiated, the 
gogoCLIENT forks itself and runs in the background to carry the 
keepalive with the tunnel broker. Keepalives are mandatory for IPv6 in 
UDP IPv4 tunnels to keep the NAT mapping up, but are optional for IPv6
in IPv4 tunnels and IPv4 in IPv6 tunnels.


Please report bugs in the gogoCLIENT on http://gogonet.gogo6.com.

MAINTAINER: gogo6, inc (http://www.gogo6.com/)

Copyright (C) 2010 gogo6, inc.

See CLIENT-LICENSE.TXT for license information.