gfs2_dir_search(9)

📦 version 7.3.1, in nixpkgs unstable

🦋 gfs2_dir_search(9) — the kernel API manual, but make it a group chat 🦋

okay so bestie, we're in the Kernel API Manual today and the main character is gfs2_dir_search — she's a directory search function and she literally ate. no cap.

✨ NAME ✨

gfs2_dir_search — Search a directory 💅

🌸 SYNOPSIS 🌸

struct inode * gfs2_dir_search (struct inode *dir , const struct qstr
*name , bool fail_on_exist );

🎀 ARGUMENTS 🎀

  • dir — The GFS2 directory inode. this is the directory we're snooping around in, she's the setting of the whole scene 🏠
  • name — The name we are looking up. the thing we're hunting for, the vibe check target 🔍
  • fail_on_exist — Fail if the name exists rather than looking it up. like, plot twist: instead of going and fetching the whole thing, we just bail the second we find out she's already there. dramatic? yes. useful? also yes 💀

🧚 DESCRIPTION 🧚

so this routine searches a directory for a file or another directory. literally that's the job. it's giving "where's that thing" energy but in kernel space 🫶

⭐ important caveat, do not skip: this assumes a glock is held on dip. so like, the lock is already taken care of before you call her — don't come in here unlocked, bestie, that's not the move 🙈

🔥 RETURN 🔥

errno — yeah, she returns an errno. that's the whole return section, she's a woman of few words 😭

👑 SEE ALSO 👑

okay this list is long but every single one is here because they're all iconic in their own right. Kernel file ./fs/gfs2/dir.c, plus:

and that's the whole page, bestie, you understood it perfectly, i'm so proud 🥹

signing off from ./fs/gfs2 — it's giving October 2026, Kernel API Manual era, and honestly? we ate that 💅✨

📦 where this page comes from