httping
(1)
Name
httping - measure the lateceny and throughput of a webserver
Synopsis
httping [options]
options: [-g url] [-h hostname] [-p portnumber] [-x proxy-
host: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
User Commands HTTPING(1)
NAME
httping - measure the lateceny and throughput of a webserver
SYNOPSIS
httping [options]
options: [-g url] [-h hostname] [-p portnumber] [-x proxy-
host: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 web-
server. Since version 1.0.6 also the throughput can be mea-
sured.
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 port-
number to probe.
-x proxyhost:port]
Probe using a proxyserver. Note that you're also mea-
suring 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!
httping Last change: 2005-11 1
User Commands HTTPING(1)
-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.
-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 resolv-
ing 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').
httping Last change: 2005-11 2
User Commands HTTPING(1)
-n warn,crit
Switches HTTPing to Nagios-plugin mode 1: return exit-
code '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.
-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.
ATTRIBUTES
See attributes(5) for descriptions of the following
attributes:
httping Last change: 2005-11 3
User Commands HTTPING(1)
+---------------+--------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+--------------------+
|Availability | diagnostic/httping |
+---------------+--------------------+
|Stability | Uncommitted |
+---------------+--------------------+
SEE ALSO
http://www.vanheusden.com/httping/
NOTES
This page describes httping as found in the httping-1.0.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. Consider
using PGP. My PGP key-id is: 0x1f28d8ae
This software was built from source available at
https://java.net/projects/solaris-userland. The original
community source was downloaded from http://www.vanheus-
den.com/httping/httping-1.4.4.tgz
Further information about this software can be found on the
open source community website at http://www.vanheus-
den.com/httping/.
httping Last change: 2005-11 4