aboutsummaryrefslogtreecommitdiff
path: root/doc/configuration/mirrors.html.part.in
blob: 00244881872c85f9546d613740e719e0ab737ee8 (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
<!-- vim: set tw=120 ft=html sw=4 sts=4 et : -->

<h1>mirrors.conf</h1>

###PALUDISENVIRONMENTONLY###

<p>The <code>mirrors.conf</code> file controls where Paludis looks when downloading files. It is a standard
configuration file which may be a bash file (<code>mirrors.bash</code>) and which may use the
<code>mirrors.conf.d/</code> directory.</p>

<p>Each line consists of a mirror name followed by one or more URLs. The special mirror name <code>*</code> can be used
to indicate a mirror that should be tried for all URLs (even those that are marked as 'not for mirroring'). Ebuild
format repositories also treat mirrors whose name is equal to the repository name (or, if the repository has a
master, the master's name) specially, checking them for all mirrorable files.</p>

<h2>Example</h2>

<pre>
# Try a fast local mirror first
* http://myfastbox/distfiles/

# For mirror://gentoo/, use our ISP's mirror. This mirror will be consulted
# for most files in the 'gentoo' repository, and repositories using 'gentoo'
# as a master, as well as for any explicit mirror://gentoo/ entry.
gentoo http://gentoo.virginmedia.com/distfiles/

# Use a local Debian mirror too. This is only used for mirror://debian/.
debian http://debian.virginmedia.com/
</pre>