.TH JUMPGATE 8
.ad
.fi
.SH NAME
jumpgate
\--
a TCP connection forwarder
.SH SYNOPSIS
.na
.nf
.fi
\fBjumpgate\fR [\fB-hsvi\fR] [\fB-b \fIlocal_host\fR] [\fB-l \fIlocal_port\fR]
[\fB-r \fIremote_port\fR] [\fB-a \fIremote_host\fR] [\fB-f \fIfilename\fR] [\fB-c \fInumber_of_connections\fR]
[\fB-L \fImicroseconds\fR]
.SH DESCRIPTION
.ad
.fi
\fBjumpgate\fR is a TCP connection forwarder that provides many
enhancements and improvements over the existing programs that do
the same thing.
.LP
\fBjumpgate\fR provides an interactive mode that queries the
connected party for the forwarding information it needs.  Also,
there is the option to log the entire forwarded session in a
file for later inspection.  Furthermore, it can log information
about the forwarded session via the syslog(3) facility.
.SH OPTIONS
.IP \fB-h\fR
Output a help message that describes in brief the usage of each
option.
.IP \fB-s\fR
Enable logging of the forwarding information via syslog(3).
.IP \fB-v\fR
Display version number and exit.
.IP \fB-i\fR
Enable interactive mode.  When interactive mode is enabled, only
the local port argument is obligatory, since the connected party
is queried about the rest needed forwarding information.
.IP "\fB-b \fIlocal_host\fR"
Specify the local IP to bind.
.IP "\fB-l \fIlocal_port\fR"
Specify the local port to listen on.  A port number or a service
name can be specified.
.IP "\fB-r \fIremote_port\fR"
Specify the remote port to forward the connection to.  A port
number or a service name can be specified.
.IP "\fB-a \fIremote_host\fR"
Specify the remote host or IP address to forward the connection to.
.IP "\fB-f \fIfilename\fR"
Specify the filename to log the entire forwarded session.  In
interactive mode it logs every forwarded connection.
.IP "\fB-c \fInumber_of_connections\fR"
Specify the maximum length of the queue of pending connections.
.IP "\fB-L \fImicroseconds\fR"
Specify the latency in the forwarded connection in microseconds.  A
microsecond is 0.000001 seconds.
.LP
\fBjumpgate\fR is thoroughly tested on OpenBSD, but should
compile and run without problems on any Unix-like system with
no or trivial modifications.  For a list of systems that
\fBjumpgate\fR is known to run on see the README file.  If you
furtherly improve it, please send me the diffs.
.SH EXAMPLES
For example, to forward all the onnections coming to the local machine on
port 4000 to bsd.gr port 21, and log the connected party via syslog(3) one
should invoke \fBjumpgate\fR like this:
.PP
\fBjumpgate -s -l 4000 -r 21 -a bsd.gr\fR
.PP
In order to wait for connections on port 4000 on the local machine, and then
ask the connected party where to forward the connection, while logging the
entire forwarding session to the jumpgate.log file you should do:
.PP
\fBjumpgate -i -l 4000 -f jumpgate.log\fR
.SH "SEE ALSO"
inetd(8), syslogd(8), syslog(3)
.SH AUTHOR
.na
.nf
Patroklos G. Argyroudis <argp@cs.tcd.ie>
.SH BUGS
\fBjumpgate\fR's interactive mode is still considered to be in
beta testing phase.  Also, there is no UDP support yet.
.\" $Id: jumpgate.8,v 1.12 2002/10/17 11:16:52 argp Exp $