aio_error(3)

✨ aio_error(3) ✨

okay bestie, so this one's from the Library Functions Manual, and it's literally the vibe check for your async I/O 🦋

---

💖 NAME 💖

aio_error — get error status of asynchronous I/O operation

---

🌸 LIBRARY 🌸

Real-time library (librt, -lrt)

---

🎀 SYNOPSIS 🎀

#include <aio.h>

int aio_error(const struct aiocb *aiocbp);

---

💅 DESCRIPTION 💅

So basically, aio_error() returns the error status for the asynchronous I/O request whose control block is pointed to by aiocbp. That's it, that's the whole job. She's simple, she's iconic, she serves 👑

(if you're like "bestie what even IS an aiocb struct" — go read aio(7), it's all laid out there, no cap)

---

🌈 RETURN VALUE 🌈

This function hands you back one of these, and every single one matters:

• EINPROGRESS — the request has not been completed yet. it's still cooking 🍓
• ECANCELED — the request was canceled. rip 🪦
• 0 — the request completed successfully. slay!! ✨
• > 0 — a positive error number if the asynchronous I/O operation failed. and this is the exact same value that would have been stored in the errno variable in the case of a synchronous read(2), write(2), fsync(2), or fdatasync(2) call. same number, different door 🚪

---

⭐ ERRORS ⭐

• EINVAL — aiocbp does not point at a control block for an asynchronous I/O request of which the return status (see aio_return(3)) has not been retrieved yet. like, that's not the girl you're looking for 🙈
• ENOSYS — aio_error() is not implemented. she's not even here, she never showed up 💀

---

👑 ATTRIBUTES 👑

For an explanation of the terms used in this section, see attributes(7).

• Interface: aio_error()
• Attribute: Thread safety
• Value: MT-Safe

(MT-Safe means you can call her from multiple threads and she will NOT start drama 🫶)

---

🧚 STANDARDS 🧚

POSIX.1-2008.

---

💜 HISTORY 💜

• glibc 2.1.
• POSIX.1-2001.

she's been around. a legend. a veteran. respect her 💅

---

🌸 EXAMPLES 🌸

See aio(7).

---

🦋 SEE ALSO 🦋

aio_cancel(3), aio_fsync(3), aio_read(3), aio_return(3), aio_suspend(3), aio_write(3), lio_listio(3), aio(7)

---

and that's the whole page, bestie!! this one shipped in Linux man-pages 6.20, dated 2026-02-08 — so go forth, check your async errors, and stay iconic 💖✨🎀