io_getevents(2) System Calls Manual io_getevents(2)
NOM
io_getevents - Lire les événements d'E/S asynchrones de la file des
événements terminés
BIBLIOTHÈQUE
Bibliothèque C standard (libc, -lc)
SYNOPSIS
#include <linux/aio_abi.h> /* Définition des types *io_* */
#include <sys/syscall.h> /* Définition des constantes SYS_* */
#include <unistd.h>
int syscall(SYS_io_getevents, aio_context_t ctx_id,
long min_nr, long nr, struct io_event *events,
struct timespec *timeout);
Note : la glibc ne fournit pas d'enveloppe autour de io_getevents(),
nécessitant l'utilisation de syscall(2).
DESCRIPTION
Remarque : cette page décrit l'interface de l'appel système Linux brut.
La fonction enveloppe fournie par libaio utilise un type différent pour
le paramètre ctx_id. Voir les NOTES.
L'appel système io_getevents() essaye de lire de min_nr à nr événements
de la file des événements terminés du contexte d'entrées-sorties asyn-
chrones ctx_id.
L'argument timeout indique une durée maximale d'attente pour les événe-
ments et est indiqué comme une limite de temps relative dans une struc-
ture timespec(3).
La durée indiquée sera arrondie à la granularité supérieure de l'hor-
loge système et elle a la garantie de ne pas expirer plus tôt.
Indiquer timeout comme NULL signifie bloquer indéfiniment jusqu'à ce
qu'au moins min_nr événements aient été obtenus.
VALEUR RENVOYÉE
io_getevents() renvoie le nombre d'événements lus, zéro s'il n'y en a
aucun, et moins de min_nr si le délai timeout a expiré. En cas d'inter-
ruption par un gestionnaire de signaux, la valeur renvoyée pourrait
être non nulle et inférieure à min_nr.
Pour les valeurs de retour en cas d'échec, consultez la section NOTES.
ERREURS
EFAULT events ou timeout est un pointeur invalide.
EINTR L'appel a été interrompu par un gestionnaire de signal ; consul-
tez signal(7).
EINVAL ctx_id est invalide. min_nr ou nr est incorrect.
ENOSYS io_getevents() n'est pas implémenté sur cette architecture.
VERSIONS
Les appels système d'entrées-sorties asynchrones sont apparus dans Li-
nux 2.5.
STANDARDS
io_getevents() est spécifique à Linux et ne doit pas être utilisé dans
des programmes destinés à être portables.
NOTES
Vous voudrez sans doute utiliser la fonction enveloppe io_getevents()
fournie par libaio.
Remarquez que la fonction d'enveloppe libaio utilise un autre type
(io_context_t) pour l'argument ctx_id. Remarquez également que l'enve-
loppe libaio ne suit pas les conventions classiques de la biblio-
thè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 va-
leurs indiquées dans la section ERREURS). Si l'appel système est invo-
qué avec syscall(2), la valeur de renvoi suit les conventions clas-
siques pour indiquer l'erreur : -1, avec errno défini à une valeur (po-
sitive) de l'erreur.
BOGUES
Un ctx_id invalide peut provoquer une erreur de segmentation au lieu de
générer une erreur EINVAL.
VOIR AUSSI
io_cancel(2), io_destroy(2), io_setup(2), io_submit(2), timespec(3),
aio(7), time(7)
TRADUCTION
La traduction française de cette page de manuel a été créée par Chris-
tophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <ste-
phan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, Fran-
çois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Gué-
rard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.cou-
lon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra-
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <si-
mon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@de-
bian.org>, David Prévot <david@tilapin.org> et Jean-Philippe MENGUAL
<jpmengual@debian.org>
Cette traduction est une documentation libre ; veuillez vous reporter à
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 RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à ⟨debian-l10n-french@lists.debian.org⟩.
Pages du manuel de Linux 6.03 30 octobre 2022 io_getevents(2)
Generated by dwww version 1.15 on Sat Jun 29 01:40:38 CEST 2024.