QB_IPCC_EVENT_RECV(3)

💌 qb_ipcc_event_recv(3) — libqb Programmer's Manual

okay bestie, gather round, because today we're receiving an event off a libqb IPC connection and it's lowkey iconic. this is qb_ipcc_event_recv from the libqb programmer's manual and she's about to hand you a message. periodt. 🎀

---

✨ NAME ✨

qb_ipcc_event_recv — Receive an event.

---

🌸 SYNOPSIS 🌸

#include <qb/qbipcc.h>

ssize_t qb_ipcc_event_recv(
    qb_ipcc_connection_t   *c,           /* connection instance */
    void                   *msg_ptr,     /* pointer to a message buffer to receive into */
    size_t                  msg_len,     /* the size of the buffer */
    /*
     * time in milliseconds to wait for a message 0 == no wait, negative ==
     * block, positive == wait X ms.
     */
    int32_t                 ms_timeout
);

like. look at her. four args, one return value, zero drama. 💅

---

🫶 PARAMS 🫶

• c — your connection instance. the whole vibe. the main character of this function call, honestly.
• msg_ptr — a pointer to a message buffer that the message is gonna be received into. she's the vessel. the container. the little cup you're catching the event in. 🍓
• msg_len — the size of that buffer. gotta tell her how much room she's working with, no cap.
• ms_timeout — time in milliseconds to wait for a message. and here's the breakdown bestie:
  • 0 == no wait
  • negative == block
  • positive == wait X ms

---

💖 DESCRIPTION 💖

so… this section is literally empty in the original. like, nothing. a blank. an empty room with great lighting. i'm not gonna invent facts about a function to fill the silence, that's not the move. the details you need live in PARAMS, RETURN VALUE and NOTE, and they ate. ✨

---

👑 RETURN VALUE 👑

size of the message, or error (-errno).

that's it. that's the whole thing. if it worked you get a size, if it didn't you get a negative errno and a little heartbreak. 😭

---

⚠️ NOTE ⚠️

that msg_ptr will include a qb_ipc_response_header at the top of the message. so heads up — the buffer you get back isn't just the payload, there's a whole header sitting at the top of it. plan your pointer math accordingly, iykyk. 🙈

---

🌈 SEE ALSO 🌈

• qb_ipcc_send(3)
• qb_ipcc_sendv_recv(3)
• qb_ipcc_recv(3)
• qb_ipcc_connect_async(3)
• qb_ipcc_fc_enable_max_set(3)
• qb_ipcc_is_connected(3)
• qb_ipcc_connect_continue(3)
• qb_ipcc_auth_get(3)
• qb_ipcc_sendv(3)
• qb_ipcc_context_set(3)
• qb_ipcc_context_get(3)
• qb_ipcc_verify_dgram_max_msg_size(3)
• qb_ipcc_get_buffer_size(3)
• qb_ipcc_connect(3)
• qb_ipcc_disconnect(3)
• qb_ipcc_fd_get(3)

---

💜 COPYRIGHT 💜

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

---

and that's the whole page, bestie. QB_IPCC_EVENT_RECV(3) from LIBQB, dated 2025-09-16. go receive your events, drink some water, and slay. mwah. 💋🦋