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.
RESTRICT keywords can be used to control the mirroring process.
RESTRICT="mirror" setting should be used if we cannot legally mirror
certain files; files will still be downloaded from the original locations.
RESTRICT="primaryuri" setting causes Portage to try
original locations first, and then fall back to mirrors if necessary
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 license requires it.
On rare occasions you may need to replace a file that is already mirrored. In this case proceed as follows:
More general information about the internals of mirroring can be found on infrastructure's pages.
If you have to host a source file (patch or tarball) yourself, as long as it is suitable to be
distributed by Gentoo Foundation (by license and legality), you're suggested to use your developer's
dev.gentoo.org. Since external overlays may depend on your patches/tarballs, using the
dev space at
dev.gentoo.org keeps the distfiles at a stable and reliable infrastructure. If you
retire, other developers can take over your distfiles and place them into their own devspace.
Previous policy was to use
mirror://gentoo directly, but this is now deprecated, as that
wouldn't allow to have long-term availability and traceability of the source files, which might be a
requirement of the license.
When you upload the file to
dev.gentoo.org:~/public_html, you must ensure that it, and its
parent directories, are world-readable.
To manually upload a file to
scp it to
dev.gentoo.org:/space/distfiles-local. The file should appear
on the mirrors within four hours (note that this is less
frequent than Git 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.
Usage of third-party mirrors and the
pseudo-protocol is described in the SRC_URI