VCLEAN(9)

💅 VCLEAN(9) — a Kernel Developer’s Manual moment 💅

okay bestie, this page is from the Kernel Developer’s Manual, and it’s all about vclean — the function that disassociates the underlying file system from a vnode like “we are SO done here” ✨

🌸 NAME 🌸

• vclean — disassociate the underlying file system from a vnode.

✨ SYNOPSIS ✨

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

void
vclean(struct vnode *vp, int flags, struct proc *p);

🫶 DESCRIPTION 🫶

The vclean() function clears any VM and buffer data associated with the vnode vp and reclaims it from the underlying file system. Literally the “clean up your room” of vnode functions, but make it kernel-level 💅

Its arguments are:

• vp — the vnode to be cleaned. main character vnode fr.
• flags — the flags indicating how the vnode should be handled.
  • DOCLOSE — if this flag is set, vclean() will call vinvalbuf(9) on the vnode. If the vnode is active, it will be closed and inactivated in the underlying file system. no cap, that’s the whole flag.
• p — the process responsible for this call. like, who’s holding the clipboard on this one.

On exit, the v_tag field of the vnode will be set to VT_NON, and if the vnode was active, it will be placed on the vnode free list. Slay, it’s been reclaimed and filed away ✨

🔥 SEE ALSO 🔥

• vinvalbuf(9)
• vnode(9)

🌈 HISTORY 🌈

This man page was originally written for OpenBSD. iconic origin story, no notes 💖

---

Cute little sign-off: this page’s source/version is Debian, and the date is November 14, 2020 — mwah 💋