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 +