Radish alpha
H
rad:z3QDZAW2FAfuLvihrhiyDC9fAD8G9
HardenedBSD Package Manager
Radicle
Git
multirepo information added to pkg.conf.5 and a hint to the man page given in README.md
namor committed 12 years ago
commit 5338b498276182a30a401aa649831eabda191a00
parent e7a7803
2 files changed +24 -6
modified README.md
@@ -305,6 +305,8 @@ packages from the remote repository, you would use the `pkg install` command:
<a name="multirepos"></a>
### Working with multiple remote repositories

+
**Note**: With pkg-1.1 the setup changes significantly. See *pkg.conf(5)* for more information.
+

pkgng is also able to work with multiple remote repositories. In the previous section
we are using only a single remote repository, which is defined by the _PACKAGESITE_ option.

modified pkg/pkg.conf.5
@@ -101,12 +101,6 @@ Specifies the directory to use for storing the package
database files.
The default value for this option is
.Fa /var/db/pkg
-
.It Cm PKG_MULTIREPOS: boolean
-
This option when enabled will tell
-
.Xr pkg 1
-
to work in multiple repositories mode.
-
For example repositories
-
definitions, please have a look at the sample configuration file.
.It Cm PLIST_KEYWORDS_DIR: string
< To be added >
.It Cm PORTSDIR: string
@@ -168,6 +162,28 @@ in JSON.
.It Cm SSH_RESTRICT_DIR: string
Directory where the ssh subsystem will be restricted to
.El
+
.Sh MULTIPLE REMOTE REPOSITORIES
+
To use multiple remote repositories, specify the primary repository as specified above.
+
Further remote repositores can be configured in repository files. Repository files reside in
+
.Fa /usr/local/etc/pkg/repos/ .
+
The filename does not matter,
+
.Fa /usr/local/etc/pkg/repos/myrepo.conf
+
could be used as an example. A repository file is in YAML format and has to following form (see above for the description of most options):
+
.Bl -tag -width ".Cm myrepo:"
+
.It Cm myrepo:
+
.Bl -tag -width ".Cm MIRROR_TYPE: string"
+
.It Cm URL: string
+
PACKAGESITE for this remote repository only.
+
.It Cm ENABLED: boolean
+
The repository will be used only if this option is enabled. (default: YES)
+
.It Cm MIRROR_TYPE: string
+
MIRROR_TYPE for this remote repository only. (default: NONE)
+
.It Cm PUBKEY: string
+
PUBKEY for this remote repository only. (default: NONE)
+
.El
+
.El
+
.Pp
+
Note that "myrepo" could be any string, however, no two repositores may share the same name. Also note that it is possible to specify more than one repository per repository file.
.Sh ENVIRONMENT
An environment variable with the same name as the option in the configuration
file always overrides the value of an option set in the file.