nbd_stats_chunks_sent(3)

💅 nbd_stats_chunks_sent(3) — the LIBNBD glow-up

okay so bestie, you're looking at nbd_stats_chunks_sent(3), which is a real page from the LIBNBD manual fam. buckle up, it's short and sweet and honestly kinda iconic 🎀

---

✨ NAME ✨

nbd_stats_chunks_sent — the stats of chunks sent over the connection so far 💫 like, a running tally, a little leaderboard for your client, yk?

---

🦋 SYNOPSIS 🦋

#include <libnbd.h>

uint64_t nbd_stats_chunks_sent (
           struct nbd_handle *h
         );

literally that's it. one handle in, one uint64_t out. no drama 💅

---

🌸 DESCRIPTION 🌸

so this function returns the number of chunks that the client has sent to the server. and before you ask "what's a chunk" — a chunk is a group of bytes delineated by a magic number that cannot be further subdivided without breaking the protocol. periodt. that's the definition. don't come for it 🙈

and like, small vibe check on what this number is not:

• it does not necessarily relate to the number of API calls made
• and it does not necessarily relate to the number of TCP packets sent over the connection

it's giving "its own thing", okay? main character energy, separate from the API calls and the packets. 🧚

---

⭐ RETURN VALUE ⭐

this call returns a counter. that's the whole idea. lowkey the most chill return value ever. 🍓

---

🔥 ERRORS 🔥

good news bestie: this function does not fail. ever. no cap. 🔥

but there's one must-know caveat: the following parameters must not be NULL: "h". for way more info on that whole situation, go see "Non-NULL parameters" in libnbd(3). 💜

---

👑 VERSION 👑

this function first appeared in libnbd 1.16. so if you're on something older, sorry babe 😭

if you need to test whether this function is available at compile time, check if the following macro is defined:

#define LIBNBD_HAVE_NBD_STATS_CHUNKS_SENT 1

that macro is your bestie for real, use it 🫶

---

🌈 SEE ALSO 🌈

the whole friend group:

• nbd_create(3)
• nbd_set_strict_mode(3)
• nbd_stats_bytes_received(3)
• nbd_stats_bytes_sent(3)
• nbd_stats_chunks_received(3)
• libnbd(3)

iykyk 👑

---

💖 AUTHORS 💖

the legends themselves:

• Eric Blake
• Richard W.M. Jones

we stan 💅👑

---

🎀 COPYRIGHT 🎀

Copyright Red Hat

---

🌸 LICENSE 🌸

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. (yes, that means no warranty, fr fr — read it and weep 😭)

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA 🌈

---

k that's the whole page bestie! now go count those chunks and slay ✨

big mwah from libnbd-1.25.8, dated 2026-10-13 — that's the version and the date, and nbd_stats_chunks_sent(3) is officially a wrap 🫶💖