From nobody Sat Feb 18 18:06:25 2023 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 4PJxSx2bW9z3sqPp for ; Sat, 18 Feb 2023 18:06:25 +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 4PJxSx2Ptcz4KM3; Sat, 18 Feb 2023 18:06:25 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1676743585; 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=a1o/vBvdDt8ezPJAGj6mW46RBCWihjZtiSkTv3d0+Lc=; b=hJyu0ucYA+DFwAMVXZxg89yBGDupSDkyOi4IIn9Pok6MkD/xE6+b8bPSKfz2rK93TugF0t zhHLxoaLLmV/XUgkTE8/GyXuN//sNl88Ve+jY1uZRFsh8eXYjkpwzfqrAYQ9roUFFsG1Zh ktGZS2Osf0J4zZov0xQlQXEOS/IW2nZHyb19LN8iLjB5pOzlPpJlEknVICnuiBEomvAilU +apYnQqI2MbccjXRkolt0xiXQah8LTrRXXd0HizRuGwJBmRlinD4Tywi/6c5aeAbThZ9hr y+pScUvmq7dfbLhCXQUqcY9C+VJQUW0fE8LmP1B04VwzwsH+CRegO8Cie/Rl2g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1676743585; 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=a1o/vBvdDt8ezPJAGj6mW46RBCWihjZtiSkTv3d0+Lc=; b=QlKKscgkP6B+BRUuRcSbuOW5LquNBPBfQSYNXcUx+liMQ/zHFZPyoAFi4pvJoeiT628Fdg OreKn707CuZaaSMH5tUDR+Mi/HJ8+g+foMoSlkGIjrrcGkiN1sVq5XA9MwMW/49+QbPwpF jAcdtAiwpDZFIpxriLdK958gwIC3NOgPDyQEOg+CGgcmv8Yt6bc/7mcSQ2HdPguRtWMGxW xBzNn9nw0aXVv33kek7oVnooHxfdLCwuA2wMb6LyPKyne/jjnPaeChNAoK4x9lrQ6P0OBQ 75jf/LOtjanQrQ3w5eqW4pB85vBJXSS9AKy13q1UWhivbD95ofikOGgHn4U7ug== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1676743585; a=rsa-sha256; cv=none; b=olIliafeEyAiej3sDWsMEoWHsqsb3Bopm1Fvkaj2+TTJSk2R3qYGQCRBOVr1p6FgNCnSRE iBEO7iOSMKK3LgaWA7CkcRXmFtY/HUWn0rzNRXCw8d4HCr7sQCuO+jnkYcGbmOBuI4973k 183wN9QY510VxeDpP/VSRhc6W3wF8To4n45JIHIkGBmZomGqxg82ZaL8U9rkpQW/h5Pg/h S0HZSv5k2cVQwLGEkO1WlVRjvMRDL2eTImHnapccCyinhVaFGdhfQh6071hNYxA0zhCZVw 5Ja5hd5/y0r698hTlusRVc0jI8FCC3X2mGMG9hZmL21FLagS5PzzprUnF72akA== 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 4PJxSx1SRYzX7Z; Sat, 18 Feb 2023 18:06:25 +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 31II6Pm5098868; Sat, 18 Feb 2023 18:06:25 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 31II6Pu6098867; Sat, 18 Feb 2023 18:06:25 GMT (envelope-from git) Date: Sat, 18 Feb 2023 18:06:25 GMT Message-Id: <202302181806.31II6Pu6098867@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mike Karels Subject: git: 5c594ec0c4 - main - 13.2R relnotes: numerous additions plus edits 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: 5c594ec0c4d9a69189c47f885287656bb87ede14 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by karels: URL: https://cgit.FreeBSD.org/doc/commit/?id=5c594ec0c4d9a69189c47f885287656bb87ede14 commit 5c594ec0c4d9a69189c47f885287656bb87ede14 Author: Mike Karels AuthorDate: 2023-02-18 18:05:37 +0000 Commit: Mike Karels 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 ,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