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

#include <linux/aio.h>

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

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

io_submit() renvoie le nombre de blocs iocb soumis et zéro si nr vaut zéro.

EINVAL

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

EFAULT

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

EBADF

Le descripteur de fichier dans le premier iocb est invalide.

EAGAIN

Pas assez de ressources pour enregistrer un iocb.

ENOSYS

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

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

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

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

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

Kent Yoder.

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 juillet 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=en man 2 io_submit ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.