This is Gentoo's testing wiki. It is a non-operational environment and its textual content is outdated.
Please visit our production wiki at https://wiki.gentoo.org
/etc/portage/repos.conf
From Gentoo Wiki (test)
Jump to:navigation
Jump to:search
/etc/portage/repos.conf is a file or directory which specifies the location and settings for the repositories used by the current system. It refers to the Gentoo repository and perhaps ebuild repositories used on a system.
Formato
Nota
While Portage can handle repos.conf as either a file or a directory of files, the preferred method to be used is a directory. Other tools like layman and mirrorselect require and expect it to be a directory. Layman creates and manages it's own layman.conf file to register its installed ebuild repositories with Portage. mirrorselect looks for the repos.conf/gentoo.conf file in order to modify the
While Portage can handle repos.conf as either a file or a directory of files, the preferred method to be used is a directory. Other tools like layman and mirrorselect require and expect it to be a directory. Layman creates and manages it's own layman.conf file to register its installed ebuild repositories with Portage. mirrorselect looks for the repos.conf/gentoo.conf file in order to modify the
sync-uri parameter for the Gentoo repository.
- Los nombres de ficheros pueden ser cadenas de caracteres arbitrarias con o sin sufijo, excepto para repos.conf/gentoo.conf que es lo que espera mirrorselect.
- Los comentarios comienzan con
#(no existen los comentarios en línea).l - La configuración de cada repositorio se especifica en un fichero aparte o sección que comienza por
[nombre_del_repositorio]. Se recomienda que[nombre_del_repositorio]sea el mismo que el nombre dado en el fichero repo_name. - Los atributos se especifican en el formato
atributo = valor.
Atributos soportados en la sección por defecto
main-repo- Specifies main repository.
eclass-overrides- Makes all repositories inherit eclasses from the specified repositories. Setting this attribute is generally not recommended since resulting changes in eclass inheritance may trigger performance issues due to invalidation of metadata cache.
- The egencache, emirrordist and repoman tools ignore this parameter by default as their operations are generally not site-specific (their operations are focused on the global, non-customized aspects of portage and the Gentoo repository). This behavior can be overruled by setting
force = eclass-overrides. force- Specifies names of attributes, which should be forcefully respected by egencache, emirrordist, and repoman. Valid values:
aliases,eclass-overrides, andmasters.
Atributos soportados en las secciones de los repositorios
aliases- Specifies aliases of given repository. Setting this attribute is generally not recommended since resulting changes in eclass inheritance may trigger performance issues due to invalidation of metadata cache.
- The egencache, emirrordist and repoman tools ignore this parameter by default as their operations are generally not site-specific (their operations are focused on the global, non-customized aspects of portage and the Gentoo repository). This behavior can be overruled by setting
force = aliases. auto-sync- This setting determines if the repo will be synced during emerge --sync or emaint sync --auto runs. This allows for repositories to be synced only when desired via emaint sync --repo foo. Valid values:
yes,no,true,false. If unset, the repo will be treated as setyes,true. eclass-overrides- Makes all repositories inherit eclasses from specified repositories. Setting this attribute is generally not recommended since resulting changes in eclass inheritance may trigger performance issues due to invalidation of metadata cache.
- The egencache, emirrordist and repoman tools ignore this parameter by default as their operations are generally not site-specific (their operations are focused on the global, non-customized aspects of portage and the Gentoo repository). This behavior can be overruled by setting
force = eclass-overrides. force- Specifies names of attributes, which should be forcefully respected by egencache, emirrordist, and repoman. Valid values:
aliases,eclass-overrides, andmasters. location- Specifies location of given repository.
masters- Specifies master repositories of given repository. Setting this attribute is generally not recommended since resulting changes in eclass inheritance may trigger performance issues due to invalidation of metadata cache.
- The egencache, emirrordist and repoman tools ignore this parameter by default as their operations are generally not site-specific (their operations are focused on the global, non-customized aspects of portage and the Gentoo repository). This behavior can be overruled by setting
force = masters. priority- Specifies priority of given repository.
sync-cvs-repo- Specifies CVS repository.
clone-depth- Specifies clone depth to use for DVCS repositories. Defaults to
1(only the newest commit). If set to0, the depth is unlimited. sync-git-verify-commit-signature- Require the top commit in the repository to contain a good OpenPGP signature. Defaults to false.
sync-type- Specifies type of synchronization performed by emerge --sync. Valid non-empty values:
cvs,git,rsync,svn,websync(<=portage-2.2.18),webrsync(>=portage-2.2.19). This attribute can be set to empty value to disable synchronization of given repository. Empty value is default. sync-umask- Specifies umask used to synchronize the repository. Takes an octal permission mask, e.g.
022. sync-uri- Specifies URI of repository used for synchronization performed by emerge --sync. This attribute can be set to empty value to disable synchronization of given repository. Empty value is default.
Syntax: cvs: [cvs://]:access_method:[username@]hostname[:port]:/path git: (git|git+ssh|http|https)://[username@]hostname[:port]/path rsync: (rsync|ssh)://[username@]hostname[:port]/(module|path)
sync-user- Specifies the credentials used to perform the synchronization. If only user is provided, the primary group of the user will be used. If only group is provided, the current user will be preserved and only the group id will be changed. This key takes precedence over
FEATURES=userpriv. If user or group id is provided, Portage no longer uses owner of the directory.
Syntax: [user][:group]
Ejemplos
Repositorio principal de Gentoo
rsync
The example below shows the default set up of the main Gentoo repository. However, there is no need for having this file unless its content deviates from the file found at /usr/share/portage/config/repos.conf.
ARCHIVO
/etc/portage/repos.conf/gentoo.confRsync example[DEFAULT] main-repo = gentoo [gentoo] location = /usr/portage sync-type = rsync sync-uri = rsync://rsync.gentoo.org/gentoo-portage auto-sync = yes sync-rsync-verify-jobs = 1 sync-rsync-verify-metamanifest = yes sync-rsync-verify-max-age = 24 sync-openpgp-key-path = /usr/share/openpgp-keys/gentoo-release.asc sync-openpgp-key-refresh-retry-count = 40 sync-openpgp-key-refresh-retry-overall-timeout = 1200 sync-openpgp-key-refresh-retry-delay-exp-base = 2 sync-openpgp-key-refresh-retry-delay-max = 60 sync-openpgp-key-refresh-retry-delay-mult = 4 # for daily squashfs snapshots #sync-type = squashdelta #sync-uri = mirror://gentoo/../snapshots/squashfs
For a setup using sync-type websync (<=portage-2.2.18), webrsync (>=portage-2.2.19), see the webrsync.conf article.
Custom ebuild repository
[NameOfYourEbuildRepository] location = /usr/local/portage masters = gentoo auto-sync = no
Para más información leer el artículo sobre el repositorio personalizado.
External ebuild repository
ARCHIVO
/etc/portage/repos.conf/brother-overlay.confAdding the brother-overlay ebuild repository[brother-overlay] location = /usr/local/overlay/brother-overlay sync-type = git sync-uri = https://github.com/stefan-langenmaier/brother-overlay.git auto-sync = yes
El fichero repos.conf como un único fichero
Para ver un ejemplo de repos.conf como un fichero monolítico, lance esta orden y busque la sección repos.conf:
user $man 5 portageListar repositorios
Para ver un listado compacto de repositorios ordenado por números ascendentes en prioridad y formateado para una fácil lectura:
user $emerge --info --verbose | sed -n '/^Repo/,/^ABI/p' | head -n -1Para ver una lista detallada de repositorios sin ningún formato:
user $portageq repos_config /Ver también
- Validated Gentoo repository snapshots in the Gentoo Handbook
- Overview over the new Portage sync system
- Layman - Using 'repos.conf' method in the Layman article
- Overlays user guide
- Repository format
- Repository mirror and Continuous Integration
- Query repository information in the Portageq article
- Using the gentoo git checkout as your local tree
- Masking installed but unsafe ebuild repositories
- eselect-repository, a tool to manage third-party repositories in repos.conf