FreeBSD/doc
1
0
Fork 0
mirror of https://git.FreeBSD.org/doc.git synced 2026-06-02 11:25:20 +00:00
Code Issues Projects Releases Wiki Activity

15.1/relnotes: Improve pkgbase notes

Browse Source 
Move pkgbase changes to a new section at the start of the release
notes.  This avoids conflating ports and pkgbase changes (which we
should avoid, since some users are already confused about the
relationship between pkgbase and ports), and provides important
information which might require user action earlier in the release
notes.

Be more explicit about when user action is and isn't required.

Remove "pkgbase" from user-facing documentation ("base system packages"
is the preferred user-facing terminology).

Suggest that people wanting to use installworld/installkernel should
depkgbasify, rather than suggesting DESTDIR=/.  Overriding this check
is basically guaranteed to break the system, and should never be done;
it's only there in case of some sort of extraordinary situation where
the system can't be repaired any other way.

Reviewed by:	ziaee
Approved by:	ziaee (doc)
Differential Revision:	https://reviews.freebsd.org/D57228
This commit is contained in:
Lexi Winter
2026-05-26 16:12:42 +01:00
parent b9709177b1
commit ea576feb9b
1 changed files with 19 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files
website/content/en/releases/15.1R/relnotes.adoc
+19 -12
View File
@@ -229,6 +229,25 @@ This section lists the various Security Advisories and Errata Notices since {rel
This section covers changes and additions to userland applications, contributed software, and system utilities.
[[userland-packages]]
=== System Packaging Changes
Changes in this section only affect systems installed using base system packages (sometimes called _pkgbase_), supported in FreeBSD 15.0 and later.
OpenPAM has moved to a new `FreeBSD-pam` package.
Systems with the `FreeBSD-set-minimal` or `FreeBSD-set-minimal-jail` package sets installed will install this package automatically, and no user action is required.
Systems which do not have either of the minimal sets installed must install the new package if they need to support PAM authentication, e.g. for man:login[1] or man:sshd[8].
gitref:95cc7f59b7ce[repository=src].
Zstandard, including the man:zstd[1] utility, has moved to a new `FreeBSD-zstd` package.
Systems with the `FreeBSD-set-minimal` or `FreeBSD-set-minimal-jail` package sets installed will install this package automatically, and no user action is required.
Other systems should install this package manually if Zstandard support is required.
gitref:8c61751d078e[repository=src].
The `installworld` and `installkernel` targets are now blocked on systems installed from packages to prevent package database inconsistencies.
Users wishing to perform source-based upgrades should first unregister the base system packages, as described in man:freebsd-base[7].
gitref:ef82bdc864c5[repository=src], gitref:235cb4b4970f[repository=src].
[[userland-config]]
=== Userland Configuration Changes
@@ -880,21 +899,9 @@ gitref:142df248ac06[repository=src].
[[ports-packages]]
=== Packaging Changes
zstd has been packaged as a separate library and program package, similar to zlib, bzip2, and xz. The zstd package has been included in the minimal package set, ensuring it remains installed by default.
gitref:8c61751d078e[repository=src].
{{< sponsored "https://www.patreon.com/bsdivy" >}}
Package repository configuration changes redirect package requests from pkgbase.freebsd.org to pkg.freebsd.org mirrors, adding approximately 70 seconds to pkgbase system installation/upgrade operations. Systems with 15.0-PRERELEASE, ALPHA, or BETA installations become orphaned as they expect packages signed with old pkg keys rather than new pkgbase signing keys.
gitref:0c87d29a54da[repository=src].
OpenPAM has been moved to a separate 'pam' package, allowing systems without PAM (e.g., jails, containers) to avoid installing PAM modules. The pam package is included in minimal installation sets by default, but custom or embedded systems can omit it.
gitref:95cc7f59b7ce[repository=src].
{{< sponsored "https://www.patreon.com/bsdivy" >}}
The `installworld` and `installkernel` targets are now blocked on systems using pkgbase to prevent package database inconsistencies. Users can override this check with `DESTDIR=/` if needed.
gitref:ef82bdc864c5[repository=src].
{{< sponsored "https://www.patreon.com/bsdivy" >}}
Firmware packages from the kmods repository have been included on the DVD installation media, ensuring that firmware modules are usable on the release version.
gitref:b0fbed20ceb9[repository=src].
{{< sponsored "https://www.patreon.com/cperciva" >}}