.TH HTS 1
.SH NAME
hts \- httptunnel server
.SH SYNOPSIS
.B hts
.I "[options] [host:][port]"
.SH "DESCRIPTION"
This manual page briefly documents the
.BR hts
command.
.PP
.B hts
listens for incoming httptunnel connections at PORT (default port is
8888), and optionally binds to ip address HOST.
When a connection is made, I/O is redirected to the destination specified
by the \-\-device, \-\-forward\-port or \-\-stdin\-stdout switch.
.SH OPTIONS
The program follows the usual GNU command line syntax, with long
options starting with two dashes (`\-').
A summary of options are included below.
.TP
.B \-h, \-\-help
Show summary of options.
.TP
.B \-c, \-\-content\-length BYTES
use HTTP PUT requests of BYTES size (k, M, and G postfixes recognized)
.TP
.B \-d, \-\-device DEVICE
use DEVICE for input and output
.TP
.B \-F, \-\-forward\-port HOST:PORT
connect to PORT at HOST and use it for input and output
.TP
.B \-k, \-\-keep\-alive SECONDS
send keepalive bytes every SECONDS seconds (default is 5)
.TP
.B \-M, \-\-max\-connection\-age SEC
maximum time a connection will stay open is SEC seconds (default is 300)
.TP
.B \-s, \-\-stdin\-stdout
use stdin/stdout for communication (implies \-\-no\-daemon)
.TP
.B \-S, \-\-strict\-content\-length
always write Content-Length bytes in requests
.TP
.B \-V, \-\-version
output version information and exit
.TP
.B \-w, \-\-no\-daemon
don't fork into the background
.TP
.B \-p, \-\-pid\-file LOCATION
write a PID file to LOCATION
.TP
.B \-C, \-\-chroot LOCATION
chroot to LOCATION before serving clients
.TP
.B \-u, \-\-user USER
change user and group identities before serving clients

.SH EXAMPLES
.TP
Start httptunnel server
.B hts \-F localhost:22 8888
Aat host REMOTE, set up httptunnel server to listen on port 8888 and
forward to localhost:22
.TP
Start httptunnel client
.B htc \-F 2222 \-P PROXY_ADDRESS:8000 REMOTE_IP:8888
At host LOCAL, set up httptunnel client to forward localhost:2222 to
REMOTE_IP:8888 via a local proxy at PROXY_ADDRESS:8000
.TP
Or, if using a buffering HTTP proxy
.B htc \-F 2222 \-P PROXY_ADDRESS:8000 -B 48K REMOTE_IP:8888
.TP
Now you can connect through the tunnel on host LOCAL
.B ssh ssh://localhost:2222

.SH AUTHOR
This manual page was contributed by Teemu Hukkanen <tjhukkan@iki.fi>,
and was originally written for the Debian GNU/Linux system.

.SH SEE ALSO
.MR htc 1