From owner-svn-doc-all@freebsd.org Sat May 23 12:31:38 2020 Return-Path: Delivered-To: svn-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 825AE2CA5F7; Sat, 23 May 2020 12:31:38 +0000 (UTC) (envelope-from bcr@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 "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 49TjQf2n2gz3g46; Sat, 23 May 2020 12:31:38 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 572FEFD65; Sat, 23 May 2020 12:31:38 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id 04NCVcd5048315; Sat, 23 May 2020 12:31:38 GMT (envelope-from bcr@FreeBSD.org) Received: (from bcr@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id 04NCVc16048314; Sat, 23 May 2020 12:31:38 GMT (envelope-from bcr@FreeBSD.org) Message-Id: <202005231231.04NCVc16048314@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: bcr set sender to bcr@FreeBSD.org using -f From: Benedict Reuschling Date: Sat, 23 May 2020 12:31:38 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r54178 - head/en_US.ISO8859-1/books/handbook/zfs X-SVN-Group: doc-head X-SVN-Commit-Author: bcr X-SVN-Commit-Paths: head/en_US.ISO8859-1/books/handbook/zfs X-SVN-Commit-Revision: 54178 X-SVN-Commit-Repository: doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.33 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 23 May 2020 12:31:38 -0000 Author: bcr Date: Sat May 23 12:31:37 2020 New Revision: 54178 URL: https://svnweb.freebsd.org/changeset/doc/54178 Log: 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 Modified: head/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/zfs/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Sat May 23 10:48:05 2020 (r54177) +++ head/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Sat May 23 12:31:37 2020 (r54178) @@ -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. + 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 + to + /home/bob. + Then, create the user and make the home directory point to + the dataset's location. This will + properly set owner and group permissions without shadowing any + pre-existing home directory paths that might exist. + To enforce a dataset quota of 10 GB for storage/home/bob: