FASTEST_CVSUP(7) FreeBSD System Manager's Manual FASTEST_CVSUP(7)NAMEfastest_cvsup - find fastest CVSup server
SYNOPSISfastest_cvsup [-h] [-(q|Q)] [-r] [-t] -c (country codes|tld|local|all)
DESCRIPTION
Displays the 3 fastest CVSup servers in user specified countries. It
can just return the fastest for use in automated shell scripts.
It uses Time::HiRes for timings and IO::Socket::INET to make a socket
connection to the target server, the server response is taken notice
of. Unlike some shell scripts it does not rely on 'pings' to measure
network speed.
USAGE-h displays usage.
-q quiet mode - only returns the fastest server and prints a progress
meter.
-Q very quiet mode - in addition the progress meter is not shown.
-r uses remote CVSup server list from the online FreeBSD Handbook.
If the variable $REWRITE_SELF is set to 1 in the script then (as
if by magic) it re-writes itself with the new server list. This
only works as root and does not do it by default.
-t calculate and show round-trip time in the result
-c country codes
this is a list (comma separated, no spaces) of server groups to
time.
FreeBSD servers are grouped into country codes - see the script or
the FreeBSD Handbook for a full list.
NetBSD and OpenBSD servers are lumped together under the 'netbsd'
and 'openbsd' codes respectively.
-c tld
checks the servers in the Top Level Domain. These can be anywhere
in the world.
-c local
uses the countries specifed in the @LOCAL_CC array. Edit the
script to specify which countries are considered local.
-c all
uses all the FreeBSD servers. This may take some time, but is
quite interesting!
EXAMPLES
1. times the FreeBSD CVSup servers in the United Kingdom, France and
Germany:
$ fastest_cvsup-c uk,fr,de
2. times the OpenBSD and NetBSD CVSup servers:
$ fastest_cvsup-c openbsd,netbsd
3. shell script, finds the fastest UK FreeBSD CVSup server, then runs
cvsup using that server:
#!/bin/sh
if SERVER=`fastest_cvsup -q -c uk`; then
cvsup -h $SERVER /usr/local/etc/cvsup/supfile
fi
RETURN VALUES
Returns 0 without any errors, 1 with errors.
AUTHOR
A.J.Robinson, <ajr@subdimension.com>
17 July 2002 17 July 2002 FASTEST_CVSUP(7)
