zfs/man/man8
Ryan Moeller 6fe3498ca3
Import vdev ashift optimization from FreeBSD
Many modern devices use physical allocation units that are much
larger than the minimum logical allocation size accessible by
external commands. Two prevalent examples of this are 512e disk
drives (512b logical sector, 4K physical sector) and flash devices
(512b logical sector, 4K or larger allocation block size, and 128k
or larger erase block size). Operations that modify less than the
physical sector size result in a costly read-modify-write or garbage
collection sequence on these devices.

Simply exporting the true physical sector of the device to ZFS would
yield optimal performance, but has two serious drawbacks:

 1. Existing pools created with devices that have different logical
    and physical block sizes, but were configured to use the logical
    block size (e.g. because the OS version used for pool construction
    reported the logical block size instead of the physical block
    size) will suddenly find that the vdev allocation size has
    increased. This can be easily tolerated for active members of
    the array, but ZFS would prevent replacement of a vdev with
    another identical device because it now appears that the smaller
    allocation size required by the pool is not supported by the new
    device.

 2. The device's physical block size may be too large to be supported
    by ZFS. The optimal allocation size for the vdev may be quite
    large. For example, a RAID controller may export a vdev that
    requires read-modify-write cycles unless accessed using 64k
    aligned/sized requests. ZFS currently has an 8k minimum block
    size limit.

Reporting both the logical and physical allocation sizes for vdevs
solves these problems. A device may be used so long as the logical
block size is compatible with the configuration. By comparing the
logical and physical block sizes, new configurations can be optimized
and administrators can be notified of any existing pools that are
sub-optimal.

Reviewed-by: Ryan Moeller <ryan@iXsystems.com>
Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Co-authored-by: Matthew Macy <mmacy@freebsd.org>
Signed-off-by: Matt Macy <mmacy@FreeBSD.org>
Closes #10619
2020-08-21 12:53:17 -07:00
..
.gitignore Ignore *.o.ur-safe build artifacts 2018-05-13 18:59:02 -07:00
Makefile.am Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
fsck.zfs.8 Reorganize zpool(8) man page into sections 2019-11-13 09:21:07 -08:00
mount.zfs.8 zfs.8 & mount.zfs.8: fix a few typos 2016-05-16 12:26:31 -07:00
vdev_id.8 vdev_id support for device link aliases 2012-12-03 14:04:47 -08:00
zdb.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zed.8.in zed additional features 2020-06-22 09:53:34 -07:00
zfs-allow.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-bookmark.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-change-key.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-clone.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-create.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-destroy.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-diff.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -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 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-inherit.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-jail.8 Add FreeBSD jail support hooks 2019-12-11 11:58:37 -08:00
zfs-list.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-load-key.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-mount-generator.8.in Systemd mount generator: Generate noauto units; add control properties 2020-02-14 15:32:55 -08:00
zfs-mount.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-program.8 Support setting user properties in a channel program 2020-02-14 13:41:42 -08:00
zfs-project.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-projectspace.8 Reorganize zfs(8) man page into sections 2019-11-12 11:17:40 -08:00
zfs-promote.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-receive.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -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 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-rollback.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-send.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-set.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-share.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-snapshot.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -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-upgrade.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-userspace.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs-wait.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfs_ids_to_path.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfsconcepts.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zfsprops.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zgenhostid.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zinject.8 Multiple DVA Scrubbing Fix 2019-03-15 14:14:31 -07:00
zpool-add.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-attach.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-checkpoint.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-clear.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-create.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-destroy.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-detach.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-events.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-export.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-get.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-history.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-import.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-initialize.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-iostat.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-labelclear.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-list.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-offline.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-online.8 Reorganize zpool(8) man page into sections 2019-11-13 09:21:07 -08:00
zpool-reguid.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-remove.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-reopen.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-replace.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-resilver.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-scrub.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-set.8 Reorganize zpool(8) man page into sections 2019-11-13 09:21:07 -08:00
zpool-split.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-status.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-sync.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-trim.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-upgrade.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool-wait.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpool.8 Import vdev ashift optimization from FreeBSD 2020-08-21 12:53:17 -07:00
zpoolconcepts.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zpoolprops.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zstream.8 Remove hard coded "Linux" OS from manpages 2020-08-21 11:55:47 -07:00
zstreamdump.8 Eliminate useless double-bolding in man pages 2019-04-24 17:04:35 -07:00