gfs2_inode_lookup(9)

📦 version 7.3.1, in nixpkgs unstable

🌸 NAME 🌸

okay so this is the manual page for gfs2_inode_lookup(9), straight from the Kernel API Manual, and it does one iconic thing: lookup an inode. no cap 💅

✨ SYNOPSIS ✨

struct inode * gfs2_inode_lookup (struct super_block *sb , unsigned int
       type , u64 no_addr , u64 no_formal_ino , unsigned int blktype );

🎀 ARGUMENTS 🎀

  • sb — the super block. the whole vibe starts here 🫶
  • type — the type of the inode.
  • no_addr — the inode number.
  • no_formal_ino — the inode generation number.
  • blktype — requested block type: GFS2_BLKST_DINODE or GFS2_BLKST_UNLINKED; GFS2_BLKST_FREE to indicate not to verify.

🦋 DESCRIPTION 🦋

so if type is DT_UNKNOWN, the inode type is fetched from disk. slay. ✨

if blktype is anything other than GFS2_BLKST_FREE — which is literally used as a placeholder because it doesn't otherwise make sense — the on-disk block type is verified to be blktype. bestie, that's the vibe check right there 👑

when no_formal_ino is non-zero, this function will return ERR_PTR(-ESTALE) if it detects that no_formal_ino doesn't match the actual inode generation number. however, it doesn't always know unless type is DT_UNKNOWN. and that's the plot twist 😭

💖 RETURN 💖

a VFS inode, or an error. that's it, that's the whole energy 🎀

🌈 SEE ALSO 🌈

kernel file ./fs/gfs2/inode.c — and the whole squad is here, no one left behind:

and that's the page, bestie 💜 signed off by source ./fs/gfs2 and dated October 2026 — mwah 💋✨

📦 where this page comes from