VINVALBUF(9)

okay so bestie, welcome to VINVALBUF(9) from the Kernel Developer's Manual — the page that flushes and invalidates buffers like it’s cleaning out a group chat 💅✨

🌸 NAME 🌸

vinvalbuf — flushes and invalidates all buffers associated with a vnode. literally all the buffers tied to that vnode, bestie. 🫶

✨ SYNOPSIS ✨

Include these first, no skipping:

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

int
vinvalbuf(struct vnode *vp, int flags, struct ucred *cred, int slpflag,
    int slptimeo);

💖 DESCRIPTION 💖

The vinvalbuf() function invalidates all of the buffers associated with the given vnode. This includes buffers on the clean list and the dirty list. If the V_SAVE flag is specified, then the buffers on the dirty list are synced prior to being released. If there is a VM Object associated with the vnode, it is removed. 👑🔥

Its arguments are:

• vp — a pointer to the vnode whose buffers will be invalidated.
• flags — the only supported flag is V_SAVE, and it indicates that dirty buffers should be synced with the disk.
• cred — the user credentials that are used to VOP_FSYNC(9) buffers if V_SAVE is set.
• slpflag — the slp flag that will be used in the priority of any sleeps in the function.
• slptimeo — the timeout for any sleeps in the function.

🔒 LOCKS 🔒

The vnode is assumed to be locked prior to the call and remains locked upon return. yep, it stays locked, no cap. 🔐

Giant must be held before the call and remains locked upon return. so yeah, get that lock sorted first, bestie. 🧚

💀 RETURN VALUES 💀

A 0 value is returned on success. that’s the whole vibe: 0 means slay. ✨

🦋 PSEUDOCODE 🦋

      vn_lock(devvp, LK_EXCLUSIVE | LK_RETRY);
      error = vinvalbuf(devvp, V_SAVE, cred, 0, 0);
      VOP_UNLOCK(devvp, 0);
      if (error)
              return (error);

🍓 ERRORS 🍓

• [ENOSPC] — the file system is full. (With V_SAVE)
• [EDQUOT] — disc quota exceeded. (With V_SAVE)
• [EWOULDBLOCK] — sleep operation timed out. (See slptimeo)
• [ERESTART] — a signal needs to be delivered and the system call should be restarted. (With PCATCH set in slpflag)
• [EINTR] — the system has been interrupted by a signal. (With PCATCH set in slpflag)

🌈 SEE ALSO 🌈

go read tsleep(9) and VOP_FSYNC(9) too, iykyk 👀💜

🎀 AUTHORS 🎀

This manual page was written by Chad David <davidc@acns.ab.ca>. iconic. 👑

---

— 🎀 xoxo, Debian — October 20, 2008 🎀