path: root/en_US.ISO8859-1/books/handbook/zfs
diff options
authorBenedict Reuschling <bcr@FreeBSD.org>2020-05-23 12:31:37 +0000
committerBenedict Reuschling <bcr@FreeBSD.org>2020-05-23 12:31:37 +0000
commitdcbe4e87a2348d1f6ef38f4e5b7fcbe675afce3d (patch)
tree00bdd7e7596ba157355322753c413b3b45c09f6e /en_US.ISO8859-1/books/handbook/zfs
parent2b0ad06063274ab62bd16911ada43cca3ea748b3 (diff)
Add explanation to the ZFS quota examples about /home.
The ZFS quota examples started with setting quotas for a user that was not created in the chapter. This led to some confusion for (new) people who tried out the example and got an error message about the missing user. Add a small paragraph to explain this concept and that ideally, when creating a user, the /home dataset should be created first to not shadow it afterwards. PR: 177514 Submitted by: Bryan Bosworth Reviewed by: noone (5 day review timeout) Differential Revision: https://reviews.freebsd.org/D24913
Notes: svn path=/head/; revision=54178
Diffstat (limited to 'en_US.ISO8859-1/books/handbook/zfs')
1 files changed, 10 insertions, 0 deletions
diff --git a/en_US.ISO8859-1/books/handbook/zfs/chapter.xml b/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
index 330bd1959d..7d21a5d6e3 100644
--- a/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
@@ -2716,6 +2716,16 @@ vfs.usermount: 0 -> 1
used to prevent users or groups from using all of the
space in the pool or dataset.</para>
+ <para>The following examples assume that the users already
+ exist in the system. Before adding a user to the system,
+ make sure to create their home dataset first and set the
+ <option>mountpoint</option> to
+ <literal>/home/<replaceable>bob</replaceable></literal>.
+ Then, create the user and make the home directory point to
+ the dataset's <option>mountpoint</option> location. This will
+ properly set owner and group permissions without shadowing any
+ pre-existing home directory paths that might exist.</para>
<para>To enforce a dataset quota of 10&nbsp;GB for