[Bug 263232] FreeBSD Handbook: potentially confusing descriptions of UFS and GELI

From: <bugzilla-noreply_at_freebsd.org>
Date: Tue, 12 Apr 2022 04:44:35 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=263232

--- Comment #1 from Graham Perrin <grahamperrin@gmail.com> ---
Maybe better, for
<https://github.com/freebsd/freebsd-doc/blob/main/documentation/content/en/books/handbook/bsdinstall/_index.adoc#6-allocating-disk-space>: 

> * Auto (UFS) uses UFS for the file system within the system partition.
> 
> * …
> 
> * …
> 
> * Auto (ZFS) uses ZFS for file systems within the system partition.
> 
> The two automatic options allow use of GELI (not ZFS) to encrypt swap and 
> system partitions. For more information about GELI, see …

– and bring forward the 'more info' blurb that's currently under
<https://github.com/freebsd/freebsd-doc/blob/main/documentation/content/en/books/handbook/bsdinstall/_index.adoc#64-guided-partitioning-using-root-on-zfs>. 

----

<https://github.com/freebsd/freebsd-doc/blob/main/documentation/content/en/books/handbook/bsdinstall/_index.adoc#85-add-users>
should include something like this: 

> If you intend to use OpenZFS encryption for any user's home directory, 
> refrain from adding the user at this stage. 

From
<https://openzfs.github.io/openzfs-docs/man/8/zfs-load-key.8.html#Encryption>: 

> … Creating an encrypted dataset requires specifying the encryption and keyformat properties 
> at creation time, …

– at, not after. The installer uses adduser(8), which does not yet support
this. 

<https://www.freebsd.org/cgi/man.cgi?query=adduser&sektion=8&manpath=FreeBSD>

-- 
You are receiving this mail because:
You are the assignee for the bug.