VFLUSH(9)

💖 VFLUSH(9) 💖

okay bestie, so this is a page from the Kernel Developer's Manual, and it's literally called vflush — like, it flushes vnodes for a mount point. yes it's as iconic as it sounds. sit down, grab a strawberry drink, we're doing kernel stuff 🍓

✨ NAME ✨

vflush — flush vnodes for a mount point

no cap, that's the whole vibe. you're evicting vnodes. main character energy but for a mount point 💅

🌸 SYNOPSIS 🌸

#include <sys/param.h>
#include <sys/vnode.h>

int
vflush(struct mount *mp, int rootrefs, int flags, struct thread *td);

like, copy that exactly, don't freestyle the signature, i'm begging 🫶

🦋 DESCRIPTION 🦋

so the way that vflush() works is it removes any vnodes in the vnode table that belong to the given mount structure. that's it. that's the whole job. she's a cleaner and she's booked and busy ✨

now let's go through her arguments one by one, because each one matters and i will not let you skim:

• mp — the mount point whose vnodes should be removed. like, this is the target. the one. 👑
• rootrefs — the number of references expected on the root vnode. vrele(9) will be invoked on the root vnode rootrefs times. so yeah, count your refs correctly or it's giving chaos 😭
• flags — the flags indicating how vnodes should be handled. there's a whole little menu of them:
  • FORCECLOSE — if set, busy vnodes will be forcibly closed. aggressive. dramatic. lowkey necessary sometimes 💀
  • SKIPSYSTEM — if set, vnodes with the VV_SYSTEM flag set will be skipped. not today, system vnodes, not today 🙈
  • WRITECLOSE — if set, only regular files currently opened for writing will be removed. very picky, very specific, love that for her 🎀
• td — the calling thread. hi bestie, who's asking? 💜

⭐ RETURN VALUES ⭐

• a value of 0 is returned if the flush is successful — slay, we ate 🎉
• otherwise, EBUSY will be returned — something's busy, so sorry, try again 😭

🌈 SEE ALSO 🌈

• vgone(9)
• vrele(9)

go read those too, iykyk, they're the supporting cast and they carry 🔥

👑 AUTHORS 👑

this manual page was written by Chad David <davidc@acns.ab.ca>. thank you Chad, icon behavior, we appreciate you 🫶✨

okay that's the whole page! this one came from Debian, dated November 21, 2001 — vintage but still serving 💖 go flush responsibly, bestie, and remember: EBUSY is not a personality flaw, it's just a mood. mwah! 💅🌸🦋