+# $Id$
+# Main page of 'My::Project::tcpoverudp'
+# Copyright (C) 2007 Jan Kratochvil <project-www.jankratochvil.net@jankratochvil.net>
+#
+# 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; exactly version 2 of June 1991 is required
+#
+# 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 this program; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+
+package project::tcpoverudp::Index;
+require 5.6.0; # at least 'use warnings;' but we need some 5.6.0+ modules anyway
+our $VERSION=do { my @r=(q$Revision$=~/\d+/g); sprintf "%d.".("%03d"x$#r),@r; };
+our $CVS_ID=q$Id$;
+use strict;
+use warnings;
+
+use My::Web;
+Wuse 'project::Lib';
+Wrequire 'product::Lib';
+
+
+our @ListItem=(
+ "name"=>"tcpoverudp",
+ "platform"=>"unixuser",
+ "priority"=>555,
+ "cvs"=>"tcpoverudp",
+ # FIXME: 'http://cvs.jankratochvil.net/viewcvs/' -> $W->{"project_viewcvs"}
+ "link-Source file"=>'http://cvs.jankratochvil.net/viewcvs/'."tcpoverudp/tcpoverudp?rev=HEAD",
+ "summary"=>"Forward TCP connections over UDP without root",
+ "license"=>"GPL",
+ "maintenance"=>"ready",
+ "language"=>"Perl",
+ "description"=>sub { return <<"HERE"; },
+<p>Does your link suffer from a high packet loss (up to 70%)?
+Do you have a UNIX account in public Internet but no root privileges access there?
+This tool can provide you a reliable fast TCP (web proxy + SSH) connectivity while
+constantly retrying transmissions on link of any quality.</p>
+HERE
+ );
+
+sub handler
+{
+project::Lib->init();
+
+
+print <<"HERE";
+<p>Local script:</p>
+<pre>
+ ./tcpoverudp --udp-server-addr=public.server.com --udp-server-port=8120 \\
+ --tcp-listen-port=8128 8122
+</pre>
+<p>Remote script:</p>
+<pre>
+ ./tcpoverudp --udp-listen-port=8120 \\
+ --tcp-forward-addr=public.web.proxy --tcp-forward-port=3128 \\
+ --tcp-forward-addr=localhost --tcp-forward-port=22
+</pre>
+
+<p>This setup configures a connection:</p>
+<table border="1" class="margin-center padded">
+ <tr>
+ <td>:8128 (TCP, for web proxy)</td>
+ <td>→</td>
+ <td rowspan="2">(UDP) → 8120 (UDP)</td>
+ <td>→</td>
+ <td>public.web.proxy:3128 (TCP, parent web proxy)</td>
+ </tr>
+ <tr>
+ <td>:8122 (TCP, for SSH)</td>
+ <td>→</td>
+ <!---->
+ <td>→</td>
+ <td>localhost:22 (TCP, SSH server)</td>
+ </tr>
+</table>
+
+<p>You should also use this <code>~/.ssh/config</code>for transparent SSH access:</p>
+<pre>
+ Host public-proxy
+ HostName public.server.com
+ HostKeyAlias public.server.com
+ Port 8122
+ ProxyCommand none
+ Host *
+ ProxyCommand ssh public-proxy exec nc %h %p
+</pre>
+HERE
+
+
+exit;
+}
+1;