forked from apenwarr/netselect
-
Notifications
You must be signed in to change notification settings - Fork 0
/
netselect.1
133 lines (111 loc) · 3.32 KB
/
netselect.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
.TH NETSELECT 1 "March 14, 2004" "DEBIAN" \" -*- nroff -*-
.\" Please adjust this date whenever revising the manpage.
.SH NAME
netselect \- choose the fastest server automatically
.SH SYNOPSIS
.B netselect
.RB [ \|\-v\| | \|\-vv\| | \|\-vvv\| | \|\-vvvv\| ]
.\".RB [ \|\-vv\| ]
.RB [ \|\-m
.IR HOPS ]
.RB [ \|\-s
.IR SERVERS\| ]
.RB [ \|\-t
.IR PACKETS\| ]
.IR host \ ...
.SH DESCRIPTION
.B netselect
determines several facts about all of the hosts given on the command
line, much faster than you would if you manually tried to use
.B ping
and
.BR traceroute .
For each
.IR host ,
.B netselect
figures out the approximate
.B ping
time (though not as accurately as
.B ping
does), the number of network "hops" to
reach the target, and the percentage of
.B ping
requests that got through successfully. Then
.B netselect
calculates the "score" of each operational
.I host
based on these values. A lower score is better, in the end it prints
one line showing the server with the best score.
.SH EXAMPLES
.nf
\fB#\fR netselect \-vv ftp.fceia.unr.edu.ar ftp.kulnet.kuleuven.ac.be \\
ftp.cdrom.com ftp.debian.org ftp.de.debian.org
.fi
This is the output:
.nf
ftp.fceia.unr.edu.ar 2792 ms 23 hops 100% ok ( 1/ 1) [ 9213]
ftp.kulnet.kuleuven.ac.be 9999 ms 30 hops 0% ok
ftp.cdrom.com 94 ms 8 hops 100% ok (10/10) [ 169]
ftp.debian.org 46 ms 15 hops 100% ok (10/10) [ 115]
ftp.de.debian.org 9999 ms 30 hops 0% ok
115 ftp.debian.org
.fi
The value in brackets is the "score" of each operational host based on these
values. A lower score is better. The last line shows the server with the
best score. If we had not used '\-vv' on the command line, only this last
line would have been printed.
Note that for ftp.kulnet.kuleuven.ac.be and ftp.de.debian.org in this case,
nothing got through at all. That indicates that either the host doesn't
exist, or it is down.
.SH OPTIONS
.TP
.B \-v
Verbose mode. Displays nameserver resolution messages to stderr. You
probably want this so that you don't get bored waiting for a hundred
name resolutions to finish.
.TP
.B \-vv
Very verbose mode. Displays nameserver resolution and statistics (not
just scores) to STDERR and STDOUT.
.TP
.B \-vvv
Very very verbose mode. Everything \-vv prints, plus it print every
packet received as it happens. Good for debugging or trying to figure
out how it works.
.TP
.B \-vvvv
Very very very verbose mode. Everything \-vvv prints, plus a trace of
all packets sent.
.TP
.BI \-m\ HOPS
Maximum TTL (time to live). Don't accept hosts that are further than
.I HOPS
away.
.TP
.BI \-s\ SERVERS
Print this many "top-scoring"
.I SERVERS
at the end of the list. If
.I SERVERS
is 0, then this disables printing of high scores.
.TP
.BI \-t\ PACKETS
Make sure at least 50% of the hosts get tested with this many
.IR PACKETS .
The more packets you use, the more accurate are the results... and the
longer it takes to run. The default is 10, which is usually okay.
.TP
.BI \-I
Use ICMP instead of UDP probes. In some occassions (firewalled hosts)
UDP probes like those used in
.BR traceroute
will get filtered out and hosts might be perceived as dead. Using this
option will make
.BR netselect
use ICMP probes instead.
.SH SEE ALSO
.BR ping (8),
.BR traceroute (8),
.BR netselect-apt (1).
.SH AUTHOR
Avery Pennarun <[email protected]>