From nobody Thu Sep 29 16:40:58 2022 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 4MdfHv0Xdjz4dhFJ for ; Thu, 29 Sep 2022 16:40:59 +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 "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4MdfHv003Yz44sJ; Thu, 29 Sep 2022 16:40:58 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1664469659; 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=nlcT7OsJ3sA5B94NQkVLjm2nfSJxow4VuIOMReaNC90=; b=tnr/ITTosU21s1MpR8oZ/oR66+t88WnUivh6JMcBhFAGSIzXTJ2j7NPQSmEmBgHyYhVCo9 F2W5HsW36fNPXluqWoLsLbViG8dnnUNCo2UslN9o7EiG91QUy5NOkuTH2eTbFaI/LJx79P 9qkEkadYbMp7Snwi5yZ/l3pzUmo+i6NJ9rvhbNv2vwjs0dFuIQbUFsbU1FChToBRYuJNkD fXkrCrTk06VE3Xcnbp7mtAlkchaFjieg6h4XXoWzSxGwzcuPdhROnEm9Y0RiUu8IphFc7G iCTG3gA8DTfQSB6nyJfYPiHiGkLQdwW09mFGb4K/AeFQRJ9M1uAHfC0ih3/jKQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4MdfHt5rBszsrW; Thu, 29 Sep 2022 16:40:58 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 28TGewrp099332; Thu, 29 Sep 2022 16:40:58 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 28TGewcp099331; Thu, 29 Sep 2022 16:40:58 GMT (envelope-from git) Date: Thu, 29 Sep 2022 16:40:58 GMT Message-Id: <202209291640.28TGewcp099331@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: 5da8147781 - main - 12.4 release: add relnotes template 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: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gjb X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 5da8147781815c3435fa49aac4b65cf807e3100c Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1664469659; 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=nlcT7OsJ3sA5B94NQkVLjm2nfSJxow4VuIOMReaNC90=; b=NtQphKlxdsezNl100yp2fWIFzv6dvvksmLSQlEXLhLBBcw41sftEcyX0wEQAUNVWAURvW1 iw+ZcWbAZLFJHoZmK2wjO1r/Bq6ttinszsw4FRzC1ggEXHww/GBLO3+n4cdZxmnsCg4Q0M 3jSdvdQb2or5pZBkhxRXdZ3z2NIHGe5e7euKpsKVHBkVRQQQXYi7lwB/lHecyJQNI06Pbf eBAig6JuA8vTLe9KxilU3dqPr4FBGGDdK3SqA1ezgRgsM+FOvaBc1SBHSBnwQ5TQ3FORhy ch5nQiDH8EmR7dyhWq25vKvB8hlwiDj2P7QFrAQDXZsb1gs4NpuWMtaieFpG2w== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1664469659; a=rsa-sha256; cv=none; b=WniYvpCdPcoxEqTfW/rHVrLls2Yocri6hZzbn4KlVqx4m16Ee0LWjvBxQC4R9rKA/YTv2p wm/KG5kwlnzBrGvK7slAsihJ+Svy3XD5I7V2skpnxTq7nekNflTzFOwzcsaFcXK85TFxSQ rZML9chgIJu8ma/4Per3diflS5l0A2V7rMswC3FB02luMMRmF1UN8m5KmIJQAJOvmEyjL5 +ZPsscRaGwzPWXPU0G8RH0DmZMW2fGRZ32g78WGbH6ye7/28qy+G2MaAlslHnG0y1Aljg3 XrJ34njm4QcNi+zJrgI3cxAJ9w3Ns/0L2rz3LlN8r5uQVtvlERT6KsKcWLqahg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=5da8147781815c3435fa49aac4b65cf807e3100c commit 5da8147781815c3435fa49aac4b65cf807e3100c Author: Glen Barber AuthorDate: 2022-09-29 16:40:46 +0000 Commit: Glen Barber CommitDate: 2022-09-29 16:40:46 +0000 12.4 release: add relnotes template Sponsored by: Rubicon Communications, LLC ("Netgate") --- website/content/en/releases/12.4R/relnotes.adoc | 171 ++++++++++++++++++++++++ 1 file changed, 171 insertions(+) diff --git a/website/content/en/releases/12.4R/relnotes.adoc b/website/content/en/releases/12.4R/relnotes.adoc new file mode 100644 index 0000000000..be8a6a9326 --- /dev/null +++ b/website/content/en/releases/12.4R/relnotes.adoc @@ -0,0 +1,171 @@ +--- +title: "FreeBSD 12.4-RELEASE Release Notes" +sidenav: download +--- + +:releaseCurrent: 12.4-RELEASE +:releaseBranch: 12-STABLE +:releasePrev: 12.3-RELEASE +:releaseNext: 12.4-RELEASE +:releaseType: release + +include::shared/en/urls.adoc[] + += FreeBSD {releaseCurrent} Release Notes +:doctype: article +:toc: macro +:toclevels: 1 +:icons: font + +== Abstract + +[.abstract-title] +The release notes for FreeBSD {releaseCurrent} contain a summary of the changes made to the FreeBSD base system on the {releaseBranch} development line. This document lists applicable security advisories that were issued since the last release, as well as significant changes to the FreeBSD kernel and userland. Some brief remarks on upgrading are also presented. + +[[intro]] +== Introduction + +This document contains the release notes for FreeBSD {releaseCurrent}. It describes recently added, changed, or deleted features of FreeBSD. It also provides some notes on upgrading from previous versions of FreeBSD. + +The {releaseType} distribution to which these release notes apply represents the latest point along the {releaseBranch} development branch since {releaseBranch} was created. Information regarding pre-built, binary {releaseType} distributions along this branch can be found at https://www.FreeBSD.org/releases/[https://www.FreeBSD.org/releases/]. + +The {releaseType} distribution to which these release notes apply represents a point along the {releaseBranch} development branch between {releasePrev} and the future {releaseNext}. Information regarding pre-built, binary {releaseType} distributions along this branch can be found at https://www.FreeBSD.org/releases/[https://www.FreeBSD.org/releases/]. + +This distribution of FreeBSD {releaseCurrent} is a {releaseType} distribution. It can be found at https://www.FreeBSD.org/releases/[https://www.FreeBSD.org/releases/] or any of its mirrors. More information on obtaining this (or other) {releaseType} distributions of FreeBSD can be found in the link:{handbook}/mirrors[Obtaining FreeBSD appendix] to the link:{handbook}/[FreeBSD Handbook]. + +All users are encouraged to consult the release errata before installing FreeBSD. The errata document is updated with "late-breaking" information discovered late in the release cycle or after the release. Typically, it contains information on known bugs, security advisories, and corrections to documentation. An up-to-date copy of the errata for FreeBSD {releaseCurrent} can be found on the FreeBSD Web site. + +This document describes the most user-visible new or changed features in FreeBSD since {releasePrev}. In general, changes described here are unique to the {releaseBranch} branch unless specifically marked as MERGED features. + +Typical release note items document recent security advisories issued after {releasePrev}, new drivers or hardware support, new commands or options, major bug fixes, or contributed software upgrades. They may also list changes to major ports/packages or release engineering practices. Clearly the release notes cannot list every single change made to FreeBSD between releases; this document focuses primarily on security advisories, user-visible changes, and major architectural improvements. + +[[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. The binary upgrade procedure 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. +==== + +[[security-errata]] +== Security and Errata + +This section lists the various Security Advisories and Errata Notices since {releasePrev}. + +//// +[[security]] +=== Security Advisories + +[width="100%",cols="40%,30%,30%",options="header",] +|=== +|Advisory |Date |Topic +|link:https://www.freebsd.org/security/advisories/FreeBSD-SA-20:31.icmp6.asc[FreeBSD-SA-20:31.icmp6] |1 December 2020 |Use-after-free in error message handling +|XXX to be filled in +|=== +//// + +//// +[[errata]] +=== Errata Notices + +[width="100%",cols="40%,30%,30%",options="header",] +|=== +|Errata |Date |Topic +|link:https://www.freebsd.org/security/advisories/FreeBSD-EN-20:19.audit.asc[FreeBSD-EN-20:19.audit] |1 December 2020 |execve/fexecve system call auditing +| XXX to be filled in +|=== +//// + +[[userland]] +== Userland + +This section covers changes and additions to userland applications, contributed software, and system utilities. + +[[userland-config]] +=== Userland Configuration Changes + +// SAMPLE ENTRY: +// A new man:rc.conf[5] variable has been added, `linux_mounts_enable`, which controls if Linux(R)-specific filesystems are mounted in [.filename]#/compat/linux# if `linux_enable` is set to `YES`. {{< revision "364883" >}} (Sponsored by The FreeBSD Foundation) + +[[userland-programs]] +=== Userland Application Changes + + +[[userland-contrib]] +=== Contributed Software + + +[[userland-libraries]] +=== Runtime Libraries and API + + +[[kernel]] +== Kernel + +This section covers changes to kernel configurations, system tuning, and system control parameters that are not otherwise categorized. + +[[kernel-general]] +=== General Kernel Changes + + +[[drivers]] +== Devices and Drivers + + +[[drivers-device]] +=== Device Drivers + + +[[storage]] +== Storage + +This section covers changes and additions to file systems and other storage subsystems, both local and networked. + +[[storage-general]] +=== General Storage + + +[[boot]] +== Boot Loader Changes + +This section covers the boot loader, boot menu, and other boot-related changes. + +[[boot-loader]] +=== Boot Loader Changes + + +[[network]] +== Networking + +This section describes changes that affect networking in FreeBSD. + +[[network-general]] +=== General Network + + +[[future-releases]] +== General Notes Regarding Future FreeBSD Releases + +[[future-releases-cputype]] +=== Default `CPUTYPE` Change + +Starting with FreeBSD-13.0, the default `CPUTYPE` for the i386 architecture will change from `486` to `686`. + +This means that, by default, binaries produced will require a 686-class CPU, including but not limited to binaries provided by the FreeBSD Release Engineering team. FreeBSD 13.0 will continue to support older CPUs, however users needing this functionality will need to build their own releases for official support. + +As the primary use for i486 and i586 CPUs is generally in the embedded market, the general end-user impact is expected to be minimal, as new hardware with these CPU types has long faded, and much of the deployed base of such systems is nearing retirement age, statistically. + +There were several factors taken into account for this change. For example, i486 does not have 64-bit atomics, and while they can be emulated in the kernel, they cannot be emulated in the userland. Additionally, the 32-bit amd64 libraries have been i686 since their inception. + +As the majority of 32-bit testing is done by developers using the lib32 libraries on 64-bit hardware with the `COMPAT_FREEBSD32` option in the kernel, this change ensures better coverage and user experience. This also aligns with what the majority of Linux(R) distributions have been doing for quite some time. + +This is expected to be the final bump of the default `CPUTYPE` in i386. + +[IMPORTANT] +==== +This change does not affect the FreeBSD 12.x series of releases. +====