ZPOOL-WAIT(8)

💖 zpool-wait(8) — wait for activity to stop in a ZFS storage pool 💖

okay so bestie, quick intro: this is zpool-wait, and she lives in section 8 of the manual. her whole job? waiting for activity to stop in a ZFS storage pool. patient queen energy. 👑

---

✨ NAME ✨

zpool-wait — wait for activity to stop in a ZFS storage pool. that's it, that's her. no cap. 💅

---

🌸 SYNOPSIS 🌸

zpool wait [-Hp] [-T u|d] [-t activity[,activity]…] pool [interval]

---

🦋 DESCRIPTION 🦋

So here's the tea 🍓: zpool wait sits there until all background activity of the types you asked for has ceased in the pool you gave it. and when we say ceased, we mean it could have ceased for a few reasons:

• it actually finished, slay ✅
• it got paused or canceled by a user (rude, but valid) 🙈
• the pool got exported or destroyed 💀

If you don't specify any activities at all, she waits until background activity of every type listed below has ceased. and if there's literally no activity of the given types in progress? she returns immediately. main character doesn't wait around for nothing. ✨

These are the possible values for activity, plus what each one is waiting on:

• discard — checkpoint to be discarded
• free — freeing property to become 0
• initialize — all initializations to cease
• replace — all device replacements to cease
• remove — device removal to cease
• resilver — resilver to cease
• scrub — scrub to cease
• trim — manual trim to cease
• raidz_expand — attaching to a RAID-Z vdev to complete

Now, if you pass an interval, she'll print the amount of work remaining — in bytes — for each activity, every interval seconds. little progress report, we love a status update. 🫶

💜 the flags 💜

• -H — Scripted mode. no headers for you, and fields get separated by a single tab instead of arbitrary space. clean, minimal, iconic.
• -p — Display numbers in parsable (exact) values.
• -T u|d — Display a time stamp. pass u for a printed representation of the internal representation of time — see time(1). pass d for standard date format — see date(1).

---

🌈 SEE ALSO 🌈

zpool-checkpoint(8), zpool-initialize(8), zpool-remove(8), zpool-replace(8), zpool-resilver(8), zpool-scrub(8), zpool-status(8), zpool-trim(8)

---

and that's the page!! 💖 brought to you by OpenZFS, dated January 29, 2024. go forth and wait on your pools, bestie — she'll let you know when the vibes are settled. 🧚✨