AIO_SUSPEND(2)

📦 version 15.1, in freebsd 14.5, freebsd 15.1

💤 AIO_SUSPEND(2) — the “go take a nap until async I/O wakes you” manual 💤

💤 NAME 💤

aio_suspend — suspend until asynchronous I/O operations or timeout complete (REALTIME)

📚 LIBRARY 📚

Standard C Library (libc, -lc)

✨ SYNOPSIS ✨

#include <aio.h>

int
aio_suspend(const struct aiocb *const iocbs[], int niocb,
    const struct timespec *timeout);

🫶 DESCRIPTION 🫶

okay so aio_suspend() is the system call that puts the calling process on pause until at least one of the specified asynchronous I/O requests have completed, a signal is delivered, or the timeout has passed. it’s giving “wait for the group chat to finally say something” energy, fr fr.

The iocbs argument is an array of niocb pointers to asynchronous I/O requests. Array members containing null pointers will be silently ignored — lowkey iconic of them tbh.

If timeout is not a null pointer, it specifies a maximum interval to suspend. If timeout is a null pointer, the suspend blocks indefinitely. To effect a poll, timeout should point to a zero-value timespec structure. ✨

🎀 RETURN VALUES 🎀

If one or more of the specified asynchronous I/O requests have completed, aio_suspend() returns 0. Otherwise it returns -1 and sets errno to indicate the error, as enumerated below. slay.

💀 ERRORS 💀

The aio_suspend() system call will fail if:

  • [EAGAIN] — the timeout expired before any I/O requests completed.
  • [EINVAL] — The iocbs argument contains more asynchronous I/O requests than the vfs.aio.max_aio_queue_per_proc sysctl(8) variable, or at least one of the requests is not valid.
  • [EINTR] — the suspend was interrupted by a signal.

👀 SEE ALSO 👀

🌈 STANDARDS 🌈

The aio_suspend() system call is expected to conform to the IEEE Std 1003.1 (“POSIX.1”) standard. periodt 💅

🦋 HISTORY 🦋

The aio_suspend() system call first appeared in FreeBSD 3.0.

💖 AUTHORS 💖

This manual page was written by Wes Peters <wes@softweyr.com>.

okay bye bestie 🫶 this page is from Debian, dated October 23, 2017, and it lives under AIO_SUSPEND(2) 💅

📦 where this page comes from