QB_RB_CHUNK_READ(3)

💖 QB_RB_CHUNK_READ 💖

okay so this lil gem lives in the libqb Programmer's Manual, section 3 (the library-functions girlies, iykyk) 💅

---

🌸 NAME 🌸

qb_rb_chunk_read — read the oldest chunk into data_out. that's the whole job, no cap ✨

---

📜 SYNOPSIS 📜

#include <qb/qbrb.h>

ssize_t qb_rb_chunk_read(
    qb_ringbuffer_t   *rb,          /* ringbuffer instance */
    void              *data_out,    /* (in/out) the chunk will be memcpy'ed into this. */
    size_t             len,         /* (in) the size of data_out. */
    int32_t            ms_timeout   /* the amount od time to wait for new data. */
);

---

🫶 PARAMS 🫶

• rb — your ringbuffer instance. the main character of this whole situation 👑
• data_out — (in/out) the chunk gets memcpy'ed into this. it's giving "bring your own buffer" fr fr
• len — (in) the size of data_out. know your limits bestie 💖
• ms_timeout — how long to wait for new data. patience is a virtue, but only for that many ms ⏳

---

🌈 DESCRIPTION 🌈

so bestie, this one is literally the same as qb_rb_chunk_peek(), memcpy(), and qb_rb_chunk_reclaim() — the combo meal of ringbuffer reading 🍓 like, it peeks at the oldest chunk, copies it into your buffer, and reclaims it. all three vibes, one function call, slay ✨

---

⭐ RETURN VALUE ⭐

the size of the chunk, or error. periodt 💅

heads up: if it comes back as an error, that's your signal that something did not go off without a hitch. don't ignore it 🚨

---

👑 SEE ALSO 👑

• qb_rb_close(3)
• qb_rb_refcount_get(3)
• qb_rb_chmod(3)
• qb_rb_chown(3)
• qb_rb_open(3)
• qb_rb_write_to_file(3)
• qb_rb_create_from_file(3)
• qb_rb_chunks_used(3)
• qb_rb_chunk_reclaim(3)
• qb_rb_space_used(3)
• qb_rb_chunk_write(3)
• qb_rb_shared_user_data_get(3)
• qb_rb_chunk_commit(3)
• qb_rb_chunk_peek(3)
• qb_rb_space_free(3)
• qb_rb_name_get(3)
• qb_rb_chunk_alloc(3)

---

📝 COPYRIGHT 📝

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

---

and that's the whole page, bestie!! 🦋 this one's tagged LIBQB, dated 2025-09-16, and yes it still says QB_RB_CHUNK_READ(3) in the corner 🎀 go forth and read your chunks, you absolute icon 👑💜