|
|
|
.\" $Id$
|
|
|
|
.TH echoping 1 "November 22, 1996" "ECHOPING" "echoping"
|
|
|
|
.SH NAME
|
|
|
|
echoping \- tests a remote host with TCP or UDP
|
|
|
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B echoping
|
|
|
|
.RI [ -vudcrC ]
|
|
|
|
.RI [ -s\ number ]
|
|
|
|
.RI [ -n\ number ]
|
|
|
|
.RI [ -w\ number ]
|
|
|
|
.RI [ -t\ number ]
|
|
|
|
.RI [ -h\ URL ]
|
|
|
|
.RI [ -i\ URL ]
|
|
|
|
.RI [ -S ]
|
|
|
|
.B hostname
|
|
|
|
[:port]
|
|
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
.LP
|
|
|
|
.B echoping
|
|
|
|
is a small program to test (approximatively) performances
|
|
|
|
of a remote Internet host by sending it TCP "echo" packets. It can use other
|
|
|
|
protocols as well (HTTP - which makes it a good tool to test Web servers, UDP "echo", etc).
|
|
|
|
.LP
|
|
|
|
.B echoping
|
|
|
|
simply shows the elapsed time, including the time to set up the TCP
|
|
|
|
connection and to transfer the data. Therefore, it is unsuitable to physical
|
|
|
|
line raw throughput measures (unlike bing or treno). On the other end, the
|
|
|
|
action it performs are close from, for instance, a HTTP request and it is meaningful
|
|
|
|
to use it (carefully) to measure Web performances.
|
|
|
|
|
|
|
|
.SH ARGUMENT
|
|
|
|
.IP hostname[:port]
|
|
|
|
Name of the server to test. For HTTP, you can specify a port number.
|
|
|
|
|
|
|
|
.SH OPTIONS
|
|
|
|
.IP -v
|
|
|
|
Verbose
|
|
|
|
.IP -s\ nnn
|
|
|
|
Size of the data to send. Large values can produce strange results with
|
|
|
|
some echo servers.
|
|
|
|
.IP -n\ nnn
|
|
|
|
Numbers of repeated tests. With this option, you have also the minimum, maximum, average and median
|
|
|
|
time. The median is the value such that half of the measures are under it
|
|
|
|
and the other half is above. When you measure highly variables values, like
|
|
|
|
it is often the case on the whole Internet, median is better than average
|
|
|
|
to avoid "extreme" values.
|
|
|
|
.IP -w\ nnn
|
|
|
|
Number of seconds to wait between two tests (default is one)
|
|
|
|
.IP -t\ nnn
|
|
|
|
Number of seconds to wait a reply before giving up. For TCP, this is the
|
|
|
|
maximum number of seconds for the whole connection (setup and data exchange).
|
|
|
|
.IP -u
|
|
|
|
Use UDP instead of TCP
|
|
|
|
.IP -d
|
|
|
|
Use the "discard" service instead of echo
|
|
|
|
.IP -c
|
|
|
|
Use the "chargen" service instead of echo
|
|
|
|
.IP -h\ url
|
|
|
|
Use the HTTP protocol (instead of echo) for the given URL. The URL has to
|
|
|
|
be a relative one (for instance '/' or '/pics/foobar.gif') because HTTP 1.0
|
|
|
|
servers will not understand a request for an absolute URL.
|
|
|
|
.IP -i\ url
|
|
|
|
Use the ICP protocol (instead of echo) for the given URL. The URL has to
|
|
|
|
be an absolute one. This is mostly for testing Squid Web proxy/caches.
|
|
|
|
.IP -C
|
|
|
|
Use the SSL (cryptography) protocol. For HTTP tests only.
|
|
|
|
.IP -S
|
|
|
|
Use the SMTP protocol (instead of echo) for the given server.
|
|
|
|
.IP -r
|
|
|
|
Use T/TCP (if it has been compiled with it). See the INSTALL file for details.
|
|
|
|
.IP -f\ character
|
|
|
|
Fill the packet with this character (default is random filling)
|
|
|
|
|
|
|
|
.SH EXAMPLES
|
|
|
|
.IP echoping\ \-v\ foobar.whoops.org
|
|
|
|
Tests the remote machine with TCP echo (one test).
|
|
|
|
.IP echoping\ \-n\ 5\ \-w\ 10\ foobar.whoops.org
|
|
|
|
Tests the remote machine with TCP echo (five tests, every ten seconds).
|
|
|
|
.IP echoping\ \-h\ /\ foobar.whoops.org
|
|
|
|
Tests the remote Web server and asks its home page. Note you don't
|
|
|
|
indicate the whole URL.
|
|
|
|
.IP echoping\ \-h\ http://www.whoops.org/\ cache.whoops.org:3128
|
|
|
|
Tests the remote Web proxy-cache and asks a Web page. Note that you must
|
|
|
|
indicate the whole URL.
|
|
|
|
|
|
|
|
.SH BUGS
|
|
|
|
|
|
|
|
See the TODO file or SourceForge bug tracking system at
|
|
|
|
<http://sourceforge.net/bugs/?group_id=4581>.
|
|
|
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
See the README for information about other network measurements programs.
|
|
|
|
|
|
|
|
.SH AUTHOR
|
|
|
|
Stephane Bortzmeyer <bortz@users.sourceforge.net>
|
|
|
|
|
|
|
|
|