ZFS-PRUNE-SNAPSHOTS(1)

✨ ZFS-PRUNE-SNAPSHOTS 💅

okay so bestie, welcome to the zfs-prune-snapshots(1) page — a general commands manual entry, no cap, and it's literally about scooping up old ZFS snapshots and yeeting them. Let me walk you through it 🫶

---

🌸 NAME 🌸

zfs-prune-snapshots — Remove snapshots from one or more zpools that match given criteria. that's it, that's the whole vibe 🎀

---

🦋 SYNOPSIS 🦋

zfs-prune-snapshots [OPTIONS] <time> [[DATASET1] ...]

like, options first, then the time thing, then as many datasets as your heart desires (or none, she's flexible 💖)

---

⭐ DESCRIPTION ⭐

Remove snapshots from one or more zpools that match a criteria given over the command line. yes queen, you hand her the criteria, she hands you a cleaner pool. it's giving spring cleaning but make it zfs 🧹✨

---

💅 OPTIONS 💅

• -h — print this message and exit (the classic "help me help you" move)
• -n — dry-run, don't actually delete snapshots 🙈 (she'll look at them very seriously but won't touch)
• -l — list only mode, just list matching snapshots names without deleting (like dry-run mode with machine-parseable output 🔥)
• -p <prefix> — snapshot prefix string to match
• -s <suffix> — snapshot suffix string to match
• -i — invert matching of prefix and suffix (the "not me matching the opposite" energy 💀)
• -q — quiet, do not printout removed snapshots 🤫
• -R — recursively delete, pass '-R' directly to 'zfs destroy'
• -v — increase verbosity (more talking, more detail, more 🌈)
• -V — print the version number and exit

⏰ TIMESPEC ⏰

The first argument denotes how old a snapshot must be for it to be considered for deletion — possible specifiers are:

• s — seconds
• m — minutes
• h — hours
• d — days
• w — weeks
• M — months
• y — years

watch the case bestie — m is minutes and M is months 😭 they are NOT the same and she will not be forgiving about it

---

🔥 EXAMPLES 🔥

• zfs-prune-snapshots 1w — Remove snapshots older than a week across all zpools
• zfs-prune-snapshots -vn 1w — Same as above, but with increased verbosity and without actually deleting any snapshots (dry-run)
• zfs-prune-snapshots 3w tank1 tank2/backup — Remove snapshots older than 3 weeks on tank1 and tank2/backup. Note that this script will recurse through all of tank1 and all datasets below tank2/backup
• zfs-prune-snapshots -p 'autosnap_' 1M zones — Remove snapshots older than a month on the zones pool that start with the string "autosnap_"
• zfs-prune-snapshots -s '_frequent' 2M tank — Remove snapshots older than two months on the tank pool that end with the string "_frequent"
• zfs-prune-snapshots -i -p 'autosnap_' 1M zones — Remove snapshots older than a month on the zones pool that do not start with the string "autosnap_"

---

💀 BUGS 💀

found one? spill it here: ⟨https://github.com/bahamas10/zfs-prune-snapshots⟩ 🐛

---

👑 AUTHOR 👑

Dave Eddy <bahamas10> <dave@daveeddy.com> (https://www.daveeddy.com) — icon behavior honestly 🫶

---

🌈 SEE ALSO 🌈

zpool(1M), zfs(1M) — go read those too, iykyk ⭐

---

🍓 LICENSE 🍓

MIT License ✨

---

and that's the whole page bestie 💜 this was zfs-prune-snapshots(1) from the General Commands Manual, part of the User Commands corner, dated NOV 2018 — slay, go prune responsibly 🎀💖