QB_LOOP_POLL_ADD(3)

✨ QB_LOOP_POLL_ADD ✨

okay so bestie, we're in the libqb Programmer's Manual and this page is literally called qb_loop_poll_add 💅 it lives in section 3 (that's the library-functions girlies, iykyk) so go ahead and pull up a chair 🎀

---

🌸 NAME 🌸

qb_loop_poll_add — add a poll job to the mainloop. that's it, that's the whole vibe 🦋

---

💖 SYNOPSIS 💖

#include <qb/qbloop.h>

int32_t qb_loop_poll_add(
    qb_loop_t                *l,            /* pointer to the loop instance */
    enum qb_loop_priority     p,            /* the priority */
    int32_t                   fd,           /* file descriptor. */
    int32_t                   events,       /* (POLLIN|POLLOUT) etc .... */
    void                     *data,         /* user data passed into the dispatch function */
    qb_loop_poll_dispatch_fn  dispatch_fn   /* callback function */
);

no cap, that's the whole signature 👑 include the header, call the function, slay.

---

🧚 PARAMS 🧚

so here's who's showing up to the function call, one by one:

• l — pointer to the loop instance. your main character loop, fr fr.
• p — the priority. lowkey, med, or highkey. (see STRUCTURES below 👇)
• fd — file descriptor.
• events — (POLLIN|POLLOUT) etc .... yes, you can or them together, that's the whole point 🫶
• data — user data passed into the dispatch function. your little gift bag for the callback 🎀
• dispatch_fn — callback function. the one who actually does the thing when the poll fires 💅

---

🌈 DESCRIPTION 🌈

literally what it says on the tin, bestie — you're handing the mainloop a poll job. ✨

---

🦋 STRUCTURES 🦋

the priority enum, in all her glory:

enum qb_loop_priority {
      QB_LOOP_LOW;
      QB_LOOP_MED;
      QB_LOOP_HIGH;
};

three tiers, three moods, pick your fighter 💜

---

⭐ RETURN VALUE ⭐

status (0 == ok, -errno == failure)

so like, 0 is the good ending, and a negative errno is the "not me crying in the group chat" ending 😭

---

🔥 NOTE 🔥

it is a re-occurring job. so don't come crying to me when it fires again, bestie — that's the assignment 🫶

---

💀 SEE ALSO 💀

the whole friend group, go read them too:

• 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),

---

👑 COPYRIGHT 👑

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

---

okay that's the page!! 🎀 this was LIBQB, dated 2025-09-16, and the manual page is QB_LOOP_POLL_ADD(3) — go forth and poll responsibly, bestie, periodt 💅✨