{"id":7410,"date":"2022-12-20T19:37:59","date_gmt":"2022-12-20T22:37:59","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/aio_suspend-man3\/"},"modified":"2022-12-20T19:37:59","modified_gmt":"2022-12-20T22:37:59","slug":"aio_suspend-man3","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/aio_suspend-man3\/","title":{"rendered":"AIO_SUSPEND (man3)"},"content":{"rendered":"

AIO_SUSPEND<\/h1>\n

NAME<\/a>
SYNOPSIS<\/a>
DESCRIPTION<\/a>
RETURN VALUE<\/a>
ERRORS<\/a>
VERSIONS<\/a>
ATTRIBUTES<\/a>
CONFORMING TO<\/a>
NOTES<\/a>
BUGS<\/a>
SEE ALSO<\/a>
COLOPHON<\/a> <\/p>\n

\n

NAME <\/a> <\/h2>\n

aio_suspend \u2212 wait for asynchronous I\/O operation or timeout<\/p>\n

SYNOPSIS <\/a> <\/h2>\n

#include <\/b><\/p>\n

int aio_suspend(const struct aiocb bodies manpages.csv script_extrae_body.sh script.sh usr const<\/b> aiocb_list<\/i>[],
int<\/b> nitems<\/i>, const struct timespec *<\/b>timeout<\/i>);<\/b><\/p>\n

Link with \u2212lrt<\/i>.<\/p>\n

DESCRIPTION <\/a> <\/h2>\n

The aio_suspend<\/b>() function suspends the calling thread until one of the following occurs:<\/p>\n\n\n\n\n
<\/td>\n\n

*<\/p>\n<\/td>\n

<\/td>\n\n

One or more of the asynchronous I\/O requests in the list aiocb_list<\/i> has completed.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

*<\/p>\n<\/td>\n

<\/td>\n\n

A signal is delivered.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

*<\/p>\n<\/td>\n

<\/td>\n\n

timeout<\/i> is not NULL and the specified time interval has passed. (For details of the timespec<\/i> structure, see nanosleep<\/b>(2).)<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

The nitems<\/i> argument specifies the number of items in aiocb_list<\/i>. Each item in the list pointed to by aiocb_list<\/i> must be either NULL (and then is ignored), or a pointer to a control block on which I\/O was initiated using aio_read<\/b>(3), aio_write<\/b>(3), or lio_listio<\/b>(3). (See aio<\/b>(7) for a description of the aiocb<\/i> structure.)<\/p>\n

If CLOCK_MONOTONIC<\/b> is supported, this clock is used to measure the timeout interval (see clock_gettime<\/b>(3)).<\/p>\n

RETURN VALUE <\/a> <\/h2>\n

If this function returns after completion of one of the I\/O requests specified in aiocb_list<\/i>, 0 is returned. Otherwise, \u22121 is returned, and errno<\/i> is set to indicate the error.<\/p>\n

ERRORS <\/a> <\/h2>\n\n\n\n\n
<\/td>\n\n

EAGAIN<\/b><\/p>\n<\/td>\n

<\/td>\n\n

The call timed out before any of the indicated operations had completed.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

EINTR<\/b><\/p>\n<\/td>\n

<\/td>\n\n

The call was ended by signal (possibly the completion signal of one of the operations we were waiting for); see signal<\/b>(7).<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

ENOSYS<\/b><\/p>\n<\/td>\n

<\/td>\n\n

aio_suspend<\/b>() is not implemented.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

VERSIONS <\/a> <\/h2>\n

The aio_suspend<\/b>() function is available since glibc 2.1.<\/p>\n

ATTRIBUTES <\/a> <\/h2>\n

For an explanation of the terms used in this section, see attributes<\/b>(7).<\/p>\n

\"Image<\/p>\n

CONFORMING TO <\/a> <\/h2>\n

POSIX.1-2001, POSIX.1-2008.<\/p>\n

NOTES <\/a> <\/h2>\n

One can achieve polling by using a non-NULL timeout<\/i> that specifies a zero time interval.<\/p>\n

If one or more of the asynchronous I\/O operations specified in aiocb_list<\/i> has already completed at the time of the call to aio_suspend<\/b>(), then the call returns immediately.<\/p>\n

To determine which I\/O operations have completed after a successful return from aio_suspend<\/b>(), use aio_error<\/b>(3) to scan the list of aiocb<\/i> structures pointed to by aiocb_list<\/i>.<\/p>\n

BUGS <\/a> <\/h2>\n

The glibc implementation of aio_suspend<\/b>() is not async-signal-safe, in violation of the requirements of POSIX.1.<\/p>\n

SEE ALSO <\/a> <\/h2>\n

aio_cancel<\/b>(3), aio_error<\/b>(3), aio_fsync<\/b>(3), aio_read<\/b>(3), aio_return<\/b>(3), aio_write<\/b>(3), lio_listio<\/b>(3), aio<\/b>(7), time<\/b>(7)<\/p>\n

COLOPHON <\/a> <\/h2>\n

This page is part of release 5.10 of the Linux man-pages<\/i> project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at https:\/\/www.kernel.org\/doc\/man\u2212pages\/.<\/p>\n

\n","protected":false},"excerpt":{"rendered":"

aio_suspend \u2212 wait for asynchronous I\/O operation or timeout <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2536],"tags":[2538,2010,3007],"class_list":["post-7410","post","type-post","status-publish","format-standard","hentry","category-3-llamadas-de-bibliotecas","tag-2538","tag-aio_suspend","tag-man3"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7410","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=7410"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7410\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=7410"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=7410"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=7410"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}