git: e29341eee0 - main - Do not recommend editing loader.conf(5) with sysrc(8)

[Mateusz Piotrowski]

The branch main has been updated by 0mp:

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

commit e29341eee0edbde6a0731d34a01cc0fb664be773
Author:     Mateusz Piotrowski <0mp at FreeBSD.org>
AuthorDate: 2021-04-16 00:39:45 +0000
Commit:     Mateusz Piotrowski <0mp at FreeBSD.org>
CommitDate: 2021-04-16 00:39:45 +0000

    Do not recommend editing loader.conf(5) with sysrc(8)
    
    The sysrc(8) utility can only be used to edit sh(1)-compatible files.
    loader.conf(5) is not one of them. For example, sysrc(8) is unable to
    set variables like vfs.root.mountfrom.
---
 .../content/en/books/handbook/multimedia/_index.adoc     |  2 +-
 .../content/en/books/handbook/virtualization/_index.adoc | 16 ++++++++--------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/documentation/content/en/books/handbook/multimedia/_index.adoc b/documentation/content/en/books/handbook/multimedia/_index.adoc
index b0a1e31c54..a586b57e68 100644
--- a/documentation/content/en/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/en/books/handbook/multimedia/_index.adoc
@@ -218,7 +218,7 @@ To load `cuse` during system startup, run this command:
 
 [source,shell]
 ....
-# sysrc -f /boot/loader.conf cuse_load=yes
+# echo 'cuse_load=yes' >> /boot/loader.conf
 ....
 
 To use headphones as a sound sink with package:audio/virtual_oss[], users need to create a virtual device after connecting to a Bluetooth audio device:
diff --git a/documentation/content/en/books/handbook/virtualization/_index.adoc b/documentation/content/en/books/handbook/virtualization/_index.adoc
index 96255c7645..235485fbc4 100644
--- a/documentation/content/en/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/en/books/handbook/virtualization/_index.adoc
@@ -882,19 +882,19 @@ The following command is used for Xen 4.7 packages:
 
 [source,shell]
 ....
-# sysrc -f /boot/loader.conf hw.pci.mcfg=0
-# sysrc -f /boot/loader.conf if_tap_load="YES"
-# sysrc -f /boot/loader.conf xen_kernel="/boot/xen"
-# sysrc -f /boot/loader.conf xen_cmdline="dom0_mem=8192M dom0_max_vcpus=4 dom0pvh=1 console=com1,vga com1=115200,8n1 guest_loglvl=all loglvl=all"
+# echo 'hw.pci.mcfg=0' >> /boot/loader.conf
+# echo 'if_tap_load="YES"' >> /boot/loader.conf
+# echo 'xen_kernel="/boot/xen"' >> /boot/loader.conf
+# echo 'xen_cmdline="dom0_mem=8192M dom0_max_vcpus=4 dom0pvh=1 console=com1,vga com1=115200,8n1 guest_loglvl=all loglvl=all"' >> /boot/loader.conf
 ....
 
 For Xen versions 4.11 and higher, the following command should be used instead:
 
 [source,shell]
 ....
-# sysrc -f /boot/loader.conf if_tap_load="YES"
-# sysrc -f /boot/loader.conf xen_kernel="/boot/xen"
-# sysrc -f /boot/loader.conf xen_cmdline="dom0_mem=8192M dom0_max_vcpus=4 dom0=pvh console=com1,vga com1=115200,8n1 guest_loglvl=all loglvl=all"
+# echo 'if_tap_load="YES"' >> /boot/loader.conf
+# echo 'xen_kernel="/boot/xen"' >> /boot/loader.conf
+# echo 'xen_cmdline="dom0_mem=8192M dom0_max_vcpus=4 dom0=pvh console=com1,vga com1=115200,8n1 guest_loglvl=all loglvl=all"' >> /boot/loader.conf
 ....
 
 [TIP]
@@ -1037,7 +1037,7 @@ FreeBSD should also be booted in verbose mode in order to identify any issues. T
 
 [source,shell]
 ....
-# sysrc -f /boot/loader.conf boot_verbose="YES"
+# echo 'boot_verbose="YES"' >> /boot/loader.conf
 ....
 
 If none of these options help solving the problem, please send the serial boot log to mailto:freebsd-xen at FreeBSD.org[freebsd-xen at FreeBSD.org] and mailto:xen-devel at lists.xenproject.org[xen-devel at lists.xenproject.org] for further analysis.