vdev · shipping · also vdev, ZFS virtual device, virtual device (ZFS)

ZFS virtual device (vdev)

A ZFS virtual device (vdev) is a node in a pool's storage hierarchy representing a backing device or a supported device arrangement such as a mirror or RAIDZ group.

Related Observatory article: ZFS virtual device (vdev) on hesela.com

A leaf vdev is a backing endpoint; a top-level vdev sits directly below the pool's root. Normal pool allocations span top-level data vdevs, while mirror or parity redundancy operates within each group. Losing a required data-bearing top-level vdev beyond its redundancy can make the pool unavailable and cause data loss. [1]

A leaf can be a disk, partition or experimental file backing. An unused spare is replacement capacity, not extra current replicas. Cache devices hold read-cache copies; log devices hold separate intent-log blocks. The special and dedup classes hold authoritative allocated blocks, not disposable caches. Roles and redundancy must be checked separately; an individual member failure is not automatically whole-pool loss. [2]

Relations

related
ZFS, RAIDZ, ZFS separate log, Mirroring (storage), Failure domain, Resilver

Citations

  1. OpenZFS: VDEVs, pool hierarchy and redundancy boundaries (accessed 2026-10-25)
  2. OpenZFS 2.3: zpoolconcepts(7), device roles and failure states (accessed 2026-10-25)
Sources & caveats
  • Pool hierarchy uses the OpenZFS Basic Concepts terminology: root, top-level and leaf.
  • Failure statements concern required data-bearing vdevs, not every cache, spare or log event; no availability probability is claimed.

JSON: /data/terms/vdev.json

Published by Hesela team · Updated

Report a correction · Editorial standards · Reuse guidance

Cite this page
Hesela team. ZFS virtual device (vdev). Hesela. 2026-10-25. https://hesela.dev/terms/vdev/