Movatterモバイル変換

aio_suspend(3) — Linux manual page

NAME \|LIBRARY \|SYNOPSIS \|DESCRIPTION \|RETURN VALUE \|ERRORS \|ATTRIBUTES \|STANDARDS \|HISTORY \|NOTES \|BUGS \|SEE ALSO \|COLOPHON

aio_suspend(3)           Library Functions Manualaio_suspend(3)

NAME top

       aio_suspend - wait for asynchronous I/O operation or timeout

LIBRARY top

       Real-time library (librt,-lrt)

SYNOPSIS top

#include <aio.h>int aio_suspend(int n;const struct aiocb *constaiocb_list[n], intn,const struct timespec *restricttimeout);

DESCRIPTION top

       Theaio_suspend() function suspends the calling thread until one       of the following occurs:       •  One or more of the asynchronous I/O requests in the listaiocb_list has completed.       •  A signal is delivered.       •timeout is not NULL and the specified time interval has passed.          (For details of thetimespec structure, seenanosleep(2).)       Then argument specifies the number of items inaiocb_list.  Each       item in the list pointed to byaiocb_list must be either NULL (and       then is ignored), or a pointer to a control block on which I/O was       initiated usingaio_read(3),aio_write(3), orlio_listio(3).  (Seeaio(7) for a description of theaiocb structure.)       IfCLOCK_MONOTONICis supported, this clock is used to measure the       timeout interval (seeclock_gettime(2)).

RETURN VALUE top

       If this function returns after completion of one of the I/O       requests specified inaiocb_list, 0 is returned.  Otherwise, -1 is       returned, anderrno is set to indicate the error.

ERRORS top

EAGAINThe call timed out before any of the indicated operations              had completed.EINTRThe call was ended by signal (possibly the completion              signal of one of the operations we were waiting for); seesignal(7).ENOSYS aio_suspend() is not implemented.

ATTRIBUTES top

       For an explanation of the terms used in this section, seeattributes(7).       ┌──────────────────────────────────────┬───────────────┬─────────┐       │Interface│Attribute│Value│       ├──────────────────────────────────────┼───────────────┼─────────┤       │aio_suspend()                        │ Thread safety │ MT-Safe │       └──────────────────────────────────────┴───────────────┴─────────┘

STANDARDS top

       POSIX.1-2008.

HISTORY top

       glibc 2.1.  POSIX.1-2001.       POSIX doesn't specify the parameters to berestrict; that is       specific to glibc.

NOTES top

       One can achieve polling by using a non-NULLtimeout that specifies       a zero time interval.       If one or more of the asynchronous I/O operations specified inaiocb_list has already completed at the time of the call toaio_suspend(), then the call returns immediately.       To determine which I/O operations have completed after a       successful return fromaio_suspend(), useaio_error(3) to scan the       list ofaiocb structures pointed to byaiocb_list.

BUGS top

       The glibc implementation ofaio_suspend() is not async-signal-       safe, in violation of the requirements of POSIX.1.

COLOPHON top

       This page is part of theman-pages (Linux kernel and C library       user-space interface documentation) project.  Information about       the project can be found at        ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report       for this manual page, see       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.       This page was obtained from the tarball man-pages-6.15.tar.gz       fetched from       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on       2025-08-11.  If you discover any rendering problems in this HTML       version of the page, or you believe there is a better or more up-       to-date source for the page, or you have corrections or       improvements to the information in this COLOPHON (which isnot       part of the original manual page), send a mail to       man-pages@man7.orgLinux man-pages 6.15            2025-06-28aio_suspend(3)

Pages that refer to this page:aio_cancel(3), aiocb(3type), aio_error(3), aio_fsync(3), aio_read(3), aio_return(3), aio_write(3), lio_listio(3), aio(7), signal-safety(7)