nbd_stats_bytes_received(3)

💖 nbd_stats_bytes_received — LIBNBD’s “bytes received over connection so far” moment 💖

okay so bestie, this is the nbd_stats_bytes_received(3) page from the LIBNBD manual, and it’s literally about the statistics of bytes received over connection so far. lowkey iconic. 💅

---

🌸 NAME 🌸

nbd_stats_bytes_received — statistics of bytes received over connection so far. that’s the vibe. ✨

---

🦋 SYNOPSIS 🦋

okay so here’s the include and the function signature, verbatim, no cap:

        #include <libnbd.h>

        uint64_t nbd_stats_bytes_received (
                   struct nbd_handle *h
                 );

---

🌈 DESCRIPTION 🌈

Return the number of bytes that the client has received from the server. that’s the whole assignment. 🫶

This tracks the plaintext bytes utilized by the NBD protocol; it may differ from the number of bytes actually received over the connection, particularly when TLS is in use. so yeah, TLS can make the raw connection bytes and this counter not match up. not me explaining TLS at the function level but here we are 😭

---

🎀 RETURN VALUE 🎀

This call returns a counter. that’s it. a counter. periodt. 🔥

---

👑 ERRORS 👑

This function does not fail. like, no error era. 💀

The following parameters must not be NULL: "h". For more information see "Non-NULL parameters" in libnbd(3).

bestie, read that again: "h" must not be NULL. the function itself does not fail, but NULL for "h" is not the move. 🙈

---

⭐ VERSION ⭐

This function first appeared in libnbd 1.16.

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

        #define LIBNBD_HAVE_NBD_STATS_BYTES_RECEIVED 1

---

🧚 SEE ALSO 🧚

• nbd_create(3)
• nbd_stats_bytes_sent(3)
• nbd_stats_chunks_received(3)
• nbd_stats_chunks_sent(3)
• libnbd(3)

---

💜 AUTHORS 💜

• Eric Blake
• Richard W.M. Jones

---

🌸 COPYRIGHT 🌸

Copyright Red Hat

---

🍓 LICENSE 🍓

okay legal bestie, here’s the exact license tea, no edits because legal is legal:

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. 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

---

xoxo, your libnbd bestie 💅 — this page is from libnbd-1.25.8, dated 2026-10-13. slay and read your manpages responsibly 🫶✨