find_first_waiter(9)
π find_first_waiter(9) β a Kernel API Manual moment
okay so bestie, welcome to the Kernel API Manual, we're literally in the 9 section (kernel land, no cap) and today's main character is find_first_waiter. yes it's a real function. yes it's iconic.
β¨ NAME β¨
find_first_waiter β find the first gh that's waiting for the glock
like, the first one. the one at the front of the line. the VIP at the velvet rope π
πΈ SYNOPSIS πΈ
struct gfs2_holder * find_first_waiter (const struct gfs2_glock *gl );
ok so it takes a glock and hands you back a struct gfs2_holder *. simple. elegant. we love a signature that doesn't overstay its welcome π
π¦ ARGUMENTS π¦
glβ the glock. that's it. that's the whole argument. she's aconst struct gfs2_glock *and she's on a mission π«Ά
π SEE ALSO π
ok so this is the part where the manpage just drops the entire friend group on you π like not me listing forty related functions, but they're all literally right there in the kernel file ./fs/gfs2/glock.c so. here's the whole squad, go say hi:
wake_up_glock(9)gfs2_glock_hold(9)gfs2_glock_put(9)may_grant(9)do_error(9)find_first_holder(9)do_promote(9)find_last_waiter(9)state_change(9)finish_xmote(9)do_xmote(9)run_queue(9)glock_set_object(9)glock_clear_object(9)gfs2_glock_get(9)__gfs2_holder_init(9)gfs2_holder_reinit(9)gfs2_holder_uninit(9)gfs2_glock_holder_ready(9)gfs2_glock_wait(9)gfs2_glock_async_wait(9)request_demote(9)add_to_queue(9)gfs2_glock_nq(9)gfs2_glock_poll(9)gfs2_glock_dq(9)gfs2_glock_dq_uninit(9)gfs2_glock_nq_num(9)glock_compare(9)nq_m_sync(9)gfs2_glock_nq_m(9)gfs2_glock_dq_m(9)gfs2_should_freeze(9)gfs2_glock_complete(9)glock_hash_walk(9)thaw_glock(9)gfs2_glock_thaw(9)gfs2_wait_glocks(9)dump_holder(9)gfs2_dump_glock(9)
and they all live in ./fs/gfs2/glock.c btw. like one big glock-themed household π π
that's the whole page bestie, go find that first waiter, you got this π§π
β§ο½₯οΎ find_first_waiter(9) Β· Kernel API Manual Β· ./fs/gfs2 Β· October 2026 ο½₯οΎβ§
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms