Provided by: manpages-fr-dev_3.32d0.2p4-1_all bug

NOM

       io_setup - Créer un contexte d'entrées-sorties asynchrones

SYNOPSIS

       #include <libaio.h>

       int io_setup(unsigned nr_events, aio_context_t *ctxp);

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

DESCRIPTION

       io_setup()  crée un contexte d'E/S asynchrone capable de recevoir au moins nr_events. ctxp
       ne doit pas pointer sur un contexte déjà existant et doit être  initialisé  à  zéro  avant
       l'appel.  Si  la  création  de  contexte  réussit,  *ctxp  est  rempli avec le descripteur
       résultant.

VALEUR RENVOYÉE

       io_setup() renvoie zéro s'il réussit. Pour les valeurs de retour en cas d'échec, consultez
       la section NOTES.

ERREURS

       EAGAIN La valeur nr_events dépasse la limite de l'utilisateur en événements disponibles.

       EFAULT Un pointeur invalide a été transmis comme ctxp.

       EINVAL ctxp  n'est  pas  initialisé  ou  la valeur nr_events dépasse les limites internes.
              nr_events doit être supérieur à zéro.

       ENOMEM Pas assez de mémoire pour le noyau.

       ENOSYS io_setup() n'est pas implémenté sur cette architecture.

VERSIONS

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

CONFORMITÉ

       io_setup() 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_setup() 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_submit(2), aio(7)

COLOPHON

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

TRADUCTION

       Depuis   2010,   cette   traduction   est   maintenue   à   l'aide   de    l'outil    po4a
       <URL:http://po4a.alioth.debian.org/>  par  l'équipe  de  traduction francophone au sein du
       projet perkamon <URL:http://perkamon.alioth.debian.org/>.

       Christophe  Blaess  <URL:http://www.blaess.fr/christophe/>   (1996-2003),   Alain   Portal
       <URL:http://manpagesfr.free.fr/>  (2003-2006).  Julien  Cristau et l'équipe francophone de
       traduction de Debian (2006-2009).

       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> ».