QBLOOP.H(3)

💖 QBLOOP.H 💖

okay bestie, so this is a page from the libqb Programmer's Manual — that's the manual name, it's a section 3 (library functions) situation — and it's all about qbloop.h, the main loop that manages your timers, jobs and polling sockets. she does it all. 💅

---

✨ NAME ✨

qbloop.h — the main loop that manages timers, jobs and polling sockets. that's it, that's the whole job description, and she slays at it 🎀

---

🌸 SYNOPSIS 🌸

#include <qb/qbloop.h>

like, that's the whole incantation. no cap. 🦋

---

👑 DESCRIPTION 👑

okay so real talk: this library only implements a weaker sense of priorities. and before you come for her, there's a whole design philosophy here — this alludes to a distinct set of pros and cons compared to the stronger, strict approach to priorities that's widely applied in this problem space. why? because the strict approach gives the application more control, sure, but the effect of the weaker one can still be achieved with some reductions, whereas going the other way around is not straightforward. cf. static priority task scheduling vs. relative fine-tuning within a single priority domain with nice(2). it's giving "we chose the flexible one on purpose." 💅

so here's what you get with this vibe:

• implicit mitigation for deadlock-prone priority arrangements 🙈 — like, she's lowkey protecting you from yourself
• less predictable responses to the arrival of the high-ranked events — this one is proportional probability based, so think of the priorities as having an advisory effect rather than a strict one. specifically, this is in the process of picking the next event to handle from the priority queue when at least two different priorities are eligible at the moment. it's a whole vibe check, basically ⭐

one practical application for this module of libqb is in combination with IPC servers based on the qbipcs.h published one — and the qb_ipcs_poll_handlers structure maps fittingly to the control functions published here. they're literally made for each other. main character energy, both of them 🔥

---

🌈 SEE ALSO 🌈

go read these next, bestie, they're all iconic:

• qb_loop_job_del(3)
• qb_loop_run(3)
• qb_loop_create(3)
• qb_loop_stop(3)
• qb_loop_poll_low_fds_event_set(3)
• qb_loop_signal_del(3)
• qb_loop_signal_add(3)
• qb_loop_job_add(3)
• qb_loop_poll_del(3)
• qb_loop_destroy(3)
• qb_loop_timer_expire_time_remaining(3)
• qb_loop_poll_mod(3)
• qb_loop_signal_mod(3)
• qb_loop_timer_del(3)
• qb_loop_timer_add(3)
• qb_loop_timer_is_running(3)
• qb_loop_timer_expire_time_get(3)
• qb_loop_poll_add(3)

---

💜 COPYRIGHT 💜

Copyright (C) 2010-2020 Red Hat, Inc.

---

and that's the whole page, periodt. 🫶 this came to you from LIBQB, dated 2025-09-16, under the name QBLOOP.H(3) — so go forth and loop responsibly, my love. 💖✨🌸