nbd_get_socket_activation_name(3)

📦
version 1.25.8 · 16 versions
, in centos-stream 10

💅 nbd_get_socket_activation_name(3) — a libnbd moment

okay bestie so you're in the libnbd section 3 man pages, and the star of this particular episode is nbd_get_socket_activation_name(3). yes that's a long name. no we're not shortening it. it's iconic, it ate, periodt.

✨ NAME ✨

nbd_get_socket_activation_name — get the socket activation name 🎀

🌸 SYNOPSIS 🌸

#include <libnbd.h>

char * nbd_get_socket_activation_name (
         struct nbd_handle *h
       );

look at her. one argument. no drama. she's lowkey the chillest function in the whole library.

💖 DESCRIPTION 💖

so basically: this returns the socket name that gets used when you call nbd_connect_systemd_socket_activation(3) on the same handle. same handle, same vibe, same name. iykyk.

and by default? she returns the empty string, which means the server is gonna see the name "unknown". so if your server's out here like "who are you 😭" that's why, bestie — that's literally the default behavior, not a bug, okay?

🦋 RETURN VALUE 🦋

this call returns a string. a whole string. main character energy.

⚠️ but listen — the caller must free the returned string to avoid a memory leak. every string has to be freed. no exceptions. don't leave her hanging in memory forever, that's so not slay. 💀

🔥 ERRORS 🔥

on error NULL is returned. yep, just NULL. sad but true.

to get further details of the error, refer to "ERROR HANDLING" in libnbd(3) — that's where the lore lives.

also! the following parameters must not be NULL: "h". like, at all. for more info see "Non-NULL parameters" in libnbd(3). don't pass a NULL handle, that's giving chaos and not the fun kind. 🙈

🌈 VERSION 🌈

this function first appeared in libnbd 1.16. she's a somewhat recent queen. 👑

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_SOCKET_ACTIVATION_NAME 1

iconic macro name honestly. try saying it out loud three times fast. you can't. 🫶

⭐ SEE ALSO ⭐

go read all of them. i'll wait. 💜

🧚 AUTHORS 🧚

  • Eric Blake
  • Richard W.M. Jones

the founders. the blueprint. the ones who literally wrote the code. slay. ✨

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

also hi, friendly PSA: that's a no warranty situation up there fr fr, the license said it not me 😭

and that's the whole page babes 🫶 this was libnbd-1.25.8, dated 2026-10-13, and the title was of course nbd_get_socket_activation_name(3) — go forth, free your strings, and stan libnbd 💅💖

📦 where this page comes from