httping(1)

1HTTPING(1)                  General Commands Manual                 HTTPING(1)
2
3
4

NAME

6       httping - measure the lateceny and throughput of a webserver
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

21       -g url This selects the url to probe. E.g.: http://localhost/
22
23       -h hostname
24              Instead of '-g' one can also set a hostname to probe with -h: -h
25              localhost
26
27       -p portnumber
28              -p can be used together with -h. -p selects  the  portnumber  to
29              probe.
30
31       -x proxyhost:port]
32              Probe  using  a proxyserver. Note that you're also measuring the
33              latency of the proxyserver!
34
35       -c count
36              How many probes to send before exiting.
37
38       -i interval
39              How many seconds to sleep between every probe sent.
40
41       -t timeout
42              How long to wait for answer from the other side.
43
44       -S     Split measured latency in time to connect and time to exchange a
45              request with the HTTP server.
46
47       -s     When  a  successfull transaction was done, show the HTTP status‐
48              code (200, 404, etc.).
49
50       -G     Do a GET request instead of a HEAD request: this means that also
51              the  complete  page/file  must be transferred. Note that in this
52              case you're no longer measuring the latency!
53
54       -b     Use this switch together with '-G'. When this  option  is  used,
55              the transferspeed (in KB/s) is shown.
56
57       -B     Use  this switch together with '-G'. Ask the HTTP server to com‐
58              press the returned data: this will reduce the influence  of  the
59              bandwidth  of  your connection while increasing the influence of
60              the processorpower of the HTTP server.
61
62       -L x   Use this switch together with '-G'. Limit  the  amount  of  data
63              transferred  to  'x'. Note that this only affects the content of
64              the page/file and not the headerdata.
65
66       -X     Use this switch together with '-G'. For  each  "ping"  show  the
67              amount of data transferred (excluding the headers).
68
69       -l     Connect  using  SSL:  for  this  to  work  you  need  to  give a
70              'https'-url or a 443 portnumber.
71
72       -z     When connecting using SSL, display the fingerprint of  the  X509
73              certificate(s) of the peer.
74
75       -a     Audible ping
76
77       -f     Flood  ping:  do not sit idle between each ping but ping as fast
78              as the computer and network allow you to.
79
80       -m     Show machine readable output (also check '-o' and '-e').
81
82       -o x,x,...
83              This selects the HTTP status-codes which are regarded as an  OK-
84              state.
85
86       -e str When  the  status-code differs from the ones selected with '-o',
87              the given string is displayed.
88
89       -I str UserAgent-string to send to the webserver (instead  of  'HTTPing
90              <version>').
91
92       -R str Referer-string to send to the webserver.
93
94       -r     Only  resolve the hostname once: this takes the resolving out of
95              the loop so that the latency of the DNS is  not  measured.  Also
96              usefull  when you want to measure only 1 webserver while the DNS
97              returns a different ip-address for each resolve ('roundrobin').
98
99       -n warn,crit
100              Switches HTTPing to Nagios-plugin mode 1:  return  exitcode  '1'
101              when  the  average  response  time is bigger then 'warn', return
102              exitcode '2' when the the average response time is  bigger  then
103              'crit'. In all other cases return exitcode '0'.
104
105       -N x   Switches  HTTPing  to Nagios-plugin mode 2: return 0 when every‐
106              thing is fine, 'x' when anything fails. E.g.: 1 => Nagios  warn‐
107              ing state, 2 => Nagios critical state.
108
109       -q     Be quiet, only return an exit-code.
110
111       -A,U,P Activate the basic authentication, Username follow the -U, Pass‐
112              word the -P.
113
114       -V     Show the version and exit.
115
116

KEYS

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

EXAMPLES

123       httping -g http://localhost/
124              Ping the webserver on host 'localhost'.
125
126       httping -h localhost -p 1000
127              Ping the webserver on host 'localhost' and portnumber 1000.
128
129       httping -l -g https://localhost/
130              Ping the webserver on host 'localhost' using an SSL connection.
131
132       httping -g http://localhost/ -A -U username -P password
133              Ping  the  webserver  on  host  'localhost' using the Basic HTTP
134              Authentication.
135

BUGS

137       None. This program is totally bug-free.
138
139

NOTES

145       This page describes httping as  found  in  the  httping-1.0.8  package;
146       other  versions may differ slightly.  Please mail corrections and addi‐
147       tions to folkert@vanheusden.com.  Report bugs in the program  to  folk‐
148       ert@vanheusden.com.  Consider using PGP. My PGP key-id is: 0x1f28d8ae
149
150
151
152httping                             2005-11                         HTTPING(1)