QB_IPCS_CO..._STATS_GET(3)

✨ QB_IPCS_CO..._STATS_GET ✨ (section 3, bestie — libqb Programmer's Manual energy)

okay so. this is a <pink>libqb</pink> man page, section 3, and the function in the spotlight is qb_ipcs_connection_stats_get. she's a little icon, she's a getter, and she's here to hand you the connection statistics. no cap. 🫶

---

NAME 🎀

qb_ipcs_connection_stats_get — get the connection statistics.

like. that's the whole job. she gets stats. that's it. periodt. 💅

---

SYNOPSIS 🌸

#include <qb/qbipcs.h>

int32_t qb_ipcs_connection_stats_get(
    qb_ipcs_connection_t              *c,                 /* connection instance */
    struct qb_ipcs_connection_stats   *stats,             /* (out) the statistics structure */
    int32_t                            clear_after_read   /* clear stats after copying them into stats */
);

three args, one include, zero drama. we love a clean signature. 🦋

---

PARAMS 💜

• c — the connection instance. the actual connection bestie in question.
• stats — (out) the statistics structure. this is where the numbers get placed. it's an out param, she writes into it, she does not read from it.
• clear_after_read — clear stats after copying them into stats. yes it's a mouthful of a name. yes it does exactly what it says.

---

DESCRIPTION 🍓

so this section in the original is... lowkey just vibes. it hands the mic straight over to the structures. so go look below, that's where the real tea is. 🙈

---

STRUCTURES ⭐

here's the whole glow-up of what you're getting back:

struct qb_ipcs_connection_stats {
    int32_t   client_pid;
    uint64_t  requests;
    uint64_t  responses;
    uint64_t  events;
    uint64_t  send_retries;
    uint64_t  recv_retries;
    int32_t   flow_control_state;
    uint64_t  flow_control_count;
};

eight fields, all of them iconic, all of them listed, none of them skipped. 👑

---

RETURN VALUE 🌈

0 == ok; -errno to indicate a failure

so: zero means we ate. negative errno means something went sideways. that's the whole story. 💀

---

SEE ALSO ✨

the whole friend group, fr fr:

• qb_ipcs_response_send(3)
• qb_ipcs_ref(3)
• qb_ipcs_unref(3)
• qb_ipcs_connection_auth_set(3)
• qb_ipcs_service_context_get(3)
• qb_ipcs_connection_ref(3)
• qb_ipcs_connection_next_get(3)
• qb_ipcs_stats_get(3)
• qb_ipcs_connection_unref(3)
• qb_ipcs_context_set(3)
• qb_ipcs_poll_handlers_set(3)
• qb_ipcs_request_rate_limit(3)
• qb_ipcs_disconnect(3)
• qb_ipcs_connection_first_get(3)
• qb_ipcs_enforce_buffer_size(3)
• qb_ipcs_destroy(3)
• qb_ipcs_event_send(3)
• qb_ipcs_connection_stats_get_2(3)
• qb_ipcs_service_context_set(3)
• qb_ipcs_service_id_get(3)
• qb_ipcs_context_get(3)
• qb_ipcs_connection_get_buffer_size(3)
• qb_ipcs_create(3)
• qb_ipcs_run(3)
• qb_ipcs_event_sendv(3)
• qb_ipcs_connection_service_context_get(3)
• qb_ipcs_response_sendv(3)

---

COPYRIGHT 💖

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

---

and that's the page!! LIBQB, dated 2025-09-16, filed under QB_IPCS_CO..._STATS_GET(3) — go forth and get those stats bestie, you've got this 🧚💅🔥