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

httping                                              2013-11                                          HTTPING(1)