mirror_zfs/man/man8
Brian Behlendorf 7987d4deb4 Update device removal documentation
Make a minor update to the 'zpool remove' man page to clarify both
raidz and draid pools do not support removal, and change sector to
ashift which is what we actually care about.

Update the big theory comment in vdev_removal.c to accurately reflect
which types of vdevs can be removed.  Furthermore, I've added some
discussion for the casual reader to briefly explain the top-level
vdev removal restrictions.  This has been a common area of confusion
and it's not intuitive where they come from without understanding
the implementation details.

Signed-off-by: Brian Behlendorf <behlendorf1@llnl.gov>
Reviewed-by: George Melikov <mail@gmelikov.ru>
Reviewed-by: Alexander Motin <alexander.motin@TrueNAS.com>
Closes #17847
2025-10-21 09:50:43 -07:00
..
.gitignore Add zfs_prepare_disk script for disk firmware install 2023-09-21 08:36:26 -07:00
fsck.zfs.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
mount.zfs.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
vdev_id.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zdb.8 zdb: add --class=(normal|special|...) to filter blocks by alloc class 2025-10-21 09:50:43 -07:00
zed.8.in zed: Add synchronous zedlets 2025-09-11 15:58:59 -07:00
zfs_ids_to_path.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs_prepare_disk.8.in SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-allow.8 ZFS allow send:encrypted 2025-09-12 15:05:02 -07:00
zfs-bookmark.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-change-key.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-clone.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-create.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-destroy.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-diff.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-get.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-groupspace.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-hold.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-inherit.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-jail.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-list.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-load-key.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-mount-generator.8.in manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-mount.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-program.8 zfs-program(8): document zfs.sync.clone() 2025-06-10 14:53:18 -07:00
zfs-project.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-projectspace.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-promote.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-receive.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zfs-recv.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-redact.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-release.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-rename.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-rewrite.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-rollback.8 zfs-rollback.8: fix typo in example number 2025-04-28 15:38:08 -04:00
zfs-send.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-set.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-share.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-snapshot.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-unallow.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-unjail.8 Add FreeBSD jail support hooks 2019-12-11 11:58:37 -08:00
zfs-unload-key.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-unmount.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-unzone.8 Add Linux namespace delegation support 2022-06-10 09:51:46 -07:00
zfs-upgrade.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-userspace.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-wait.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs-zone.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zfs.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zgenhostid.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zinject.8 zinject: Introduce ready delay fault injection 2025-10-21 09:50:43 -07:00
zpool_influxdb.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-add.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-attach.8 Use "vdev" instead of "devices" when referring to vdevs 2025-09-25 12:07:52 -07:00
zpool-checkpoint.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-clear.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-create.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-ddtprune.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-destroy.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-detach.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-events.8 Detect a slow raidz child during reads 2025-09-10 15:31:30 -07:00
zpool-export.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-get.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-history.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-import.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-initialize.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-iostat.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-labelclear.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-list.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-offline.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-online.8 Reorganize zpool(8) man page into sections 2019-11-13 09:21:07 -08:00
zpool-prefetch.8 SPDX: license tags: CDDL-1.0 2025-03-13 17:56:27 -07:00
zpool-reguid.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-remove.8 Update device removal documentation 2025-10-21 09:50:43 -07:00
zpool-reopen.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-replace.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-resilver.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-scrub.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-set.8 Reorganize zpool(8) man page into sections 2019-11-13 09:21:07 -08:00
zpool-split.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-status.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-sync.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-trim.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool-upgrade.8 manuals: fix typos in zpool-upgrade man page 2025-09-29 16:50:57 -07:00
zpool-wait.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zpool.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zstream.8 manuals: Audit/bump dates for last content change 2025-09-09 17:04:19 -07:00
zstreamdump.8 zstreamdump: replace with link to zstream 2021-05-21 10:16:14 -07:00