DragonFly On-Line Manual Pages

Search: Section:  

prtunnel(1)            DragonFly 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
       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]
       [--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.
       remote-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
              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
              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
              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
              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/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
       WARRANTIES 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
       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 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)

Search: Section: