maintainer-feedback requested: [Bug 271384] zfs_load is not suitably documented

Graham Perrin <grahamperrin@freebsd.org> has asked freebsd-fs (Nobody)
<fs@FreeBSD.org> for maintainer-feedback:
Bug 271384: zfs_load is not suitably documented
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=271384



--- 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/6e15678a470671d454dba52e195c4167
b8d63c06#diff-566a1b9d6ad5ce6df61a53416b8d7c690b67d0a53c667a1000a45042131f6e95R
39>

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

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