8918aed Document the (not so) new PRIORITY and CONSERVATIVE_UPGRADE settings, explaining how to control which repository packages should be installed from. — HardenedBSD-pkg

rad:z3QDZAW2FAfuLvihrhiyDC9fAD8G9

HardenedBSD Package Manager

Document the (not so) new PRIORITY and CONSERVATIVE_UPGRADE settings, explaining how to control which repository packages should be installed from.

Matthew Seaman committed 11 years ago

commit 8918aed9c1f929e60d65be0eb6f0e374b6cb36d7
parent 6cbff9c

2 files changed +30 -21

modified docs/pkg-repository.5

@@ -15,7 +15,7 @@

 .\"     @(#)pkg-repository.5
 .\" $FreeBSD$
 .\"
 .Dd December 29, 2014
 .Dd February 1, 2015
 .Dt PKG-REPOSITORY 5
 .Os
 .Sh NAME

@@ -103,7 +103,7 @@ Packages are stored as package tarballs identified by name and

 version.
 This directory may contain several different versions of each package
 accumulated over time, but the repository catalogue will only record
 the latest version for each distinct package origin.
 the latest version for each distinct package name.
 .It Pa $REPOSITORY_ROOT/Latest/
 May contains symbolic links to the latest versions of packages in the
 .Pa All

@@ -148,7 +148,7 @@ ports tree.

 .Pp
 Each of the packages listed in the repository catalogue must have a
 unique
 .Cm origin .
 .Cm name .
 There are no other constraints: package sets are not required to be
 either complete (i.e., with all dependencies satisfied) or
 self-consistent within a single repository.

@@ -221,8 +221,11 @@ all mirror sites.

 .Sh WORKING WITH MULTIPLE REPOSITORIES
 Where several different repositories are configured
 .Nm pkg
 will search amongst them all in the order specified,
 unless directed to use a single repository by the
 will search amongst them all in the order specified by the
 .Cm PRIORITY
 settings in the
 .Pa repo.conf
 files, unless directed to use a single repository by the
 .Fl r
 flag to
 .Xr pkg-fetch 8 ,

@@ -231,10 +234,6 @@ flag to

 .Xr pkg-search 8
 or
 .Xr pkg-rquery 8 .
 The search order is as displayed in the output of
 .Bd -literal -offset indent
 pkg -v -v
 .Ed
 .Pp
 Where several different versions of the same package are available,
 .Nm pkg

@@ -262,10 +261,12 @@ pkg install -r repo-a example-1.0.0

 .Pp
 and then to make updates to that package
 .Dq sticky
 to the same repository, add an annotation to the package:
 .Bd -literal -offset indent
 pkg annotate -A example repository repo-a
 .Ed
 to the same repository, set the value
 .Cm CONSERVATIVE_UPGRADE
 to
 .Sy true
 in
 .Pa pkg.conf .
 .Pp
 .Sh SEE ALSO
 .Xr fetch 3 ,

modified docs/pkg.conf.5

@@ -15,7 +15,7 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd December 29, 2014
 .Dd February 1, 2015
 .Dt PKG.CONF 5
 .Os
 .Sh NAME

@@ -348,7 +348,8 @@ This option overrides the global setting with the same name and can be

 overwritten by a command line option.
 Default: 0.
 .It Cm PRIORITY: integer
 Set the priority of the repository the higher is the prefered repository.
 Set the priority of the repository.
 Higher values are prefered.
 Default: 0
 .El
 .El

@@ -441,16 +442,23 @@ with this content:

 FreeBSD: { enabled: NO }
 .Ed
 .Pp
 Repositories are prioritized in the order they are found on the
 Repositories are processedin the order they are found on the
 .Sy REPOS_DIR
 search path, with individual repository configuration files in the
 same directory processed in alphabetical order.
 Earlier files take precedence, meaning that packages will be downloaded
 from them preferentially where the same package is available from several
 repositories.
 This behaviour may be overridden per-package by adding a
 Settings from files later in the search path will override those from
 earlier ones.
 Packages are selected preferentially out of all the repositories that contain
 them from the repository with the highest priority, so long as they are
 suitable to solve the necessary dependency requirements.
 However, this preference may be overruled when
 .Sy CONSERVATIVE_UPGRADE
 is set to
 .Dv true ,
 in which case a package will as far as possible always be upgraded from the
 same repository the older installed version came from, as given in the
 .Sy repository
 annotation to the installed package.
 annotation of the installed package.
 See
 .Xr pkg-repository 8
 for details.