Man Linux: Main Page and Category List


       httping - measure the lateceny and throughput of a webserver


       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]


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


       -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

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

       -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-

       -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

       -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.

       -V     Show the version and exit.


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


       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.


       None. This program is totally bug-free.



       This page describes httping as  found  in  the  httping-1.0.8  package;
       other  versions  may  differ  slightly.   Please  mail  corrections and
       additions to  Report bugs  in  the  program  to    Consider   using  PGP.  My  PGP  key-id  is: