QB_LOOP_TIMER_ADD(3)

✨ NAME ✨

qb_loop_timer_add — add a timer to the mainloop. that's it, that's the whole vibe 🎀

(this one lives in the libqb Programmer's Manual, just so u know which family reunion we're at 💖)

---

🌸 SYNOPSIS 🌸

#include <qb/qbloop.h>

int32_t qb_loop_timer_add(
    qb_loop_t                 *l,                 /* pointer to the loop instance */
    enum qb_loop_priority      p,                 /* the priority */
    uint64_t                   nsec_duration,     /* nano-secs in the future to run the dispatch. */
    void                      *data,              /* user data passed into the dispatch function */
    qb_loop_timer_dispatch_fn  dispatch_fn,       /* callback function */
    qb_loop_timer_handle      *timer_handle_out   /* handle to delete the timer if needed. */
);

---

🫶 PARAMS 🫶

okay so six things, bestie. six. count em 💅

• l — pointer to the loop instance. like, the actual mainloop u want this timer to live in 🌀
• p — the priority. yes it matters, we'll get to it ⭐
• nsec_duration — nano-secs in the future to run the dispatch. nanoseconds!! in the future!! so specific ✨
• data — user data passed into the dispatch function. ur lil payload, ur emotional support pointer 🎀
• dispatch_fn — callback function. the thing that actually runs when the timer goes off 🔥
• timer_handle_out — handle to delete the timer if needed. ur receipt. keep it 🧾

---

💜 DESCRIPTION 💜

so this section is, and i'm being so fr right now, empty in the original page. nothing. blank. a whole heading and then vibes 🫠

not me leaving it here anyway because we keep every section in the same order, periodt. it's giving minimalist. it's giving "the author was busy". iconic either way 👑

---

🦋 STRUCTURES 🦋

here's the priority enum, and yes u pick one of these three when u call the function 👇

enum qb_loop_priority {
      QB_LOOP_LOW;
      QB_LOOP_MED;
      QB_LOOP_HIGH;
};

• QB_LOOP_LOW — lowkey priority 🐢
• QB_LOOP_MED — the middle one, medium energy 🐇
• QB_LOOP_HIGH — highkey priority, main character energy 👑

---

🌈 RETURN VALUE 🌈

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

so: 0 and we're slaying ✨, negative errno and it's giving tragedy 😭

---

💀 NOTE 💀

it is a one-shot job.

read that again bestie. it fires once. one and done. no encore, no round two, no "run it back". if u want it again u gotta add it again fr fr 🎯

---

🔥 SEE ALSO 🔥

the whole friend group, go say hi 👋

• 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_is_running(3)
• qb_loop_timer_expire_time_get(3)
• qb_loop_poll_add(3)

---

🎀 COPYRIGHT 🎀

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

---

okay that's the whole page, u ate it, i'm obsessed 🫶 this was LIBQB, dated 2025-09-16, and it was QB_LOOP_TIMER_ADD(3) the entire time 💖 bye bestie, go schedule something ✨