io_setup(2)                   System Calls Manual                  io_setup(2)

NOM
       io_setup - Creer un contexte d'entrees-sorties asynchrones

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

       Sinon, la bibliotheque d'E/S asynchrones ((libaio, -laio) ; voir les
       VERSIONS.

SYNOPSIS
       #include <linux/aio_abi.h>          /* Definit les types necessaires */

       long io_setup(unsigned int nr_events, aio_context_t *ctx_idp);

       Note : il n'existe pas d'enveloppe pour cet appel systeme dans la
       glibc ; voir VERSIONS.

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. Consultez la section VERSIONS.

       L'appel systeme io_setup() cree un contexte d'E/S asynchrone capable de
       traiter simultanement nr_events. L'argument ctx_idp ne doit pas pointer
       sur un contexte deja existant et doit etre initialise a zero avant
       l'appel. Si la creation de contexte reussit, *ctx_idp est rempli avec
       le descripteur resultant.

VALEUR RENVOYEE
       io_setup() renvoie 0 s'il reussit. Pour les valeurs de retour en cas
       d'echec, consultez la section VERSIONS.

ERREURS
       EAGAIN La nr_events depasse la limite des evenements disponibles, telle
              que definie par /proc/sys/fs/aio-max-nr (voir proc(5))..

       EFAULT Un pointeur invalide a ete transmis comme ctx_idp.

       EINVAL ctx_idp n'est pas initialise ou la valeur nr_events depasse les
              limites internes. nr_events doit etre superieur a zero.

       ENOMEM Pas assez de memoire pour le noyau.

       ENOSYS io_setup() n'est pas implemente sur cette architecture.

VERSIONS
       La glibc ne fournit pas de fonction autour de cet appel systeme. Vous
       pourriez l'invoquer en utilisant syscall(2). Mais vous voudrez sans
       doute utiliser la fonction enveloppe io_setup() fournie par libaio.

       Remarquez que la fonction enveloppe libaio utilise un autre type
       (io_context_t *) pour l'argument ctx_idp. 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 retour suit les conventions
       classiques pour indiquer l'erreur : -1 avec errno contenant le code
       (positif) de l'erreur.

STANDARDS
       Linux.

HISTORIQUE
       Linux 2.5.

VOIR AUSSI
       io_cancel(2), io_destroy(2), io_getevents(2), io_submit(2), aio(7)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org> et Jean-Philippe MENGUAL <jpmengual@debian.org>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> 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 <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                    io_setup(2)