gfs2_dir_add(9)

📦 version 7.3.1, in nixpkgs unstable

💖 gfs2_dir_add(9) 💖

okay so this is gfs2_dir_add from the Kernel API Manual — yes it's a kernel function manual page, yes we're reading it for fun, no I will not be explaining myself 💅

✨ NAME ✨

gfs2_dir_add — drop a brand-new filename into a directory, slay

🌸 SYNOPSIS 🌸

int gfs2_dir_add (struct inode *inode , const struct qstr *name , const
       struct gfs2_inode *nip , struct gfs2_diradd *da );

like, it returns an int, and it takes four things. four! we love a four-arg situation 🫶

🦋 ARGUMENTS 🦋

  • inode — the directory inode. this is the directory we're adding into, bestie. the main character of the whole operation 👑
  • name — the new name. the fresh little string that's about to become ✨real✨
  • nip — the GFS2 inode that's getting linked in to the directory. the new kid being introduced to the group chat 💖
  • da — the directory addition info. this is the little info bundle that carries all the context, ok? very important errand-runner energy 🧚

⭐ DESCRIPTION ⭐

ok so here's the tea ☕ — if the call to gfs2_diradd_alloc_required already worked out that there's no need to allocate any new directory blocks, then da will already be holding a pointer to the directory entry and the bh in which it resides. iconic. efficient. we love her.

and because we already have that, we can just use it — no need to go back and repeat the whole search again. lowkey the best shortcut ever, ngl. why do the work twice when past-you already did it 💅

but if there was no free space? then bestie, we're doing the thing: we must now create more space. no free real estate means we build some. periodt 🔥

no cap, that's the whole vibe of this function — reuse the answer if you've got it, otherwise make room 🌈

🎀 RETURN 🎀

  • 0 on success 🥳
  • error code on failure 😭

that's it. that's the returns. zero means we ate and left no crumbs; anything else is a vibe check that failed 💀

💜 SEE ALSO 💜

like literally the entire directory-ops friend group, all linked up 🫶 iykyk

and that's the whole page bestie!! 🎀 this lil icon comes courtesy of ./fs/gfs2, dated October 2026, and it lives in the Kernel API Manual alongside all her sisters 💖 go read the source, mwah 💋✨

📦 where this page comes from