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]

-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

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.

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

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

-V

Show the version and exit.

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.