diff options
Diffstat (limited to 'documentation/content/en/books/handbook/zfs/_index.po')
| -rw-r--r-- | documentation/content/en/books/handbook/zfs/_index.po | 1176 |
1 files changed, 588 insertions, 588 deletions
diff --git a/documentation/content/en/books/handbook/zfs/_index.po b/documentation/content/en/books/handbook/zfs/_index.po index 4ad7261726..e322e0de16 100644 --- a/documentation/content/en/books/handbook/zfs/_index.po +++ b/documentation/content/en/books/handbook/zfs/_index.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2023-01-21 20:00-0300\n" +"POT-Creation-Date: 2023-04-20 20:56-0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -35,32 +35,32 @@ msgid "Chapter 21. The Z File System (ZFS)" msgstr "" #. type: Title = -#: documentation/content/en/books/handbook/zfs/_index.adoc:15 +#: documentation/content/en/books/handbook/zfs/_index.adoc:14 #, no-wrap msgid "The Z File System (ZFS)" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:53 +#: documentation/content/en/books/handbook/zfs/_index.adoc:52 msgid "" "ZFS is an advanced file system designed to solve major problems found in " "previous storage subsystem software." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:55 +#: documentation/content/en/books/handbook/zfs/_index.adoc:54 msgid "" "Originally developed at Sun(TM), ongoing open source ZFS development has " "moved to the http://open-zfs.org[OpenZFS Project]." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:57 +#: documentation/content/en/books/handbook/zfs/_index.adoc:56 msgid "ZFS has three major design goals:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:59 +#: documentation/content/en/books/handbook/zfs/_index.adoc:58 msgid "" "Data integrity: All data includes a <<zfs-term-checksum,checksum>> of the " "data. ZFS calculates checksums and writes them along with the data. When " @@ -71,7 +71,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:60 +#: documentation/content/en/books/handbook/zfs/_index.adoc:59 msgid "" "Pooled storage: adding physical storage devices to a pool, and allocating " "storage space from that shared pool. Space is available to all file systems " @@ -79,7 +79,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:61 +#: documentation/content/en/books/handbook/zfs/_index.adoc:60 msgid "" "Performance: caching mechanisms provide increased performance. <<zfs-term-" "arc,ARC>> is an advanced memory-based read cache. ZFS provides a second " @@ -88,18 +88,18 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:63 +#: documentation/content/en/books/handbook/zfs/_index.adoc:62 msgid "A complete list of features and terminology is in <<zfs-term>>." msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/zfs/_index.adoc:65 +#: documentation/content/en/books/handbook/zfs/_index.adoc:64 #, no-wrap msgid "What Makes ZFS Different" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:78 +#: documentation/content/en/books/handbook/zfs/_index.adoc:77 msgid "" "More than a file system, ZFS is fundamentally different from traditional " "file systems. Combining the traditionally separate roles of volume manager " @@ -123,37 +123,37 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/zfs/_index.adoc:80 +#: documentation/content/en/books/handbook/zfs/_index.adoc:79 #, no-wrap msgid "Quick Start Guide" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:84 +#: documentation/content/en/books/handbook/zfs/_index.adoc:83 msgid "" "FreeBSD can mount ZFS pools and datasets during system initialization. To " "enable it, add this line to [.filename]#/etc/rc.conf#:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:88 +#: documentation/content/en/books/handbook/zfs/_index.adoc:87 #, no-wrap msgid "zfs_enable=\"YES\"\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:91 +#: documentation/content/en/books/handbook/zfs/_index.adoc:90 msgid "Then start the service:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:95 +#: documentation/content/en/books/handbook/zfs/_index.adoc:94 #, no-wrap msgid "# service zfs start\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:99 +#: documentation/content/en/books/handbook/zfs/_index.adoc:98 msgid "" "The examples in this section assume three SCSI disks with the device names [." "filename]#da0#, [.filename]#da1#, and [.filename]#da2#. Users of SATA " @@ -161,29 +161,29 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:101 +#: documentation/content/en/books/handbook/zfs/_index.adoc:100 #, no-wrap msgid "Single Disk Pool" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:104 +#: documentation/content/en/books/handbook/zfs/_index.adoc:103 msgid "To create a simple, non-redundant pool using a single disk device:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:108 +#: documentation/content/en/books/handbook/zfs/_index.adoc:107 #, no-wrap msgid "# zpool create example /dev/da0\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:111 +#: documentation/content/en/books/handbook/zfs/_index.adoc:110 msgid "To view the new pool, review the output of `df`:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:120 +#: documentation/content/en/books/handbook/zfs/_index.adoc:119 #, no-wrap msgid "" "# df\n" @@ -195,14 +195,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:124 +#: documentation/content/en/books/handbook/zfs/_index.adoc:123 msgid "" "This output shows creating and mounting of the `example` pool, and that is " "now accessible as a file system. Create files for users to browse:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:135 +#: documentation/content/en/books/handbook/zfs/_index.adoc:134 #, no-wrap msgid "" "# cd /example\n" @@ -216,14 +216,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:139 +#: documentation/content/en/books/handbook/zfs/_index.adoc:138 msgid "" "This pool is not using any advanced ZFS features and properties yet. To " "create a dataset on this pool with compression enabled:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:144 +#: documentation/content/en/books/handbook/zfs/_index.adoc:143 #, no-wrap msgid "" "# zfs create example/compressed\n" @@ -231,30 +231,30 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:148 +#: documentation/content/en/books/handbook/zfs/_index.adoc:147 msgid "" "The `example/compressed` dataset is now a ZFS compressed file system. Try " "copying some large files to [.filename]#/example/compressed#." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:150 +#: documentation/content/en/books/handbook/zfs/_index.adoc:149 msgid "Disable compression with:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:154 +#: documentation/content/en/books/handbook/zfs/_index.adoc:153 #, no-wrap msgid "# zfs set compression=off example/compressed\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:157 +#: documentation/content/en/books/handbook/zfs/_index.adoc:156 msgid "To unmount a file system, use `zfs umount` and then verify with `df`:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:167 +#: documentation/content/en/books/handbook/zfs/_index.adoc:166 #, no-wrap msgid "" "# zfs umount example/compressed\n" @@ -267,14 +267,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:170 +#: documentation/content/en/books/handbook/zfs/_index.adoc:169 msgid "" "To re-mount the file system to make it accessible again, use `zfs mount` and " "verify with `df`:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:181 +#: documentation/content/en/books/handbook/zfs/_index.adoc:180 #, no-wrap msgid "" "# zfs mount example/compressed\n" @@ -288,12 +288,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:184 +#: documentation/content/en/books/handbook/zfs/_index.adoc:183 msgid "Running `mount` shows the pool and file systems:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:193 +#: documentation/content/en/books/handbook/zfs/_index.adoc:192 #, no-wrap msgid "" "# mount\n" @@ -305,7 +305,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:199 +#: documentation/content/en/books/handbook/zfs/_index.adoc:198 msgid "" "Use ZFS datasets like any file system after creation. Set other available " "features on a per-dataset basis when needed. The example below creates a " @@ -314,7 +314,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:204 +#: documentation/content/en/books/handbook/zfs/_index.adoc:203 #, no-wrap msgid "" "# zfs create example/data\n" @@ -322,12 +322,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:207 +#: documentation/content/en/books/handbook/zfs/_index.adoc:206 msgid "Use `df` to see the data and space usage:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:218 +#: documentation/content/en/books/handbook/zfs/_index.adoc:217 #, no-wrap msgid "" "# df\n" @@ -341,7 +341,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:223 +#: documentation/content/en/books/handbook/zfs/_index.adoc:222 msgid "" "Notice that all file systems in the pool have the same available space. " "Using `df` in these examples shows that the file systems use the space they " @@ -351,12 +351,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:225 +#: documentation/content/en/books/handbook/zfs/_index.adoc:224 msgid "To destroy the file systems and then the pool that is no longer needed:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:231 +#: documentation/content/en/books/handbook/zfs/_index.adoc:230 #, no-wrap msgid "" "# zfs destroy example/compressed\n" @@ -365,13 +365,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:234 +#: documentation/content/en/books/handbook/zfs/_index.adoc:233 #, no-wrap msgid "RAID-Z" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:240 +#: documentation/content/en/books/handbook/zfs/_index.adoc:239 msgid "" "Disks fail. One way to avoid data loss from disk failure is to use RAID. " "ZFS supports this feature in its pool design. RAID-Z pools require three or " @@ -379,19 +379,19 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:242 +#: documentation/content/en/books/handbook/zfs/_index.adoc:241 msgid "" "This example creates a RAID-Z pool, specifying the disks to add to the pool:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:246 +#: documentation/content/en/books/handbook/zfs/_index.adoc:245 #, no-wrap msgid "# zpool create storage raidz da0 da1 da2\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:254 +#: documentation/content/en/books/handbook/zfs/_index.adoc:253 msgid "" "Sun(TM) recommends that the number of devices used in a RAID-Z configuration " "be between three and nine. For environments requiring a single pool " @@ -401,25 +401,25 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:258 +#: documentation/content/en/books/handbook/zfs/_index.adoc:257 msgid "" "The previous example created the `storage` zpool. This example makes a new " "file system called `home` in that pool:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:262 +#: documentation/content/en/books/handbook/zfs/_index.adoc:261 #, no-wrap msgid "# zfs create storage/home\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:265 +#: documentation/content/en/books/handbook/zfs/_index.adoc:264 msgid "Enable compression and store an extra copy of directories and files:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:270 +#: documentation/content/en/books/handbook/zfs/_index.adoc:269 #, no-wrap msgid "" "# zfs set copies=2 storage/home\n" @@ -427,14 +427,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:273 +#: documentation/content/en/books/handbook/zfs/_index.adoc:272 msgid "" "To make this the new home directory for users, copy the user data to this " "directory and create the appropriate symbolic links:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:280 +#: documentation/content/en/books/handbook/zfs/_index.adoc:279 #, no-wrap msgid "" "# cp -rp /home/* /storage/home\n" @@ -444,30 +444,30 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:284 +#: documentation/content/en/books/handbook/zfs/_index.adoc:283 msgid "" "Users data is now stored on the freshly-created [.filename]#/storage/home#. " "Test by adding a new user and logging in as that user." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:286 +#: documentation/content/en/books/handbook/zfs/_index.adoc:285 msgid "Create a file system snapshot to roll back to later:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:290 +#: documentation/content/en/books/handbook/zfs/_index.adoc:289 #, no-wrap msgid "# zfs snapshot storage/home@08-30-08\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:293 +#: documentation/content/en/books/handbook/zfs/_index.adoc:292 msgid "ZFS creates snapshots of a dataset, not a single directory or file." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:296 +#: documentation/content/en/books/handbook/zfs/_index.adoc:295 msgid "" "The `@` character is a delimiter between the file system name or the volume " "name. Before deleting an important directory, back up the file system, then " @@ -475,26 +475,26 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:300 +#: documentation/content/en/books/handbook/zfs/_index.adoc:299 #, no-wrap msgid "# zfs rollback storage/home@08-30-08\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:304 +#: documentation/content/en/books/handbook/zfs/_index.adoc:303 msgid "" "To list all available snapshots, run `ls` in the file system's [.filename]#." "zfs/snapshot# directory. For example, to see the snapshot taken:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:308 +#: documentation/content/en/books/handbook/zfs/_index.adoc:307 #, no-wrap msgid "# ls /storage/home/.zfs/snapshot\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:313 +#: documentation/content/en/books/handbook/zfs/_index.adoc:312 msgid "" "Write a script to take regular snapshots of user data. Over time, snapshots " "can use up a lot of disk space. Remove the previous snapshot using the " @@ -502,33 +502,33 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:317 +#: documentation/content/en/books/handbook/zfs/_index.adoc:316 #, no-wrap msgid "# zfs destroy storage/home@08-30-08\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:321 +#: documentation/content/en/books/handbook/zfs/_index.adoc:320 msgid "" "After testing, make [.filename]#/storage/home# the real [.filename]#/home# " "with this command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:325 +#: documentation/content/en/books/handbook/zfs/_index.adoc:324 #, no-wrap msgid "# zfs set mountpoint=/home storage/home\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:328 +#: documentation/content/en/books/handbook/zfs/_index.adoc:327 msgid "" "Run `df` and `mount` to confirm that the system now treats the file system " "as the real [.filename]#/home#:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:344 +#: documentation/content/en/books/handbook/zfs/_index.adoc:343 #, no-wrap msgid "" "# mount\n" @@ -547,7 +547,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:348 +#: documentation/content/en/books/handbook/zfs/_index.adoc:347 msgid "" "This completes the RAID-Z configuration. Add daily status updates about the " "created file systems to the nightly man:periodic[8] runs by adding this line " @@ -555,52 +555,52 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:352 +#: documentation/content/en/books/handbook/zfs/_index.adoc:351 #, no-wrap msgid "daily_status_zfs_enable=\"YES\"\n" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:355 +#: documentation/content/en/books/handbook/zfs/_index.adoc:354 #, no-wrap msgid "Recovering RAID-Z" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:359 +#: documentation/content/en/books/handbook/zfs/_index.adoc:358 msgid "" "Every software RAID has a method of monitoring its `state`. View the status " "of RAID-Z devices using:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:363 +#: documentation/content/en/books/handbook/zfs/_index.adoc:362 #, no-wrap msgid "# zpool status -x\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:366 +#: documentation/content/en/books/handbook/zfs/_index.adoc:365 msgid "" "If all pools are <<zfs-term-online,Online>> and everything is normal, the " "message shows:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:370 +#: documentation/content/en/books/handbook/zfs/_index.adoc:369 #, no-wrap msgid "all pools are healthy\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:373 +#: documentation/content/en/books/handbook/zfs/_index.adoc:372 msgid "" "If there is a problem, perhaps a disk being in the <<zfs-term-offline," "Offline>> state, the pool state will look like this:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:385 +#: documentation/content/en/books/handbook/zfs/_index.adoc:384 #, no-wrap msgid "" " pool: storage\n" @@ -615,7 +615,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:392 +#: documentation/content/en/books/handbook/zfs/_index.adoc:391 #, no-wrap msgid "" "\tNAME STATE READ WRITE CKSUM\n" @@ -627,60 +627,60 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:394 -#: documentation/content/en/books/handbook/zfs/_index.adoc:429 -#: documentation/content/en/books/handbook/zfs/_index.adoc:475 -#: documentation/content/en/books/handbook/zfs/_index.adoc:518 -#: documentation/content/en/books/handbook/zfs/_index.adoc:541 -#: documentation/content/en/books/handbook/zfs/_index.adoc:573 -#: documentation/content/en/books/handbook/zfs/_index.adoc:652 -#: documentation/content/en/books/handbook/zfs/_index.adoc:706 -#: documentation/content/en/books/handbook/zfs/_index.adoc:743 -#: documentation/content/en/books/handbook/zfs/_index.adoc:772 -#: documentation/content/en/books/handbook/zfs/_index.adoc:852 -#: documentation/content/en/books/handbook/zfs/_index.adoc:925 -#: documentation/content/en/books/handbook/zfs/_index.adoc:956 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1056 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1100 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1125 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1145 +#: documentation/content/en/books/handbook/zfs/_index.adoc:393 +#: documentation/content/en/books/handbook/zfs/_index.adoc:428 +#: documentation/content/en/books/handbook/zfs/_index.adoc:474 +#: documentation/content/en/books/handbook/zfs/_index.adoc:517 +#: documentation/content/en/books/handbook/zfs/_index.adoc:540 +#: documentation/content/en/books/handbook/zfs/_index.adoc:572 +#: documentation/content/en/books/handbook/zfs/_index.adoc:651 +#: documentation/content/en/books/handbook/zfs/_index.adoc:705 +#: documentation/content/en/books/handbook/zfs/_index.adoc:742 +#: documentation/content/en/books/handbook/zfs/_index.adoc:771 +#: documentation/content/en/books/handbook/zfs/_index.adoc:851 +#: documentation/content/en/books/handbook/zfs/_index.adoc:924 +#: documentation/content/en/books/handbook/zfs/_index.adoc:955 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1055 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1099 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1124 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1144 #, no-wrap msgid "errors: No known data errors\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:397 +#: documentation/content/en/books/handbook/zfs/_index.adoc:396 msgid "" "\"OFFLINE\" shows the administrator took [.filename]#da1# offline using:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:401 +#: documentation/content/en/books/handbook/zfs/_index.adoc:400 #, no-wrap msgid "# zpool offline storage da1\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:405 +#: documentation/content/en/books/handbook/zfs/_index.adoc:404 msgid "" "Power down the computer now and replace [.filename]#da1#. Power up the " "computer and return [.filename]#da1# to the pool:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:409 +#: documentation/content/en/books/handbook/zfs/_index.adoc:408 #, no-wrap msgid "# zpool replace storage da1\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:412 +#: documentation/content/en/books/handbook/zfs/_index.adoc:411 msgid "" "Next, check the status again, this time without `-x` to display all pools:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:420 +#: documentation/content/en/books/handbook/zfs/_index.adoc:419 #, no-wrap msgid "" "# zpool status storage\n" @@ -691,8 +691,8 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:427 -#: documentation/content/en/books/handbook/zfs/_index.adoc:473 +#: documentation/content/en/books/handbook/zfs/_index.adoc:426 +#: documentation/content/en/books/handbook/zfs/_index.adoc:472 #, no-wrap msgid "" "\tNAME STATE READ WRITE CKSUM\n" @@ -704,25 +704,25 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:432 +#: documentation/content/en/books/handbook/zfs/_index.adoc:431 msgid "In this example, everything is normal." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:434 +#: documentation/content/en/books/handbook/zfs/_index.adoc:433 #, no-wrap msgid "Data Verification" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:438 +#: documentation/content/en/books/handbook/zfs/_index.adoc:437 msgid "" "ZFS uses checksums to verify the integrity of stored data. Creating file " "systems automatically enables them." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:445 +#: documentation/content/en/books/handbook/zfs/_index.adoc:444 msgid "" "Disabling Checksums is possible but _not_ recommended! Checksums take little " "storage space and provide data integrity. Most ZFS features will not work " @@ -731,20 +731,20 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:448 +#: documentation/content/en/books/handbook/zfs/_index.adoc:447 msgid "" "Verifying the data checksums (called _scrubbing_) ensures integrity of the " "`storage` pool with:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:452 +#: documentation/content/en/books/handbook/zfs/_index.adoc:451 #, no-wrap msgid "# zpool scrub storage\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:458 +#: documentation/content/en/books/handbook/zfs/_index.adoc:457 msgid "" "The duration of a scrub depends on the amount of data stored. Larger " "amounts of data will take proportionally longer to verify. Since scrubbing " @@ -753,7 +753,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:466 +#: documentation/content/en/books/handbook/zfs/_index.adoc:465 #, no-wrap msgid "" "# zpool status storage\n" @@ -764,7 +764,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:479 +#: documentation/content/en/books/handbook/zfs/_index.adoc:478 msgid "" "Displaying the completion date of the last scrubbing helps decide when to " "start another. Routine scrubs help protect data from silent corruption and " @@ -772,18 +772,18 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:481 +#: documentation/content/en/books/handbook/zfs/_index.adoc:480 msgid "Refer to man:zfs[8] and man:zpool[8] for other ZFS options." msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/zfs/_index.adoc:483 +#: documentation/content/en/books/handbook/zfs/_index.adoc:482 #, no-wrap msgid "`zpool` Administration" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:488 +#: documentation/content/en/books/handbook/zfs/_index.adoc:487 msgid "" "ZFS administration uses two main utilities. The `zpool` utility controls " "the operation of the pool and allows adding, removing, replacing, and " @@ -793,13 +793,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:490 +#: documentation/content/en/books/handbook/zfs/_index.adoc:489 #, no-wrap msgid "Creating and Destroying Storage Pools" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:499 +#: documentation/content/en/books/handbook/zfs/_index.adoc:498 msgid "" "Creating a ZFS storage pool requires permanent decisions, as the pool " "structure cannot change after creation. The most important decision is " @@ -814,12 +814,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:501 +#: documentation/content/en/books/handbook/zfs/_index.adoc:500 msgid "Create a simple mirror pool:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:510 +#: documentation/content/en/books/handbook/zfs/_index.adoc:509 #, no-wrap msgid "" "# zpool create mypool mirror /dev/ada1 /dev/ada2\n" @@ -831,7 +831,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:516 +#: documentation/content/en/books/handbook/zfs/_index.adoc:515 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" @@ -842,14 +842,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:521 +#: documentation/content/en/books/handbook/zfs/_index.adoc:520 msgid "" "To create more than one vdev with a single command, specify groups of disks " "separated by the vdev type keyword, `mirror` in this example:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:530 +#: documentation/content/en/books/handbook/zfs/_index.adoc:529 #, no-wrap msgid "" "# zpool create mypool mirror /dev/ada1 /dev/ada2 mirror /dev/ada3 /dev/ada4\n" @@ -861,7 +861,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:539 +#: documentation/content/en/books/handbook/zfs/_index.adoc:538 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" @@ -875,7 +875,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:550 +#: documentation/content/en/books/handbook/zfs/_index.adoc:549 msgid "" "Pools can also use partitions rather than whole disks. Putting ZFS in a " "separate partition allows the same disk to have other partitions for other " @@ -890,12 +890,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:552 +#: documentation/content/en/books/handbook/zfs/_index.adoc:551 msgid "Create a <<zfs-term-vdev-raidz,RAID-Z2>> pool using partitions:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:561 +#: documentation/content/en/books/handbook/zfs/_index.adoc:560 #, no-wrap msgid "" "# zpool create mypool raidz2 /dev/ada0p3 /dev/ada1p3 /dev/ada2p3 /dev/ada3p3 /dev/ada4p3 /dev/ada5p3\n" @@ -907,9 +907,9 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:571 -#: documentation/content/en/books/handbook/zfs/_index.adoc:770 -#: documentation/content/en/books/handbook/zfs/_index.adoc:954 +#: documentation/content/en/books/handbook/zfs/_index.adoc:570 +#: documentation/content/en/books/handbook/zfs/_index.adoc:769 +#: documentation/content/en/books/handbook/zfs/_index.adoc:953 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" @@ -924,7 +924,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:580 +#: documentation/content/en/books/handbook/zfs/_index.adoc:579 msgid "" "Destroy a pool that is no longer needed to reuse the disks. Destroying a " "pool requires unmounting the file systems in that pool first. If any " @@ -934,13 +934,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:582 +#: documentation/content/en/books/handbook/zfs/_index.adoc:581 #, no-wrap msgid "Adding and Removing Devices" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:586 +#: documentation/content/en/books/handbook/zfs/_index.adoc:585 msgid "" "Two ways exist for adding disks to a pool: attaching a disk to an existing " "vdev with `zpool attach`, or adding vdevs to the pool with `zpool add`. " @@ -949,7 +949,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:595 +#: documentation/content/en/books/handbook/zfs/_index.adoc:594 msgid "" "A pool created with a single disk lacks redundancy. It can detect " "corruption but can not repair it, because there is no other copy of the " @@ -964,15 +964,15 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:597 +#: documentation/content/en/books/handbook/zfs/_index.adoc:596 msgid "" "Upgrade the single disk (stripe) vdev [.filename]#ada0p3# to a mirror by " "attaching [.filename]#ada1p3#:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:605 -#: documentation/content/en/books/handbook/zfs/_index.adoc:802 +#: documentation/content/en/books/handbook/zfs/_index.adoc:604 +#: documentation/content/en/books/handbook/zfs/_index.adoc:801 #, no-wrap msgid "" "# zpool status\n" @@ -983,7 +983,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:609 +#: documentation/content/en/books/handbook/zfs/_index.adoc:608 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" @@ -992,7 +992,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:613 +#: documentation/content/en/books/handbook/zfs/_index.adoc:612 #, no-wrap msgid "" "errors: No known data errors\n" @@ -1001,19 +1001,19 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:615 +#: documentation/content/en/books/handbook/zfs/_index.adoc:614 #, no-wrap msgid "If you boot from pool 'mypool', you may need to update boot code on newly attached disk _ada1p3_.\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:617 +#: documentation/content/en/books/handbook/zfs/_index.adoc:616 #, no-wrap msgid "Assuming you use GPT partitioning and _da0_ is your new boot disk you may use the following command:\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:631 +#: documentation/content/en/books/handbook/zfs/_index.adoc:630 #, no-wrap msgid "" " gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 da0\n" @@ -1032,7 +1032,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:637 +#: documentation/content/en/books/handbook/zfs/_index.adoc:636 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" @@ -1043,7 +1043,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:644 +#: documentation/content/en/books/handbook/zfs/_index.adoc:643 #, no-wrap msgid "" "errors: No known data errors\n" @@ -1055,10 +1055,10 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:650 -#: documentation/content/en/books/handbook/zfs/_index.adoc:683 -#: documentation/content/en/books/handbook/zfs/_index.adoc:741 -#: documentation/content/en/books/handbook/zfs/_index.adoc:808 +#: documentation/content/en/books/handbook/zfs/_index.adoc:649 +#: documentation/content/en/books/handbook/zfs/_index.adoc:682 +#: documentation/content/en/books/handbook/zfs/_index.adoc:740 +#: documentation/content/en/books/handbook/zfs/_index.adoc:807 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" @@ -1069,7 +1069,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:660 +#: documentation/content/en/books/handbook/zfs/_index.adoc:659 msgid "" "When adding disks to the existing vdev is not an option, as for RAID-Z, an " "alternative method is to add another vdev to the pool. Adding vdevs " @@ -1082,7 +1082,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:665 +#: documentation/content/en/books/handbook/zfs/_index.adoc:664 msgid "" "ZFS stripes data across each of the vdevs. For example, with two mirror " "vdevs, this is effectively a RAID 10 that stripes writes across two sets of " @@ -1092,20 +1092,20 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:667 +#: documentation/content/en/books/handbook/zfs/_index.adoc:666 msgid "" "When attaching new devices to a boot pool, remember to update the bootcode." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:669 +#: documentation/content/en/books/handbook/zfs/_index.adoc:668 msgid "" "Attach a second mirror group ([.filename]#ada2p3# and [.filename]#ada3p3#) " "to the existing mirror:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:677 +#: documentation/content/en/books/handbook/zfs/_index.adoc:676 #, no-wrap msgid "" "# zpool status\n" @@ -1116,7 +1116,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:695 +#: documentation/content/en/books/handbook/zfs/_index.adoc:694 #, no-wrap msgid "" "errors: No known data errors\n" @@ -1133,7 +1133,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:704 +#: documentation/content/en/books/handbook/zfs/_index.adoc:703 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" @@ -1147,7 +1147,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:710 +#: documentation/content/en/books/handbook/zfs/_index.adoc:709 msgid "" "Removing vdevs from a pool is impossible and removal of disks from a mirror " "is exclusive if there is enough remaining redundancy. If a single disk " @@ -1156,12 +1156,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:712 +#: documentation/content/en/books/handbook/zfs/_index.adoc:711 msgid "Remove a disk from a three-way mirror group:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:720 +#: documentation/content/en/books/handbook/zfs/_index.adoc:719 #, no-wrap msgid "" "# zpool status\n" @@ -1172,7 +1172,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:727 +#: documentation/content/en/books/handbook/zfs/_index.adoc:726 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" @@ -1184,7 +1184,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:735 +#: documentation/content/en/books/handbook/zfs/_index.adoc:734 #, no-wrap msgid "" "errors: No known data errors\n" @@ -1197,13 +1197,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:746 +#: documentation/content/en/books/handbook/zfs/_index.adoc:745 #, no-wrap msgid "Checking the Status of a Pool" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:752 +#: documentation/content/en/books/handbook/zfs/_index.adoc:751 msgid "" "Pool status is important. If a drive goes offline or ZFS detects a read, " "write, or checksum error, the corresponding error count increases. The " @@ -1213,7 +1213,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:760 +#: documentation/content/en/books/handbook/zfs/_index.adoc:759 #, no-wrap msgid "" "# zpool status\n" @@ -1224,13 +1224,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:775 +#: documentation/content/en/books/handbook/zfs/_index.adoc:774 #, no-wrap msgid "Clearing Errors" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:781 +#: documentation/content/en/books/handbook/zfs/_index.adoc:780 msgid "" "When detecting an error, ZFS increases the read, write, or checksum error " "counts. Clear the error message and reset the counts with `zpool clear " @@ -1240,13 +1240,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:783 +#: documentation/content/en/books/handbook/zfs/_index.adoc:782 #, no-wrap msgid "Replacing a Functioning Device" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:792 +#: documentation/content/en/books/handbook/zfs/_index.adoc:791 msgid "" "It may be desirable to replace one disk with a different disk. When " "replacing a working disk, the process keeps the old disk online during the " @@ -1259,12 +1259,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:794 +#: documentation/content/en/books/handbook/zfs/_index.adoc:793 msgid "Replace a functioning device in the pool:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:812 +#: documentation/content/en/books/handbook/zfs/_index.adoc:811 #, no-wrap msgid "" "errors: No known data errors\n" @@ -1273,19 +1273,19 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:814 +#: documentation/content/en/books/handbook/zfs/_index.adoc:813 #, no-wrap msgid "When booting from the pool 'zroot', update the boot code on the newly attached disk 'ada2p3'.\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:816 +#: documentation/content/en/books/handbook/zfs/_index.adoc:815 #, no-wrap msgid "Assuming GPT partitioning is used and [.filename]#da0# is the new boot disk, use the following command:\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:829 +#: documentation/content/en/books/handbook/zfs/_index.adoc:828 #, no-wrap msgid "" " gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 da0\n" @@ -1303,7 +1303,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:837 +#: documentation/content/en/books/handbook/zfs/_index.adoc:836 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" @@ -1316,7 +1316,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:844 +#: documentation/content/en/books/handbook/zfs/_index.adoc:843 #, no-wrap msgid "" "errors: No known data errors\n" @@ -1328,8 +1328,8 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:850 -#: documentation/content/en/books/handbook/zfs/_index.adoc:923 +#: documentation/content/en/books/handbook/zfs/_index.adoc:849 +#: documentation/content/en/books/handbook/zfs/_index.adoc:922 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" @@ -1340,13 +1340,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:855 +#: documentation/content/en/books/handbook/zfs/_index.adoc:854 #, no-wrap msgid "Dealing with Failed Devices" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:863 +#: documentation/content/en/books/handbook/zfs/_index.adoc:862 msgid "" "When a disk in a pool fails, the vdev to which the disk belongs enters the " "<<zfs-term-degraded,degraded>> state. The data is still available, but with " @@ -1359,7 +1359,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:866 +#: documentation/content/en/books/handbook/zfs/_index.adoc:865 msgid "" "If the vdev does not have any redundancy, or if devices have failed and " "there is not enough redundancy to compensate, the pool enters the <<zfs-term-" @@ -1368,7 +1368,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:869 +#: documentation/content/en/books/handbook/zfs/_index.adoc:868 msgid "" "When replacing a failed disk, the name of the failed disk changes to the " "GUID of the new disk. A new device name parameter for `zpool replace` is " @@ -1376,12 +1376,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:871 +#: documentation/content/en/books/handbook/zfs/_index.adoc:870 msgid "Replace a failed disk using `zpool replace`:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:883 +#: documentation/content/en/books/handbook/zfs/_index.adoc:882 #, no-wrap msgid "" "# zpool status\n" @@ -1396,7 +1396,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:889 +#: documentation/content/en/books/handbook/zfs/_index.adoc:888 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" @@ -1407,7 +1407,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:902 +#: documentation/content/en/books/handbook/zfs/_index.adoc:901 #, no-wrap msgid "" "errors: No known data errors\n" @@ -1425,7 +1425,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:910 +#: documentation/content/en/books/handbook/zfs/_index.adoc:909 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" @@ -1438,7 +1438,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:917 +#: documentation/content/en/books/handbook/zfs/_index.adoc:916 #, no-wrap msgid "" "errors: No known data errors\n" @@ -1450,13 +1450,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:928 +#: documentation/content/en/books/handbook/zfs/_index.adoc:927 #, no-wrap msgid "Scrubbing a Pool" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:933 +#: documentation/content/en/books/handbook/zfs/_index.adoc:932 msgid "" "Routinely <<zfs-term-scrub,scrub>> pools, ideally at least once every " "month. The `scrub` operation is disk-intensive and will reduce performance " @@ -1467,7 +1467,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:944 +#: documentation/content/en/books/handbook/zfs/_index.adoc:943 #, no-wrap msgid "" "# zpool scrub mypool\n" @@ -1481,18 +1481,18 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:959 +#: documentation/content/en/books/handbook/zfs/_index.adoc:958 msgid "To cancel a scrub operation if needed, run `zpool scrub -s _mypool_`." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:961 +#: documentation/content/en/books/handbook/zfs/_index.adoc:960 #, no-wrap msgid "Self-Healing" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:972 +#: documentation/content/en/books/handbook/zfs/_index.adoc:971 msgid "" "The checksums stored with data blocks enable the file system to _self-" "heal_. This feature will automatically repair data whose checksum does not " @@ -1511,14 +1511,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:974 +#: documentation/content/en/books/handbook/zfs/_index.adoc:973 msgid "" "The next example shows this self-healing behavior by creating a mirrored " "pool of disks [.filename]#/dev/ada0# and [.filename]#/dev/ada1#." msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:983 +#: documentation/content/en/books/handbook/zfs/_index.adoc:982 #, no-wrap msgid "" "# zpool create healer mirror /dev/ada0 /dev/ada1\n" @@ -1530,8 +1530,8 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:989 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1143 +#: documentation/content/en/books/handbook/zfs/_index.adoc:988 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1142 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" @@ -1542,7 +1542,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:994 +#: documentation/content/en/books/handbook/zfs/_index.adoc:993 #, no-wrap msgid "" "errors: No known data errors\n" @@ -1552,14 +1552,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:997 +#: documentation/content/en/books/handbook/zfs/_index.adoc:996 msgid "" "Copy some important data to the pool to protect from data errors using the " "self-healing feature and create a checksum of the pool for later comparison." msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1007 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1006 #, no-wrap msgid "" "# cp /some/important/data /healer\n" @@ -1572,7 +1572,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1011 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1010 msgid "" "Simulate data corruption by writing random data to the beginning of one of " "the disks in the mirror. To keep ZFS from healing the data when detected, " @@ -1580,7 +1580,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1019 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1018 msgid "" "This is a dangerous operation that can destroy vital data, shown here for " "demonstration alone. *Do not try* it during normal operation of a storage " @@ -1591,7 +1591,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1029 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1028 #, no-wrap msgid "" "# zpool export healer\n" @@ -1603,7 +1603,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1035 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1034 msgid "" "The pool status shows that one device has experienced an error. Note that " "applications reading data from the pool did not receive any incorrect data. " @@ -1613,7 +1613,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1048 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1047 #, no-wrap msgid "" "# zpool status healer\n" @@ -1629,7 +1629,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1054 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1053 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" @@ -1640,7 +1640,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1060 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1059 msgid "" "ZFS detected the error and handled it by using the redundancy present in the " "unaffected [.filename]#ada0# mirror disk. A checksum comparison with the " @@ -1648,7 +1648,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1067 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1066 #, no-wrap msgid "" "# sha1 /healer >> checksum.txt\n" @@ -1658,7 +1658,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1076 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1075 msgid "" "Generate checksums before and after the intentional tampering while the pool " "data still matches. This shows how ZFS is capable of detecting and " @@ -1673,7 +1673,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1092 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1091 #, no-wrap msgid "" "# zpool scrub healer\n" @@ -1692,7 +1692,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1098 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1097 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" @@ -1703,7 +1703,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1104 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1103 msgid "" "The scrub operation reads data from [.filename]#ada0# and rewrites any data " "with a wrong checksum on [.filename]#ada1#, shown by the `(repairing)` " @@ -1712,7 +1712,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1117 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1116 #, no-wrap msgid "" "# zpool status healer\n" @@ -1728,7 +1728,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1123 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1122 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" @@ -1739,7 +1739,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1128 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1127 msgid "" "After the scrubbing operation completes with all the data synchronized from " "[.filename]#ada0# to [.filename]#ada1#, <<zfs-zpool-clear,clear>> the error " @@ -1747,7 +1747,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1137 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1136 #, no-wrap msgid "" "# zpool clear healer\n" @@ -1759,20 +1759,20 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1148 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1147 msgid "" "The pool is now back to a fully working state, with all error counts now " "zero." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1150 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1149 #, no-wrap msgid "Growing a Pool" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1159 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1158 msgid "" "The smallest device in each vdev limits the usable size of a redundant " "pool. Replace the smallest device with a larger device. After completing a " @@ -1785,20 +1785,20 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1162 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1161 msgid "" "Start expansion by using `zpool online -e` on each device. After expanding " "all devices, the extra space becomes available to the pool." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1164 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1163 #, no-wrap msgid "Importing and Exporting Pools" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1172 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1171 msgid "" "_Export_ pools before moving them to another system. ZFS unmounts all " "datasets, marking each device as exported but still locked to prevent use by " @@ -1812,18 +1812,18 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1174 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1173 msgid "Export a pool that is not in use:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1178 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1177 #, no-wrap msgid "# zpool export mypool\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1186 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1185 msgid "" "Importing a pool automatically mounts the datasets. If this is undesired " "behavior, use `zpool import -N` to prevent it. `zpool import -o` sets " @@ -1835,12 +1835,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1188 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1187 msgid "List all available pools for import:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1197 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1196 #, no-wrap msgid "" "# zpool import\n" @@ -1852,7 +1852,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1200 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1199 #, no-wrap msgid "" " mypool ONLINE\n" @@ -1860,12 +1860,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1203 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1202 msgid "Import the pool with an alternative root directory:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1211 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1210 #, no-wrap msgid "" "# zpool import -o altroot=/mnt mypool\n" @@ -1876,13 +1876,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1214 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1213 #, no-wrap msgid "Upgrading a Storage Pool" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1220 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1219 msgid "" "After upgrading FreeBSD, or if importing a pool from a system using an older " "version, manually upgrade the pool to the latest ZFS version to support " @@ -1892,12 +1892,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1222 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1221 msgid "Upgrade a v28 pool to support `Feature Flags`:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1235 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1234 #, no-wrap msgid "" "# zpool status\n" @@ -1913,8 +1913,8 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1241 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1289 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1240 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1288 #, no-wrap msgid "" " NAME STATE READ WRITE CKSUM\n" @@ -1925,8 +1925,8 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1245 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1293 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1244 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1292 #, no-wrap msgid "" "errors: No known data errors\n" @@ -1935,7 +1935,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1248 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1247 #, no-wrap msgid "" "The following pools are formatted with legacy version numbers and are upgraded to use feature flags.\n" @@ -1943,7 +1943,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1252 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1251 #, no-wrap msgid "" "VER POOL\n" @@ -1952,7 +1952,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1257 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1256 #, no-wrap msgid "" "Use 'zpool upgrade -v' for a list of available legacy versions.\n" @@ -1962,7 +1962,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1264 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1263 #, no-wrap msgid "" "Successfully upgraded 'mypool' from version 28 to feature flags.\n" @@ -1974,7 +1974,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1268 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1267 msgid "" "The newer features of ZFS will not be available until `zpool upgrade` has " "completed. Use `zpool upgrade -v` to see what new features the upgrade " @@ -1982,12 +1982,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1270 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1269 msgid "Upgrade a pool to support new feature flags:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1283 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1282 #, no-wrap msgid "" "# zpool status\n" @@ -2003,13 +2003,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1295 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1294 #, no-wrap msgid "All pools are formatted using feature flags.\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1299 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1298 #, no-wrap msgid "" "Some supported features are not enabled on the following pools. Once a\n" @@ -2018,7 +2018,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1312 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1311 #, no-wrap msgid "" "POOL FEATURE\n" @@ -2036,7 +2036,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1320 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1319 #, no-wrap msgid "" "Enabled the following features on 'mypool':\n" @@ -2049,7 +2049,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1327 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1326 msgid "" "Update the boot code on systems that boot from a pool to support the new " "pool version. Use `gpart bootcode` on the partition that contains the boot " @@ -2058,42 +2058,42 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1329 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1328 msgid "For legacy boot using GPT, use the following command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1333 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1332 #, no-wrap msgid "# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada1\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1336 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1335 msgid "For systems using EFI to boot, execute the following command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1340 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1339 #, no-wrap msgid "# gpart bootcode -p /boot/boot1.efifat -i 1 ada1\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1344 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1343 msgid "" "Apply the bootcode to all bootable disks in the pool. See man:gpart[8] for " "more information." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1347 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1346 #, no-wrap msgid "Displaying Recorded Pool History" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1353 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1352 msgid "" "ZFS records commands that change the pool, including creating datasets, " "changing properties, or replacing a disk. Reviewing history about a pool's " @@ -2103,7 +2103,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1362 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1361 #, no-wrap msgid "" "# zpool history\n" @@ -2115,7 +2115,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1367 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1366 msgid "" "The output shows `zpool` and `zfs` commands altering the pool in some way " "along with a timestamp. Commands like `zfs list` are not included. When " @@ -2123,7 +2123,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1370 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1369 msgid "" "`zpool history` can show even more information when providing the options `-" "i` or `-l`. `-i` displays user-initiated events as well as internally " @@ -2131,7 +2131,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1382 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1381 #, no-wrap msgid "" "# zpool history -i\n" @@ -2146,7 +2146,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1386 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1385 msgid "" "Show more details by adding `-l`. Showing history records in a long format, " "including information like the name of the user who issued the command and " @@ -2154,7 +2154,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1395 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1394 #, no-wrap msgid "" "# zpool history -l\n" @@ -2166,7 +2166,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1401 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1400 msgid "" "The output shows that the `root` user created the mirrored pool with disks [." "filename]#/dev/ada0# and [.filename]#/dev/ada1#. The hostname `myzfsbox` is " @@ -2177,7 +2177,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1404 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1403 msgid "" "Combine both options to `zpool history` to give the most detailed " "information possible for any given pool. Pool history provides valuable " @@ -2186,13 +2186,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1406 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1405 #, no-wrap msgid "Performance Monitoring" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1413 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1412 msgid "" "A built-in monitoring system can display pool I/O statistics in real time. " "It shows the amount of free and used space on the pool, read and write " @@ -2202,7 +2202,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1421 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1420 #, no-wrap msgid "" "# zpool iostat\n" @@ -2213,7 +2213,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1427 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1426 msgid "" "To continuously see I/O activity, specify a number as the last parameter, " "indicating an interval in seconds to wait between updates. The next " @@ -2223,7 +2223,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1432 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1431 msgid "" "Display even more detailed I/O statistics with `-v`. Each device in the " "pool appears with a statistics line. This is useful for seeing read and " @@ -2233,7 +2233,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1444 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1443 #, no-wrap msgid "" "# zpool iostat -v \n" @@ -2248,13 +2248,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1447 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1446 #, no-wrap msgid "Splitting a Storage Pool" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1454 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1453 msgid "" "ZFS can split a pool consisting of one or more mirror vdevs into two pools. " "Unless otherwise specified, ZFS detaches the last member of each mirror and " @@ -2265,26 +2265,26 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/zfs/_index.adoc:1456 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1455 #, no-wrap msgid "`zfs` Administration" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1460 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1459 msgid "" "The `zfs` utility can create, destroy, and manage all existing ZFS datasets " "within a pool. To manage the pool itself, use <<zfs-zpool,`zpool`>>." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1462 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1461 #, no-wrap msgid "Creating and Destroying Datasets" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1472 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1471 msgid "" "Unlike traditional disks and volume managers, space in ZFS is _not_ " "preallocated. With traditional file systems, after partitioning and " @@ -2304,14 +2304,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1474 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1473 msgid "" "Create a new dataset and enable <<zfs-term-compression-lz4,LZ4 compression>> " "on it:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1509 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1508 #, no-wrap msgid "" "# zfs list\n" @@ -2349,7 +2349,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1512 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1511 msgid "" "Destroying a dataset is much quicker than deleting the files on the dataset, " "as it does not involve scanning the files and updating the corresponding " @@ -2357,12 +2357,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1514 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1513 msgid "Destroy the created dataset:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1549 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1548 #, no-wrap msgid "" "# zfs list\n" @@ -2400,7 +2400,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1557 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1556 msgid "" "In modern versions of ZFS, `zfs destroy` is asynchronous, and the free space " "might take minutes to appear in the pool. Use `zpool get freeing " @@ -2414,13 +2414,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1559 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1558 #, no-wrap msgid "Creating and Destroying Volumes" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1564 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1563 msgid "" "A volume is a special dataset type. Rather than mounting as a file system, " "expose it as a block device under [.filename]#/dev/zvol/poolname/dataset#. " @@ -2430,7 +2430,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1569 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1568 msgid "" "Format a volume with any file system or without a file system to store raw " "data. To the user, a volume appears to be a regular disk. Putting ordinary " @@ -2440,7 +2440,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1583 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1582 #, no-wrap msgid "" "# zfs create -V 250m -o compression=on tank/fat32\n" @@ -2457,7 +2457,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1587 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1586 msgid "" "Destroying a volume is much the same as destroying a regular file system " "dataset. The operation is nearly instantaneous, but it may take minutes to " @@ -2465,13 +2465,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1589 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1588 #, no-wrap msgid "Renaming a Dataset" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1596 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1595 msgid "" "To change the name of a dataset, use `zfs rename`. To change the parent of " "a dataset, use this command as well. Renaming a dataset to have a different " @@ -2482,12 +2482,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1598 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1597 msgid "Rename a dataset and move it to be under a different parent dataset:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1634 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1633 #, no-wrap msgid "" "# zfs list\n" @@ -2526,7 +2526,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1639 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1638 msgid "" "Renaming snapshots uses the same command. Due to the nature of snapshots, " "rename cannot change their parent dataset. To rename a recursive snapshot, " @@ -2535,7 +2535,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1649 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1648 #, no-wrap msgid "" "# zfs list -t snapshot\n" @@ -2548,13 +2548,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1652 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1651 #, no-wrap msgid "Setting Dataset Properties" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1662 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1661 msgid "" "Each ZFS dataset has properties that control its behavior. Most properties " "are automatically inherited from the parent dataset, but can be overridden " @@ -2569,7 +2569,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1669 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1668 #, no-wrap msgid "" "# zfs set custom:costcenter=1234 tank\n" @@ -2579,7 +2579,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1673 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1672 msgid "" "To remove a custom property, use `zfs inherit` with `-r`. If the custom " "property is not defined in any of the parent datasets, this option removes " @@ -2587,7 +2587,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1682 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1681 #, no-wrap msgid "" "# zfs inherit -r custom:costcenter tank\n" @@ -2599,13 +2599,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:1685 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1684 #, no-wrap msgid "Getting and Setting Share Properties" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1691 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1690 msgid "" "Two commonly used and useful dataset properties are the NFS and SMB share " "options. Setting these defines if and how ZFS shares datasets on the " @@ -2614,7 +2614,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1700 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1699 #, no-wrap msgid "" "# zfs get sharenfs mypool/usr/home\n" @@ -2626,18 +2626,18 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1703 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1702 msgid "To enable sharing of a dataset, enter:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1707 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1706 #, no-wrap msgid "# zfs set sharenfs=on mypool/usr/home\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1711 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1710 msgid "" "Set other options for sharing datasets through NFS, such as `-alldirs`, `-" "maproot` and `-network`. To set options on a dataset shared through NFS, " @@ -2645,19 +2645,19 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1715 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1714 #, no-wrap msgid "# zfs set sharenfs=\"-alldirs,-maproot=root,-network=192.168.1.0/24\" mypool/usr/home\n" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:1718 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1717 #, no-wrap msgid "Managing Snapshots" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1732 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1731 msgid "" "<<zfs-term-snapshot,Snapshots>> are one of the most powerful features of " "ZFS. A snapshot provides a read-only, point-in-time copy of the dataset. " @@ -2678,7 +2678,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1741 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1740 msgid "" "Snapshots in ZFS provide a variety of features that even other file systems " "with snapshot functionality lack. A typical example of snapshot use is as a " @@ -2697,25 +2697,25 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:1743 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1742 #, no-wrap msgid "Creating Snapshots" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1747 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1746 msgid "" "To create snapshots, use `zfs snapshot _dataset_@_snapshotname_`. Adding `-" "r` creates a snapshot recursively, with the same name on all child datasets." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1749 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1748 msgid "Create a recursive snapshot of the entire pool:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1787 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1786 #, no-wrap msgid "" "# zfs list -t all\n" @@ -2756,7 +2756,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1792 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1791 msgid "" "Snapshots are not shown by a normal `zfs list` operation. To list " "snapshots, append `-t snapshot` to `zfs list`. `-t all` displays both file " @@ -2764,7 +2764,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1796 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1795 msgid "" "Snapshots are not mounted directly, showing no path in the `MOUNTPOINT` " "column. ZFS does not mention available disk space in the `AVAIL` column, as " @@ -2773,7 +2773,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1803 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1802 #, no-wrap msgid "" "# zfs list -rt all mypool/usr/home\n" @@ -2783,7 +2783,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1809 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1808 msgid "" "Displaying both the dataset and the snapshot together reveals how snapshots " "work in <<zfs-term-cow,COW>> fashion. They save the changes (_delta_) made " @@ -2793,7 +2793,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1819 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1818 #, no-wrap msgid "" "# cp /etc/passwd /var/tmp\n" @@ -2806,7 +2806,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1824 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1823 msgid "" "The second snapshot contains the changes to the dataset after the copy " "operation. This yields enormous space savings. Notice that the size of the " @@ -2815,13 +2815,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:1826 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1825 #, no-wrap msgid "Comparing Snapshots" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1832 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1831 msgid "" "ZFS provides a built-in command to compare the differences in content " "between two snapshots. This is helpful with a lot of snapshots taken over " @@ -2832,7 +2832,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1843 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1842 #, no-wrap msgid "" "# zfs list -rt all mypool/var/tmp\n" @@ -2846,7 +2846,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1847 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1846 msgid "" "The command lists the changes between the specified snapshot (in this case " "`_mypool/var/tmp@my_recursive_snapshot_`) and the live file system. The " @@ -2854,55 +2854,55 @@ msgid "" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:1853 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1852 #, no-wrap msgid "+" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:1855 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1854 #, no-wrap msgid "Adding the path or file." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:1856 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1855 #, no-wrap msgid "-" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:1858 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1857 #, no-wrap msgid "Deleting the path or file." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:1859 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1858 #, no-wrap msgid "M" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:1861 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1860 #, no-wrap msgid "Modifying the path or file." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:1862 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1861 #, no-wrap msgid "R" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:1863 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1862 #, no-wrap msgid "Renaming the path or file." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1868 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1867 msgid "" "Comparing the output with the table, it becomes clear that ZFS added [." "filename]#passwd# after creating the snapshot `_mypool/var/" @@ -2911,21 +2911,21 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1870 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1869 msgid "" "Comparing two snapshots is helpful when using the ZFS replication feature to " "transfer a dataset to a different host for backup purposes." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1872 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1871 msgid "" "Compare two snapshots by providing the full dataset name and snapshot name " "of both datasets:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1884 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1883 #, no-wrap msgid "" "# cp /var/tmp/passwd /var/tmp/passwd.copy\n" @@ -2940,7 +2940,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1888 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1887 msgid "" "A backup administrator can compare two snapshots received from the sending " "host and determine the actual changes in the dataset. See the <<zfs-zfs-" @@ -2948,13 +2948,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:1890 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1889 #, no-wrap msgid "Snapshot Rollback" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1903 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1902 msgid "" "When at least one snapshot is available, roll back to it at any time. Most " "often this is the case when the current state of the dataset is no longer " @@ -2976,14 +2976,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1905 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1904 msgid "" "In the first example, roll back a snapshot because of a careless `rm` " "operation that removes too much data than intended." msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1919 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1918 #, no-wrap msgid "" "# zfs list -rt all mypool/var/tmp\n" @@ -3000,7 +3000,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1924 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1923 msgid "" "At this point, the user notices the removal of extra files and wants them " "back. ZFS provides an easy way to get them back using rollbacks, when " @@ -3009,7 +3009,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1930 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1929 #, no-wrap msgid "" "# zfs rollback mypool/var/tmp@diff_snapshot\n" @@ -3018,7 +3018,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1935 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1934 msgid "" "The rollback operation restored the dataset to the state of the last " "snapshot. Rolling back to a snapshot taken much earlier with other " @@ -3027,7 +3027,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1948 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1947 #, no-wrap msgid "" "# zfs list -rt snapshot mypool/var/tmp\n" @@ -3043,7 +3043,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1955 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1954 msgid "" "This warning means that snapshots exist between the current state of the " "dataset and the snapshot to which the user wants to roll back. To complete " @@ -3056,7 +3056,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1964 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1963 #, no-wrap msgid "" "# zfs rollback -r mypool/var/tmp@my_recursive_snapshot\n" @@ -3068,20 +3068,20 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1967 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1966 msgid "" "The output from `zfs list -t snapshot` confirms the removal of the " "intermediate snapshots as a result of `zfs rollback -r`." msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:1969 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1968 #, no-wrap msgid "Restoring Individual Files from Snapshots" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1976 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1975 msgid "" "Snapshots live in a hidden directory under the parent dataset: [.filename]#." "zfs/snapshots/snapshotname#. By default, these directories will not show " @@ -3093,7 +3093,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:1987 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1986 #, no-wrap msgid "" "# zfs get snapdir mypool/var/tmp\n" @@ -3107,7 +3107,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:1992 +#: documentation/content/en/books/handbook/zfs/_index.adoc:1991 msgid "" "Restore individual files to a previous state by copying them from the " "snapshot back to the parent dataset. The directory structure below [." @@ -3118,7 +3118,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2003 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2002 #, no-wrap msgid "" "# rm /var/tmp/passwd\n" @@ -3132,7 +3132,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2010 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2009 msgid "" "Even if the `snapdir` property is set to hidden, running `ls .zfs/snapshot` " "will still list the contents of that directory. The administrator decides " @@ -3142,7 +3142,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2015 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2014 #, no-wrap msgid "" "# cp /etc/rc.conf /var/tmp/.zfs/snapshot/after_cp/\n" @@ -3150,7 +3150,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2019 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2018 msgid "" "The error reminds the user that snapshots are read-only and cannot change " "after creation. Copying files into and removing them from snapshot " @@ -3159,7 +3159,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2022 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2021 msgid "" "Snapshots consume space based on how much the parent file system has changed " "since the time of the snapshot. The `written` property of a snapshot tracks " @@ -3167,7 +3167,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2026 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2025 msgid "" "To destroy snapshots and reclaim the space, use `zfs destroy " "_dataset_@_snapshot_`. Adding `-r` recursively removes all snapshots with " @@ -3177,13 +3177,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2028 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2027 #, no-wrap msgid "Managing Clones" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2037 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2036 msgid "" "A clone is a copy of a snapshot treated more like a regular dataset. Unlike " "a snapshot, a clone is writeable and mountable, and has its own properties. " @@ -3198,12 +3198,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2039 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2038 msgid "To show the clone feature use this example dataset:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2047 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2046 #, no-wrap msgid "" "# zfs list -rt all camino/home/joe\n" @@ -3214,7 +3214,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2053 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2052 msgid "" "A typical use for clones is to experiment with a specific dataset while " "keeping the snapshot around to fall back to in case something goes wrong. " @@ -3225,7 +3225,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2060 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2059 #, no-wrap msgid "" "# zfs clone camino/home/joe@backup camino/home/joenew\n" @@ -3235,7 +3235,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2067 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2066 #, no-wrap msgid "" "/usr/home/joenew:\n" @@ -3247,7 +3247,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2076 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2075 msgid "" "Creating a clone makes it an exact copy of the state the dataset as it was " "when taking the snapshot. Changing the clone independently from its " @@ -3259,7 +3259,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2086 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2085 #, no-wrap msgid "" "# zfs get origin camino/home/joenew\n" @@ -3272,7 +3272,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2091 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2090 msgid "" "After making some changes like copying [.filename]#loader.conf# to the " "promoted clone, for example, the old directory becomes obsolete in this " @@ -3282,7 +3282,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2102 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2101 #, no-wrap msgid "" "# cp /boot/defaults/loader.conf /usr/home/joenew\n" @@ -3296,7 +3296,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2111 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2110 msgid "" "The cloned snapshot is now an ordinary dataset. It contains all the data " "from the original snapshot plus the files added to it like [." @@ -3310,13 +3310,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2113 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2112 #, no-wrap msgid "Replication" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2121 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2120 msgid "" "Keeping data on a single pool in one location exposes it to risks like theft " "and natural or human disasters. Making regular backups of the entire pool " @@ -3330,12 +3330,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2123 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2122 msgid "These examples show ZFS replication with these two pools:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2130 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2129 #, no-wrap msgid "" "# zpool list\n" @@ -3345,7 +3345,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2138 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2137 msgid "" "The pool named _mypool_ is the primary pool where writing and reading data " "happens on a regular basis. Using a second standby pool _backup_ in case " @@ -3358,7 +3358,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2145 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2144 #, no-wrap msgid "" "# zfs snapshot mypool@backup1\n" @@ -3368,7 +3368,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2150 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2149 msgid "" "Now that a snapshot exists, use `zfs send` to create a stream representing " "the contents of the snapshot. Store this stream as a file or receive it on " @@ -3377,7 +3377,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2156 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2155 #, no-wrap msgid "" "# zfs send mypool@backup1\n" @@ -3386,7 +3386,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2160 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2159 msgid "" "To back up a dataset with `zfs send`, redirect to a file located on the " "mounted backup pool. Ensure that the pool has enough free space to " @@ -3395,7 +3395,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2168 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2167 #, no-wrap msgid "" "# zfs send mypool@backup1 > /backup/backup1\n" @@ -3406,7 +3406,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2172 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2171 msgid "" "The `zfs send` transferred all the data in the snapshot called _backup1_ to " "the pool named _backup_. To create and send these snapshots automatically, " @@ -3414,7 +3414,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2178 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2177 msgid "" "Instead of storing the backups as archive files, ZFS can receive them as a " "live file system, allowing direct access to the backed up data. To get to " @@ -3426,7 +3426,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2186 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2185 #, no-wrap msgid "" "# zfs snapshot mypool@replica1\n" @@ -3437,7 +3437,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2191 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2190 #, no-wrap msgid "" "# zpool list\n" @@ -3447,13 +3447,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:2194 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2193 #, no-wrap msgid "Incremental Backups" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2199 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2198 msgid "" "`zfs send` can also determine the difference between two snapshots and send " "individual differences between the two. This saves disk space and transfer " @@ -3461,7 +3461,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2211 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2210 #, no-wrap msgid "" "# zfs snapshot mypool@replica2\n" @@ -3476,7 +3476,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2217 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2216 msgid "" "Create a second snapshot called _replica2_. This second snapshot contains " "changes made to the file system between now and the previous snapshot, " @@ -3486,7 +3486,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2224 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2223 #, no-wrap msgid "" "# zfs send -v -i mypool@replica1 mypool@replica2 | zfs receive /backup/mypool\n" @@ -3496,7 +3496,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2229 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2228 #, no-wrap msgid "" "# zpool list\n" @@ -3506,7 +3506,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2235 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2234 #, no-wrap msgid "" "# zfs list\n" @@ -3517,7 +3517,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2242 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2241 #, no-wrap msgid "" "# zfs list -t snapshot\n" @@ -3529,7 +3529,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2247 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2246 msgid "" "The incremental stream replicated the changed data rather than the entirety " "of _replica1_. Sending the differences alone took much less time to " @@ -3539,7 +3539,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2252 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2251 msgid "" "A new file system, _backup/mypool_, is available with the files and data " "from the pool _mypool_. Specifying `-p` copies the dataset properties " @@ -3549,13 +3549,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:2254 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2253 #, no-wrap msgid "Sending Encrypted Backups over SSH" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2262 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2261 msgid "" "Sending streams over the network is a good way to keep a remote backup, but " "it does come with a drawback. Data sent over the network link is not " @@ -3569,7 +3569,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2265 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2264 msgid "" "Change some settings and take security precautions first. This describes " "the necessary steps required for the `zfs send` operation; for more " @@ -3577,30 +3577,30 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2267 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2266 msgid "Change the configuration as follows:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2269 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2268 msgid "" "Passwordless SSH access between sending and receiving host using SSH keys" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2270 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2269 msgid "" "ZFS requires the privileges of the `root` user to send and receive streams. " "This requires logging in to the receiving system as `root`." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2271 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2270 msgid "Security reasons prevent `root` from logging in by default." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2273 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2272 msgid "" "Use the <<zfs-zfs-allow,ZFS Delegation>> system to allow a non-`root` user " "on each system to perform the respective send and receive operations. On " @@ -3608,25 +3608,25 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2277 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2276 #, no-wrap msgid "# zfs allow -u someuser send,snapshot mypool\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2280 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2279 msgid "" "To mount the pool, the unprivileged user must own the directory, and regular " "users need permission to mount file systems." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2282 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2281 msgid "On the receiving system:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2291 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2290 #, no-wrap msgid "" "# sysctl vfs.usermount=1\n" @@ -3638,14 +3638,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2294 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2293 msgid "" "The unprivileged user can receive and mount datasets now, and replicates the " "_home_ dataset to the remote system:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2299 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2298 #, no-wrap msgid "" "% zfs snapshot -r mypool/home@monday\n" @@ -3653,7 +3653,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2309 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2308 msgid "" "Create a recursive snapshot called _monday_ of the file system dataset " "_home_ on the pool _mypool_. Then `zfs send -R` includes the dataset, all " @@ -3669,13 +3669,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2311 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2310 #, no-wrap msgid "Dataset, User, and Group Quotas" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2316 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2315 msgid "" "Use <<zfs-term-quota,Dataset quotas>> to restrict the amount of space " "consumed by a particular dataset. <<zfs-term-refquota,Reference Quotas>> " @@ -3686,7 +3686,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2321 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2320 msgid "" "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 " @@ -3697,90 +3697,90 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2323 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2322 msgid "To enforce a dataset quota of 10 GB for [.filename]#storage/home/bob#:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2327 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2326 #, no-wrap msgid "# zfs set quota=10G storage/home/bob\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2330 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2329 msgid "" "To enforce a reference quota of 10 GB for [.filename]#storage/home/bob#:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2334 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2333 #, no-wrap msgid "# zfs set refquota=10G storage/home/bob\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2337 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2336 msgid "To remove a quota of 10 GB for [.filename]#storage/home/bob#:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2341 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2340 #, no-wrap msgid "# zfs set quota=none storage/home/bob\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2344 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2343 msgid "" "The general format is `userquota@_user_=_size_`, and the user's name must be " "in one of these formats:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2346 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2345 msgid "POSIX compatible name such as _joe_." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2347 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2346 msgid "POSIX numeric ID such as _789_." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2348 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2347 msgid "SID name such as _joe.bloggs@example.com_." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2349 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2348 msgid "SID numeric ID such as _S-1-123-456-789_." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2351 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2350 msgid "For example, to enforce a user quota of 50 GB for the user named _joe_:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2355 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2354 #, no-wrap msgid "# zfs set userquota@joe=50G\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2358 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2357 msgid "To remove any quota:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2362 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2361 #, no-wrap msgid "# zfs set userquota@joe=none\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2369 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2368 msgid "" "User quota properties are not displayed by `zfs get all`. Non-`root` users " "can't see other's quotas unless granted the `userquota` privilege. Users " @@ -3788,37 +3788,37 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2372 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2371 msgid "" "The general format for setting a group quota is: `groupquota@_group_=_size_`." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2374 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2373 msgid "To set the quota for the group _firstgroup_ to 50 GB, use:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2378 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2377 #, no-wrap msgid "# zfs set groupquota@firstgroup=50G\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2381 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2380 msgid "" "To remove the quota for the group _firstgroup_, or to make sure that one is " "not set, instead use:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2385 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2384 #, no-wrap msgid "# zfs set groupquota@firstgroup=none\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2389 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2388 msgid "" "As with the user quota property, non-`root` users can see the quotas " "associated with the groups to which they belong. A user with the " @@ -3826,7 +3826,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2393 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2392 msgid "" "To display the amount of space used by each user on a file system or " "snapshot along with any quotas, use `zfs userspace`. For group information, " @@ -3835,26 +3835,26 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2395 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2394 msgid "" "Privileged users and `root` can list the quota for [.filename]#storage/home/" "bob# using:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2399 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2398 #, no-wrap msgid "# zfs get quota storage/home/bob\n" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2402 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2401 #, no-wrap msgid "Reservations" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2407 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2406 msgid "" "<<zfs-term-reservation,Reservations>> guarantee an always-available amount " "of space on a dataset. The reserved space will not be available to any " @@ -3863,31 +3863,31 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2409 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2408 msgid "" "The general format of the `reservation` property is `reservation=_size_`, so " "to set a reservation of 10 GB on [.filename]#storage/home/bob#, use:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2413 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2412 #, no-wrap msgid "# zfs set reservation=10G storage/home/bob\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2416 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2415 msgid "To clear any reservation:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2420 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2419 #, no-wrap msgid "# zfs set reservation=none storage/home/bob\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2423 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2422 msgid "" "The same principle applies to the `refreservation` property for setting a " "<<zfs-term-refreservation,Reference Reservation>>, with the general format " @@ -3895,14 +3895,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2425 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2424 msgid "" "This command shows any reservations or refreservations that exist on [." "filename]#storage/home/bob#:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2430 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2429 #, no-wrap msgid "" "# zfs get reservation storage/home/bob\n" @@ -3910,13 +3910,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2433 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2432 #, no-wrap msgid "Compression" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2439 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2438 msgid "" "ZFS provides transparent compression. Compressing data written at the block " "level saves space and also increases disk throughput. If data compresses by " @@ -3927,7 +3927,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2445 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2444 msgid "" "ZFS offers different compression algorithms, each with different trade-" "offs. The introduction of LZ4 compression in ZFS v5000 enables compressing " @@ -3941,14 +3941,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2447 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2446 msgid "" "The administrator can see the effectiveness of compression using dataset " "properties." msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2456 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2455 #, no-wrap msgid "" "# zfs get used,compressratio,compression,logicalused mypool/compressed_dataset\n" @@ -3960,7 +3960,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2461 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2460 msgid "" "The dataset is using 449 GB of space (the used property). Without " "compression, it would have taken 496 GB of space (the `logicalused` " @@ -3968,7 +3968,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2467 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2466 msgid "" "Compression can have an unexpected side effect when combined with <<zfs-term-" "userquota,User Quotas>>. User quotas restrict how much actual space a user " @@ -3982,7 +3982,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2471 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2470 msgid "" "Compression can have a similar unexpected interaction with backups. Quotas " "are often used to limit data storage to ensure there is enough backup space " @@ -3991,13 +3991,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2473 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2472 #, no-wrap msgid "Zstandard Compression" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2477 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2476 msgid "" "OpenZFS 2.0 added a new compression algorithm. Zstandard (Zstd) offers " "higher compression ratios than the default LZ4 while offering much greater " @@ -4007,7 +4007,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2481 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2480 msgid "" "Zstd provides a large selection of compression levels, providing fine-" "grained control over performance versus compression ratio. One of the main " @@ -4017,7 +4017,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2486 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2485 msgid "" "Even with frequent data updates, enabling compression often provides higher " "performance. One of the biggest advantages comes from the compressed ARC " @@ -4028,7 +4028,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2492 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2491 msgid "" "ZFS offers 19 levels of Zstd compression, each offering incrementally more " "space savings in exchange for slower compression. The default level is " @@ -4043,7 +4043,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2496 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2495 msgid "" "If ZFS is not able to get the required memory to compress a block with Zstd, " "it will fall back to storing the block uncompressed. This is unlikely to " @@ -4053,13 +4053,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2498 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2497 #, no-wrap msgid "Deduplication" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2504 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2503 msgid "" "When enabled, <<zfs-term-deduplication,deduplication>> uses the checksum of " "each block to detect duplicate blocks. When a new block is a duplicate of " @@ -4071,18 +4071,18 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2506 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2505 msgid "To activate deduplication, set the `dedup` property on the target pool:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2510 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2509 #, no-wrap msgid "# zfs set dedup=on pool\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2515 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2514 msgid "" "Deduplicating only affects new data written to the pool. Merely activating " "this option will not deduplicate data already written to the pool. A pool " @@ -4090,7 +4090,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2521 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2520 #, no-wrap msgid "" "# zpool list\n" @@ -4099,7 +4099,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2526 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2525 msgid "" "The `DEDUP` column shows the actual rate of deduplication for the pool. A " "value of `1.00x` shows that data has not deduplicated yet. The next example " @@ -4108,7 +4108,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2532 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2531 #, no-wrap msgid "" "# for d in dir1 dir2 dir3; do\n" @@ -4117,12 +4117,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2535 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2534 msgid "To observe deduplicating of redundant data, use:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2541 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2540 #, no-wrap msgid "" "# zpool list\n" @@ -4131,7 +4131,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2546 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2545 msgid "" "The `DEDUP` column shows a factor of `3.00x`. Detecting and deduplicating " "copies of the data uses a third of the space. The potential for space " @@ -4140,7 +4140,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2549 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2548 msgid "" "Deduplication is not always beneficial when the data in a pool is not " "redundant. ZFS can show potential space savings by simulating deduplication " @@ -4148,7 +4148,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2554 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2553 #, no-wrap msgid "" "# zdb -S pool\n" @@ -4156,7 +4156,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2570 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2569 #, no-wrap msgid "" "bucket allocated referenced\n" @@ -4177,13 +4177,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2572 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2571 #, no-wrap msgid "dedup = 1.05, compress = 1.11, copies = 1.00, dedup * compress / copies = 1.16\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2581 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2580 msgid "" "After `zdb -S` finishes analyzing the pool, it shows the space reduction " "ratio that activating deduplication would achieve. In this case, `1.16` is " @@ -4200,13 +4200,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2583 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2582 #, no-wrap msgid "ZFS and Jails" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2589 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2588 msgid "" "Use `zfs jail` and the corresponding `jailed` property to delegate a ZFS " "dataset to a crossref:jails[jails,Jail]. `zfs jail _jailid_` attaches a " @@ -4217,13 +4217,13 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/zfs/_index.adoc:2591 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2590 #, no-wrap msgid "Delegated Administration" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2599 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2598 msgid "" "A comprehensive permission delegation system allows unprivileged users to " "perform ZFS administration functions. For example, if each user's home " @@ -4236,13 +4236,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2601 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2600 #, no-wrap msgid "Delegating Dataset Creation" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2607 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2606 msgid "" "`zfs allow _someuser_ create _mydataset_` gives the specified user " "permission to create child datasets under the selected parent dataset. A " @@ -4253,13 +4253,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2609 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2608 #, no-wrap msgid "Delegating Permission Delegation" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2613 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2612 msgid "" "`zfs allow _someuser_ allow _mydataset_` gives the specified user the " "ability to assign any permission they have on the target dataset, or its " @@ -4269,38 +4269,38 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/zfs/_index.adoc:2615 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2614 #, no-wrap msgid "Advanced Topics" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2618 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2617 #, no-wrap msgid "Tuning" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2621 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2620 msgid "Adjust tunables to make ZFS perform best for different workloads." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2623 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2622 msgid "" -"[[zfs-advanced-tuning-arc_max]] `_vfs.zfs.arc.max_` starting with 13.x " -"(`_vfs.zfs.arc_max` for 12.x) - Upper size of the <<zfs-term-arc,ARC>>. The " -"default is all RAM but 1 GB, or 5/8 of all RAM, whichever is more. Use a " -"lower value if the system runs any other daemons or processes that may " -"require memory. Adjust this value at runtime with man:sysctl[8] and set it " -"in [.filename]#/boot/loader.conf# or [.filename]#/etc/sysctl.conf#." +"[[zfs-advanced-tuning-arc_max]] `_vfs.zfs.arc.max_` starting with 13.x (`vfs." +"zfs.arc_max` for 12.x) - Upper size of the <<zfs-term-arc,ARC>>. The default " +"is all RAM but 1 GB, or 5/8 of all RAM, whichever is more. Use a lower value " +"if the system runs any other daemons or processes that may require memory. " +"Adjust this value at runtime with man:sysctl[8] and set it in [.filename]#/" +"boot/loader.conf# or [.filename]#/etc/sysctl.conf#." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2624 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2623 msgid "" "[[zfs-advanced-tuning-arc_meta_limit]] `_vfs.zfs.arc.meta_limit_` starting " -"with 13.x (`_vfs.zfs.arc_meta_limit` for 12.x)` - Limit the amount of the " +"with 13.x (`vfs.zfs.arc_meta_limit` for 12.x)` - Limit the amount of the " "<<zfs-term-arc,ARC>> used to store metadata. The default is one fourth of " "`vfs.zfs.arc.max`. Increasing this value will improve performance if the " "workload involves operations on a large number of files and directories, or " @@ -4310,18 +4310,18 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2625 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2624 msgid "" -"[[zfs-advanced-tuning-arc_min]] `_vfs.zfs.arc.min_` starting with 13.x " -"(`_vfs.zfs.arc_min` for 12.x) - Lower size of the <<zfs-term-arc,ARC>>. The " -"default is one half of `vfs.zfs.arc.meta_limit`. Adjust this value to " -"prevent other applications from pressuring out the entire <<zfs-term-arc," -"ARC>>. Adjust this value at runtime with man:sysctl[8] and in [.filename]#/" -"boot/loader.conf# or [.filename]#/etc/sysctl.conf#." +"[[zfs-advanced-tuning-arc_min]] `_vfs.zfs.arc.min_` starting with 13.x (`vfs." +"zfs.arc_min` for 12.x) - Lower size of the <<zfs-term-arc,ARC>>. The default " +"is one half of `vfs.zfs.arc.meta_limit`. Adjust this value to prevent other " +"applications from pressuring out the entire <<zfs-term-arc,ARC>>. Adjust " +"this value at runtime with man:sysctl[8] and in [.filename]#/boot/loader." +"conf# or [.filename]#/etc/sysctl.conf#." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2626 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2625 msgid "" "[[zfs-advanced-tuning-vdev-cache-size]] `_vfs.zfs.vdev.cache.size_` - A " "preallocated amount of memory reserved as a cache for each device in the " @@ -4331,7 +4331,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2627 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2626 msgid "" "[[zfs-advanced-tuning-min-auto-ashift]] `_vfs.zfs.min_auto_ashift_` - Lower " "`ashift` (sector size) used automatically at pool creation time. The value " @@ -4342,7 +4342,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2633 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2632 msgid "" "Common drives have 4 KB sectors. Using the default `ashift` of `9` with " "these drives results in write amplification on these devices. Data " @@ -4355,7 +4355,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2636 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2635 msgid "" "Forcing 4 KB blocks is also useful on pools with planned disk upgrades. " "Future disks use 4 KB sectors, and `ashift` values cannot change after " @@ -4363,7 +4363,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2640 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2639 msgid "" "In some specific cases, the smaller 512-byte block size might be " "preferable. When used with 512-byte disks for databases or as storage for " @@ -4372,7 +4372,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2641 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2640 msgid "" "[[zfs-advanced-tuning-prefetch_disable]] `_vfs.zfs.prefetch_disable_` - " "Disable prefetch. A value of `0` enables and `1` disables it. The default is " @@ -4384,7 +4384,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2642 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2641 msgid "" "[[zfs-advanced-tuning-vdev-trim_on_init]] `_vfs.zfs.vdev.trim_on_init_` - " "Control whether new devices added to the pool have the `TRIM` command run on " @@ -4395,7 +4395,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2643 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2642 msgid "" "[[zfs-advanced-tuning-vdev-max_pending]] `_vfs.zfs.vdev.max_pending_` - " "Limit the number of pending I/O requests per device. A higher value will " @@ -4404,7 +4404,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2644 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2643 msgid "" "[[zfs-advanced-tuning-top_maxinflight]] `_vfs.zfs.top_maxinflight_` - Upper " "number of outstanding I/Os per top-level <<zfs-term-vdev,vdev>>. Limits the " @@ -4415,7 +4415,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2645 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2644 msgid "" "[[zfs-advanced-tuning-l2arc_write_max]] `_vfs.zfs.l2arc_write_max_` - Limit " "the amount of data written to the <<zfs-term-l2arc,L2ARC>> per second. This " @@ -4424,7 +4424,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2646 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2645 msgid "" "[[zfs-advanced-tuning-l2arc_write_boost]] `_vfs.zfs.l2arc_write_boost_` - " "Adds the value of this tunable to <<zfs-advanced-tuning-l2arc_write_max,`vfs." @@ -4435,7 +4435,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2647 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2646 msgid "" "[[zfs-advanced-tuning-scrub_delay]]`_vfs.zfs.scrub_delay_` - Number of ticks " "to delay between each I/O during a <<zfs-term-scrub,`scrub`>>. To ensure " @@ -4453,7 +4453,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2648 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2647 msgid "" "[[zfs-advanced-tuning-resilver_delay]] `_vfs.zfs.resilver_delay_` - Number " "of milliseconds of delay inserted between each I/O during a <<zfs-term-" @@ -4474,7 +4474,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2649 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2648 msgid "" "[[zfs-advanced-tuning-scan_idle]] `_vfs.zfs.scan_idle_` - Number of " "milliseconds since the last operation before considering the pool is idle. " @@ -4484,7 +4484,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2650 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2649 msgid "" "[[zfs-advanced-tuning-txg-timeout]] `_vfs.zfs.txg.timeout_` - Upper number " "of seconds between <<zfs-term-txg,transaction group>>s. The current " @@ -4497,26 +4497,26 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/zfs/_index.adoc:2652 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2651 #, no-wrap msgid "ZFS on i386" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2655 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2654 msgid "" "Some of the features provided by ZFS are memory intensive, and may require " "tuning for upper efficiency on systems with limited RAM." msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:2656 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2655 #, no-wrap msgid "Memory" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2664 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2663 msgid "" "As a lower value, the total system memory should be at least one gigabyte. " "The amount of recommended RAM depends upon the size of the pool and which " @@ -4529,13 +4529,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:2665 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2664 #, no-wrap msgid "Kernel Configuration" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2668 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2667 msgid "" "Due to the address space limitations of the i386(TM) platform, ZFS users on " "the i386(TM) architecture must add this option to a custom kernel " @@ -4543,13 +4543,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2672 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2671 #, no-wrap msgid "options KVA_PAGES=512\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2677 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2676 msgid "" "This expands the kernel address space, allowing the `vm.kvm_size` tunable to " "push beyond the imposed limit of 1 GB, or the limit of 2 GB for PAE. To " @@ -4558,13 +4558,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/zfs/_index.adoc:2678 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2677 #, no-wrap msgid "Loader Tunables" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2682 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2681 msgid "" "Increases the [.filename]#kmem# address space on all FreeBSD architectures. " "A test system with 1 GB of physical memory benefitted from adding these " @@ -4572,7 +4572,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/zfs/_index.adoc:2689 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2688 #, no-wrap msgid "" "vm.kmem_size=\"330M\"\n" @@ -4582,43 +4582,43 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2692 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2691 msgid "" "For a more detailed list of recommendations for ZFS-related tuning, see " "https://wiki.freebsd.org/ZFSTuningGuide[]." msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/zfs/_index.adoc:2694 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2693 #, no-wrap msgid "Further Resources" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2697 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2696 msgid "https://openzfs.org/[OpenZFS]" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2698 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2697 msgid "https://wiki.freebsd.org/ZFSTuningGuide[FreeBSD Wiki - ZFS Tuning]" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2699 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2698 msgid "" "https://calomel.org/zfs_raid_speed_capacity.html[Calomel Blog - ZFS Raidz " "Performance, Capacity and Integrity]" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/zfs/_index.adoc:2701 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2700 #, no-wrap msgid "ZFS Features and Terminology" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/zfs/_index.adoc:2710 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2709 msgid "" "More than a file system, ZFS is fundamentally different. ZFS combines the " "roles of file system and volume manager, enabling new storage devices to add " @@ -4635,13 +4635,13 @@ msgid "" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2716 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2715 #, no-wrap msgid "[[zfs-term-pool]]pool" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2719 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2718 #, no-wrap msgid "" "A storage _pool_ is the most basic building block of ZFS. A pool consists of one or more vdevs, the underlying devices that store the data. A pool is then used to create one or more file systems (datasets) or block devices (volumes).\n" @@ -4649,13 +4649,13 @@ msgid "" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2720 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2719 #, no-wrap msgid "[[zfs-term-vdev]]vdev Types" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2750 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2749 #, no-wrap msgid "" "A pool consists of one or more vdevs, which themselves are a single disk or a group of disks, transformed to a RAID. When using a lot of vdevs, ZFS spreads data across the vdevs to increase performance and maximize usable space. All vdevs must be at least 128 MB in size. \n" @@ -4690,13 +4690,13 @@ msgid "" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2751 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2750 #, no-wrap msgid "[[zfs-term-txg]] Transaction Group (TXG)" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2757 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2756 #, no-wrap msgid "" "Transaction Groups are the way ZFS groups blocks changes together and writes them to the pool. Transaction groups are the atomic unit that ZFS uses to ensure consistency. ZFS assigns each transaction group a unique 64-bit consecutive identifier. There can be up to three active transaction groups at a time, one in each of these three states: \n" @@ -4707,121 +4707,121 @@ msgid "" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2758 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2757 #, no-wrap msgid "[[zfs-term-arc]]Adaptive Replacement Cache (ARC)" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2760 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2759 #, no-wrap msgid "ZFS uses an Adaptive Replacement Cache (ARC), rather than a more traditional Least Recently Used (LRU) cache. An LRU cache is a simple list of items in the cache, sorted by how recently object was used, adding new items to the head of the list. When the cache is full, evicting items from the tail of the list makes room for more active objects. An ARC consists of four lists; the Most Recently Used (MRU) and Most Frequently Used (MFU) objects, plus a ghost list for each. These ghost lists track evicted objects to prevent adding them back to the cache. This increases the cache hit ratio by avoiding objects that have a history of occasional use. Another advantage of using both an MRU and MFU is that scanning an entire file system would evict all data from an MRU or LRU cache in favor of this freshly accessed content. With ZFS, there is also an MFU that tracks the most frequently used objects, and the cache of the most commonly accessed blocks remains." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2761 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2760 #, no-wrap msgid "[[zfs-term-l2arc]]L2ARC" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2763 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2762 #, no-wrap msgid "L2ARC is the second level of the ZFS caching system. RAM stores the primary ARC. Since the amount of available RAM is often limited, ZFS can also use <<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 disks. L2ARC is entirely optional, but having one will increase read speeds for cached files on the SSD instead of having to read from the regular disks. L2ARC can also speed up <<zfs-term-deduplication,deduplication>> because a deduplication table (DDT) that does not fit in RAM but does fit in the L2ARC will be much faster than a DDT that must read from disk. Limits on the data rate added to the cache devices prevents prematurely wearing out SSDs with extra writes. Until the cache is full (the first block evicted to make room), writes to the L2ARC limit to the sum of the write limit and the boost limit, and afterwards limit to the write limit. A pair of man:sysctl[8] values control these rate limits. <<zfs-advanced-tuning-l2arc_write_max,`vfs.zfs.l2arc_write_max`>> controls the number of bytes written to the cache per second, while <<zfs-advanced-tuning-l2arc_write_boost,`vfs.zfs.l2arc_write_boost`>> adds to this limit during the \"Turbo Warmup Phase\" (Write Boost)." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2764 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2763 #, no-wrap msgid "[[zfs-term-zil]]ZIL" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2766 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2765 #, no-wrap msgid "ZIL accelerates synchronous transactions by using storage devices like SSDs that are faster than those used in the main storage pool. When an application requests a synchronous write (a guarantee that the data is stored to disk rather than merely cached for later writes), writing the data to the faster ZIL storage then later flushing it out to the regular disks greatly reduces latency and improves performance. Synchronous workloads like databases will profit from a ZIL alone. Regular asynchronous writes such as copying files will not use the ZIL at all." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2767 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2766 #, no-wrap msgid "[[zfs-term-cow]]Copy-On-Write" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2769 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2768 #, no-wrap msgid "Unlike a traditional file system, ZFS writes a different block rather than overwriting the old data in place. When completing this write the metadata updates to point to the new location. When a shorn write (a system crash or power loss in the middle of writing a file) occurs, the entire original contents of the file are still available and ZFS discards the incomplete write. This also means that ZFS does not require a man:fsck[8] after an unexpected shutdown." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2770 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2769 #, no-wrap msgid "[[zfs-term-dataset]]Dataset" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2772 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2771 #, no-wrap msgid "_Dataset_ is the generic term for a ZFS file system, volume, snapshot or clone. Each dataset has a unique name in the format _poolname/path@snapshot_. The root of the pool is a dataset as well. Child datasets have hierarchical names like directories. For example, _mypool/home_, the home dataset, is a child of _mypool_ and inherits properties from it. Expand this further by creating _mypool/home/user_. This grandchild dataset will inherit properties from the parent and grandparent. Set properties on a child to override the defaults inherited from the parent and grandparent. Administration of datasets and their children can be <<zfs-zfs-allow,delegated>>." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2773 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2772 #, no-wrap msgid "[[zfs-term-filesystem]]File system" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2775 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2774 #, no-wrap msgid "A ZFS dataset is most often used as a file system. Like most other file systems, a ZFS file system mounts somewhere in the systems directory hierarchy and contains files and directories of its own with permissions, flags, and other metadata." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2776 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2775 #, no-wrap msgid "[[zfs-term-volume]]Volume" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2778 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2777 #, no-wrap msgid "ZFS can also create volumes, which appear as disk devices. Volumes have a lot of the same features as datasets, including copy-on-write, snapshots, clones, and checksumming. Volumes can be useful for running other file system formats on top of ZFS, such as UFS virtualization, or exporting iSCSI extents." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2779 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2778 #, no-wrap msgid "[[zfs-term-snapshot]]Snapshot" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2781 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2780 #, no-wrap msgid "The <<zfs-term-cow,copy-on-write>> (COW) design of ZFS allows for nearly instantaneous, consistent snapshots with arbitrary names. After taking a snapshot of a dataset, or a recursive snapshot of a parent dataset that will include all child datasets, new data goes to new blocks, but without reclaiming the old blocks as free space. The snapshot contains the original file system version and the live file system contains any changes made since taking the snapshot using no other space. New data written to the live file system uses new blocks to store this data. The snapshot will grow as the blocks are no longer used in the live file system, but in the snapshot alone. Mount these snapshots read-only allows recovering of previous file versions. A <<zfs-zfs-snapshot,rollback>> of a live file system to a specific snapshot is possible, undoing any changes that took place after taking the snapshot. Each block in the pool has a reference counter which keeps track of the snapshots, clones, datasets, or volumes use that block. As files and snapshots get deleted, the reference count decreases, reclaiming the free space when no longer referencing a block. Marking snapshots with a <<zfs-zfs-snapshot,hold>> results in any attempt to destroy it will returns an `EBUSY` error. Each snapshot can have holds with a unique name each. The <<zfs-zfs-snapshot,release>> command removes the hold so the snapshot can deleted. Snapshots, cloning, and rolling back works on volumes, but independently mounting does not." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2782 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2781 #, no-wrap msgid "[[zfs-term-clone]]Clone" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2784 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2783 #, no-wrap msgid "Cloning a snapshot is also possible. A clone is a writable version of a snapshot, allowing the file system to fork as a new dataset. As with a snapshot, a clone initially consumes no new space. As new data written to a clone uses new blocks, the size of the clone grows. When blocks are overwritten in the cloned file system or volume, the reference count on the previous block decreases. Removing the snapshot upon which a clone bases is impossible because the clone depends on it. The snapshot is the parent, and the clone is the child. Clones can be _promoted_, reversing this dependency and making the clone the parent and the previous parent the child. This operation requires no new space. Since the amount of space used by the parent and child reverses, it may affect existing quotas and reservations." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2785 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2784 #, no-wrap msgid "[[zfs-term-checksum]]Checksum" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2792 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2791 #, no-wrap msgid "" "Every block is also checksummed. The checksum algorithm used is a per-dataset property, see <<zfs-zfs-set,`set`>>. The checksum of each block is transparently validated when read, allowing ZFS to detect silent corruption. If the data read does not match the expected checksum, ZFS will attempt to recover the data from any available redundancy, like mirrors or RAID-Z. Triggering a validation of all checksums with <<zfs-term-scrub,`scrub`>>. Checksum algorithms include:\n" @@ -4833,13 +4833,13 @@ msgid "" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2793 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2792 #, no-wrap msgid "[[zfs-term-compression]]Compression" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2807 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2806 #, no-wrap msgid "" "Each dataset has a compression property, which defaults to off. Set this property to an available compression algorithm. This causes compression of all new data written to the dataset. Beyond a reduction in space used, read and write throughput often increases because fewer blocks need reading or writing. \n" @@ -4858,49 +4858,49 @@ msgid "" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2808 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2807 #, no-wrap msgid "[[zfs-term-copies]]Copies" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2810 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2809 #, no-wrap msgid "When set to a value greater than 1, the `copies` property instructs ZFS to maintain copies of each block in the <<zfs-term-filesystem,file system>> or <<zfs-term-volume,volume>>. Setting this property on important datasets provides added redundancy from which to recover a block that does not match its checksum. In pools without redundancy, the copies feature is the single form of redundancy. The copies feature can recover from a single bad sector or other forms of minor corruption, but it does not protect the pool from the loss of an entire disk." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2811 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2810 #, no-wrap msgid "[[zfs-term-deduplication]]Deduplication" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2813 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2812 #, no-wrap msgid "Checksums make it possible to detect duplicate blocks when writing data. With deduplication, the reference count of an existing, identical block increases, saving storage space. ZFS keeps a deduplication table (DDT) in memory to detect duplicate blocks. The table contains a list of unique checksums, the location of those blocks, and a reference count. When writing new data, ZFS calculates checksums and compares them to the list. When finding a match it uses the existing block. Using the SHA256 checksum algorithm with deduplication provides a secure cryptographic hash. Deduplication is tunable. If `dedup` is `on`, then a matching checksum means that the data is identical. Setting `dedup` to `verify`, ZFS performs a byte-for-byte check on the data ensuring they are actually identical. If the data is not identical, ZFS will note the hash collision and store the two blocks separately. As the DDT must store the hash of each unique block, it consumes a large amount of memory. A general rule of thumb is 5-6 GB of ram per 1 TB of deduplicated data). In situations not practical to have enough RAM to keep the entire DDT in memory, performance will suffer greatly as the DDT must read from disk before writing each new block. Deduplication can use L2ARC to store the DDT, providing a middle ground between fast system memory and slower disks. Consider using compression instead, which often provides nearly as much space savings without the increased memory." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2814 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2813 #, no-wrap msgid "[[zfs-term-scrub]]Scrub" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2816 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2815 #, no-wrap msgid "Instead of a consistency check like man:fsck[8], ZFS has `scrub`. `scrub` reads all data blocks stored on the pool and verifies their checksums against the known good checksums stored in the metadata. A periodic check of all the data stored on the pool ensures the recovery of any corrupted blocks before needing them. A scrub is not required after an unclean shutdown, but good practice is at least once every three months. ZFS verifies the checksum of each block during normal use, but a scrub makes certain to check even infrequently used blocks for silent corruption. ZFS improves data security in archival storage situations. Adjust the relative priority of `scrub` with <<zfs-advanced-tuning-scrub_delay,`vfs.zfs.scrub_delay`>> to prevent the scrub from degrading the performance of other workloads on the pool." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2817 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2816 #, no-wrap msgid "[[zfs-term-quota]]Dataset Quota" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2828 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2827 #, no-wrap msgid "" "ZFS provides fast and accurate dataset, user, and group space accounting as well as quotas and space reservations. This gives the administrator fine grained control over space allocation and allows reserving space for critical file systems. \n" @@ -4916,49 +4916,49 @@ msgid "" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2829 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2828 #, no-wrap msgid "[[zfs-term-refquota]]Reference Quota" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2831 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2830 #, no-wrap msgid "A reference quota limits the amount of space a dataset can consume by enforcing a hard limit. This hard limit includes space referenced by the dataset alone and does not include space used by descendants, such as file systems or snapshots." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2832 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2831 #, no-wrap msgid "[[zfs-term-userquota]]User Quota" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2834 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2833 #, no-wrap msgid "User quotas are useful to limit the amount of space used by the specified user." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2835 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2834 #, no-wrap msgid "[[zfs-term-groupquota]]Group Quota" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2837 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2836 #, no-wrap msgid "The group quota limits the amount of space that a specified group can consume." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2838 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2837 #, no-wrap msgid "[[zfs-term-reservation]]Dataset Reservation" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2842 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2841 #, no-wrap msgid "" "The `reservation` property makes it possible to guarantee an amount of space for a specific dataset and its descendants. This means that setting a 10 GB reservation on [.filename]#storage/home/bob# prevents other datasets from using up all free space, reserving at least 10 GB of space for this dataset. Unlike a regular <<zfs-term-refreservation,`refreservation`>>, space used by snapshots and descendants is not counted against the reservation. For example, if taking a snapshot of [.filename]#storage/home/bob#, enough disk space other than the `refreservation` amount must exist for the operation to succeed. Descendants of the main data set are not counted in the `refreservation` amount and so do not encroach on the space set.\n" @@ -4967,73 +4967,73 @@ msgid "" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2843 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2842 #, no-wrap msgid "[[zfs-term-refreservation]]Reference Reservation" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2845 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2844 #, no-wrap msgid "The `refreservation` property makes it possible to guarantee an amount of space for the use of a specific dataset _excluding_ its descendants. This means that setting a 10 GB reservation on [.filename]#storage/home/bob#, and another dataset tries to use the free space, reserving at least 10 GB of space for this dataset. In contrast to a regular <<zfs-term-reservation,reservation>>, space used by snapshots and descendant datasets is not counted against the reservation. For example, if taking a snapshot of [.filename]#storage/home/bob#, enough disk space other than the `refreservation` amount must exist for the operation to succeed. Descendants of the main data set are not counted in the `refreservation` amount and so do not encroach on the space set." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2846 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2845 #, no-wrap msgid "[[zfs-term-resilver]]Resilver" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2847 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2846 #, no-wrap msgid "When replacing a failed disk, ZFS must fill the new disk with the lost data. _Resilvering_ is the process of using the parity information distributed across the remaining drives to calculate and write the missing data to the new drive." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2848 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2847 #, no-wrap msgid "[[zfs-term-online]]Online" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2850 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2849 #, no-wrap msgid "A pool or vdev in the `Online` state has its member devices connected and fully operational. Individual devices in the `Online` state are functioning." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2851 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2850 #, no-wrap msgid "[[zfs-term-offline]]Offline" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2853 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2852 #, no-wrap msgid "The administrator puts individual devices in an `Offline` state if enough redundancy exists to avoid putting the pool or vdev into a <<zfs-term-faulted,Faulted>> state. An administrator may choose to offline a disk in preparation for replacing it, or to make it easier to identify." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2854 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2853 #, no-wrap msgid "[[zfs-term-degraded]]Degraded" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2856 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2855 #, no-wrap msgid "A pool or vdev in the `Degraded` state has one or more disks that disappeared or failed. The pool is still usable, but if other devices fail, the pool may become unrecoverable. Reconnecting the missing devices or replacing the failed disks will return the pool to an <<zfs-term-online,Online>> state after the reconnected or new device has completed the <<zfs-term-resilver,Resilver>> process." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2857 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2856 #, no-wrap msgid "[[zfs-term-faulted]]Faulted" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/zfs/_index.adoc:2858 +#: documentation/content/en/books/handbook/zfs/_index.adoc:2857 #, no-wrap msgid "A pool or vdev in the `Faulted` state is no longer operational. Accessing the data is no longer possible. A pool or vdev enters the `Faulted` state when the number of missing or failed devices exceeds the level of redundancy in the vdev. If reconnecting missing devices the pool will return to an <<zfs-term-online,Online>> state. Insufficient redundancy to compensate for the number of failed disks loses the pool contents and requires restoring from backups." msgstr "" |