[Bug 271384] zfs_load is not suitably documented

From: <bugzilla-noreply_at_freebsd.org>
Date: Sat, 13 May 2023 04:44:33 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=271384

Graham Perrin <grahamperrin@freebsd.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Assignee|bugs@FreeBSD.org            |doc@FreeBSD.org
             Blocks|                            |261212
           Keywords|                            |needs-patch
            Summary|zpool not imported if zfs   |zfs_load is not suitably
                   |isn't enabled in            |documented
                   |loader.conf                 |
                 CC|                            |fs@FreeBSD.org
            Product|Base System                 |Documentation
             Status|New                         |Open
              Flags|                            |maintainer-feedback?(fs@Fre
                   |                            |eBSD.org)
            Version|13.1-RELEASE                |Latest
          Component|misc                        |Books & Articles

--- Comment #1 from Graham Perrin <grahamperrin@freebsd.org> ---
zfs_load is mentioned obscurely under
<https://docs.freebsd.org/en/articles/remote-install/#_post_installation_steps>
in 'Remote Installation of the FreeBSD Operating System Without a Remote
Console', however: 

* it's nowhere in the FreeBSD Handbook.

We should document that zfs_load: 

* is automatically enabled (set to "YES") if ZFS is chosen when installing
FreeBSD

* can be manually enabled for atypical use cases, such as the one described in 
  comment 0

* must be "NO" when using the port of OpenZFS, i.e. sysutils/openzfs-kmod.


Also – maybe a question for fs@ – should zfs_load be mentioned in
loader.conf(5)?


----

<https://github.com/freebsd/freebsd-src/commit/6e15678a470671d454dba52e195c4167b8d63c06#diff-566a1b9d6ad5ce6df61a53416b8d7c690b67d0a53c667a1000a45042131f6e95R39>

<https://man.freebsd.org/cgi/man.cgi?query=loader.conf&sektion=5&manpath=freebsd-release>

<https://www.freshports.org/sysutils/openzfs-kmod/#message>


Referenced Bugs:

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=261212
[Bug 261212] Update the ZFS chapter of the FreeBSD Handbook, and other
OpenZFS-related pages
-- 
You are receiving this mail because:
You are the assignee for the bug.