nbd_aio_notify_write(3)

💅 nbd_aio_notify_write — NAME ✨

ok so welcome to the LIBNBD manual (section 3, bestie, we're in the library pages now 🎀) and today's main character is nbd_aio_notify_write — the function whose whole job is telling the state machine "hey queen, the connection is writable now" 💖

---

🌸 SYNOPSIS 🌸

like, the vibe check first, obvi:

#include <libnbd.h>

int nbd_aio_notify_write (
      struct nbd_handle *h
    );

that's it. that's the whole flex. one handle, no cap 🫶

---

✨ DESCRIPTION ✨

okay so here's the tea ☕ — you call this to send a notification to the state machine that the connection is writable 💅

the way that this normally goes down: your main loop has already detected that the file descriptor associated with this connection is writable, and now you're like "hey bestie, I checked, we're good, go off" 🔥 that's literally when you call this. after the fd says it's writable. periodt.

---

🦋 RETURN VALUE 🦋

if the call is successful, the function returns 0 🎀 iconic, flawless, no notes.

---

😭 ERRORS 😭

on error, -1 is returned 💀 (yes it's giving "something went wrong", go check).

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

also!! the following parameters must not be NULL: "h" 🚨 for more info see "Non-NULL parameters" in libnbd(3). do not pass a NULL handle, that's not the move, bestie 🙈

---

⭐ VERSION ⭐

this function first appeared in libnbd 1.0 — an OG, honestly 👑

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

#define LIBNBD_HAVE_NBD_AIO_NOTIFY_WRITE 1

slay, now you can feature-detect it 🧚

---

🌈 SEE ALSO 🌈

• nbd_create(3)
• libnbd(3)

go read those too, they're part of the lore 🫶

---

💜 AUTHORS 💜

• Eric Blake
• Richard W.M. Jones

absolute legends, we stan 💖

---

🎀 COPYRIGHT 🎀

Copyright Red Hat

---

👑 LICENSE 👑

okay legal moment, bestie, but I'm keeping this exactly how it is because it's legally binding and not a vibe-check situation 💅

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, mwah 💋 — this was nbd_aio_notify_write(3) from libnbd-1.25.8, dated 2026-10-13. go notify that write bestie, you got this 🌸✨🦋