From owner-dev-commits-doc-all@freebsd.org Fri Apr 16 00:44:45 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 4F96B5DECB1 for ; Fri, 16 Apr 2021 00:44:45 +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 4FLyCd1mfyz53gJ; Fri, 16 Apr 2021 00:44:45 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 2FB0F1B72F; Fri, 16 Apr 2021 00:44:45 +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 13G0ijeh070216; Fri, 16 Apr 2021 00:44:45 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13G0ijBa070215; Fri, 16 Apr 2021 00:44:45 GMT (envelope-from git) Date: Fri, 16 Apr 2021 00:44:45 GMT Message-Id: <202104160044.13G0ijBa070215@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: e29341eee0 - main - Do not recommend editing loader.conf(5) with sysrc(8) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: e29341eee0edbde6a0731d34a01cc0fb664be773 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 16 Apr 2021 00:44:45 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=e29341eee0edbde6a0731d34a01cc0fb664be773 commit e29341eee0edbde6a0731d34a01cc0fb664be773 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-16 00:39:45 +0000 Commit: Mateusz Piotrowski <0mp@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@FreeBSD.org[freebsd-xen@FreeBSD.org] and mailto:xen-devel@lists.xenproject.org[xen-devel@lists.xenproject.org] for further analysis.