gfs2_rlist_alloc(9)

💅 gfs2_rlist_alloc — Kernel API Manual ✨

okay so, bestie, we're in the Kernel API Manual today and the function we're stanning is gfs2_rlist_alloc (section 9, very demure, very kernel). Let me break it down for you 🫶

---

🌸 NAME 🌸

gfs2_rlist_alloc — so like, all the RGs have already been added to the rlist by the time we get here, and now our job is to allocate and initialize an array of glock holders for them. that's it. that's the gig. 💅

---

🦋 SYNOPSIS 🦋

void gfs2_rlist_alloc (struct gfs2_rgrp_list *rlist , unsigned int state
, u16 flags );

no return value, it's giving void, it's giving "i do the work and i don't report back" 💀

---

🎀 ARGUMENTS 🎀

• rlist — the list of resource groups. literally the whole point of the function, the main character honestly 👑
• state — the state we're requesting. what vibe are we asking the glocks for ✨
• flags — the modifier flags. the little seasonings on top 🍓

---

💖 DESCRIPTION 💖

FIXME: Don't use NOFAIL

that's it. that's the whole description. the original authors really said "we'll finish this later" and then did not 😭 not me reading a FIXME in a published manpage — iconic honestly, keep it, do not touch it, it's canon 💀

---

🌈 SEE ALSO 🌈

okay this list is LONG, like genuinely a whole friend group, but they're all in the kernel file ./fs/gfs2/rgrp.c and you will be meeting them:

gfs2_setbit(9), gfs2_testbit(9), gfs2_bit_search(9), rs_cmp(9), gfs2_bitfit(9), gfs2_rbm_from_block(9), gfs2_rbm_add(9), gfs2_unaligned_extlen(9), gfs2_free_extlen(9), gfs2_bitcount(9), gfs2_rgrp_verify(9), gfs2_blk2rgrpd(9), gfs2_rgrpd_get_first(9), gfs2_rgrpd_get_next(9), __rs_deltree(9), gfs2_rs_deltree(9), gfs2_rs_delete(9), return_all_reservations(9), compute_bitstructs(9), gfs2_ri_total(9), read_rindex_entry(9), set_rgrp_preferences(9), gfs2_ri_update(9), gfs2_rindex_update(9), gfs2_rgrp_go_instantiate(9), gfs2_rgrp_brelse(9), gfs2_fitrim(9), rs_insert(9), rgd_free(9), rg_mblk_search(9), gfs2_next_unreserved_block(9), gfs2_reservation_check_and_update(9), gfs2_rbm_find(9), try_rgrp_unlink(9), gfs2_rgrp_congested(9), gfs2_rgrp_used_recently(9), fast_to_acquire(9), gfs2_inplace_reserve(9), gfs2_inplace_release(9), gfs2_alloc_extent(9), rgblk_free(9), gfs2_rgrp_dump(9), gfs2_adjust_reservation(9), gfs2_set_alloc_start(9), gfs2_alloc_blocks(9), __gfs2_free_blocks(9), gfs2_free_meta(9), gfs2_check_blk_type(9), gfs2_rlist_add(9), gfs2_rlist_free(9)

like i said. a whole friend group. go say hi 🧚

---

and that's the page, bestie! this one lives in ./fs/gfs2 and it's dated October 2026 — yes, the future, we're ahead of schedule, slay ⭐💜