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 @@
=== 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`