From nobody Thu Feb 15 16:13:59 2024 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 4TbKr74dMqz553PW for ; Thu, 15 Feb 2024 16:13: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 4TbKr72sJHz4Tvl; Thu, 15 Feb 2024 16:13:59 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1708013639; 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=dbTWaCCEUBgo81MisdlgrC28Hp8Kt1OEYQ0ZXQcD91Y=; b=l65xVkE4s4HPLI8Lww+slY9D4U1Tt5npZRdTQSz8591hr8Sr1iOUpbXYQIylgTLbfQ+kW5 RbGMzc2MTRHCcLddvI8HibnfnOSMuYQGhZDg+4Ppv70nj9CVuQnnnzk7+pHHB78c370UGk 9x29Cy24zryKEIS+DPXPJGTbTKskKd0ex6pTc1xJf4ZL6HSS3nSINAroVLTHuAyIYhmTd1 6VJE/p8z5LyJ72k4MMZ15cyguq/N4zj/yyF85B8nbtVcBZMlF/CjSTfkv+Nt4sZNc0B/80 QaD/jz6ynvBXndN8Q5CBliv0ZDbJ4FL82ACiMDbVlRBuNgJq0Ss7w3cRr9YbKw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1708013639; a=rsa-sha256; cv=none; b=fIPqv3qzpz1pwiYCDnUwqEEbb2Pf4obVVHuAy22PPEbqMy9yAWMRG91xbIpE4KsHXFAVuU Kedg8KhMoASdIypEWS08yWCS9z3E6m7Sy9jNYyp/H16TWDSbFvMOx0hY5NIx1Mphjd4tUW DCIV1Jbo+FH/gJijoIJuvUC5E+/L4N52UHFhvEq0AfYnsQJFMjp1woeSNBLVh3MFkbdBKE vDParV1EPVTFqQaO5T8DC0Jb3nMTMR3z7RbbN2TVxOTA8+8TdsgV4bFd4EWBL9hJPudSq2 NrGjL+qcX84NbL0tHY54os8jOJRfpqWCEgCwbVuKJoPMuvMcGNv0VwFPsi0pcA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1708013639; 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=dbTWaCCEUBgo81MisdlgrC28Hp8Kt1OEYQ0ZXQcD91Y=; b=AtY2V+qK2/Hf+xBR9BGfkiaim6vMlgy6GSAT2dR1aoQ3PWD8N5XhX2RHLd0ZA5+kmmahuk hJ0ijSuML6LGiVFHFQjf3Jelgu8fh1ecoldIrXaAmn0funWdsuVFHG9ZV8OEL18nqbQlDQ n7yG255Z83oV7wzEsabeGNUt4ZEO9ZqZRP8fI3bdTj2XK+NHzc1hnRIntgNNS6vlNZxL9g A1KxxYgD0ebRpoOliem3iDBtRoihvj2Rcx+97req316TJ7Gvh2wO65xUqJ6sQdco2usaE1 GrCf+3rRUhO6qqE0SP8Dw6qSgnDMNb4FrbpePXblKuKA+PHYOkC7VHqQnKhjAA== 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 4TbKr71t4BzpPl; Thu, 15 Feb 2024 16:13:59 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 41FGDx6c032024; Thu, 15 Feb 2024 16:13:59 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 41FGDx5f032021; Thu, 15 Feb 2024 16:13:59 GMT (envelope-from git) Date: Thu, 15 Feb 2024 16:13:59 GMT Message-Id: <202402151613.41FGDx5f032021@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mike Karels Subject: git: b04b9b6490 - main - 13.3 relnotes: create skeleton 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: karels X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: b04b9b6490c78846fbf67f91bb01d659062cc44d Auto-Submitted: auto-generated The branch main has been updated by karels: URL: https://cgit.FreeBSD.org/doc/commit/?id=b04b9b6490c78846fbf67f91bb01d659062cc44d commit b04b9b6490c78846fbf67f91bb01d659062cc44d Author: Mike Karels AuthorDate: 2024-02-15 16:12:31 +0000 Commit: Mike Karels CommitDate: 2024-02-15 16:13:50 +0000 13.3 relnotes: create skeleton Create the skeleton for the 13.3 release notes, starting with the 13.2 version. Differential Revision: https://reviews.freebsd.org/D43840 --- website/content/en/releases/13.3R/relnotes.adoc | 168 ++++++++++++++++++++++++ 1 file changed, 168 insertions(+) diff --git a/website/content/en/releases/13.3R/relnotes.adoc b/website/content/en/releases/13.3R/relnotes.adoc new file mode 100644 index 0000000000..b2cacf3096 --- /dev/null +++ b/website/content/en/releases/13.3R/relnotes.adoc @@ -0,0 +1,168 @@ +--- +title: "FreeBSD 13.3-RELEASE Release Notes" +sidenav: download +--- + +:releaseCurrent: 13.3-RELEASE +:releaseBranch: 13-STABLE +:releasePrev: 13.2-RELEASE +:releaseNext: 13.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/[]. + +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/[]. + +This distribution of FreeBSD {releaseCurrent} is a {releaseType} distribution. +It can be found at 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 {releaseBranch} since {releasePrev}. +Note that some of the changes described here are also available in FreeBSD 14.0-RELEASE. + +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 link:{handbook}cutting-edge/#freebsdupdate-upgrade[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. +==== + +[IMPORTANT] +==== +After installing the new userland software, running daemons are still from the previous version. +After installing the user-level components with the second invocation of freebsd-update, or via an upgrade from source with `installworld`, the system should be rebooted to start everything with the new software. +For example, older versions of `sshd` failed to process incoming connections correctly after the new [.filename]#/usr/sbin/sshd# was installed; rebooting started a new `sshd` and other daemons. +==== + +//// +XXX: Release Engineering Lead will fill this in just before the release is final +[[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 +|=== + +[[errata]] +=== Errata Notices + +[width="100%",cols="40%,30%,30%",options="header",] +|=== +|Errata |Date |Topic +|=== +//// + +[[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`. +// gitref:1234567890ab[repository=src] (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 + +This section covers changes and additions to devices and device drivers since {releasePrev}. + +[[drivers-device]] +=== Device Drivers + +[[storage]] +== Storage + +This section covers changes and additions to file systems and other storage subsystems, both local and networked. + +[[storage-nfs]] +=== NFS Changes + +[[storage-ufs]] +=== UFS Changes + +[[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 +