INSMNTQUE(9)

📦
version 15.1 · 2 versions
, in freebsd 14.5, freebsd 15.1

🦋 INSMNTQUE(9) — the vnode-and-mount bestie page 🦋

hiii bestie 💖 welcome to the INSMNTQUE(9) page from the Kernel Developer's Manual. this one is all about introducing a vnode to a mount. iconic behavior, honestly.

🎀 NAME 🎀

insmntque, insmntque1 — associate a vnode with a mount

✨ SYNOPSIS ✨

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

int
insmntque(struct vnode *vp, struct mount *mp);

int
insmntque1(struct vnode *vp, struct mount *mp);

💅 DESCRIPTION 💅

okay so insmntque() is the function that associates a vnode with a mount. like, it handles updating v_mount for the vnode and inserting the vnode into the mount's vnode list. very matchmaker of it. 💫

the indirect mount reference count is maintained as the count of the vnodes owned by it. it gets incremented for each vnode added to the mount, and that reference is decremented by vgone(9). the way that all lines up?? obsessed. 🌸

bestie, important vibe check: the mount's interlock is held while the vnode is inserted. the vnode must be exclusively locked. no exceptions, periodt. 🔒

on failure, insmntque() resets the vnode's operations vector to the vector of deadfs(9), clears v_data, and then calls vgone(9) and vput(9). 😭

if you need more elaborated cleanup after an insmntque() failure, use insmntque1() instead. it does not do any cleanup following a failure — all the work is left to the caller. in particular, the operations vector v_op and v_data fields of the vnode are kept intact. 🫶

🌈 RETURN VALUES 🌈

  • insmntque() will always return 0, unless the file system is currently being unmounted — in which case it may return EBUSY. yikes, but okay. 💀
  • also, insmntque() may be forced to insert the vnode into the mount's vnode list by setting the VV_FORCEINSMQ flag in the vnode v_flag, even if the file system is being unmounted. forced entry, but make it kernel. 👑

🔥 SEE ALSO 🔥

👑 AUTHORS 👑

This manual page was written by Chad David <davidc@acns.ab.ca>. shoutout to Chad, fr fr. 💜

this cute little page comes straight from Debian, dated October 24, 2025 — slay and goodbye bestie 🎀✨

📦 where this page comes from