VFS_VGET(9)

💖 VFS_VGET 💖

okay bestie, welcome to the Kernel Developer's Manual, section 9 — this is where the kernel girlies live. today we're talking about VFS_VGET — the function that turns an inode number into a vnode. slay.

✨ NAME ✨

VFS_VGET — convert an inode number to a vnode 🦋

✨ SYNOPSIS ✨

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

int
VFS_VGET(struct mount *mp, ino_t ino, int flags, struct vnode **vpp);

✨ DESCRIPTION ✨

so. VFS_VGET() looks up or creates a vnode from a (mount, inode#) tuple. that's it, that's the whole vibe. it's giving "you gave me a number, i give you a vnode." iconic behavior fr fr 💅

Its arguments are:

• mp — the mount point. the location, the setting, the whole scene 🎀
• ino — the inode representing the file. this is a unique number assigned by the file system when vnodes are first created. no cap, it's literally one-of-a-kind per file.
• flags — additional locking flags to pass through to vget(9). just handing them off, respectfully ✨
• vpp — return parameter for the vnode. this is where the vnode comes back to you, bestie, like a little gift 🫶

This is an optional file system entry-point for file systems mainly intended for NFS server use, but many file systems use it internally in VOP_LOOKUP(9) and similar. so it's optional but also everyone's using it. the duality. the range. 👑

If the file system does not support this call, then it should return EOPNOTSUPP. like, if you can't do it, just say you can't do it. honesty is the policy 💀

Please see ffs_vget() in sys/ufs/ffs/ffs_vfsops.c for the canonical example. that's the reference implementation, the blueprint, the main character of examples 🌟

✨ SEE ALSO ✨

• VFS(9)
• vget(9)
• vnode(9)

✨ AUTHORS ✨

This manual page was written by Doug Rabson. thank you king 🙇♀️

okay that's the whole page bestie, go forth and convert those inode numbers 🦋✨

Debian · January 7, 2005 · mwah 💋