QB_LOOP_JOB_ADD(3)

💖 QB_LOOP_JOB_ADD 💖

okay bestie, so this is a page from the libqb Programmer's Manual and we're about to make your mainloop do a little task for you. it's giving "hey can you run this for me real quick" energy and honestly? iconic. 🎀

---

✨ NAME ✨

qb_loop_job_add — Add a job to the mainloop. 🫶

---

🌈 SYNOPSIS 🌈

#include <qb/qbloop.h>

int32_t qb_loop_job_add(
    qb_loop_t               *l,            /* pointer to the loop instance */
    enum qb_loop_priority    p,            /* the priority */
    void                    *data,         /* user data passed into the dispatch function */
    qb_loop_job_dispatch_fn  dispatch_fn   /* callback function */
);

---

🦋 PARAMS 🦋

• l — pointer to the loop instance 💫 (like, which loop are we doing this to, bestie)
• p — the priority ✨ (yes you get to pick, we'll get to that)
• data — user data passed into the dispatch function 🎀 (your little care package that gets handed straight to the callback)
• dispatch_fn — callback function 👑 (the thing that actually gets run)

---

💅 DESCRIPTION 💅

This is run in the next cycle of the loop. no cap. you hand it the job, the loop picks it up on the very next pass around, and that's the whole deal. lowkey elegant. 💖

---

🧚 STRUCTURES 🧚

enum qb_loop_priority {
      QB_LOOP_LOW;
      QB_LOOP_MED;
      QB_LOOP_HIGH;
};

your three priority vibes, from chill to main character. 🌸

---

⭐ RETURN VALUE ⭐

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

so like… zero means slay, negative errno means it did NOT eat. 💀

---

🔥 NOTE 🔥

it is a one-shot job. 🚨

bestie hear me out — ONE. SHOT. it runs once and it's done. do not expect it to come back. it is not coming back. if you wanted a recurring thing, that is a different function and a different conversation. 🙈

---

💜 SEE ALSO 💜

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

the whole friend group, fr fr. go read them all, iykyk. 📚✨

---

🎀 COPYRIGHT 🎀

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

---

and that's the tea, bestie 🍓 — this lil page came from libqb, dated 2025-09-16, and you just read the whole thing like the queen you are. periodt. 👑💖