NAME

       httping - measure the lateceny and throughput of a webserver

SYNOPSIS

       httping [options]

       options:  [-g  url]  [-h  hostname]  [-p  portnumber]  [-x  proxyhost:port] [-c count] [-i
       interval] [-t timeout] [-s] [-G] [-b] [-L xferlimit] [-X] [-l] [-z] [-f] [-m] [-o  rc,...]
       [-e  string]  [-I useragent string] [-R referer string] [-r] [-n warn,crit] [-N mode] [-q]
       [-V]

DESCRIPTION

       The program httping lets you measure the latency of a webserver. Since version 1.0.6  also
       the throughput can be measured.

OPTIONS

       -g url This selects the url to probe. E.g.: http://localhost/

       -h hostname
              Instead of '-g' one can also set a hostname to probe with -h: -h localhost

       -p portnumber
              -p can be used together with -h. -p selects the portnumber to probe.

       -x proxyhost:port]
              Probe  using  a  proxyserver.  Note  that  you're also measuring the latency of the
              proxyserver!

       -c count
              How many probes to send before exiting.

       -i interval
              How many seconds to sleep between every probe sent.

       -t timeout
              How long to wait for answer from the other side.

       -S     Split measured latency in time to connect and time to exchange a request  with  the
              HTTP server.

       -s     When a successfull transaction was done, show the HTTP statuscode (200, 404, etc.).

       -G     Do  a  GET  request  instead  of  a HEAD request: this means that also the complete
              page/file must be transferred. Note that in this case you're  no  longer  measuring
              the latency!

       -b     Use this switch together with '-G'. When this option is used, the transferspeed (in
              KB/s) is shown.

       -B     Use this switch together with '-G'. Ask the HTTP server to  compress  the  returned
              data:  this  will  reduce  the  influence of the bandwidth of your connection while
              increasing the influence of the processorpower of the HTTP server.

       -L x   Use this switch together with '-G'. Limit the amount of data  transferred  to  'x'.
              Note that this only affects the content of the page/file and not the headerdata.

       -X     Use  this  switch  together  with  '-G'.  For  each  "ping" show the amount of data
              transferred (excluding the headers).

       -l     Connect using SSL: for this to work you  need  to  give  a  'https'-url  or  a  443
              portnumber.

       -z     When  connecting  using  SSL, display the fingerprint of the X509 certificate(s) of
              the peer.

       -a     Audible ping

       -f     Flood ping: do not sit idle between each ping but ping as fast as the computer  and
              network allow you to.

       -m     Show machine readable output (also check '-o' and '-e').

       -o x,x,...
              This  selects  the  HTTP  status-codes which are regarded as an OK-state (only with
              '-m').

       -e str When the status-code differs from the ones selected with '-o', the given string  is
              displayed.

       -I str UserAgent-string to send to the webserver (instead of 'HTTPing <version>').

       -R str Referer-string to send to the webserver.

       -r     Only  resolve  the  hostname once: this takes the resolving out of the loop so that
              the latency of the DNS is not measured. Also usefull when you want to measure  only
              1  webserver  while  the  DNS  returns  a  different  ip-address  for  each resolve
              ('roundrobin').

       -n warn,crit
              Switches HTTPing to Nagios-plugin mode 1: return  exitcode  '1'  when  the  average
              response  time  is  bigger  then  'warn',  return exitcode '2' when the the average
              response time is bigger then 'crit'. In all other cases return exitcode '0'.

       -N x   Switches HTTPing to Nagios-plugin mode 2: return 0 when  everything  is  fine,  'x'
              when anything fails. E.g.: 1 => Nagios warning state, 2 => Nagios critical state.

       -q     Be quiet, only return an exit-code.

       -A,U,P Activate the basic authentication, Username follow the -U, Password the -P.

       -F     Attempt  TCP  Fast Open while trying to connect to a server (for Linux, version 3.7
              onwards of the kernel)

       -V     Show the version and exit.

KEYS

       Press <CTRL> + <c> to exit the program. It will display a summary of what was measured.

EXAMPLES

       httping -g http://localhost/
              Ping the webserver on host 'localhost'.

       httping -h localhost -p 1000
              Ping the webserver on host 'localhost' and portnumber 1000.

       httping -l -g https://localhost/
              Ping the webserver on host 'localhost' using an SSL connection.

       httping -g http://localhost/ -A -U username -P password
              Ping the webserver on host 'localhost' using the Basic HTTP Authentication.

BUGS

       None. This program is totally bug-free.

SEE ALSO

       http://www.vanheusden.com/httping/

NOTES

       This page describes httping as found in the  httping-1.5.8  package;  other  versions  may
       differ slightly.  Please mail corrections and additions to folkert@vanheusden.com.  Report
       bugs in the program  to  folkert@vanheusden.com.   Please  consider  sending  bitcoins  to
       1N5Sn4jny4xVwTwSYLnf7WnFQEGoVRmTQF