diff --git a/man/man8/zpool.8 b/man/man8/zpool.8 index 3e71e65ab7..337836b767 100644 --- a/man/man8/zpool.8 +++ b/man/man8/zpool.8 @@ -234,29 +234,29 @@ Invalid command line options were specified. .It Sy Example 1 : No Creating a RAID-Z Storage Pool The following command creates a pool with a single raidz root vdev that consists of six disks: -.Dl # Nm zpool Cm create Ar tank Sy raidz Ar sda sdb sdc sdd sde sdf +.Dl # Nm zpool Cm create Ar tank Sy raidz Pa sda sdb sdc sdd sde sdf . .It Sy Example 2 : No Creating a Mirrored Storage Pool The following command creates a pool with two mirrors, where each mirror contains two disks: -.Dl # Nm zpool Cm create Ar tank Sy mirror Ar sda sdb Sy mirror Ar sdc sdd +.Dl # Nm zpool Cm create Ar tank Sy mirror Pa sda sdb Sy mirror Pa sdc sdd . .It Sy Example 3 : No Creating a ZFS Storage Pool by Using Partitions The following command creates an unmirrored pool using two disk partitions: -.Dl # Nm zpool Cm create Ar tank sda1 sdb2 +.Dl # Nm zpool Cm create Ar tank Pa sda1 sdb2 . .It Sy Example 4 : No Creating a ZFS Storage Pool by Using Files The following command creates an unmirrored pool using files. While not recommended, a pool based on files can be useful for experimental purposes. -.Dl # Nm zpool Cm create Ar tank /path/to/file/a /path/to/file/b +.Dl # Nm zpool Cm create Ar tank Pa /path/to/file/a /path/to/file/b . .It Sy Example 5 : No Adding a Mirror to a ZFS Storage Pool The following command adds two mirrored disks to the pool .Ar tank , assuming the pool is already made up of two-way mirrors. The additional space is immediately available to any datasets within the pool. -.Dl # Nm zpool Cm add Ar tank Sy mirror Ar sda sdb +.Dl # Nm zpool Cm add Ar tank Sy mirror Pa sda sdb . .It Sy Example 6 : No Listing Available ZFS Storage Pools The following command lists all available pools on the system. @@ -315,28 +315,28 @@ This system is currently running ZFS version 2. . .It Sy Example 11 : No Managing Hot Spares The following command creates a new pool with an available hot spare: -.Dl # Nm zpool Cm create Ar tank Sy mirror Ar sda sdb Sy spare Ar sdc +.Dl # Nm zpool Cm create Ar tank Sy mirror Pa sda sdb Sy spare Pa sdc .Pp If one of the disks were to fail, the pool would be reduced to the degraded state. The failed device can be replaced using the following command: -.Dl # Nm zpool Cm replace Ar tank sda sdd +.Dl # Nm zpool Cm replace Ar tank Pa sda sdd .Pp Once the data has been resilvered, the spare is automatically removed and is made available for use should another device fail. The hot spare can be permanently removed from the pool using the following command: -.Dl # Nm zpool Cm remove Ar tank sdc +.Dl # Nm zpool Cm remove Ar tank Pa sdc . .It Sy Example 12 : No Creating a ZFS Pool with Mirrored Separate Intent Logs The following command creates a ZFS storage pool consisting of two, two-way mirrors and mirrored log devices: -.Dl # Nm zpool Cm create Ar pool Sy mirror Ar sda sdb Sy mirror Ar sdc sdd Sy log mirror Ar sde sdf +.Dl # Nm zpool Cm create Ar pool Sy mirror Pa sda sdb Sy mirror Pa sdc sdd Sy log mirror Pa sde sdf . .It Sy Example 13 : No Adding Cache Devices to a ZFS Pool The following command adds two disks for use as cache devices to a ZFS storage pool: -.Dl # Nm zpool Cm add Ar pool Sy cache Ar sdc sdd +.Dl # Nm zpool Cm add Ar pool Sy cache Pa sdc sdd .Pp Once added, the cache devices gradually fill with content from main memory. Depending on the size of your cache devices, it could take over an hour for @@ -402,7 +402,7 @@ data 23.9G 14.6G 9.30G - 48% 61% 1.00x ONLINE - Additional columns can be added to the .Nm zpool Cm status No and Nm zpool Cm iostat No output with Fl c . .Bd -literal -compact -offset Ds -.No # Nm zpool Cm status Fl c Ar vendor , Ns Ar model , Ns Ar size +.No # Nm zpool Cm status Fl c Pa vendor , Ns Pa model , Ns Pa size NAME STATE READ WRITE CKSUM vendor model size tank ONLINE 0 0 0 mirror-0 ONLINE 0 0 0 @@ -413,7 +413,7 @@ Additional columns can be added to the U13 ONLINE 0 0 0 SEAGATE ST8000NM0075 7.3T U14 ONLINE 0 0 0 SEAGATE ST8000NM0075 7.3T -.No # Nm zpool Cm iostat Fl vc Ar size +.No # Nm zpool Cm iostat Fl vc Pa size capacity operations bandwidth pool alloc free read write read write size ---------- ----- ----- ----- ----- ----- ----- ----