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
This page is a translated version of the page /etc/portage/repos.conf and the translation is 59% complete.
Outdated translations are marked like this.
Other languages:

/etc/portage/repos.conf 是一个文件或目录，它指定当前系统使用的软件仓库的位置和设置。 软件仓库指的是系统上使用的 Gentoo 代码库 以及 ebuild 软件仓库 。

格式

Note
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.
  • File names can be arbitrary strings of characters with or without suffix, except for repos.conf/gentoo.conf expected by mirrorselect.
  • Comments begin with # (no inline comments).
  • Configuration of each repository is specified in a separate file or section starting with [repository_name]. It is recommended that [repository_name] is the same as the name given in the repo_name file.
  • Attributes are specified in attribute = value format.

默认章节中支持的属性

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, and masters.

仓库章节中支持的属性

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 set yes, 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, and masters.
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 to 0, 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]

示例

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.

FILE /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.

自定义 ebuild 软件仓库

FILE /etc/portage/repos.conf/local.conf
[NameOfYourEbuildRepository]
location = /usr/local/portage
masters = gentoo
auto-sync = no

For further information see the custom repository article.

External ebuild repository

FILE /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

单个文件的repos.conf

For an example of repos.conf as a monolithic file, run this command and search for the repos.conf section:

user $man 5 portage

仓库列表

To see a compact list of repositories, sorted by ascending priority numbers and formatted for easy reading:

user $emerge --info --verbose | sed -n '/^Repo/,/^ABI/p' | head -n -1

To see a detailed list of repositories, without any formatting:

user $portageq repos_config /

参考

外部资源

Retrieved from "https://wikitest.gentoo.org/index.php?title=/etc/portage/repos.conf/zh-cn&oldid=741174"