Main > Manpage

Manpage


HTOveN(8)                 Networking Software Manual                 HTOveN(8)



NAME
       htoven - HTTP request tunneller.

SYNTAX
       htoven [options]

DESCRIPTION
       HTOveN  proxies  your  http  connections  from  machine with real IP to
       internal  network  machines  (or  "real  IP"-less  machines,  connected
       through SSH tunnel) according to requested name.


OPTIONS
       -d     Debug mode. Provides lots of outputs. Should be used by develop‐
              ers to track things going on.


       -g <group>
              Drop privileges to specified group. Should be used  for security
              reasons,  because  running  with  root privileges may be unsafe.
              Recommended group is nogroup.


       -h     Output help information and exit.


       -H <filename>
              Specify host database file. In this  file  public  and  internal
              hostnames  are  stored also with ports of internal ones. Default
              hosts config file is /etc/htoven/hosts.conf You may send SIGUSR1
              signal  to  HTOveN  to  reload  host  configuration file without
              restarting daemon.


       -p <port>
              Specify TCP port to listen on. It may be decimal port number  or
              service  name string. Default port is 80 if htoven is started as
              root, and 1111 in other case.


       -u <user>
              Drop privileges to specified user. Should be  used  for security
              reasons,  because  running  with  root privileges may be unsafe.
              Recommended user is nobody.


       -V     Output version information and exit.


       -v     Verbose mode. Almost useless at the  moment.  Only  one  message
              will be shown: Listening on 80 port, if server started correctly
              on 80-th port. Soon more statistics will be added.


FILES
       /etc/htoven/hosts.conf

EXAMPLES
       To run htoven the standard way if you have root privileges type:

       htoven -u nobody -g nogroup

       Alternativly you can run it as non-root user:

       htoven -p 8080 -H ~/myhosts.conf

AUTHORS
       Andrew Kosovich http://kosovich.org.ua
       http://htoven.org.ua



Andrew Kosovich                       0.1                            HTOveN(8)