From owner-svn-doc-projects@FreeBSD.ORG Thu Aug 15 01:04:54 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 BD6EAD7F; Thu, 15 Aug 2013 01:04:54 +0000 (UTC) (envelope-from wblock@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 AA1592704; Thu, 15 Aug 2013 01:04:54 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r7F14sKS055833; Thu, 15 Aug 2013 01:04:54 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r7F14snc055832; Thu, 15 Aug 2013 01:04:54 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201308150104.r7F14snc055832@svn.freebsd.org> From: Warren Block Date: Thu, 15 Aug 2013 01:04:54 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r42543 - 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: Thu, 15 Aug 2013 01:04:54 -0000 Author: wblock Date: Thu Aug 15 01:04:54 2013 New Revision: 42543 URL: http://svnweb.freebsd.org/changeset/doc/42543 Log: Fix IDs. 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 Wed Aug 14 23:34:16 2013 (r42542) +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Thu Aug 15 01:04:54 2013 (r42543) @@ -33,7 +33,7 @@ designed to prevent data write corruption and to overcome some of the limitations of hardware RAID. - + ZFS Features and Terminology ZFS is a fundamentally different file system because it @@ -58,7 +58,7 @@ zpool + id="zfs-term-zpool">zpool A storage pool is the most basic building block of ZFS. A pool is made up of one or more vdevs, the @@ -82,7 +82,7 @@ vdev Types + id="zfs-term-vdev">vdev Types A zpool is made up of one or more vdevs, which themselves can be a single disk or a group of disks, in @@ -92,7 +92,7 @@ - + Disk - The most basic type of vdev is a standard block device. This can be an entire disk (such as @@ -107,7 +107,7 @@ - + File - In addition to disks, ZFS pools can be backed by regular files, this is especially useful for testing and @@ -118,7 +118,7 @@ - + Mirror - When creating a mirror, specify the mirror keyword followed by the list of member devices @@ -133,13 +133,13 @@ regular single disk vdev can be upgraded to a mirror vdev at any time using the zpool attach + linkend="zfs-zpool-attach">attach command. - + RAID-Z - ZFS implements RAID-Z, a variation on standard RAID-5 that offers better distribution of parity @@ -183,7 +183,7 @@ - + Spare - ZFS has a special pseudo-vdev type for keeping track of available hot spares. Note that installed hot spares are @@ -193,7 +193,7 @@ - + Log - ZFS Log Devices, also known as ZFS Intent Log (ZIL) move the intent log from the regular pool @@ -214,7 +214,7 @@ - + Cache - Adding a cache vdev to a zpool will add the storage of the cache to the L2ARC. Cache devices cannot be mirrored. @@ -227,7 +227,7 @@ Adaptive Replacement + id="zfs-term-arc">Adaptive Replacement Cache (ARC) ZFS uses an Adaptive Replacement Cache @@ -260,7 +260,7 @@ L2ARC + id="zfs-term-l2arc">L2ARC The L2ARC is the second level of the ZFS caching system. The @@ -268,7 +268,7 @@ RAM, however since the amount of available RAM is often limited, ZFS can also make use of cache + linkend="zfs-term-vdev-cache">cache vdevs. Solid State Disks (SSDs) are often used as these cache devices due to their higher speed and lower latency compared to traditional spinning @@ -277,7 +277,7 @@ are cached on the SSD instead of having to be read from the regular spinning disks. The L2ARC can also speed up deduplication + linkend="zfs-term-deduplication">deduplication since a DDT that does not fit in RAM but does fit in the L2ARC will be much faster than if the @@ -299,7 +299,7 @@ Copy-On-Write + id="zfs-term-cow">Copy-On-Write Unlike a traditional file system, when data is overwritten on ZFS the new data is written to a @@ -316,7 +316,7 @@ Dataset + id="zfs-term-dataset">Dataset Dataset is the generic term for a ZFS file system, volume, snapshot or clone. Each dataset will have a @@ -338,7 +338,7 @@ Volume + id="zfs-term-volum">Volume In additional to regular file system datasets, ZFS can also create volumes, which are block devices. @@ -352,10 +352,10 @@ Snapshot + id="zfs-term-snapshot">Snapshot The copy-on-write + linkend="zfs-term-cow">copy-on-write design of ZFS allows for nearly instantaneous consistent snapshots with arbitrary names. After taking a snapshot @@ -373,7 +373,7 @@ These snapshots can be mounted (read only) to allow for the recovery of previous versions of files. It is also possible to rollback + linkend="zfs-zfs-snapshot">rollback a live file system to a specific snapshot, undoing any changes that took place after the snapshot was taken. Each block in the zpool has a reference counter which @@ -382,11 +382,11 @@ are deleted, the reference count is decremented; once a block is no longer referenced, it is reclaimed as free space. Snapshots can also be marked with a hold, + linkend="zfs-zfs-snapshot">hold, once a snapshot is held, any attempt to destroy it will return an EBUY error. Each snapshot can have multiple holds, each with a unique name. The release + linkend="zfs-zfs-snapshot">release command removes the hold so the snapshot can then be deleted. Snapshots can be taken on volumes, however they can only be cloned or rolled back, not mounted @@ -395,7 +395,7 @@ Clone + id="zfs-term-clone">Clone Snapshots can also be cloned; a clone is a writable version of a snapshot, allowing the file system to be @@ -417,7 +417,7 @@ Checksum + id="zfs-term-checksum">Checksum Every block that is allocated is also checksummed (which algorithm is used is a per dataset property, see: @@ -427,7 +427,7 @@ expected checksum, ZFS will attempt to recover the data from any available redundancy (mirrors, RAID-Z). You can trigger the validation of all checksums using the - scrub + scrub command. The available checksum algorithms include: @@ -452,7 +452,7 @@ Compression + id="zfs-term-compression">Compression Each dataset in ZFS has a compression property, which defaults to off. This property can be set to one @@ -471,7 +471,7 @@ Deduplication + id="zfs-term-deduplication">Deduplication ZFS has the ability to detect duplicate blocks of data as they are written (thanks to the checksumming @@ -511,7 +511,7 @@ Scrub + id="zfs-term-scrub">Scrub In place of a consistency check like fsck, ZFS has the scrub command, which reads all @@ -530,7 +530,7 @@ Dataset Quota + id="zfs-term-quota">Dataset Quota ZFS provides very fast and accurate dataset, user and group space accounting in addition to quotes and @@ -541,11 +541,11 @@ ZFS supports different types of quotas: the dataset quota, the reference + linkend="zfs-term-refquota">reference quota (refquota), the - user + user quota, and the - group + group quota. Quotas limit the amount of space that a dataset @@ -562,7 +562,7 @@ Reference + id="zfs-term-refquota">Reference Quota A reference quota limits the amount of space a @@ -575,7 +575,7 @@ User + id="zfs-term-userquota">User Quota User quotas are useful to limit the amount of space @@ -584,7 +584,7 @@ Group + id="zfs-term-groupquota">Group Quota The group quota limits the amount of space that a @@ -593,7 +593,7 @@ Dataset + id="zfs-term-reservation">Dataset Reservation The reservation property makes @@ -607,7 +607,7 @@ storage/home/bob, the space used by that snapshot is counted against the reservation. The refreservation + linkend="zfs-term-refreservation">refreservation property works in a similar way, except it excludes descendants, such as snapshots. @@ -622,7 +622,7 @@ Reference + id="zfs-term-refreservation">Reference Reservation The refreservation property @@ -634,7 +634,7 @@ dataset tries to use all of the free space, at least 10 GB of space is reserved for this dataset. In contrast to a regular reservation, + linkend="zfs-term-reservation">reservation, space used by snapshots and decendant datasets is not counted against the reservation. As an example, if a snapshot was taken of @@ -649,7 +649,7 @@ Resilver + id="zfs-term-resilver">Resilver When a disk fails and must be replaced, the new disk must be filled with the data that was lost. This @@ -663,7 +663,7 @@ - + What Makes ZFS Different ZFS is significantly different from any previous file system @@ -694,7 +694,7 @@ than a single monolithic filesystem. - + <acronym>ZFS</acronym> Quick Start Guide There is a start up mechanism that allows &os; to mount @@ -1071,108 +1071,108 @@ errors: No known data errors - + <command>zpool</command> Administration - + Creating & Destroying Storage Pools - + Adding & Removing Devices - + Dealing with Failed Devices - + Importing & Exporting Pools - + Upgrading a Storage Pool - + Checking the Status of a Pool - + Performance Monitoring - + Splitting a Storage Pool - + <command>zfs</command> Administration - + Creating & Destroying Datasets - + Creating & Destroying Volumes - + Renaming a Dataset - + Setting Dataset Properties - + Managing Snapshots - + Managing Clones - + ZFS Replication - + Dataset, User and Group Quotes To enforce a dataset quota of 10 GB for @@ -1276,7 +1276,7 @@ errors: No known data errors &prompt.root; zfs get quota storage/home/bob - + Reservations @@ -1307,53 +1307,53 @@ errors: No known data errors &prompt.root; zfs get refreservation storage/home/bob - + Compression - + Deduplication - + Delegated Administration - + ZFS Advanced Topics - + ZFS Tuning - + Booting Root on ZFS - + ZFS Boot Environments - + Troubleshooting - + ZFS on i386 Some of the features provided by ZFS @@ -1417,7 +1417,7 @@ vfs.zfs.vdev.cache.size="5M" - + Additional Resources