From owner-svn-doc-projects@FreeBSD.ORG Sun Sep 29 15:07:47 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 9C442F91; Sun, 29 Sep 2013 15:07:47 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 706A02AC8; Sun, 29 Sep 2013 15:07:47 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r8TF7loi043594; Sun, 29 Sep 2013 15:07:47 GMT (envelope-from bcr@svn.freebsd.org) Received: (from bcr@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r8TF7ljW043593; Sun, 29 Sep 2013 15:07:47 GMT (envelope-from bcr@svn.freebsd.org) Message-Id: <201309291507.r8TF7ljW043593@svn.freebsd.org> From: Benedict Reuschling Date: Sun, 29 Sep 2013 15:07:47 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r42735 - projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs X-SVN-Group: doc-projects MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 29 Sep 2013 15:07:47 -0000 Author: bcr Date: Sun Sep 29 15:07:46 2013 New Revision: 42735 URL: http://svnweb.freebsd.org/changeset/doc/42735 Log: Provide a small example that shows how to augment a non-ZFS filesystem on a ZFS volume with ZFS features. Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml ============================================================================== --- projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Sun Sep 29 10:12:35 2013 (r42734) +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Sun Sep 29 15:07:46 2013 (r42735) @@ -531,6 +531,26 @@ errors: No known data errors Creating & Destroying Volumes + + A volume can be formatted with any filesystem on top of + it. This will appear to the user as if they are working with + that specific filesystem and not ZFS. This way, it can be + used to augment non-ZFS filesystems with ZFS features that + they do not have. For example, combining the ZFS compression + property together with a 250 MB volume allows to create a + compressed FAT filesystem. + + &prompt.root; zfs create -V 250m -o compression=on tank/fat32 +&prompt.root; zfs list tank +NAME USED AVAIL REFER MOUNTPOINT +tank 258M 670M 31K /tank +&prompt.root; newfs_msdos -F32 /dev/zvol/tank/fat32 +&prompt.root; mount -t msdosfs /dev/zvol/tank/fat32 /mnt +&prompt.root; df -h /mnt | grep fat32 +Filesystem Size Used Avail Capacity Mounted on +/dev/zvol/tank/fat32 249M 24k 249M 0% /mnt +&prompt.root; mount | grep fat32 +/dev/zvol/tank/fat32 on /mnt (msdosfs, local) @@ -544,7 +564,7 @@ errors: No known data errors - It is possible to set user-defined properties in ZFS. They + It is possible to set user-defined properties in ZFS. They become part of the pool configuration and can be used to provide additional information about the pool or it's contents. To distnguish these custom properties from the ones supplied by