Provided by: gatling_0.13-6.1_amd64 bug

NAME

       gatling - high performance file server

SYNOPSIS

       gatling [-hnvVtdDfFUlaEe] [-i bind-to-ip] [-p bind-to-port] [-T seconds]
               [-u uid] [-c dir] [-w workgroup] [-P bytes] [-O [f/]ip/port/regex]
               [-r redir-url] [-X timeout,sshd]

DESCRIPTION

       gatling  is  a  HTTP  and FTP server.  It will export the current working directory to the
       world.

       Use -i 127.0.0.1 to only bind to a certain IP address.

       Use -p 81 to bind HTTP to a different TCP port than 80.  Use -f -p 2100 to bind FTP  to  a
       different  TCP  port  than  21.   When running as non-root, the default ports are 8000 and
       2121, respectively.

       Use -u nobody to run under a different UID than root.  This  is  done  after  binding  the
       server  ports,  so  it  is  safe  to  use  -u  and still bind to port 80 -- in fact, it is
       recommended not to run gatling as superuser.

       Use -c /home/www to chdir and  chroot  to  another  directory  than  the  current  working
       directory.   It is recommended to run gatling in a chroot environment to lessen the impact
       of possible future security problems.

       Use -P 2M to activate prefetching mode.  Gatling will then make sure  this  much  data  is
       prefetched.   This can reduce disk activity and improve throughput dramatically if your OS
       I/O scheduler is not state of the art and you are serving several  large  files  from  the
       same  hard  disk  to  different downloaders.  Without prefetching, the disk will otherwise
       waste time moving the disk head between the two large files.

       Use -f to enable anonymous FTP (default) or -F to disable it.  Use -U to  disable  uploads
       altogether  (normally  gatling  will  allow file uploads).  Gatling only allows uploads to
       world writable directories to prevent accidental upload permission, and the files will not
       be  world  readable  (use  -a  if  you want them world readable).  Gatling will only allow
       downloads of world readable files, that's why this switch is important.  These options are
       only available if gatling is compiled with SUPPORT_FTP defined.

       Use  -e  to enable encryption support (https) or -E to disable it.  These options are only
       available if gatling is compiled with SUPPORT_HTTPS defined.

       Use -l to make gatling always ask for FTP passwords.  Normally  gatling  does  not,  which
       confuses some stupid clients.  This option makes gatling ask for (and ignore) a password.

       Use  -d  to  enable  directory  index  generation  for HTTP (listing directories is always
       possible in FTP), -D to disable.  It is harder to accidentally publish a document  if  the
       attacker can not find out the file name through directory listings.

       Use -t to enable transparent proxy mode.  Normally, gatling will replace the port in Host:
       HTTP headers and FTP virtual host names with the actual port the  connection  arrived  at.
       This  is  important  for security (in case you have a secret intranet web site on port 81,
       which is blocked at the firewall).  However, when using a firewall to redirect connections
       to  gatling,  it  may  make  more  sense to keep the ports from the HTTP Host: headers for
       virtual hosting.

       Use -v to enable virtual hosting mode, -V to disable it.  Normally, when a HTTP connection
       asks  for  /foo.html  and  carries  a "Host: www.fefe.de:80" header, gatling will chdir to
       "www.fefe.de:80".  If "www.fefe.de:80" does not exist, gatling will  chdir  to  "default".
       If this also does not exist, and neither -v or -V are given, gatling will serve "foo.html"
       from the current working directory.  Specifying -v will make sure that  no  file  is  ever
       served  from the current working directory, only from the virtual host directories or from
       default.  Specifying -V means that gatling will not try to chdir at all and  always  serve
       from the current working directory.

       Use  -T  600  to  set  the  timeout  for  HTTP and FTP data connections to 10 minutes (600
       seconds, default is 23 seconds).  Use -f -T  600  to  set  the  timeout  for  FTP  control
       connections (default is 600 seconds).

       If  you  use  -r  http://master.example.com/ on mirror.example.com, and someone asks for a
       file that does not exist, gatling will not create a 404 error but a redirect to  the  same
       file on master.example.com.

       Use  -X  timeout,sshd  to  enable  SSH  passthrough  mode.  If someone connects on the SSL
       socket, but does not say anything for timeout (sane value:  2-10)  seconds,  then  gatling
       will run an sshd in inetd mode with that socket.  sshd is the full path name to sshd, plus
       the command line you want to give it, if any.  gatling automatically appends  -i,  so  use
       this for example for -u0 to disable DNS lookups.

       Use  -O [flag/]ip/port/regex to enable proxy mode, also used for SCGI and FastCGI.  To use
       the proxy mode, there has to be a ".proxy" file in the root of  the  virtual  host  it  is
       meant for.  Specify ip and port to point to your app server, and give a regex to match the
       URI.  Note: the regex needs to match  the  full  file  name,  so  use  the  extension  for
       matching.   If  no flags are given, HTTP proxying is used.  Otherwise, flags specifies the
       proxying mode: Use S for SCGI and F for FastCGI mode.  See README.php for an example.

       It  is  also  possible  to  specify  a  Unix  Domain  socket,   using   the   syntax   --O
       [flag/]|filename|regex.   Remember  to  put  the  argument in quotes when typing it in the
       shell.

       Gatling will not serve or list dotfiles unless they are aliased  with  :dotfile,  e.g.  to
       enable serving .dotfile, you have to ln -s .dotfile ":dotfile".

SIGNALS

       Sending  gatling  SIGHUP will make it close all the server sockets (so you can start a new
       gatling process with different options on the same ports).  The old gatling  process  will
       continue serving the established connections until they are all finished.

AUTHOR

       Initially written by Felix von Leitner <felix-gatling@fefe.de>.

LICENSE

       GPLv2  (see  http://www.gnu.org/copyleft/gpl.html)  with  an  exception  to  allow linking
       against openssl.

                                                                                       gatling(1)