nbd_get_handle_name(3)

💅 nbd_get_handle_name — get the handle name

okay so bestie, welcome to the nbd_get_handle_name(3) page, part of the libnbd manual, and honestly? this one is a little gift. it's the "what's ur name bestie" of the libnbd world and i'm obsessed 💖

---

✨ SYNOPSIS ✨

like, here's the whole vibe, copy it exactly or the compiler will simply not slay:

#include <libnbd.h>

char * nbd_get_handle_name (
         struct nbd_handle *h
       );

---

🌸 DESCRIPTION 🌸

okay so it literally just gets the name of the handle. that's it. that's the function. main character energy honestly 🎀

if it was previously set by calling nbd_set_handle_name(3) then this returns the name that was set — like, it remembers what you told it, no cap ✨

otherwise?? it'll return a generic name like "nbd1", "nbd2", etc. so like, your handle gets assigned a basic little default name. it's giving "new phone, who dis" but for handles 🦋

---

💖 RETURN VALUE 💖

this call returns a string. the caller must free the returned string to avoid a memory leak. like, don't just walk away from it — that string is ur responsibility now, ok?? free it 🙈💅

---

💀 ERRORS 💀

on error NULL is returned. yes, the classic NULL jumpscare 😭

refer to "ERROR HANDLING" in libnbd(3) for how to get further details of the error — that's where the actual tea is spilled.

the following parameters must not be NULL: "h". for more information see "Non-NULL parameters" in libnbd(3). so like, don't pass a NULL handle, bestie, that's not the move 🫶

---

⭐ VERSION ⭐

this function first appeared in libnbd 1.0 — an absolute icon from day one, tbh 👑

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

#define LIBNBD_HAVE_NBD_GET_HANDLE_NAME 1

slay, macro, slay ✨

---

🦋 SEE ALSO 🦋

• nbd_create(3)
• nbd_set_handle_name(3)
• libnbd(3)

go read those too, they're all connected, iykyk 💜

---

🎀 AUTHORS 🎀

• Eric Blake
• Richard W.M. Jones

legends, honestly 🌈

---

👑 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

no warranty bestie, the lawyers made me say it, but fr fr read the license 💖

---

okay that's the whole page, mwah 🫶 this one's from libnbd-1.25.8, dated 2026-10-13, and it's the nbd_get_handle_name(3) page — go name ur handles, queen 💅✨