mirror of https://framagit.org/bortzmeyer/echoping
Add a README
parent
9574c70b29
commit
50639f3829
@ -0,0 +1,64 @@
|
||||
echoping
|
||||
========
|
||||
|
||||
echoping **was** a small program to test (approximatively) performances of a remote host by sending it requests such as HTTP requests.
|
||||
|
||||
echoping is **no longer** maintained.
|
||||
|
||||
To use it, simply:
|
||||
|
||||
```
|
||||
% echoping machine.somewhere.org
|
||||
```
|
||||
|
||||
or use the options before the machine name (see the man page).
|
||||
|
||||
See the DETAILS file for various traps when benchmarking networks, specially with this program.
|
||||
|
||||
In any case, be polite: don't bother the remote host with many repeated requests, especially with large size. Ask for permission if you often test hosts which aren't yours.
|
||||
|
||||
Current features:
|
||||
|
||||
* plugins, so you can extend echoping with any protocol you like and/or use,
|
||||
* Supports IPv6 as well as IPv4,
|
||||
* Supports IDN (Unicode domain names like café.gennic.net),
|
||||
* uses the protocols echo, discard, chargen or HTTP,
|
||||
* can use cryptographic connections with HTTP,
|
||||
* uses UDP instead of TCP for the protocols which accept it (like echo),
|
||||
* can repeat the test and display various measures about it,
|
||||
|
||||
Examples of output:
|
||||
|
||||
```
|
||||
(Simple test with 1000 bytes echo TCP packets)
|
||||
|
||||
% echoping -v -s 1000 mycisco
|
||||
|
||||
This is echoping, version 5.0.0.
|
||||
|
||||
Trying to connect to internet address 172.21.0.14 7 to transmit 1000 bytes...
|
||||
Connected...
|
||||
TCP Latency: 0.003165 seconds
|
||||
Sent (1000 bytes)...
|
||||
Application Latency: 0.322183 seconds
|
||||
1000 bytes read from server.
|
||||
Checked
|
||||
Elapsed time: 0.326960 seconds
|
||||
|
||||
(Repeated tests with average / mean and median displayed.)
|
||||
|
||||
% echoping -n 10 faraway-machine
|
||||
[...]
|
||||
Minimum time: 6.722336 seconds (38 bytes per sec.)
|
||||
Maximum time: 17.975060 seconds (14 bytes per sec.)
|
||||
Average time: 10.873267 seconds (24 bytes per sec.)
|
||||
Standard deviation: 3.102793
|
||||
Median time: 9.218506 seconds (28 bytes per sec.)
|
||||
|
||||
(Testing a Web server with an HTTP request for its home page.)
|
||||
|
||||
% echoping -h / mywww
|
||||
Elapsed time: 0.686792 seconds
|
||||
```
|
||||
|
||||
The exit status is set if there is any problem, so you can use echoping to test repeatedly a Web server, to be sure it runs fine (SmokePing does it).
|
Loading…
Reference in New Issue