ZFS-UPGRADE(8)

💖 zfs-upgrade(8) — bestie edition 💖

okay so this is the zfs-upgrade page from the System Manager's Manual, and it's literally all about managing the on-disk version of ZFS filesystems. no cap, it's giving "software update but make it ✨mystical✨" energy. let's get into it 🫶

---

✨ NAME ✨

zfs-upgrade — manage on-disk version of ZFS filesystems

like… it's the vibe check for your filesystem's version number 💅

---

🌸 SYNOPSIS 🌸

zfs upgrade
zfs upgrade -v
zfs upgrade [-r] [-V version] -a|filesystem

---

🦋 DESCRIPTION 🦋

💜 zfs upgrade

Displays a list of file systems that are not the most recent version.

basically it's like "hey bestie, who here is behind on their glow-up?" and it hands you the list 📋✨

💜 zfs upgrade -v

Displays a list of currently supported file system versions.

this is the menu of versions you can be. icon behavior honestly 👑

💜 zfs upgrade [-r] [-V version] -a|filesystem

Upgrades file systems to a new on-disk version.

⚠️ okay so MAJOR warning time, no cap: once this is done, the file systems will no longer be accessible on systems running older versions of ZFS. also, zfs send streams generated from new snapshots of these file systems cannot be accessed on systems running older versions of ZFS. so like… this is a one-way door, fr fr. there is no take-backsies 💀

In general, the file system version is independent of the pool version. See zpool-features(7) for information on features of ZFS storage pools.

In some cases, the file system version and the pool version are interrelated and the pool version must be upgraded before the file system version can be upgraded.

like, sometimes the pool has to go first because the filesystem version is waiting on it — it's giving "you can't sit with us until the pool is ready" 😭

---

🎀 the options, bestie 🎀

• -V version — Upgrade to version. If not specified, upgrade to the most recent version. This option can only be used to increase the version number, and only up to the most recent version supported by this version of ZFS.

so like… it only goes up ⬆️, never down, and it will NOT let you reach a version newer than what this ZFS even knows about. periodt.

• -a — Upgrade all file systems on all imported pools.

every single one. all of them. the whole squad 🔥

• filesystem — Upgrade the specified file system.

just the one you named. main character treatment 👑

• -r — Upgrade the specified file system and all descendent file systems.

and its whole bloodline too, recursive style 🧬✨

---

🌈 SEE ALSO 🌈

• zpool-upgrade(8)

iykyk 💖

---

so yeah, that's the whole page! this is the OpenZFS manual, dated July 11, 2022, and honestly? iconic for it. go upgrade responsibly bestie, and remember: read the warning twice, upgrade once 💅✨🎀