From nobody Sun Dec 21 19:24:50 2025 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4dZB6q0tmmz6LNpd for ; Sun, 21 Dec 2025 19:24:51 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R13" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4dZB6p74s2z3Ysl for ; Sun, 21 Dec 2025 19:24:50 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1766345091; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=02J5asIR3hBpSagwh8DtgFpMpYpIfgGlIiiaGrMGG+w=; b=UMgUAWRJhK7t7NfFFy9Trz5X93/Oi6qEVGGPLXLQ3cqzcT3thFIM/v/vrrWmxz1Cy5vLr6 Ug2KoAX4YA26QI9fvLKdcXD7NOfrkiG7hwUrv9PHda8hH5Ju6aPRhCdm/yefu6oXMPpRgd zFaGEe64ShyHqLnXCV9XomY148pxuIeVrQbxbtftVBvEMR7XXNq88spJpBrKDntUmAilWt BR3qmWxvRzBpnhQQ8R1+46h6in4dhrinDf8sluZyycj9tEUW7TvZuRJGYZxT58N6T0isUt E1VCFufzA0M/SK4KPiJwa0780fUc8o5CgBmvD9h2CrXrTbemXjQmEMu2KBJhjw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1766345091; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=02J5asIR3hBpSagwh8DtgFpMpYpIfgGlIiiaGrMGG+w=; b=AedgybURhIUhVpBdRa7YMeE/1YK5s2w4GeqPJhRr5VPCghFONN/Jls9qNEhhWy/c2qCQ2z Cy4/4tBDWnpGjdVor1KNTyK12hBPVzoU4QNjgtb2XVB90uqoDHEu1wod7oRh76wuTqtzZF WaViOejI/sOE4CWrc3cgP8tqh9pao+lfJ3cqesNQ9ngd6cec7GV+biZ6sqkBMQJ2InG3yQ +4zSKfDR/SvMNXOkCJQAtxHVGtOqK4bLWPOMymFNo3R7SL+32HhgJLrZx8hB6Hao0ksM+w vlcCxwo/O3d384x129i8V0lnCr+nhRgt0QYDeDvX89havnpFb/+piNLFdhLoCA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1766345091; a=rsa-sha256; cv=none; b=RuziLtUaTfLC/yp60jmEEfWLPEaRBfiNuzynf45nmZFvuJURTnPKE4eFUCzHl3cYES2ZgI gPBRo+PP2xELqJJXfJBQ+ac47UAMH6e6chS+3XEU34hsmkGrElU+QrRfCnPvLcGnO/ZQBH MuHWII4gqJ4cPl51gftW4X6PLCvKKuO2yrPh4bMDrniwrkRhTeSvlkWDuNIk7VHQ39h/ab ODHRe/EQjwvbMT7hqJIn4aR5j5BnYV7D7bsfBUwnWxZzljR1woWpB3paBFetkT8G6okEss Kp/OKXXFI93OJWHfZShTVbFe2B+2ngVvxucHkRtTONPXjEn9cqFFbe2iJs9aSA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4dZB6p5x21ztbG for ; Sun, 21 Dec 2025 19:24:50 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 36df1 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Sun, 21 Dec 2025 19:24:50 +0000 To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Alexander Ziaee Subject: git: dce95ff77e - main - 15.0/relnote: Organize Upgrading section List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ziaee X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: dce95ff77e20458eddae4233e3247c39e4548362 Auto-Submitted: auto-generated Date: Sun, 21 Dec 2025 19:24:50 +0000 Message-Id: <69484982.36df1.7403720f@gitrepo.freebsd.org> The branch main has been updated by ziaee: URL: https://cgit.FreeBSD.org/doc/commit/?id=dce95ff77e20458eddae4233e3247c39e4548362 commit dce95ff77e20458eddae4233e3247c39e4548362 Author: Alexander Ziaee AuthorDate: 2025-12-21 18:00:11 +0000 Commit: Alexander Ziaee CommitDate: 2025-12-21 18:22:06 +0000 15.0/relnote: Organize Upgrading section Judging from the mailing list discussion, this section needs organized better. While here, sneak in a bit of wordsmithing. We still have a lot of work to do improving the instructions for upgrading systems installed with packages, but we have to keep moving. Discussed with: cperciva (it's still ok to organize better) Discussed with: ivy (s/distribution/& sets/) Discussed with: jrm (upgrading from source wordsmithing) Reviewed by: dch (previous, fixed a typo since) Differential Revision: https://reviews.freebsd.org/D54181 --- website/content/en/releases/15.0R/relnotes.adoc | 33 ++++++++++++++----------- 1 file changed, 18 insertions(+), 15 deletions(-) diff --git a/website/content/en/releases/15.0R/relnotes.adoc b/website/content/en/releases/15.0R/relnotes.adoc index 25616fe296..ea669f7352 100644 --- a/website/content/en/releases/15.0R/relnotes.adoc +++ b/website/content/en/releases/15.0R/relnotes.adoc @@ -53,26 +53,28 @@ Clearly the release notes cannot list every single change made to FreeBSD betwee [[upgrade]] == Upgrading from Previous Releases of FreeBSD -Binary upgrades between RELEASE versions (and snapshots of the various security branches) are supported using the man:freebsd-update[8] utility. -See the release-specific upgrade procedure, link:../installation/#upgrade-binary[FreeBSD {releaseCurrent} upgrade information], with more details in the FreeBSD handbook link:{handbook}cutting-edge/#freebsdupdate-upgrade[binary upgrade procedure]. -This will update unmodified userland utilities, as well as unmodified GENERIC kernels distributed as a part of an official FreeBSD release. -The man:freebsd-update[8] utility requires that the host being upgraded have Internet connectivity. - -Source-based upgrades (those based on recompiling the FreeBSD base system from source code) from previous versions are supported, according to the instructions in [.filename]#/usr/src/UPDATING#. - [IMPORTANT] ==== Upgrading FreeBSD should only be attempted after backing up _all_ data and configuration files. ==== +[[upgrade-fu]] +=== Upgrading from Distribution Sets + +Binary upgrades between snapshots and RELEASE versions are supported using the man:freebsd-update[8] utility. +See the release-specific upgrade procedure, link:../installation/#upgrade-binary[FreeBSD {releaseCurrent} upgrade information], with more details in the FreeBSD handbook link:{handbook}cutting-edge/#freebsdupdate-upgrade[binary upgrade procedure]. +This will update unmodified userland utilities, as well as unmodified GENERIC kernels distributed as a part of an official FreeBSD release. +The man:freebsd-update[8] utility requires that the host being upgraded have Internet connectivity. + [[upgrade-rc]] -== Upgrading from Existing Pre-Release Base System Package Installs +=== Upgrading from Packages + [IMPORTANT] ==== -For users of PRERELEASE, ALPHA, and BETA builds of FreeBSD 15.0, due to late-breaking changes in FreeBSD.org infrastructure, it is not possible to upgrade directly using the man:pkg-upgrade[8] utility. +For users of PRERELEASE, ALPHA, and BETA builds of FreeBSD 15.0, due to late-breaking changes in FreeBSD.org infrastructure, it is not possible to upgrade directly using the man:pkg[8] utility. ==== -Users should either manually copy the required files from a source tree checkout of `15.0-RELEASE` tag, or a later commit in `STABLE` or `CURRENT` branches, or alternatively, force-install the `FreeBSD-pkg-bootstrap` package from the official release base system packages. +Packaged base system installations require either manually copying the required files from a source tree checkout of the `15.0-RELEASE` tag, or alternatively, force-install the `FreeBSD-pkg-bootstrap` package from the official release base system packages. The recommended, and most secure approach, is using the source tree checkout of any of head, stable/15, or releng/15.0 branches after 2025-11-27 22:00 UTC. @@ -82,7 +84,7 @@ The recommended, and most secure approach, is using the source tree checkout of # cp -R /usr/src/share/keys/pkgbase-15 /usr/share/keys/pkgbase-15 .... -Users who do not have up to date sources installed may use a less secure, but simpler approach, validating the checksums after installation. As these are architecture-independent files, the checksums will match on all platforms. The FreeBSD-base package repository will need to be enabled before upgrading via man:pkg[8]. +Users who do not have up to date sources installed may use a less secure, but simpler approach, validating the checksums after installation. As these are architecture-independent files, the checksums will match on all platforms. The FreeBSD-base package repository will need to be enabled before upgrading via man:pkg[8]: .... # pkg add -f https://pkg.freebsd.org/FreeBSD:15:$(uname -p)/base_release_0/FreeBSD-pkg-bootstrap-15.0.pkg @@ -96,10 +98,11 @@ c368ec8d05654bdaad34742c1d75b9b150bfc3892838cef32f6e5b036b0c0605 /usr/share/keys # echo "FreeBSD-base: { enabled: yes }" > /usr/local/etc/pkg/repos/FreeBSD.conf .... -[IMPORTANT] -==== -Upgrading FreeBSD should only be attempted after backing up _all_ data and configuration files. -==== +[[upgrade-mk]] +=== Upgrading from Source + +Source-based upgrades from previous versions are supported via compiling the releng/15.0 branch. +Refer to the instructions in [.filename]#/usr/src/UPDATING#. [[security-errata]] == Included Security Fixes and Errata Patches