Provided by: manpages-fr-dev_3.17.1-1_all bug

NOM

       io_submit - Soumettre un bloc d’entrées-sorties asynchrones

SYNOPSIS

       #include <libaio.h>

       int io_submit(aio_context_t ctx_id, long nr, struct iocb **iocbpp);

       Effectuez l’édition des liens avec l’option -laio.

DESCRIPTION

       io_submit()  enregistre  nr requêtes d’entrées-sorties asynchrones pour
       être traitées dans le contexte ctx_id, iocbpp devant être une table  de
       nr blocs de contrôle, qui seront soumis au contexte ctx_id.

VALEUR RENVOYÉE

       io_submit()  renvoie  le nombre de blocs iocb soumis (qui peut être nul
       si nr vaut zéro). Pour les valeurs de retour en cas  d’échec,  voir  la
       section NOTES.

ERREURS

       EAGAIN Pas assez de ressources pour enregistrer un iocb.

       EBADF  Le descripteur de fichier dans le premier iocb est invalide.

       EFAULT L’une des structures de données pointe sur une zone invalide.

       EINVAL Le  contexte  ctx_id  est  invalide, nr est inférieur à zéro, le
              bloc à l’adresse *iocbpp[0] n’est pas initialisé correctement ou
              l’opération précisée est invalide pour le descripteur de fichier
              iocb.

       ENOSYS io_submit() n’est pas implémenté dans ce noyau.

VERSIONS

       Les appels système  d’entrées-sorties  asynchrones  sont  apparus  dans
       Linux 2.5 en août 2002.

CONFORMITÉ

       io_submit() est spécifique à Linux et ne doit pas être utilisé dans des
       programmes destinés à être portables.

NOTES

       La glibc ne fournit pas de fonction autour de cet appel système.

       La fonction  de  la  bibliothèque  libaio  autour  de  l’appel  système
       io_submit() ne suit pas les conventions classiques de la bibliothèque C
       concernant l’indication des erreurs :  en  cas  d’erreur,  la  fonction
       renvoie  un  nombre  négatif  (la  valeur négative de l’une des valeurs
       indiquées dans la section ERREURS). Si l’appel système est invoqué avec
       syscall(2),  la  valeur  de retour suit les conventions classiques pour
       indiquer l’erreur : -1  avec  errno  contenant  le  code  (positif)  de
       l’erreur.

VOIR AUSSI

       io_cancel(2), io_destroy(2), io_getevents(2), io_setup(2)

COLOPHON

       Cette  page  fait  partie  de  la  publication 3.17 du projet man-pages
       Linux. Une description du projet et des instructions pour signaler  des
       anomalies       peuvent       être       trouvées      à      l’adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Cette page de manuel a été traduite  et  mise  à  jour  par  Christophe
       Blaess  <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
       Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et  mise  à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement gérées par Julien Cristau <jcristau@debian.org> et l’équipe
       francophone de traduction de Debian.

       Veuillez   signaler   toute   erreur   de   traduction  en  écrivant  à
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous  pouvez  toujours avoir accès à la version anglaise de ce document
       en utilisant la commande « man -L C <section> <page_de_man> ».