__bfq_requeue_entity(9)

📦 version 7.3.1, in nixpkgs unstable

💅 __bfq_requeue_entity — a Kernel API Manual moment

okay bestie so this is a page from the Kernel API Manual, and the function we're obsessing over today is literally called __bfq_requeue_entity. yes the double underscore. yes it's serious. no you may not skip it. 🎀

✨ NAME ✨

__bfq_requeue_entity — handle requeueing or repositioning of an entity. that's the whole vibe. requeue or reposition. she contains multitudes. 💅

🌸 SYNOPSIS 🌸

void __bfq_requeue_entity (struct bfq_entity *entity );

returns nothing, takes exactly one thing. low maintenance icon behavior fr fr.

🦋 ARGUMENTS 🦋

  • entity — the entity being requeued or repositioned. that's her. that's the girl. she's a struct bfq_entity * and she's about to get moved around. 🫶

👑 DESCRIPTION 👑

okay so here's the tea, no cap. 🍓

Requeueing is needed if this entity stops being served — which happens if a leaf descendant entity has expired. so like, a baby entity down at the bottom of the tree timed out, and now mom needs to go back in the queue. 😭

Repositioning, on the other hand, is needed if the next_inservice_entity for the child entity has changed. different reason, same "we gotta move her" energy.

the original literally says: "See the comments inside the function for details." so like. go read the code bestie. the details are in there, i'm just the messenger. 🙈

Basically — and this is the whole dance, three steps, slay — this function does this:

  1. removes entity from its active tree if it's present there,
  2. updates the timestamps of entity, and
  3. inserts entity back into its active tree — in the new, right position for the new values of the timestamps. ✨

it's giving "take her out, refresh her, put her back exactly where she belongs." main character energy tbh. the tree stays sorted, she stays iconic. 🔥

💜 SEE ALSO 💜

the group chat is huge and everybody's invited. also fyi the kernel file is ./block/bfq-wf2q.c:

and that's the page bestie!! 🧚💖 this cutie came out of the ./block source and it's dated October 2026 — mwah, periodt. 🌈⭐

📦 where this page comes from