News - Main Page
Whitepapers
Tools and Download
Presentations
Related
:hoppy

usage

  Usage: /usr/local/bin/hoppy -h <[http[s]]://hostname[:port]> [options]

         -h [http[s]]://]hostname[:port] [--host=]       (required or -H)
         -H [http[s]]://]hostname[:port] [--host=]       (app only, shortcut for -h host -A)
         -p port [--port=]                               (default 80)
         -l location [--location=]                       (default /images)
         -f file [--file=]                               (default dummy.txt)
         -o methods_file [--options=]                    (default /usr/local/share/http-methods)
         -k keywords_file [--keywords=]                  (default /usr/local/share/response-keywords)
         -r realhostname [--name=]                       (default same as hostname)
         -t port-timeout [--timeout=]                    (default 10s)
         -T max_thread_count [--threads=]                (default 20)
         -a username:password [--auth=]                  (Basic Auth only)
         -C config_file [--config=]                      (Load an alternative for /etc/hoppy/hoppy.conf)
         -S file [--save=]                               (save output to file)
         -L file [--loop=]                               (loop around valid methods)
         -A [--apponly]                                  (disable the host checks)
         -s [--ssl]                                      (use ssl)
         -E [--nospider]                                 (disable the auto spider)
         -n [--nossl]                                    (disable ssl, takes precedence)
         -4 [--404]                                      (do not supress 404's, 100's or 400 or 000 errors)
         -N [--no-proxy]                                 (disable proxy use, even if HTTP_PROXY is set)
         -v [--verbose]                                  (be verbose, print parsed output as we go along)
         -vv                                             (be very verbose, print server response)
         -vvv                                            (be very very verbose, print our test and server response)
         -c [--check]                                    (check the config files for errors, do nothing else)

  To use a web proxy set the ENV vairable HTTP_PROXY to [http[s]://]proxyserver:port
         
Hopefully the usage is explanitary enough but if not ....

-h hostname is the URL of the webserver you wish to test e.g. www.google.com or http://www.google.com:80. If www.google.com:443 is used ssl negotiation is autoenabled, https://www.google.com will auto set port to 443 unless it has explcitly ser elsewhere and put on the ssl negotiation.

-H shortcut for -h host -A (see below for -A)

-p port if you need this explained then maybe you shouldn't be using this tool

-l location is the directory with which to test eg bin will test www.google.com/bin/(file)

-f file is the file with which to test eg tet.html will test www.google.com/(location)/test.html

-o use an alternative methods file

-k use an alternative keywords file

-r use to supply the real hostname is going through a mitm proxy or stunnel

-t port time out, if you get alot of 000 errors (which can be seen by adding the -4 switch) try increasing this

-a adds Basic Authetication to the requests which have the (auth) keyword in the methods file 

-S output result to a file

-L loop around valid methods, this function repeats all methods that contain the (loop) keyword replacing the keyword each time with a new entry from the loop file. This is particularily useful when you wish to test for webDav in a number of location on a webserver.

-A Runs in application only mode, this will only send requests with a correctly formatted Host: header. This will miss some Internal
   IP addresses but will stick to your vhost!

-s switch on ssl negotioation

-4 404 supression is enabled by default, this behaviour can be removed by this switch

-N disable the proxy if one is set in the HTTP_PROXY env var.

-n force ssl off (will override -s or port 443 auto on)

-v will print what is going on as we progress through the test
-vv will print the entire server response
-vvv will print both the request sent and the server respose. 

 

Last Updated : 14/09/2008 17:43:52