VFS_GETVFS(9)

💅 VFS_GETVFS(9) — the kernel dev manual, but make it cute 🎀

okay so bestie, welcome to the kernel developer's manual for vfs_getvfs — yes it's a section 9 page, yes it's real, yes we're doing this 💖

---

✨ NAME ✨

vfs_getvfs — returns a mount point given its file system identifier 🌸

---

✨ SYNOPSIS ✨

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

struct mount *
vfs_getvfs(fsid_t *fsid);

---

🦋 DESCRIPTION 🦋

so the vfs_getvfs() function returns the mount point structure for a file system, given its file system identifier. literally that's it, that's the whole vibe 🫶

⭐ tiny but important detail, bestie: the file system ID should have been allocated by calling vfs_getnewfsid(9) — otherwise, it will not be found. no cap. 🙈

a major user of vfs_getvfs() is NFS, which uses the fsid as part of file handles in order to determine the file system a given RPC is for 🔥 and if vfs_getvfs() fails to find the mount point related to fsid, the file system is considered stale. awkward. 💀

---

👑 RETURN VALUES 👑

• if fsid is found → the mount point for the ID is returned ✨
• otherwise → NULL is returned 😭

---

🧚 PSEUDOCODE 🧚

here's the vibe in code form, iconic honestly:

if ((mp = vfs_getvfs(&fhp->fh_fsid)) == NULL) {
        error = ESTALE;
        goto out;
}

---

🌈 SEE ALSO 🌈

• vfs_getnewfsid(9) — go read this one too, iykyk 💜

---

💜 AUTHORS 💜

this manual page was written by Chad David <davidc@acns.ab.ca> — king behavior honestly 👑

---

okay that's the whole page bestie, you ate that 🍓 and for the record: this one's from the Debian manual set, dated November 21, 2001 — yeah it's old but it still slays 💅 mwah, go mount something responsibly 🎀