.de Sh " Subsection .if t .Sp .ne 5

$1

.. .de Sp " Vertical space (when we can't use .PP) .if t .5v .if n .. .de Ip " List item .ie
(.$>=3 .ne $3 .el .ne 3
[/col][/row][/table]

Nom

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

Résumé

.ad l .hy 0 #include <linux/aio.h> .HP 15 long io_setup (unsigned nr_events, aio_context_t *ctxp); .ad .hy

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èmes 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 Be,jam LaHaise.

Auteur

Kent Yoder.

Traduction

Christophe Blaess, 1996-2003.