From b36069ab8862502760bc6edcd16c45bceb9aadc8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=BD=D0=B0=D0=B1?= Date: Wed, 16 Mar 2022 18:04:32 +0100 Subject: [PATCH] man: zpool-remove.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 --- man/man8/zpool-remove.8 | 44 ++++++++++++++++++++++++++++++++++++++++- man/man8/zpool.8 | 1 + 2 files changed, 44 insertions(+), 1 deletion(-) diff --git a/man/man8/zpool-remove.8 b/man/man8/zpool-remove.8 index 2e1bfec3fa..ec476ec885 100644 --- a/man/man8/zpool-remove.8 +++ b/man/man8/zpool-remove.8 @@ -26,12 +26,14 @@ .\" Copyright 2017 Nexenta Systems, Inc. .\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved. .\" -.Dd August 9, 2019 +.Dd March 16, 2022 .Dt ZPOOL-REMOVE 8 .Os +. .Sh NAME .Nm zpool-remove .Nd remove devices from ZFS storage pool +. .Sh SYNOPSIS .Nm zpool .Cm remove @@ -41,6 +43,7 @@ .Cm remove .Fl s .Ar pool +. .Sh DESCRIPTION .Bl -tag -width Ds .It Xo @@ -102,6 +105,45 @@ Waits until the removal has completed before returning. .Xc Stops and cancels an in-progress removal of a top-level vdev. .El +. +.Sh EXAMPLES +.\" These are, respectively, examples 14 from zpool.8 +.\" Make sure to update them bidirectionally +.Ss Example 1 : No Removing a Mirrored top-level (Log or Data) Device +The following commands remove the mirrored log device +.Sy mirror-2 +and mirrored top-level data device +.Sy mirror-1 . +.Pp +Given this configuration: +.Bd -literal -compact -offset Ds + pool: tank + state: ONLINE + scrub: none requested +config: + + NAME STATE READ WRITE CKSUM + tank ONLINE 0 0 0 + mirror-0 ONLINE 0 0 0 + sda ONLINE 0 0 0 + sdb ONLINE 0 0 0 + mirror-1 ONLINE 0 0 0 + sdc ONLINE 0 0 0 + sdd ONLINE 0 0 0 + logs + mirror-2 ONLINE 0 0 0 + sde ONLINE 0 0 0 + sdf ONLINE 0 0 0 +.Ed +.Pp +The command to remove the mirrored log +.Ar mirror-2 No is: +.Dl # Nm zpool Cm remove Ar tank mirror-2 +.Pp +The command to remove the mirrored data +.Ar mirror-1 No is: +.Dl # Nm zpool Cm remove Ar tank mirror-1 +. .Sh SEE ALSO .Xr zpool-add 8 , .Xr zpool-detach 8 , diff --git a/man/man8/zpool.8 b/man/man8/zpool.8 index 57e86cf347..345ce21ddf 100644 --- a/man/man8/zpool.8 +++ b/man/man8/zpool.8 @@ -237,6 +237,7 @@ Invalid command line options were specified. .\" Examples 8 are shared with zpool-export.8. .\" Examples 9 are shared with zpool-import.8. .\" Examples 10 are shared with zpool-upgrade.8. +.\" Examples 14 are shared with zpool-remove.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