prtunnel(1)prtunnel(1)NAMEprtunnel - tunnels TCP connections through HTTP or SOCKS5 proxies
SYNOPSISprtunnel [-DVc6hv] [-t proxy-type] [-H proxy-host] [-P proxy-port] [-T
address] [-u username] [-p password] [--password-prompt] [--http-1.0]
[--telnet-keep-alive interval] [--crlf-keep-alive interval] [--irc-
auto-pong] [--timeout time] [--server-timeout time] [--help] [--ver‐
sion] local-port [remote-host remote-port]
DESCRIPTIONprtunnel tunnels TCP connections through an HTTP or SOCKS5 proxy
server. It is useful if you're behind such a proxy and want to use a
program that doesn't have native proxy support.
local-port is the port that prtunnel will listen for a connection on.
remote-host and remote-port are the hostname/address and port, respec‐
tively, of the remote server that the connection will be tunneled to.
If run without the <remote host> and <remote port> arguments, prtunnel
will accept SOCKS4/SOCKS5 commands from the client to determine the
remote server to connect to.
OPTIONS-D Run as a daemon. prtunnel will run in the background and accept
multiple TCP connections with this option.
-V Turns on verbose output; all data transferred will be printed to
standard output
-c Use color to differentiate between incoming and outgoing data in
verbose output; without this, each line of outgoing verbose out‐
put will begin with ">>> " and incoming output with "<<< "
-6 Enables IPv6 mode. This doesn't affect the way outgoing connec‐
tions are made with the direct/direct6 tunneling modes; direct
will always connect with IPv4 and direct6 will always connect
with IPv6.
-t tunnel-mode
Set tunneling mode; http (default), socks5, direct and direct6
are supported. With http and socks5, you must specify the
address of an http/socks5 proxy to use. direct will make prtun‐
nel connect directly to the remote host specified; direct6 does
the same, but with IPv6 instead of IPv4.
-H proxy-host
Set proxy server hostname
-P proxy-port
Set proxy server port; defaults are 8080 for http, 1080 for
socks5
-T address
Add a trusted address. For security reasons, only localhost is
trusted by default. Only connections from trusted addresses are
allowed. You can specify an address itself (like 10.0.0.0), or
in the form of address/bitcheck, where bitcheck is the number of
leading bits to compare; for example, 10.0.0.0/24 would mean any
address in the range of 10.0.0.0 to 10.0.0.255.
-u username
Set username to use for proxy authentication
-p password
Set password to use for proxy authentication
--password-prompt
Prompt for proxy username and password
--http-1.0
Use HTTP/1.0 instead of HTTP/1.1 for HTTP connections
--telnet-keep-alive interval
Causes prtunnel to send keep-alive data at the specified inter‐
val, using the telnet NOP command
--crlf-keep-alive interval
Causes prtunnel to send keep-alive data at the specified inter‐
val, using a CRLF (this works for some text-based protocols)
--irc-auto-pong
Causes prtunnel to automatically respond to PING commands sent
by IRC servers.
--timeout time
Allows you to set a client socket timeout; if no data is
recieved from the client for <time> seconds, the connection will
be closed
--server-timeout time
Allows you to set a server socket timeout; if no data is
recieved from the remote host for <time> seconds, the connection
will be closed
-h, --help
Show help message
-v, --version
Show version information
EXAMPLEprtunnel-H proxy 6667 irc.freenode.net 6667
After starting prtunnel like this, you could then point an IRC client
to 127.0.0.1, and prtunnel will attempt to connect you to irc.freen‐
ode.net via the HTTP proxy server on a system named "proxy".
WEBSITE
The latest version of prtunnel can be found at http://josh‐
beam.com/software/prtunnel.php
AUTHOR
Josh Beam <josh@joshbeam.com>
NO WARRANTY
THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WAR‐
RANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SER‐
VICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTACT, STRICT LIA‐
BILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
prtunnel 0.2.7 March 12, 2006 prtunnel(1)
