aboutsummaryrefslogtreecommitdiff
blob: 8f0f56e1800c368deb41f263f5de05cba7e587e5 (plain)
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
134
135
136
137
138
139
140
141
142
143
144
145
146
147
.TH "mirrorselect" "8" "2.2.6"

.SH "NAME"
.LP
mirrorselect \- A tool which helps to select rsync and distfiles mirrors for Gentoo

.SH "SYNTAX"
.LP
mirrorselect [options]

.SH "OPTIONS"
.TP
.B \-h, \-\-help
Print a usage summary and exit.
.TP
.B \-\-version
Show program's version number and exit.
.SS "Main modes"
.TP
.B \-a, \-\-all
This will present a list of all filtered search results
to make it possible to select mirrors you wish to use.
For the -r, --rsync option, it will select the rotation server
only. As multiple rsync URL's are not supported.
.TP
.B \-D, \-\-deep
Deep mode. This is used to give a more accurate speed test. It will download
a 100k file from each server. Because of this you should only use this option
if you have a good connection.
.TP
.B \-i, \-\-interactive
Interactive Mode, this will present a list to make it possible to select mirrors
you wish to use.
.SS "Server type selection (choose at most one)"
.TP
.BI \-c " COUNTRY " "\fR,\fP \-\-country " COUNTRY "
Only use mirrors from the specified country.
NOTE: Names with a space must be quoted
    eg.:  -c 'South Korea'
.TP
.B \-F, \-\-ftp
ftp only mode. Will not consider hosts of other types.
.TP
.B \-H, \-\-http
http only mode. Will not consider hosts of other types.
.TP
.B \-r, \-\-rsync
rsync mode. Allows you to interactively select your rsync mirror.
 Requires -i to be used.
.TP
.BI \-R " REGION " "\fR,\fP \-\-region " REGION "
Only use mirrors from the specified region.
NOTE: Names with a space must be quoted.
    eg.:  -R 'North America'
.TP
.B \-4, \-\-ipv4
only use IPv4.
.TP
.B \-6, \-\-ipv6
only use IPv6.
.SS "Other options"
.TP
.BI \-b " BLOCKSIZE " "\fR,\fP \-\-blocksize" " BLOCKSIZE "
This is to be used in automatic mode and will split the hosts into blocks of
BLOCKSIZE for use with netselect. This is required for certain routers which
block 40+ requests at any given time.
Recommended parameters to pass are: -s 3 -b 10
.TP
.BI \-d " VERBOSITY " "\fR,\fP \-\-debug " VERBOSITY "
Debug mode.
.TP
.BI \-f " FILE " "\fR,\fP \-\-file "FILE "
An alternate file to download for deep testing. Please
choose the file carefully as to not abuse the system
by selecting an overly large size file.  You must also
use the -m, --md5 option.
.TP
.BI \-m " MD5 " "\fR,\fP \-\-md5 " MD5 "
An alternate file md5sum value used to compare the
downloaded file against for deep testing.
.TP
.B \-o, \-\-output
Output Only Mode, this is especially useful when being used during installation,
to redirect output to a file other than /etc/portage/make.conf.
.TP
.BI \-P " PROXY " "\fR,\fP \-\-proxy " PROXY "
Proxy server to use if not the default proxy in the
environment.
.TP
.B \-q, \-\-quiet
Quiet mode.
.TP
.BI \-s " SERVERS " "\fR,\fP \-servers" " SERVERS "
Specify Number of servers for Automatic Mode to select. this is only valid for
download mirrors. If this is not specified, a default of 1 is used.
.TP
.BI \-t " TIMEOUT " "\fR,\fP \-timeout" " TIMEOUT "
Timeout for deep mode. Defaults to 10 seconds.
.TP
.BI \-e " EXCLUDE " "\fR,\fP \-exclude" " EXCLUDE "
Exclude host from mirrors list.

.SH "EXAMPLES"
automatic:
.LP
.RS 8
Autoselect the 5 best mirrors and save results in /etc/portage/make.conf,
a backup will be created.
.LP
# mirrorselect -s5
.LP
Autoselect the 3 best mirrors, use a
.I BLOCKSIZE
of 10 and append the output to /etc/portage/make.conf.
.LP
# mirrorselect -s3 -b10 -o >> /etc/portage/make.conf
.LP
Autoselect the 4 best mirrors, it also loads a 100k file from each mirror.
The result will be written to /etc/portage/make.conf, a backup will be created.
.LP
# mirrorselect -D -s4
.LP
.RE
interactive:
.LP
.RS 8
Start mirrorselect in interactive mode to select rsync mirrors.
.LP
# mirrorselect -i -r
.RE

.SH "AUTHORS"
.LP
Colin Kingsley <tercel@gentoo.org>
.LP
Zac Medico <zmedico@gentoo.org>
.LP
Sebastian Pipping <sebastian@pipping.org>
.LP
Christian Ruppert <idl0r@gentoo.org>
.LP
Brian Dolbec <dolsen@gentoo.org>
.LP
Douglas Freed <dwfreed@mtu.edu>

.SH "BUGS"
Please report any bugs to http://bugs.gentoo.org