]> git.proxmox.com Git - mirror_zfs.git/commit - man/man5/zpool-features.5
OpenZFS 9238 - ZFS Spacemap Encoding V2
authorSerapheim Dimitropoulos <serapheim@delphix.com>
Fri, 4 Aug 2017 16:30:49 +0000 (09:30 -0700)
committerBrian Behlendorf <behlendorf1@llnl.gov>
Thu, 5 Jul 2018 19:02:34 +0000 (12:02 -0700)
commit4d044c4c1d68ed518fe37eea61a4cc77048940fb
treee9e7f15b37f046a508ae038246e3808e17eed625
parent4e82b4be78b0febb2a6add5dc070f34b27a4b786
OpenZFS 9238 - ZFS Spacemap Encoding V2

Motivation
==========

The current space map encoding has the following disadvantages:
[1] Assuming 512 sector size each entry can represent at most 16MB for a segment.
    This makes the encoding very inefficient for large regions of space.
[2] As vdev-wide space maps have started to be used by new features (i.e.
    device removal, zpool checkpoint) we've started imposing limits in the
    vdevs that can be used with them based on the maximum addressable offset
    (currently 64PB for a top-level vdev).

New encoding
============

The layout can be found at space_map.h and it remains backwards compatible with
the old one. The introduced two-word entry format, besides extending the limits
imposed by the single-entry layout, also includes a vdev field and some extra
padding after its prefix.

The extra padding after the prefix should is reserved for future usage (e.g.
new prefixes for future encodings or new fields for flags). The new vdev field
not only makes the space maps more self-descriptive, but also opens the doors
for pool-wide space maps (expected to be used in the log spacemap project).

One final important note is that the number of bits used for vdevs is reduced
to 24 bits for blkptrs. That was decided as we don't know of any setups that
use more than 16M vdevs for the time being and we wanted to fit the vdev field
in the space map. In addition that gives us some extra bits in dva_t.

Other references:
=================

The new encoding is also discussed towards the end of the Log Space Map
presentation from 2017's OpenZFS summit.
Link: https://www.youtube.com/watch?v=jj2IxRkl5bQ
Authored by: Serapheim Dimitropoulos <serapheim@delphix.com>
Reviewed by: Matt Ahrens <mahrens@delphix.com>
Reviewed by: George Wilson <gwilson@zfsmail.com>
Reviewed by: Brian Behlendorf <behlendorf1@llnl.gov>
Approved by: Gordon Ross <gwr@nexenta.com>
Ported-by: Tim Chase <tim@chase2k.com>
Signed-off-by: Tim Chase <tim@chase2k.com>
OpenZFS-commit: https://github.com/openzfs/openzfs/commit/90a56e6d
OpenZFS-issue: https://www.illumos.org/issues/9238
Closes #7665
15 files changed:
cmd/zdb/zdb.c
cmd/ztest/ztest.c
include/sys/spa.h
include/sys/space_map.h
include/zfeature_common.h
man/man5/zpool-features.5
module/zcommon/zfeature_common.c
module/zfs/metaslab.c
module/zfs/spa_checkpoint.c
module/zfs/space_map.c
module/zfs/vdev.c
module/zfs/vdev_indirect.c
module/zfs/vdev_indirect_mapping.c
tests/zfs-tests/tests/functional/cli_root/zpool_get/zpool_get.cfg
tests/zfs-tests/tests/functional/pool_checkpoint/checkpoint_discard_busy.ksh