Archive-Team
/
zfs
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 103 Wiki Activity

man: zpool-remove.8: import examples from zpool.8 

Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Closes #13228
This commit is contained in:
наб 2022-03-16 18:04:32 +01:00 committed by Brian Behlendorf
parent d8dd89acd1
commit b36069ab88
2 changed files with 44 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

44
man/man8/zpool-remove.8
View File

@ -26,12 +26,14 @@
.\" Copyright 2017 Nexenta Systems, Inc. .\" Copyright 2017 Nexenta Systems, Inc.
.\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved. .\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved.
.\" .\"
.Dd August 9, 2019 .Dd March 16, 2022
.Dt ZPOOL-REMOVE 8 .Dt ZPOOL-REMOVE 8
.Os .Os
.
.Sh NAME .Sh NAME
.Nm zpool-remove .Nm zpool-remove
.Nd remove devices from ZFS storage pool .Nd remove devices from ZFS storage pool
.
.Sh SYNOPSIS .Sh SYNOPSIS
.Nm zpool .Nm zpool
.Cm remove .Cm remove
@ -41,6 +43,7 @@
.Cm remove .Cm remove
.Fl s .Fl s
.Ar pool .Ar pool
.
.Sh DESCRIPTION .Sh DESCRIPTION
.Bl -tag -width Ds .Bl -tag -width Ds
.It Xo .It Xo
@ -102,6 +105,45 @@ Waits until the removal has completed before returning.
.Xc .Xc
Stops and cancels an in-progress removal of a top-level vdev. Stops and cancels an in-progress removal of a top-level vdev.
.El .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 .Sh SEE ALSO
.Xr zpool-add 8 , .Xr zpool-add 8 ,
.Xr zpool-detach 8 , .Xr zpool-detach 8 ,

1
man/man8/zpool.8
View File

@ -237,6 +237,7 @@ Invalid command line options were specified.
.\" Examples 8 are shared with zpool-export.8. .\" Examples 8 are shared with zpool-export.8.
.\" Examples 9 are shared with zpool-import.8. .\" Examples 9 are shared with zpool-import.8.
.\" Examples 10 are shared with zpool-upgrade.8. .\" Examples 10 are shared with zpool-upgrade.8.
.\" Examples 14 are shared with zpool-remove.8.
.\" Make sure to update them bidirectionally .\" Make sure to update them bidirectionally
.Ss Example 1 : No Creating a RAID-Z Storage Pool .Ss Example 1 : No Creating a RAID-Z Storage Pool
The following command creates a pool with a single raidz root vdev that The following command creates a pool with a single raidz root vdev that