nbd_get_version_extra(3)

💖 nbd_get_version_extra(3) — the libnbd page, bestie edition 💖

okay so you're in the LIBNBD section of the manual and you want the whole tea on nbd_get_version_extra. say less. here's everything, no cap 🫶

✨ NAME ✨

nbd_get_version_extra — literally just returns the extra version of the library 💅

✨ SYNOPSIS ✨

#include <libnbd.h>

const char * nbd_get_version_extra (
               struct nbd_handle *h
             );

✨ DESCRIPTION ✨

okay so this one is giving "tell me your lore" energy. it returns the extra version of libnbd. like, the freeform string that gets baked in at package build time using this:

./configure --with-extra="..."

and the whole point? downstream packagers (think Linux distributions, iykyk) are the intended audience — they use it to convey extra version info, like the exact version of the libnbd RPM, the .deb, that kind of thing 🎀

the string may be "", which is the vibe check saying no extra version info is available — or that this is an upstream build of libnbd. either way, empty is a legit answer, don't come for her 💀

✨ RETURN VALUE ✨

this call returns a statically allocated string — valid for the lifetime of the process, or until libnbd is unloaded by dlclose(3). and bestie listen to me: you must not try to free the string. hands off. it's not yours. 🫶

✨ ERRORS ✨

she does not fail. periodt. this function cannot fail. icon behaviour honestly 👑

the following parameters must not be NULL: "h". for more info see "Non-NULL parameters" in libnbd(3).

✨ VERSION ✨

this function first appeared in libnbd 1.24. she's new-ish, respect her 🌸

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

#define LIBNBD_HAVE_NBD_GET_VERSION_EXTRA 1

✨ SEE ALSO ✨

nbd_create(3), nbd_get_package_name(3), nbd_get_version_extra(3), libnbd(3).

✨ AUTHORS ✨

Eric Blake

Richard W.M. Jones

(absolute legends, fr fr 💜)

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

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

---

and that's the whole page, bestie 🦋 this lil beauty is from libnbd-1.24.4, dated 2026-10-13, and you were reading the nbd_get_version_extra(3) page the entire time ✨ mwah 💋