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
|
.\" Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH APT-SPY.CONF 5 "20th May, 2003"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
apt-spy.conf \- configuration file for apt-spy(8)
.SH DESCRIPTION
\fBapt-spy.conf\fP is the configuration file for \fBapt-spy\fP(8).
It consists of a series of area labels, followed by a list of countries
belonging to that label.
Whitespace is ignored.
.PP
Comments may be added anywhere, and begin with the hash ('#') character.
Once a hash character is encountered, the rest of the line is ignored.
.PP
A label consists of any alphanumeric characters, and ends with a colon
character (':').
The label must be on a line by itself (excluding comments).
.PP
Following a label are a list of country codes (one per line) of countries
belonging to that label.
.PP
Each country has a unique two-letter country code corresponding to its top
level domain identifier.
This is the same as the ISO3166 code.
You can find the country code for a specific country either by looking at
\fB/var/lib/apt-spy/mirrors.txt,\fP or by looking at the commented
examples in the default \fBapt-spy.conf\fP.
.PP
Labels cannot exist within labels.
The end of a label section is signaled by the start of a new one, or by the
end of file.
.PP
Any valid label existing in \fBapt-spy.conf\fP can be specified to apt-spy using
the '-a' option.
apt-spy will then proceed to benchmark the mirrors in the list of countries
associated with that label.
.SH EXAMPLES
.TP
This is an example of a valid apt-spy.conf file:
.nf
USUK:
GB # United Kingdom
US # United States
Australia:
AU
France-Germany-Netherlands:
FR
DE
NL
.fi
.PP
There is a default configuration file included with apt-spy. For further
examples, and for a list of valid country codes, please refer to this.
.SH SEE ALSO
.BR apt-spy "(8), " apt "(8), " sources.list "(5)"
|
