io_getevents(2) System Calls Manual io_getevents(2) NOM io_getevents - Lire les evenements d'E/S asynchrones de la file des evenements termines BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) Sinon, la bibliotheque d'E/S asynchrones ((libaio, -laio) ; voir les VERSIONS. SYNOPSIS #include /* Definition des types *io_* */ #include /* Definition des constantes SYS_* */ #include int syscall(SYS_io_getevents, aio_context_t ctx_id, long min_nr, long nr, struct io_event *events, struct timespec *timeout); Note : la glibc ne fournit pas d'enveloppe autour de io_getevents(), necessitant l'utilisation de syscall(2). DESCRIPTION Remarque : cette page decrit l'interface de l'appel systeme Linux brut. La fonction enveloppe fournie par libaio utilise un type different pour le parametre ctx_id. Voir les VERSIONS. L'appel systeme io_getevents() essaye de lire de min_nr a nr evenements de la file des evenements termines du contexte d'entrees-sorties asynchrones ctx_id. L'argument timeout indique une duree maximale d'attente pour les evenements et est indique comme une limite de temps relative dans une structure timespec(3). La duree indiquee sera arrondie a la granularite superieure de l'horloge systeme et elle a la garantie de ne pas expirer plus tot. Indiquer timeout comme NULL signifie bloquer indefiniment jusqu'a ce qu'au moins min_nr evenements aient ete obtenus. VALEUR RENVOYEE io_getevents() renvoie le nombre d'evenements lus, zero s'il n'y en a aucun, et moins de min_nr si le delai timeout a expire. En cas d'interruption par un gestionnaire de signaux, la valeur renvoyee pourrait etre non nulle et inferieure a min_nr. Pour les valeurs de retour en cas d'echec, consultez la section VERSIONS. ERREURS EFAULT events ou timeout est un pointeur invalide. EINTR L'appel a ete interrompu par un gestionnaire de signal ; consultez signal(7). EINVAL ctx_id est invalide. min_nr ou nr est incorrect. ENOSYS io_getevents() n'est pas implemente sur cette architecture. VERSIONS Vous voudrez sans doute utiliser la fonction enveloppe io_getevents() fournie par libaio. Remarquez que la fonction d'enveloppe libaio utilise un autre type (io_context_t) pour l'argument ctx_id. Remarquez egalement que l'enveloppe libaio ne suit pas les conventions classiques de la bibliotheque C concernant l'indication des erreurs : en cas d'erreur, la fonction renvoie un nombre negatif (la valeur negative de l'une des valeurs indiquees dans la section ERREURS). Si l'appel systeme est invoque avec syscall(2), la valeur de renvoi suit les conventions classiques pour indiquer l'erreur : -1, avec errno defini a une valeur (positive) de l'erreur. STANDARDS Linux. HISTORIQUE Linux 2.5. BOGUES Un ctx_id invalide peut provoquer une erreur de segmentation au lieu de generer une erreur EINVAL. VOIR AUSSI io_cancel(2), io_destroy(2), io_setup(2), io_submit(2), timespec(3), aio(7), time(7) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot et Jean-Philippe MENGUAL Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 io_getevents(2)