aboutsummaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorнаб <[email protected]>2022-03-16 18:02:42 +0100
committerBrian Behlendorf <[email protected]>2022-03-28 10:13:13 -0700
commitc34eb6f7a1ff9d1e0b22e937d629e8097d34f587 (patch)
tree6729f7e9235e9bb2d9c188f103fd117311e83510 /man
parent9cdb06753966f8419260114a081e8a083a680351 (diff)
man: zpool-add.8: import examples from zpool.8
Reviewed-by: Brian Behlendorf <[email protected]> Signed-off-by: Ahelenia Ziemiańska <[email protected]> Closes #13228
Diffstat (limited to 'man')
-rw-r--r--man/man8/zpool-add.825
-rw-r--r--man/man8/zpool.81
2 files changed, 25 insertions, 1 deletions
diff --git a/man/man8/zpool-add.8 b/man/man8/zpool-add.8
index 26cf33c55..04171ae02 100644
--- a/man/man8/zpool-add.8
+++ b/man/man8/zpool-add.8
@@ -25,7 +25,7 @@
.\" Copyright 2017 Nexenta Systems, Inc.
.\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved.
.\"
-.Dd May 27, 2021
+.Dd March 16, 2022
.Dt ZPOOL-ADD 8
.Os
.
@@ -93,6 +93,29 @@ The only property supported at the moment is
.Sy ashift .
.El
.
+.Sh EXAMPLES
+.\" These are, respectively, examples 5, 13 from zpool.8
+.\" Make sure to update them bidirectionally
+.Ss Example 1 : 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 Pa sda sdb
+.
+.Ss Example 2 : 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 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
+them to fill.
+Capacity and reads can be monitored using the
+.Cm iostat
+subcommand as follows:
+.Dl # Nm zpool Cm iostat Fl v Ar pool 5
+.
.Sh SEE ALSO
.Xr zpool-attach 8 ,
.Xr zpool-import 8 ,
diff --git a/man/man8/zpool.8 b/man/man8/zpool.8
index ace00d7ad..5a11567a8 100644
--- a/man/man8/zpool.8
+++ b/man/man8/zpool.8
@@ -231,6 +231,7 @@ Invalid command line options were specified.
.
.Sh EXAMPLES
.\" Examples 1, 2, 3, 4, 11, 12 are shared with zpool-create.8.
+.\" Examples 5, 13 are shared with zpool-add.8.
.\" Make sure to update them bidirectionally
.Ss Example 1 : No Creating a RAID-Z Storage Pool
The following command creates a pool with a single raidz root vdev that