io_setup

Autres langues

Langue: fr

Version: 21 février 2003 (fedora - 25/11/07)

Section: 2 (Appels système)

NOM

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

SYNOPSIS

#include <linux/aio.h>

long io_setup (unsigned nr_events, aio_context_t *ctxp);

DESCRIPTION

io_setup() crée un contexte d'E/S asynchrone capable de recevoir au moins nr_events. ctxp doit 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, sinon l'une des erreurs décrites ci-dessous est renvoyée.

ERREURS

EINVAL
ctxp n'est pas initialisé ou la valeur nr_events dépasse les limites internes. nr_events doit être supérieur à zéro.
EFAULT
Un pointeur invalide a été transmis comme ctxp.
ENOMEM
Pas assez de mémoire pour le noyau.
EAGAIN
La valeur nr_events dépasse la limite de l'utilisateur en événements disponibles.
ENOSYS
io_setup() n'est pas implémenté sur cette architecture.

CONFORMITÉ

io_setup() est spécifique à Linux et ne doit pas être utilisé dans des programmes conçus pour être portables.

HISTORIQUE

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

VOIR AUSSI

io_getevents(2), io_cancel(2), io_destroy(2), io_submit(2)

NOTES

Les appels d'E/S asynchrones ont été écrits par Benjamin LaHaise.

AUTEUR

Kent Yoder.

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 18 juillet 2003 et révisée le 7 décembre 2006.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 io_setup ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.