nbd_set_uri_allow_tls(3)

💅 NAME

Okay bestie, this is nbd_set_uri_allow_tls(3) from the libnbd manual, and it does exactly one thing: it sets the allowed TLS settings in NBD URIs. That's the whole vibe. ✨

---

✨ SYNOPSIS

#include <libnbd.h>

int nbd_set_uri_allow_tls (
      struct nbd_handle *h, int tls
    );

Like, you hand it a handle and a tls value, and it just gets it. 🫶

---

🎀 DESCRIPTION

So basically this is the little function that decides which TLS settings are even allowed to show up inside NBD URIs. Out of the box, the default is to allow either non-TLS or TLS URIs — very "you do you, bestie" energy. 🌈

The tls parameter can be:

• LIBNBD_TLS_DISABLE — TLS URIs are not permitted, periodt. A URI like nbds://... will be rejected. Ngl, it's giving "we don't do that here." 💀
• LIBNBD_TLS_ALLOW — this is the default. TLS may be used or not, depending on whether the URI uses nbds or nbd. Lowkey the most chill option. 🦋
• LIBNBD_TLS_REQUIRE — TLS URIs are required. All URIs must use nbds. No exceptions, no negotiating, main character energy only. 👑

---

🔥 RETURN VALUE

If the call is successful the function returns 0. Slay. ✅

---

💀 ERRORS

On error -1 is returned. 😭

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

The following parameters must not be NULL: h. For more information see "Non-NULL parameters" in libnbd(3). Like, do not pass a NULL handle, I am begging you. 🙈

---

🦋 HANDLE STATE

nbd_set_uri_allow_tls can be called when the handle is in the following state:

• Handle created, before connecting — ✅ allowed
• Connecting — ❌ error
• Connecting & handshaking (opt_mode) — ❌ error
• Connected to the server — ❌ error
• Connection shut down — ❌ error
• Handle dead — ❌ error

So yeah — it's a "before you connect" kinda function. Timing is everything, iykyk. ⭐

---

🌸 VERSION

This function first appeared in libnbd 1.2. She's been iconic for a minute. 👑

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

#define LIBNBD_HAVE_NBD_SET_URI_ALLOW_TLS 1

---

👑 SEE ALSO

nbd_connect_uri(3), nbd_create(3), nbd_set_uri_allow_transports(3), libnbd(3).

Go read the whole squad, fr fr. 💜

---

🫶 AUTHORS

Eric Blake

Richard W.M. Jones

---

🌈 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

---

Okay that's the whole page, bestie — this was libnbd-1.25.8, dated 2026-10-13, and it's the nbd_set_uri_allow_tls(3) manual page. Now go forth and configure your TLS settings correctly 💅✨🎀