zfs-deferred-snapshot-destruction · shipping · also zfs destroy -d, ZFS defer_destroy

ZFS deferred snapshot destruction

ZFS deferred snapshot destruction marks an ineligible snapshot for automatic deletion once its holds and clone dependencies no longer prevent removal.

Related Observatory article: ZFS deferred snapshot destruction on hesela.com

Request versus waiting: zfs destroy -d can delete an eligible snapshot immediately; it is not a preview command. A pending snapshot remains visible and can acquire new holds or clones. [1]

Pending status: defer_destroy is read-only. Adding a hold does not cancel the pending request. Inspect userrefs, hold tags and clones together; visibility alone is not a retention guarantee. [2] [1]

Removal triggers: releasing the final hold can delete a pending snapshot with no remaining clones. Destroying the final dependent clone can delete its pending origin when no user holds remain. These paths are source-verified in OpenZFS 2.3.0; active internal long holds can make the release check return EBUSY. [3] [4]

Promotion is different: it reverses the origin/clone relationship and transfers snapshot ownership, rather than removing every dependency. Reinspect the snapshot under its new owner. A releasable hold is not administrator-resistant retention. [5] [6]

Relations

related
ZFS snapshot hold, ZFS dataset clone, ZFS clone promotion, Storage snapshot

Citations

  1. OpenZFS v2.3: zfs-destroy(8), snapshot eligibility and -d versus -n (accessed 2026-10-22)
  2. OpenZFS v2.3: zfsprops(7), read-only defer_destroy, userrefs and clones (accessed 2026-10-22)
  3. OpenZFS zfs-2.3.0: dsl_userhold.c, release check and sync paths (accessed 2026-10-22)
  4. OpenZFS zfs-2.3.0: dsl_destroy.c, immediate snapshot and deferred origin destruction (accessed 2026-10-22)
  5. OpenZFS v2.3: zfs-promote(8), reversed dependency and transferred snapshots (accessed 2026-10-22)
  6. OpenZFS v2.3: zfs-allow(8), release permission may destroy a snapshot (accessed 2026-10-22)
Sources & caveats
  • Documentation review of OpenZFS v2.3 and source inspection of tag zfs-2.3.0; no live pool, deletion or recovery experiment was performed.

JSON: /data/terms/zfs-deferred-snapshot-destruction.json

Published by Hesela team · Updated

Report a correction · Editorial standards · Reuse guidance

Cite this page
Hesela team. ZFS deferred snapshot destruction. Hesela. 2026-10-22. https://hesela.dev/terms/zfs-deferred-snapshot-destruction/