home | help 
prtunnel(1)		     General Commands Manual		     prtunnel(1)

NAME
     prtunnel - tunnels TCP connections through HTTP or SOCKS5 proxies

SYNOPSIS
     prtunnel  [-DVc6hv] [-t proxy-type] [-H proxy-host] [-P proxy-port] [-T ad-
     dress] [-u username] [-p password] [--password-prompt] [--http-1.0] [--tel-
     net-keep-alive  interval]	[--crlf-keep-alive  interval]  [--irc-auto-pong]
     [--timeout  time]	[--server-timeout  time] [--help] [--version] local-port
     [remote-host remote-port]

DESCRIPTION
     prtunnel 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. re-
     mote-host and remote-port are the hostname/address and port,  respectively,
     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 mul-
	    tiple 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  output
	    will begin with ">>> " and incoming output with "<<< "

     -6     Enables  IPv6 mode. This doesn't affect the way outgoing connections
	    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 prtunnel 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  al-
	    lowed.  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  interval,
	    using the telnet NOP command

     --crlf-keep-alive interval
	    Causes  prtunnel  to send keep-alive data at the specified interval,
	    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

EXAMPLE
     prtunnel -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.freenode.net via
     the HTTP proxy server on a system named "proxy".

WEBSITE
     The  latest  version  of prtunnel can be found at http://joshbeam.com/soft-
     ware/prtunnel.php

AUTHOR
     Josh Beam <josh@joshbeam.com>

NO WARRANTY
     THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY	EXPRESS  OR  IM-
     PLIED  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
     MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO
     EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPE-
     CIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT  LIMITED  TO,
     PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
     OR  BUSINESS  INTERRUPTION)  HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
     WHETHER IN CONTACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTH-
     ERWISE) 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)
home | help