Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 18 Feb 2023 18:06:25 GMT
From:      Mike Karels <karels@FreeBSD.org>
To:        doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org
Subject:   git: 5c594ec0c4 - main - 13.2R relnotes: numerous additions plus edits
Message-ID:  <202302181806.31II6Pu6098867@gitrepo.freebsd.org>

next in thread | raw e-mail | index | archive | help
The branch main has been updated by karels:

URL: https://cgit.FreeBSD.org/doc/commit/?id=5c594ec0c4d9a69189c47f885287656bb87ede14

commit 5c594ec0c4d9a69189c47f885287656bb87ede14
Author:     Mike Karels <karels@FreeBSD.org>
AuthorDate: 2023-02-18 18:05:37 +0000
Commit:     Mike Karels <karels@FreeBSD.org>
CommitDate: 2023-02-18 18:05:37 +0000

    13.2R relnotes: numerous additions plus edits
    
    Add entries for many remaining "Relnotes: yes" entries in the git
    log.  Add solicited input in many areas.  Some additional edits
    to previous entries, and add a few details.  Strengthen recommendation
    to reboot after installing user software.  Format filenames with
    [.filename]#name#.  Updated sample entry with gitref reference.
    
    Approved by:    delphij
    Reviewed by:    pauamma, delphij
    Differential Revision:  https://reviews.freebsd.org/D38639
---
 website/content/en/releases/13.2R/relnotes.adoc | 164 ++++++++++++++++++++----
 1 file changed, 137 insertions(+), 27 deletions(-)

diff --git a/website/content/en/releases/13.2R/relnotes.adoc b/website/content/en/releases/13.2R/relnotes.adoc
index 3a0889b5a1..5459d54e9b 100644
--- a/website/content/en/releases/13.2R/relnotes.adoc
+++ b/website/content/en/releases/13.2R/relnotes.adoc
@@ -46,17 +46,17 @@ Binary upgrades between RELEASE versions (and snapshots of the various security
 
 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#.
 
-Users of all powerpc architectures, after successful kernel and world installation, will need to run manually "kldxref /boot/kernel".
+Users of all PowerPC architectures, after successful kernel and world installation, must run `kldxref /boot/kernel` manually.
 
 [IMPORTANT]
 ====
-Upgrading FreeBSD should only be attempted after backing up _all_ data and configuration files.
+Upgrading FreeBSD should only be attempted after backing up **all** data and configuration files.
 ====
 
 [IMPORTANT]
 ====
-After upgrading, sshd (from OpenSSH 8.8p1) will not accept new connections until it is restarted.
-After installing the new userland, either reboot (as specified in the source update procedure), or execute `service sshd restart`.
+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.
 ====
 
 ////
@@ -94,28 +94,35 @@ This section covers changes and additions to userland applications, contributed
 === 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)
+// 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:1234567abc[repository=src] (Sponsored by The FreeBSD Foundation)
 
-A new man:rc.conf[5] variable has been added, `growfs_swap_size`, which controls
-the size of the swap partition created by the `growfs` startup script as documented
-in man:growfs[7].
+The man:growfs[7] startup script will now add a swap partition while expanding
+the root file system if possible, and if one did not previously exist.
+This is primarily useful when installing on an SD card using a raw image.
+A new man:rc.conf[5] variable has been added, `growfs_swap_size`,
+which can control the addition if necessary.
+See man:growfs[7] for details.
 
 A new RC script, `zpoolreguid` has been added, which will assign a new GUID to
 one or more zpools, useful for virtualization environments when sharing datasets.
 
-A new RC script, `machine_id` has been added, which will generate the `/etc/machine-id`
-file if it does not exist. The file is used by some libraries like GLib.
+A new RC script, `machine_id`, has been added, which will generate the
+[.filename]#/var/db/machine-id#
+file containing a random UUID (version 4) if it does not exist.
+Note that [.filename]#/etc/machine-id# is a symbolic link to
+[.filename]#/var/db/machine-id#.
+The file is used by some libraries such as GLib.
 gitref:17333d92643d[repository=src]
 
-It is now possible to add default routes for other FIBs by using the `defaultrouter_fibN`
-and `ipv6_defaultrouter_fibN` man:rc.conf[5] variables.
+It is now possible to add default routes for FIBs other than the primary
+by using the `defaultrouter_fibN` and `ipv6_defaultrouter_fibN` man:rc.conf[5] variables.
 gitref:c6ec1b441ad3[repository=src]
 (Sponsored by ScaleEngine Inc.)
 
 [[userland-programs]]
 === Userland Application Changes
 
-The man:bhyve[8] utility has gained a virtio-input device emulation support.
+The man:bhyve[8] utility has gained virtio-input device emulation support.
 This will be used to inject keyboard/mouse input events into a guest.
 The command line syntax is: `-s <slot>,virtio-input,/dev/input/eventX`
 gitref:6192776124c5[repository=src]
@@ -123,12 +130,12 @@ gitref:6192776124c5[repository=src]
 The man:kdump[1] utility has gained support for decoding Linux system calls.
 
 The man:killall[1] utility now allows sending signals to processes with
-their control terminal on pts(4).
+their controlling terminal on man:pts[4] using the syntax `-t pts/N`.
 gitref:a76fa7bb6cb7[repository=src]
 
-The man:timeout[1] utility has been moved from /usr/bin to /bin.
+The man:timeout[1] utility has been moved from [.filename]#/usr/bin# to [.filename]#/bin#.
 
-The man:pciconf[8] utility added support for decoding ACS extended capability.
+The man:pciconf[8] utility has added support for decoding ACS extended capability.
 gitref:dde4103a465b[repository=src]
 (Sponsored by Chelsio Communications)
 
@@ -136,8 +143,8 @@ The man:procstat[1] utility can now print information about advisory locks on
 files with the newly added `advlock` command.
 gitref:f9daaf452a8a[repository=src]
 
-The man:pwd_mkdb[8] utility no longer copies comments from `/etc/master.passwd`
-to `/etc/passwd`.
+The man:pwd_mkdb[8] utility no longer copies comments from
+[.filename]#/etc/master.passwd# to [.filename]#/etc/passwd#.
 gitref:3e955733117d[repository=src]
 
 MSS clamping has been improved for man:ppp[8].
@@ -154,12 +161,17 @@ and `vfs.zfs.arc.max`).
 gitref:e4f508d5a211[repository=src]
 (Sponsored by Axcient)
 
+When invoked by man:inetd[8], `ctlstat -P` will now produce output suitable for
+ingestion into Prometheus; see man:ctlstat[8].
+gitref:f7896015fcde[repository=src]
+(Sponsored by Axcient)
+
 [[userland-contrib]]
 === Contributed Software
 
 Gavin Howard's `bc` has been upgraded to version 6.2.4.
 
-`expat` (libbsdxml) has been upgraded to version 2.5.0.
+`expat` (`libbsdxml`) has been upgraded to version 2.5.0.
 
 `file` has been upgraded to version 5.43.
 
@@ -171,11 +183,13 @@ https://github.com/libarchive/libarchive/releases[https://github.com/libarchive/
 
 `libedit` has been upgraded to version 2022-04-11.
 
-`LLVM` has been upgraded to version 14.0.5.
+`LLVM` and the `clang` compiler have been upgraded to version 14.0.5.
+
+Supported `LLVM` sanitizers are now enabled on `powerpc64` and variants.
 
 `mandoc` has been upgraded to version 1.14.6.
 
-`OpenSSH` has been upgraded to version 9.1p1.
+`OpenSSH` has been upgraded to version 9.2p1.
 
 `OpenSSL` has been upgraded to version 1.1.1t.
 
@@ -200,6 +214,11 @@ Support of SHA-512/224 has been added to `libmd`.
 gitref:e04ee7d95ef6[repository=src]
 (Sponsored by Klara, Inc.)
 
+Linux-style system call tracing is now supported by
+man:sysdecode[3] and man:kdump[1].
+
+The native pthread library functions can now support Linux semantics.
+
 [[kernel]]
 == Kernel
 
@@ -208,10 +227,10 @@ This section covers changes to kernel configurations, system tuning, and system
 [[kernel-general]]
 === General Kernel Changes
 
-The man:bhyve[8] utility now supports more than 16 vCPUs in a guest.  By default
-bhyve permits each guest to create the same number of vCPUs as
-the count of physical CPUs on the host.  This limit can be
-adjusted via the loader tunable `hw.vmm.maxcpu`.
+The man:bhyve[8] hypervisor and kernel module man:vmm[4] now support more than 16 vCPUs in a guest.
+By default bhyve permits each guest to create the same number of vCPUs as
+the count of physical CPUs on the host.
+This limit can be adjusted via the loader tunable `hw.vmm.maxcpu`.
 gitref:3e02f8809aec[repository=src]
 
 Address Space Layout Randomization (ASLR) is enabled for 64-bit executables
@@ -219,6 +238,54 @@ by default.
 gitref:10192e77cfac[repository=src]
 (Sponsored by Stormshield)
 
+A workaround has been implemented for an apparent page invalidation problem
+on Intel Alder Lake (twelfth generation) and probably Raptor Lake (thirteenth
+generation) hybrid CPUs.
+The bug can lead to file system corruption with UFS and MSDOSFS,
+and probably other memory corruption.
+The slower cores (E-cores) use a slower method of page invalidation with the workaround.
+gitref:567cc4e6bfd9[repository=src]
+(Sponsored by The FreeBSD Foundation)
+
+A new kernel configuration knob is available, `SPLIT_KERNEL_DEBUG`, which
+controls splitting of kernel and module debug data into separate
+standalone files.
+This interacts with the `WITHOUT_KERNEL_SYMBOLS` option, which operates
+differently than in 13.0-RELEASE and {releasePrev},
+but similarly to prior releases; it now controls only installation
+of the debug data.
+The defaults are `WITH_KERNEL_SYMBOLS` and `WITH_SPLIT_KERNEL_DEBUG`,
+allowing the kernel and modules without debug data to be installed
+in [.filename]#/boot#, and standalone debugging files to be installed
+in [.filename]#/usr/lib/debug#, as was done by default in releases
+before 13.0-RELEASE.
+Using `WITHOUT_KERNEL_SYMBOLS` and `WITH_SPLIT_KERNEL_DEBUG`,
+standalone debugging files are generated but not installed,
+as when using `WITHOUT_KERNEL_SYMBOLS` in releases before 13.0-RELEASE.
+Finally, using `WITHOUT_KERNEL_SYMBOLS` and `WITHOUT_SPLIT_KERNEL_DEBUG`
+installs the kernel and modules with built-in debugging information in
+[.filename]#/boot#, as in {releasePrev} using `WITHOUT_KERNEL_SYMBOLS`.
+gitref:0c4d13c521aa[repository=src]
+(Sponsored by The FreeBSD Foundation)
+
+On the PowerPC, a radix pmap in pseries is supported for ISA 3.0.
+This should make pseries significantly faster on POWER9 instances,
+as fewer hypercalls are needed to manage pmap now.
+gitref:c74c77531248[repository=src]
+
+Support for man:ptrace[2] is now available for Linux processes on arm64.
+gitref:99950e8beb72[repository=src]
+
+vDSO (virtual dynamic shared object) support has been nearly completed
+in the man:linux[4] ABI.
+The system calls for man:gettimeofday[2], man:clock_gettime[2], all
+*_time64() calls, and getcpu() are now implemented in the vDSO,
+avoiding system call overhead.
+Unimplemented vDSO system calls fall back to the kernel system calls.
+The thread affinity system calls were modified to support Linux semantics.
+The arm64 Linux support has been brought to parity with amd64.
+gitref:a340b5b4bd48[repository=src]
+
 [[drivers]]
 == Devices and Drivers
 
@@ -234,7 +301,7 @@ gitref:3f8306cf8e2d[repository=src]
 The man:ena[4] driver has been upgraded to version 2.6.2.
 (Sponsored by Amazon, Inc.)
 
-Basic Intel Alderlake CPUs support has been implemented for man:hwpmc[4].
+Basic support for Intel Alder Lake CPUs has been implemented for man:hwpmc[4].
 gitref:b8ef2ca9eae9[repository=src]
 
 The man:irdma[4] driver was introduced for the Intel E810 Ethernet Controller,
@@ -243,6 +310,14 @@ default.
 gitref:42bad04a2156[repository=src]
 (Sponsored by Intel Corporation)
 
+Initial support is now available for DPAA2 (second generation Data Path Acceleration
+Architecture -- a hardware-level
+networking architecture found in some NXP SoCs).
+It runs NXP-supplied firmware which provides DPAA2 objects as an abstraction
+layer, and provides a `dpni` network interface.
+gitref:d5a64a935bc9[repository=src]
+(Sponsored by Bare Enthusiasm :) and Traverse Technologies)
+
 [[drivers-platform]]
 === Supported Platforms
 
@@ -265,10 +340,19 @@ https://github.com/openzfs/zfs/releases[https://github.com/openzfs/zfs/releases]
 [[storage-nfs]]
 === NFS Changes
 
+A problem causing NFS server hangs has been fixed; the problem was caused
+by a bug with SACK handling in TCP.
 
 [[storage-ufs]]
 === UFS Changes
 
+It is now possible to take snapshots on UFS filesystems when running
+with journaled soft updates.
+Thus it is now possible to do background dumps on live filesystems running
+with journaled soft updates.
+Background dumps are requested by using the `-L` flag to man:dump[8].
+gitref:3f908eed27b4[repository=src]
+(Sponsored by The FreeBSD Foundation)
 
 [[boot]]
 == Boot Loader Changes
@@ -278,6 +362,13 @@ This section covers the boot loader, boot menu, and other boot-related changes.
 [[boot-loader]]
 === Boot Loader Changes
 
+The `teken.fg_color` and `teken.bg_color` man:loader.conf[5] variables now
+accept a `bright` or `light` prefix (and color numbers 8 through 15)
+to select bright colors.
+gitref:1dcb6002c500[repository=src]
+See also gitref:233ab015c0d7[repository=src].
+(Sponsored by The FreeBSD Foundation)
+
 
 [[boot-process]]
 === Other Boot Changes
@@ -291,10 +382,29 @@ This section describes changes that affect networking in FreeBSD.
 [[network-general]]
 === General Network
 
-The man:wg[4] WireGuard driver has been added.
+The man:wg[4] WireGuard driver has been added, which provides Virtual
+Private Network (VPN) interfaces using the WireGuard protocol.
 gitref:5ae69e2f10da[repository=src]
 (Sponsored by The FreeBSD Foundation)
 
+KTLS (the kernel TLS implementation) has added receive offload support for TLS 1.3.
+Receive offload is now supported for TLS 1.1 through 1.3;
+send offload is supported for TLS 1.0 through 1.3.
+gitref:1462dc95f796[repository=src]
+(Sponsored by Netflix)
+
+The man:netlink[4] network configuration protocol is now available.
+It is a communication protocol defined in RFC 3549, and uses a raw socket
+to exchange configuration information between user space and kernel.
+It is used by third-party routing programs and by the man:linux[4] ABI.
+gitref:6058f6cc48f5[repository=src]
+
+Radix tables and lookups are now supported for MAC addresses in man:ipfw[4].
+This allows MAC address tables to be constructed and used for filtering.
+gitref:c31f8b7bd895[repository=src]
+
+There are numerous bug fixes in TCP and SCTP.
+
 [[future-releases]]
 == General Notes Regarding Future FreeBSD Releases
 



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202302181806.31II6Pu6098867>