ZFS-HOLD(8)

📦
version 2.4.4 · 6 versions
, in alpine 3.23, alpine 3.24, nixos 26.05, nixpkgs unstable, ubuntu resolute, ubuntu stonking

💖 ZFS-HOLD(8) 💖

okay bestie, welcome to zfs-hold — it's part of the System Manager's Manual and it's literally the girl who holds your snapshots so nobody can delete them. iconic behaviour honestly. 🫶

✨ NAME ✨

zfs-hold — hold ZFS snapshots to prevent their removal

🌸 SYNOPSIS 🌸

zfs hold [-r] tag snapshot…
zfs holds [-rHp] snapshot…
zfs release [-r] tag snapshot…

🎀 DESCRIPTION 🎀

🦋 zfs hold [-r] tag snapshot…

Adds a single reference, named with the tag argument, to the specified snapshots. no cap, that's it. Each snapshot has its own tag namespace, and tags must be unique within that space — so don't be out here duplicating your tag names on the same snapshot, it's giving messy. 💅

If a hold exists on a snapshot, attempts to destroy that snapshot by using the zfs destroy command return EBUSY. so like… your snapshot is protected, periodt. 💀

  • -r — Specifies that a hold with the given tag is applied recursively to the snapshots of all descendent file systems. it's giving "and the whole family too". 👑

🌈 zfs holds [-rHp] snapshot…

Lists all existing user references for the given snapshot or snapshots. this is the receipts-listing command, fr fr. 🧚

  • -r — Lists the holds that are set on the named descendent snapshots, in addition to listing the holds on the named snapshot.
  • -H — Do not print headers, use tab-delimited output. clean, no fluff, lowkey perfect for scripting. ✨
  • -p — Prints holds timestamps as Unix epoch timestamps.

🍓 zfs release [-r] tag snapshot…

Removes a single reference, named with the tag argument, from the specified snapshot or snapshots. The tag must already exist for each snapshot — if it's not there, there's nothing to let go of, bestie. 😭

If a hold exists on a snapshot, attempts to destroy that snapshot by using the zfs destroy command return EBUSY.

  • -r — Recursively releases a hold with the given tag on the snapshots of all descendent file systems. the whole bloodline gets un-held. 🦋

💜 SEE ALSO 💜

so yeah, hold it, list it, release it. main character energy in three commands. 🌟

OpenZFS — November 8, 2022 🎀 mwah, love u, go hold some snapshots bestie 💖✨

📦 where this page comes from