blob: b42647e8244de495c6e47e92db28cb80e52b5ca2 (
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
|
Mirrors
=======
Automatic Mirroring
-------------------
Packages will automatically have their ``SRC_URI`` components mirrored onto
Gentoo mirrors. When fetching, portage checks Gentoo mirrors first before
trying the original upstream location.
This is generally desired behaviour -- upstream mirrors are prone to being
rearranged, tidied out or having files modified.
Restricting Automatic Mirroring
'''''''''''''''''''''''''''''''
Three ``RESTRICT`` keywords can be used to control the mirroring process.
The ``RESTRICT="nomirror"`` setting should be used if we cannot legally mirror
certain files.
The ``RESTRICT="primaryuri"`` setting causes portage to try
original locations *first*, and then fall back to mirrors if necessary -- this
is sometimes useful if approximate download counts are needed, or if upstream
have a reliable mirror setup.
There is also ``RESTRICT="fetch"``, which prevents portage from trying to
fetch anything manually. The `pkg_nofetch`_ function will be called if any
``SRC_URI`` components cannot be found. This should only be used if a licence
requires it.
Suitable Download Hosts
'''''''''''''''''''''''
Hosting files off ``dev.gentoo.org`` is **not** acceptable for main-tree items.
Instead, these files must be moved onto ``mirror://gentoo`` before release.
Gentoo Mirrors
--------------
To manually upload a file to ``mirror://gentoo``, ``scp`` it to
``dev.gentoo.org:/space/distfiles-local``. You must ensure that the permissions
are set to ``ug+rw`` manually. The file should appear on the mirrors within four
hours (note that this is *less frequent* than `CVS to rsync`_).
If the upstream download location for a package uses a non-standard TCP port
(anything other than 21, 80 or 443), you *must* manually mirror the files. Not
doing so can cause all kinds of problems with strict firewalls.
Mirroring Process
-----------------
.. figure:: diagram.png
:alt: Mirroring Process
Diagram showing the mirroring process
.. vim: set ft=glep tw=80 sw=4 et spell spelllang=en : ..
|
GitWeb
