path: root/man
diff options
authorZac Medico <zmedico@gentoo.org>2020-09-06 14:12:32 -0700
committerZac Medico <zmedico@gentoo.org>2020-09-07 18:37:42 -0700
commitc36a4ec6694b8b9e22fb63298d1588589acb1ab2 (patch)
treec9ea340b2c46aefecf8338ef2a065a003f8ccf8c /man
parentman/portage.5: Fix man2html rendering in repos.conf section (diff)
Add binrepos.conf to replace PORTAGE_BINHOST (bug 668334)
Support /etc/portage/binrepos.conf as a replacement for the PORTAGE_BINHOST variable. Behavior is similar to repos.conf, initially supporting just the sync-uri attribute. Both binrepos.conf and PORTAGE_BINHOST can be used simultaneously, in the same way that repos.conf and PORTDIR_OVERLAY can be used simultaneously. The emerge --info output for binrepos.conf looks like this: Binary Repositories: example-binhost sync-uri: https://example.com/binhost Bug: https://bugs.gentoo.org/668334 Signed-off-by: Zac Medico <zmedico@gentoo.org>
Diffstat (limited to 'man')
2 files changed, 40 insertions, 1 deletions
diff --git a/man/make.conf.5 b/man/make.conf.5
index 8a1ea0603..403465fad 100644
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -855,7 +855,8 @@ Each entry in the list must specify the full address of a directory
serving tbz2's for your system (this directory must contain a 'Packages' index
file). This is only used when running with
the get binary pkg options are given to \fBemerge\fR. Review \fBemerge\fR(1)
-for more information.
+for more information. The \fBPORTAGE_BINHOST\fR variable is deprecated in
+favor of the \fBbinrepos.conf\fR configuration file (see \fBportage\fR(5)).
diff --git a/man/portage.5 b/man/portage.5
index 4cffb194a..4f183654c 100644
--- a/man/portage.5
+++ b/man/portage.5
@@ -47,6 +47,7 @@ virtuals
.BR /etc/portage/
@@ -620,6 +621,43 @@ any other bash script.
Additional package-specific bashrc files can be created in /etc/portage/env.
+.BR binrepos.conf
+Specifies remote binary package repository configuration information. This
+is intended to be used as a replacement for the \fBmake.conf\fR(5)
+\fBPORTAGE_BINHOST\fR variable.
+.I Format:
+\- comments begin with # (no inline comments)
+\- configuration of each repository is specified in a section starting with \
+\- attributes are specified in "${attribute} = ${value}" format
+.I Attributes supported in sections of repositories:
+.B priority
+Specifies priority of given repository. When a package exists in multiple
+repositories, those with higher priority are preferred.
+.B sync\-uri
+Specifies URI of repository used for `emerge \-\-getbinpkg`.
+.I Example:
+# repos with higher priorities are preferred when packages with equal
+# versions are found in multiple repos
+priority = 9999
+# packages are fetched from here
+sync-uri = https://example.com/binhost
.BR categories
A simple list of valid categories that may be used in repositories and PKGDIR
(see \fBmake.conf\fR(5)). This allows for custom categories to be created.