~ubuntu-branches/debian/sid/netselect/sid

« back to all changes in this revision

Viewing changes to netselect.1

  • Committer: Bazaar Package Importer
  • Author(s): Javier Fernandez-Sanguino Pen~a
  • Date: 2010-12-01 01:43:12 UTC
  • Revision ID: james.westby@ubuntu.com-20101201014312-mqb1bh22dfagzqsg
Tags: 0.3.ds1-15
* Take over this package's maintenance, with maintainer's approval.
* netselect:
    - Implement a -I option to make netselect use ICMP probes instead of UDP.
      This option is useful to test servers when there is some element
      that does not allow traceroute tests in the intermediate path 
      (including the local computer, through it's firewall).  
      (Closes: 601227, 217256, 384218)
    - Do not printout verbose messages detailing hosts to stdout but
      to stderr
* netselect.1:
   - Document the new -I option
   - Add more examples, specifically describing the issues with multiple
     DNS names in hosts.
* netselect-apt:
   - Introduce a way to provide options to netselect through -O
   - Check if netselect exists 
   - Abort if not being run as root and netselect is not setuid
   - Use -I per default as many debian mirrors do not actually allow
     traceroute tests
   - Only use standard output when parsing netselect's output, stderr
     gets thrown out as we do not need it (but the user might have
     set it with -v calls in -O)
   - Stricter filtering of netselect output to prevent picking up
     wrong data by mistake 
* debian/netselect.README.Debian: More information on why netselect
  needs to be run as ROOT.
* debian/control: 
    - Update Homepage to github
    - Update SVN-Browse to github, keep the URL of collab-main
      in debian/README.source
* debian/EXTRA: include modified version of netselect-apt by
  Manuel Estrada Sainz a long time ago (2002) which provides additional
  features such as testing for other protocols (rsync, ftp, http)
  and checking that the mirrors actually work. This code needs to
  be forward ported to netselect-apt in order to close 135558. But having
  it in the package at least ensures it is not forgotten.
* debian/TODO: review all pending work to be done and include it in the
  file, reference bug reports when appropriate.
* debian/netselect-apt.NEWS and debian/netselect.NEWS: Fix version
  numbers as they pointed to inexistent versions

Show diffs side-by-side

added added

removed removed

Lines of Context:
43
43
based on these values.  A lower score is better, in the end it prints
44
44
one line showing the server with the best score.
45
45
 
 
46
If the DNS name has multiple IP addresses associated with IT
 
47
.B netselect
 
48
will test each of the IP addresses independently. In this case, 
 
49
.B netselect
 
50
will report the 
 
51
 
46
52
.SH EXAMPLES
47
53
 
48
54
.nf
70
76
nothing got through at all.  That indicates that either the host doesn't
71
77
exist, or it is down.
72
78
 
 
79
 
 
80
.nf
 
81
\fB#\fR netselect \-vv http.us.debian.org
 
82
.fi
 
83
 
 
84
This is the output:
 
85
 
 
86
.nf
 
87
204.152.191.39                         300 ms  17 hops   90% ok ( 9/10) [  899]
 
88
35.9.37.225                           9999 ms  30 hops    0% ok
 
89
64.50.233.100                         9999 ms  30 hops    0% ok
 
90
128.30.2.36                            183 ms  15 hops   90% ok ( 9/10) [  510]
 
91
149.20.20.135                          226 ms  18 hops   90% ok ( 9/10) [  702]
 
92
  510 128.30.2.36
 
93
.fi
 
94
 
 
95
In this case, since the single name has multiple DNS addresses all of the
 
96
servers will be tested indenpendently and the fastest server will be provided.
 
97
 
 
98
If you notice the above output you will see that the time for some hosts
 
99
is 9999 ms. This is typically an indication of remote hosts blocking the
 
100
UDP probes 
 
101
.B netselect
 
102
relies on. To prevent this issue you can use ICMP tests. For example,
 
103
repeating the above test using ICMP, that is:
 
104
 
 
105
.nf
 
106
\fB#\fR netselect \-I \-vv http.us.debian.org
 
107
.fi
 
108
 
 
109
yields the following output:
 
110
 
 
111
.nf
 
112
204.152.191.39                         291 ms  17 hops  100% ok (10/10) [  785]
 
113
35.9.37.225                            180 ms  19 hops   66% ok ( 2/ 3) [  783]
 
114
64.50.233.100                          140 ms  12 hops  100% ok (10/10) [  308]
 
115
128.30.2.36                            182 ms  15 hops  100% ok (10/10) [  455]
 
116
149.20.20.135                          227 ms  18 hops  100% ok (10/10) [  635]
 
117
  308 64.50.233.100
 
118
.fi
 
119
 
 
120
In this last example the selected server will change since, actually, the
 
121
fastest server is one that also actively blocks UDP probes.
 
122
 
 
123
 
73
124
.SH OPTIONS
74
125
.TP
75
126
.B \-v
114
165
The more packets you use, the more accurate are the results... and the
115
166
longer it takes to run.  The default is 10, which is usually okay.
116
167
 
 
168
.TP
 
169
.BI \-I
 
170
Use ICMP instead of UDP probes. In some occassions (firewalled hosts)
 
171
UDP probes like those used in
 
172
.BR traceroute 
 
173
will get filtered out and hosts might be perceived as dead. Using this
 
174
option will make 
 
175
.BR netselect
 
176
use ICMP probes instead. 
 
177
 
117
178
.SH SEE ALSO
118
179
.BR ping (8),
119
180
.BR traceroute (8),