ZFS-WAIT(8)

✨ zfs-wait — bestie edition ✨

okay so this is zfs-wait, from the System Manager's Manual section 8 (that's the sysadmin-stuff section, iykyk) 💅

---

🌸 NAME 🌸

zfs-wait — wait for activity in ZFS filesystem to stop 🦋

---

🎀 SYNOPSIS 🎀

zfs wait [-t activity[,activity]…] filesystem

---

💖 DESCRIPTION 💖

So basically? It waits. 🫶 It waits until all background activity of the given types has ceased in the given filesystem. Periodt.

And lowkey the activity could stop for two very different reasons, bestie:

• it actually completed ✅
• the filesystem got destroyed or unmounted 💀

Both count! The command does not care which one happened, it just wants the activity gone.

If you don't specify any activities at all, it waits until background activity of every type listed below has ceased. And if there's literally no activity of the given types in progress right now? It returns immediately. Instant. Iconic. No waiting around for drama that isn't happening ✨

---

🌈 the possible values for activity 🌈

Here's what each one is waiting for, no cap:

• deleteq — the filesystem's internal delete queue to empty 🗑️✨

---

⚠️ heads up bestie, this one's important: the internal delete queue does not finish draining until all large files have had time to be fully destroyed and all open file handles to unlinked files are closed. So if something's holding a handle open, the queue is just gonna sit there. Not me waiting on a file handle that never closes 😭

---

👑 SEE ALSO 👑

• lsof(8) — go find out who's holding that file handle open, fr fr 🔍

---

and that's the whole vibe, bestie — this page came to you from OpenZFS, dated July 11, 2022. slay, go wait on something 💜