/etc/portage/repos.conf/zh-cn

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

格式

 * 文件名可以是任意字符串，有无后缀均可，但 期望的  文件除外.
 * 注释以  开头（没有行内注释）.
 * 每个软件仓库的配置在以  开头的单独文件或章节中指定. 建议   与repo_name 文件中给出的名称相同.
 * 属性用  格式指定.

默认章节中支持的属性

 * 指定主软件仓库.
 * 指定主软件仓库.


 * 让所有软件仓库都从指定仓库中继承 eclass. 通常不建议设置此属性，它会导致 eclass 继承关系发生变化，从而可能因为元数据缓存的失效而触发性能问题.
 * 、 和 工具默认会忽略这个参数，因为它们的操作通常不是基于特定站点的（它们的操作集中于 portage 和 Gentoo 软件仓库中的全局、非自定义部分）.  通过设置   可以改写这个行为.
 * 、 和 工具默认会忽略这个参数，因为它们的操作通常不是基于特定站点的（它们的操作集中于 portage 和 Gentoo 软件仓库中的全局、非自定义部分）.  通过设置   可以改写这个行为.


 * 指定属性名，、 和 应该强制遵守这些名称. 有效值： 、  和.
 * 指定属性名，、 和 应该强制遵守这些名称. 有效值： 、  和.

仓库章节中支持的属性

 * 指定给定软件仓库的别名. 通常不建议设置此属性，它会导致 eclass 继承关系发生变化，从而可能因为元数据缓存的失效而触发性能问题.
 * 、 和 工具默认会忽略这个参数，因为它们的操作通常不是基于特定站点的（它们的操作集中于 portage 和 Gentoo 软件仓库中的全局、非自定义部分）.  通过设置   可以改写这个行为.
 * 、 和 工具默认会忽略这个参数，因为它们的操作通常不是基于特定站点的（它们的操作集中于 portage 和 Gentoo 软件仓库中的全局、非自定义部分）.  通过设置   可以改写这个行为.


 * 此设置决定在 或  运行期间是否同步仓库. 它可以使仓库仅在需要时通过  进行同步.  有效值： 、 、 、 . 如果未设置，仓库同步行为将被视为设成   或.
 * 此设置决定在 或  运行期间是否同步仓库. 它可以使仓库仅在需要时通过  进行同步.  有效值： 、 、 、 . 如果未设置，仓库同步行为将被视为设成   或.


 * 让所有软件仓库都从指定仓库中继承 eclass. 通常不建议设置此属性，它会导致 eclass 继承关系发生变化，从而可能因为元数据缓存的失效而触发性能问题.
 * 、 和 工具默认会忽略这个参数，因为它们的操作通常不是基于特定站点的（它们的操作集中于 portage 和 Gentoo 软件仓库中的全局、非自定义部分）.  通过设置   可以改写这个行为.
 * 、 和 工具默认会忽略这个参数，因为它们的操作通常不是基于特定站点的（它们的操作集中于 portage 和 Gentoo 软件仓库中的全局、非自定义部分）.  通过设置   可以改写这个行为.


 * 指定属性名，、, 和 应该强制遵守这些名称. 有效值： 、  和.
 * 指定属性名，、, 和 应该强制遵守这些名称. 有效值： 、  和.


 * 为给定仓库指定存储位置.
 * 为给定仓库指定存储位置.


 * 为给定仓库指定主仓库. 通常不建议设置此属性，它会导致 eclass 继承关系发生变化，从而可能因为元数据缓存的失效而触发性能问题.
 * 、 和 工具默认会忽略这个参数，因为它们的操作通常不是基于特定站点的（它们的操作集中于 portage 和 Gentoo 软件仓库中的全局、非自定义部分）.  通过设置   可以改写这个行为.
 * 、 和 工具默认会忽略这个参数，因为它们的操作通常不是基于特定站点的（它们的操作集中于 portage 和 Gentoo 软件仓库中的全局、非自定义部分）.  通过设置   可以改写这个行为.


 * 为给定仓库指定 优先级.
 * 为给定仓库指定 优先级.


 * 指定 CVS 仓库.
 * 指定 CVS 仓库.


 * 指定用于 DVCS 仓库的克隆深度. 默认是  （仅限最新的提交）. 如果设为  ，则深度不受限制.
 * 指定用于 DVCS 仓库的克隆深度. 默认是  （仅限最新的提交）. 如果设为  ，则深度不受限制.


 * 要求仓库中的顶端提交包含良好的OpenPGP签名. 默认为false.
 * 要求仓库中的顶端提交包含良好的OpenPGP签名. 默认为false.


 * 指定 执行的同步类型. 有效非空值：  、 、 、 、 （<=portage-2.2.18）、 （>=portage-2.2.19）. 可以将此属性设置为空值以禁用给定仓库的同步. 默认为空值.
 * 指定 执行的同步类型. 有效非空值：  、 、 、 、 （<=portage-2.2.18）、 （>=portage-2.2.19）. 可以将此属性设置为空值以禁用给定仓库的同步. 默认为空值.


 * 指定用于同步仓库的 umask . 采用八进制许可掩码，例如：.
 * 指定用于同步仓库的 umask . 采用八进制许可掩码，例如：.


 * 指定 执行同步时所使用的仓库的URI. 可以将此属性设置为空值以禁用给定仓库的同步. 默认为空值.
 * 指定 执行同步时所使用的仓库的URI. 可以将此属性设置为空值以禁用给定仓库的同步. 默认为空值.

语法： 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)
 * 指定用于执行同步的凭据. 如果只提供了用户，则将使用该用户的主要组. 如果只提供了组，则将保留当前用户，且仅更改组ID. 此键优先于 . 如果提供了用户或组ID，则Portage不再使用该目录的所有者.
 * 指定用于执行同步的凭据. 如果只提供了用户，则将使用该用户的主要组. 如果只提供了组，则将保留当前用户，且仅更改组ID. 此键优先于 . 如果提供了用户或组ID，则Portage不再使用该目录的所有者.

语法：[用户][:组]

Usage
If it doesn't exist create it.

(The Handbook however prefers using it as a directory.)

Add ebuild repositories using eselect repository, e.g. the brother-overlay ebuild repository:

Adding a custom repository is described in the Handbook.

Verify the setting using portageq

References in the output to Gentoo main repository come from the defaults in.

The file might then look like

Eselect can also be used as an alternative to mirrorselect --rsync for setting the Gentoo rsync mirror.

Manipulation of other attributes than,   or   seems not supported by eselect repository but could be done manually when needed.

For further options see.

参考

 * Gentoo 手册中的验证的Gentoo软件仓库快照
 * 关于新的Portage同步系统的概述
 * Layman 文章中的 Layman - 'repos.conf' 方法
 * Overlays 用户指南
 * 软件仓库镜像和持续集成
 * 在 Portageq 文章中的 查询软件仓库信息
 * Using the gentoo git checkout as your local tree
 * 屏蔽已安装但不安全的 ebuild 仓库
 * 屏蔽已安装但不安全的 ebuild 仓库

外部资源

 * Portage Sync 新闻公告（2015-02-04）
 * rsync.gentoo.org rsync modules: gentoo-repo-changelog added, gentoo-x86-portage & gentoo-sec discontinued.