From 9cdb06753966f8419260114a081e8a083a680351 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=BD=D0=B0=D0=B1?= Date: Wed, 16 Mar 2022 17:47:06 +0100 Subject: [PATCH] man: zpool-create.8: import examples from zpool.8 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Reviewed-by: Brian Behlendorf Signed-off-by: Ahelenia Ziemiańska Closes #13228 Closes #13140 --- man/man8/zpool-create.8 | 34 +++++++++++++++++++++++++++++++++- man/man8/zpool.8 | 4 +++- 2 files changed, 36 insertions(+), 2 deletions(-) diff --git a/man/man8/zpool-create.8 b/man/man8/zpool-create.8 index e902c77007..c1d1c7d564 100644 --- a/man/man8/zpool-create.8 +++ b/man/man8/zpool-create.8 @@ -27,7 +27,7 @@ .\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved. .\" Copyright (c) 2021, Colm Buckley .\" -.Dd June 2, 2021 +.Dd March 16, 2022 .Dt ZPOOL-CREATE 8 .Os . @@ -205,6 +205,38 @@ such as virtual machines or physical machines whose pools live on network block devices. .El . +.Sh EXAMPLES +.\" These are, respectively, examples 1, 2, 3, 4, 11, 12 from zpool.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 +consists of six disks: +.Dl # Nm zpool Cm create Ar tank Sy raidz Pa sda sdb sdc sdd sde sdf +. +.Ss 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 Pa sda sdb Sy mirror Pa sdc sdd +. +.Ss Example 3 : No Creating a ZFS Storage Pool by Using Partitions +The following command creates a non-redundant pool using two disk partitions: +.Dl # Nm zpool Cm create Ar tank Pa sda1 sdb2 +. +.Ss Example 4 : No Creating a ZFS Storage Pool by Using Files +The following command creates a non-redundant pool using files. +While not recommended, a pool based on files can be useful for experimental +purposes. +.Dl # Nm zpool Cm create Ar tank Pa /path/to/file/a /path/to/file/b +. +.Ss Example 5 : 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 Pa sda sdb Sy spare Pa sdc +. +.Ss Example 6 : 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 Pa sda sdb Sy mirror Pa sdc sdd Sy log mirror Pa sde sdf +. .Sh SEE ALSO .Xr zpool-destroy 8 , .Xr zpool-export 8 , diff --git a/man/man8/zpool.8 b/man/man8/zpool.8 index a8e8b23b7d..ace00d7ad4 100644 --- a/man/man8/zpool.8 +++ b/man/man8/zpool.8 @@ -26,7 +26,7 @@ .\" Copyright 2017 Nexenta Systems, Inc. .\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved. .\" -.Dd June 2, 2021 +.Dd March 16, 2022 .Dt ZPOOL 8 .Os . @@ -230,6 +230,8 @@ Invalid command line options were specified. .El . .Sh EXAMPLES +.\" Examples 1, 2, 3, 4, 11, 12 are shared with zpool-create.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 consists of six disks: