do_promote(9)
π do_promote(9) β like, the glock's whole moment
okay so bestie, welcome to do_promote(9) from the Kernel API Manual β yes it's a real page, yes it's giving very niche-kernel-girlie, and yes we're gonna get through it together π«Ά
β¨ NAME β¨
do_promote β promote as many requests as possible on the current queue. that's it. that's the whole vibe. it's the little function that could, out here making the queue go up π₯
πΈ SYNOPSIS πΈ
void do_promote (struct gfs2_glock *gl );
literally one line, no cap. it returns void, so she doesn't even give you a result back β she just does the thing and leaves π
π ARGUMENTS π
glβ The glock. that's the whole description, bestie, the manpage is not being generous with us here π it's astruct gfs2_glock *, it's the glock you're promoting stuff on, and honestly that's the entire tea.
π¦ SEE ALSO π¦
okay this is the part where the page absolutely spills. like, the whole friend group shows up. all of these live in the kernel file ./fs/gfs2/glock.c:
wake_up_glock(9)gfs2_glock_hold(9)gfs2_glock_put(9)may_grant(9)do_error(9)find_first_holder(9)find_first_waiter(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)
likeβ¦ forty entries. she said "you want the whole syllabus? here's the whole syllabus" π go read them, iykyk β this is the glock cinematic universe and do_promote is just one iconic episode π
real talk though: the manpage tells us exactly two things β the signature and that gl is the glock β so don't go inventing extra behaviour in your head, bestie. stay in your lane, stay slaying π
mwah, that's the page! π this little drop comes to you from the kernel source spot ./fs/gfs2, dated October 2026, and it's filed under do_promote(9) β screenshot it, cite it, whatever, she ate πβ¨
π¦ 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