bfq_bfqq_move(9)

✨ bfq_bfqq_move — the glow-up relocation service 💅

okay so bestie, this is bfq_bfqq_move(9) from the Kernel API Manual, and it's literally the function that gives a queue a whole new address. moving day, but make it kernel. 🚚✨

---

🌸 SYNOPSIS 🌸

void bfq_bfqq_move (struct bfq_data *bfqd , struct bfq_queue *bfqq ,
       struct bfq_group *bfqg );

three args, void return, no drama. she takes bfqd, bfqq and bfqg and she does the thing. periodt.

---

🎀 ARGUMENTS 🎀

• bfqd — the queue descriptor. the big-picture context vibe. 👑
• bfqq — the queue we're moving. our main character, fr fr. 🦋
• bfqg — the group she's moving to. the new crib. 🏠

---

💖 DESCRIPTION 💖

so the whole plot: move bfqq to bfqg, deactivating it from its old group and reactivating it on the new one. it's giving "pack ur bags, we're switching friend groups" and honestly? iconic. ✨

one very specific detail that matters: avoid putting the entity on the old group idle tree. like, do not leave her stuff behind in the old group's idle tree. we're not doing that. nope. 🙈

⚠️ Must be called under the scheduler lock. why? to make sure that the blkg owning bfqg does not disappear mid-move. if that blkg bails while you're relocating, it's over for you. 😭 (see the comments in bfq_bic_update_cgroup on guaranteeing the consistency of blkg objects — that's where the lore lives. iykyk.)

---

🔥 SEE ALSO 🔥

kernel file ./block/bfq-cgroup.c, plus the whole squad:

• bfq_stat_add(9)
• bfq_stat_read(9)
• bfq_stat_reset(9)
• bfq_stat_add_aux(9)
• blkg_prfill_stat(9)
• __bfq_bic_change_cgroup(9)
• bfq_flush_idle_tree(9)
• bfq_reparent_leaf_entity(9)
• bfq_reparent_active_queues(9)
• bfq_pd_offline(9)

---

okay that's the whole thing, no cap. this page ships out of ./block and the date on it says October 2026, so bestie is out here being organized about future-dated kernel docs. love that for her. 🫶💜 stay locked, stay moved, and please please please call it under the scheduler lock 💅✨🎀