perkamon - en to fr translation catalogue (54 entries)

note: type: TH
en: 2019-03-06
fr: 6 mars 2019

note: type: TH
en: Linux Programmer's Manual
fr: Manuel du programmeur Linux

note: type: SH
en: NAME
fr: NOM

note: type: Plain text
en: eventfd - create a file descriptor for event notification
fr: eventfd - Créer un descripteur de fichier pour la notification d'événements

note: type: Plain text
en: B<eventfd>()  creates an "eventfd object" that can be used as an event wait/notify mechanism by user-space applications, and by the kernel to notify user-space applications of events.  The object contains an unsigned 64-bit integer (I<uint64_t>)  counter that is maintained by the kernel.  This counter is initialized with the value specified in the argument I<initval>.
fr: B<eventfd>() créée un « objet eventfd » qui peut être utilisé par les applications de l'espace utilisateur pour l'attente ou la notification d'un événement et par le noyau pour notifier des applications de certains événements. Les objets contiennent un compteur entier non signé sur 64 bits (I<uint64_t>) qui est maintenu par le noyau. Ce compteur est initialisé à la valeur spécifiée par le paramètre I<initval>.

note: type: Plain text
en: The following values may be bitwise ORed in I<flags> to change the behavior of B<eventfd>():
fr: Les valeurs suivantes peuvent être incluses (avec un OU logique) dans I<flags> pour changer le comportement de B<eventfd>() :

note: type: TP
en: B<EFD_CLOEXEC> (since Linux 2.6.27)
fr: B<EFD_CLOEXEC> (depuis Linux 2.6.27)

note: type: Plain text
en: Set the close-on-exec (B<FD_CLOEXEC>)  flag on the new file descriptor.  See the description of the B<O_CLOEXEC> flag in B<open>(2)  for reasons why this may be useful.
fr: Placer l'attribut « close-on-exec » (B<FD_CLOEXEC>) sur le nouveau descripteur de fichier. Consultez la description de l'attribut B<O_CLOEXEC> dans B<open>(2) pour savoir pourquoi cela peut être utile.

note: type: TP
en: B<EFD_NONBLOCK> (since Linux 2.6.27)
fr: B<EFD_NONBLOCK> (depuis Linux 2.6.27)

note: type: TP
en: B<EFD_SEMAPHORE> (since Linux 2.6.30)
fr: B<EFD_SEMAPHORE> (depuis Linux 2.6.30)

note: type: Plain text
en: Provide semaphore-like semantics for reads from the new file descriptor.  See below.
fr: Fournir une sémantique similaire aux sémaphores pour les lectures sur le nouveau descripteur de fichier. Voir ci-dessous.

note: type: Plain text
en: In Linux up to version 2.6.26, the I<flags> argument is unused, and must be specified as zero.
fr: Dans les versions de Linux jusqu'à la version 2.6.26, le paramètre I<flags> n'est pas utilisé et doit valoir zéro.

note: type: Plain text
en: The value returned by B<read>(2)  is in host byte order\(emthat is, the native byte order for integers on the host machine.
fr: La valeur renvoyée par B<read>(2) utilise l'ordre des octets de l'hôte, c'est-à-dire l'ordre des octets natif pour les entiers sur la machine hôte.

note: type: Plain text
en: The semantics of B<read>(2)  depend on whether the eventfd counter currently has a nonzero value and whether the B<EFD_SEMAPHORE> flag was specified when creating the eventfd file descriptor:
fr: La sémantique de B<read>(2) dépend du fait que le compteur eventfd a actuellement une valeur non nulle, et que l'attribut B<EFD_SEMAPHORE> était spécifié lors de la création du descripteur de fichier eventfd :

note: type: Plain text
en: If B<EFD_SEMAPHORE> was not specified and the eventfd counter has a nonzero value, then a B<read>(2)  returns 8 bytes containing that value, and the counter's value is reset to zero.
fr: Si B<EFD_SEMAPHORE> n'était pas spécifié et si le compteur eventfd a une valeur non nulle, un B<read>(2) renverra 8 octets contenant cette valeur, et la valeur du compteur sera remise à zéro.

note: type: Plain text
en: If B<EFD_SEMAPHORE> was specified and the eventfd counter has a nonzero value, then a B<read>(2)  returns 8 bytes containing the value 1, and the counter's value is decremented by 1.
fr: Si B<EFD_SEMAPHORE> était spécifié et si le compteur eventfd a une valeur non nulle, un B<read>(2) renverra 8 octets contenant la valeur 1, et la valeur du compteur sera décrémentée de 1.

note: type: Plain text
en: If the eventfd counter is zero at the time of the call to B<read>(2), then the call either blocks until the counter becomes nonzero (at which time, the B<read>(2)  proceeds as described above)  or fails with the error B<EAGAIN> if the file descriptor has been made nonblocking.
fr: Si le compteur eventfd est nul au moment de l'appel à B<read>(2), l'appel bloquera jusqu'à ce que le compteur devienne non nul (auquel cas l'appel à B<read>(2) sera traité comme décrit ci-dessus), ou échouera avec l'erreur B<EAGAIN> si le descripteur de fichier est en mode non bloquant.

note: type: Plain text
en: A B<write>(2)  call adds the 8-byte integer value supplied in its buffer to the counter.  The maximum value that may be stored in the counter is the largest unsigned 64-bit value minus 1 (i.e., 0xfffffffffffffffe).  If the addition would cause the counter's value to exceed the maximum, then the B<write>(2)  either blocks until a B<read>(2)  is performed on the file descriptor, or fails with the error B<EAGAIN> if the file descriptor has been made nonblocking.
fr: Un appel à B<write>(2) ajoute au compteur la valeur de l'entier sur 8 octets fourni dans le tampon. La valeur maximale qui peut être stockée dans le compteur est le plus grand entier non signé sur 64 bits moins 1 (c'est-à-dire 0xfffffffffffffffe). Si l'addition résulte en un compteur qui dépasserait la valeur maximale, le B<write>(2) bloquera jusqu'à ce qu'un B<read>(2) soit effectué sur le descripteur de fichier, ou échouera avec l'erreur B<EAGAIN> si le descripteur de fichier est en mode non bloquant.

note: type: TP
en: B<poll>(2), B<select>(2) (and similar)
fr: B<poll>(2), B<select>(2) (et similaire)

note: type: Plain text
en: The returned file descriptor supports B<poll>(2)  (and analogously B<epoll>(7))  and B<select>(2), as follows:
fr: Le descripteur de fichier prend en charge les B<poll>(2) (et de façon analogue B<epoll>(7)) et B<select>(2) de la façon suivante :

note: type: Plain text
en: The file descriptor is readable (the B<select>(2)  I<readfds> argument; the B<poll>(2)  B<POLLIN> flag)  if the counter has a value greater than 0.
fr: Le descripteur de fichier est lisible (le paramètre I<readfds> de B<select>(2) ; l'attribut B<POLLIN> de B<poll>(2)) si le compteur a une valeur supérieure à 0.

note: type: Plain text
en: The file descriptor is writable (the B<select>(2)  I<writefds> argument; the B<poll>(2)  B<POLLOUT> flag)  if it is possible to write a value of at least "1" without blocking.
fr: Le descripteur de fichier est disponible en écriture (le paramètre I<writefds> de B<select>(2) ; l'attribut B<POLLOUT> de B<poll>(2)) s'il est possible d'écrire une valeur d'au moins « 1 » sans bloquer.

note: type: Plain text
en: If an overflow of the counter value was detected, then B<select>(2)  indicates the file descriptor as being both readable and writable, and B<poll>(2)  returns a B<POLLERR> event.  As noted above, B<write>(2)  can never overflow the counter.  However an overflow can occur if 2^64 eventfd "signal posts" were performed by the KAIO subsystem (theoretically possible, but practically unlikely).  If an overflow has occurred, then B<read>(2)  will return that maximum I<uint64_t> value (i.e., 0xffffffffffffffff).
fr: Si un dépassement de la valeur du compteur a été détectée, B<select>(2) indique que le descripteur de fichier est disponible en lecture et en écriture et B<poll>(2) renvoie un événement B<POLLERR>. Comme indiquée ci-dessus, un B<write>(2) ne peut jamais produire de dépassement. Cependant, un dépassement peut se produire si un « signal post » eventfd de 2^64 a été effectué par le sous-système KAIO (théoriquement possible, mais très peut probable en pratique). Si un dépassement survient, un B<read>(2) renverra la valeur maximale d'un I<uint64_t> (c'est-à-dire 0xffffffffffffffff).

note: type: Plain text
en: The eventfd file descriptor also supports the other file-descriptor multiplexing APIs: B<pselect>(2)  and B<ppoll>(2).
fr: Le descripteur de fichier eventfd prend également en charge les autres interfaces de multiplexage de descripteurs de fichier : B<pselect>(2) et B<ppoll>(2).

note: type: Plain text
en: When the file descriptor is no longer required it should be closed.  When all file descriptors associated with the same eventfd object have been closed, the resources for object are freed by the kernel.
fr: Quand le descripteur de fichier n'est plus nécessaire il doit être fermé. Quand tous les descripteurs de fichier associés au même objet eventfd ont été fermés, les ressources pour cet objet sont libérées par le noyau.

note: type: Plain text
en: A copy of the file descriptor created by B<eventfd>()  is inherited by the child produced by B<fork>(2).  The duplicate file descriptor is associated with the same eventfd object.  File descriptors created by B<eventfd>()  are preserved across B<execve>(2), unless the close-on-exec flag has been set.
fr: Une copie d'un descripteur de fichier créé par B<eventfd>() est héritée par le fils produit par B<fork>(2). Le duplicata du descripteur de fichier est associé au même objet eventfd. Les descripteurs de fichier créés par B<eventfd>() sont préservés au travers des exécutions par B<execve>(2), sauf si l'attribut «\ close\(hyon\(hyexec\ » est positionné.

note: type: SH
en: RETURN VALUE
fr: VALEUR DE RETOUR

note: type: Plain text
en: On success, B<eventfd>()  returns a new eventfd file descriptor.  On error, -1 is returned and I<errno> is set to indicate the error.
fr: S'il réussit, B<eventfd>() renvoie un nouveau descripteur de fichier eventfd. En cas d'erreur, il renvoie -1 et remplit I<errno> avec la valeur d'erreur.

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: An unsupported value was specified in I<flags>.
fr: Une valeur non prise en compte a été spécifiée dans I<flags>.

note: type: Plain text
en: The system-wide limit on the total number of open files has been reached.
fr: La limite du nombre total de fichiers ouverts sur le système a été atteinte.

note: Note from Davide: The ENODEV error is basically never going to happen if the kernel boots correctly. That error happen only if during the kernel initialization, some error occur in the anonymous inode source initialization. type: Plain text
en: Could not mount (internal) anonymous inode device.
fr: Impossible de monter (en interne) le périphérique anonyme d'inœud.

note: type: Plain text
en: There was insufficient memory to create a new eventfd file descriptor.
fr: Il n'y a pas assez de mémoire pour que le noyau crée le nouveau descripteur de fichier eventfd.

note: eventfd() is in glibc 2.7, but reportedly does not build type: Plain text
en: B<eventfd>()  is available on Linux since kernel 2.6.22.  Working support is provided in glibc since version 2.8.  The B<eventfd2>()  system call (see NOTES) is available on Linux since kernel 2.6.27.  Since version 2.9, the glibc B<eventfd>()  wrapper will employ the B<eventfd2>()  system call, if it is supported by the kernel.
fr: B<eventfd>() est disponible sous Linux depuis le noyau 2.6.22. Le support fonctionnel est fourni par la glibc depuis la version 2.8. L'appel système B<eventfd2>() (consultez les NOTES) est disponible sous Linux depuis le noyau 2.6.27. Depuis la version 2.9, la fonction enveloppe de la glibc pour B<eventfd>() utilise l'appel système B<eventfd2>() s'il est pris en charge par le noyau.

note: type: SH
en: ATTRIBUTES
fr: ATTRIBUTS

note: type: tbl table
en: Value
fr: Valeur

note: type: SH
en: CONFORMING TO
fr: CONFORMITÉ

note: type: Plain text
en: B<eventfd>()  and B<eventfd2>()  are Linux-specific.
fr: B<eventfd>() et B<eventfd2>() sont spécifiques à Linux.

note: type: Plain text
en: Applications can use an eventfd file descriptor instead of a pipe (see B<pipe>(2))  in all cases where a pipe is used simply to signal events.  The kernel overhead of an eventfd file descriptor is much lower than that of a pipe, and only one file descriptor is required (versus the two required for a pipe).
fr: Les applications peuvent utiliser un descripteur de fichier eventfd à la place d'un tube (consultez B<pipe>(2)) à chaque fois qu'un tube est utilisé pour signaler des événements. La surcharge du noyau pour un descripteur de fichier est bien plus faible que pour un tube. De plus un seul descripteur de fichier est nécessaire (alors que deux sont nécessaires pour un tube).

note: or eventually syslets/threadlets type: Plain text
en: When used in the kernel, an eventfd file descriptor can provide a bridge from kernel to user space, allowing, for example, functionalities like KAIO (kernel AIO)  to signal to a file descriptor that some operation is complete.
fr: Quand un descripteur de fichier eventfd est utilisé par le noyau, il peut fournir un pont entre l'espace utilisateur et l'espace noyau. Par exemple, les fonctionnalités comme KAIO (« kernel AIO ») pour signaler dans un descripteur de fichier que certaines opérations sont finies.

note: type: Plain text
en: A key point about an eventfd file descriptor is that it can be monitored just like any other file descriptor using B<select>(2), B<poll>(2), or B<epoll>(7).  This means that an application can simultaneously monitor the readiness of "traditional" files and the readiness of other kernel mechanisms that support the eventfd interface.  (Without the B<eventfd>()  interface, these mechanisms could not be multiplexed via B<select>(2), B<poll>(2), or B<epoll>(7).)
fr: Un aspect important d'un descripteur de fichier eventfd est qu'il peut être surveillé comme n'importe quel descripteur de fichier avec B<select>(2), B<poll>(2) ou B<epoll>(7). Ceci signifie qu'une application peut surveiller simultanément la disponibilité de fichiers « traditionnels » et la disponibilité de mécanismes noyau qui gèrent une interface eventfd. (Sans l'interface B<eventfd>(), ces mécanismes ne pouvaient pas être multiplexés avec B<select>(2), B<poll>(2) ou B<epoll>(7))

note: type: Plain text
en: There are two underlying Linux system calls: B<eventfd>()  and the more recent B<eventfd2>().  The former system call does not implement a I<flags> argument.  The latter system call implements the I<flags> values described above.  The glibc wrapper function will use B<eventfd2>()  where it is available.
fr: Il y a deux appels système sous-jacent : B<eventfd>() et B<eventfd2>(), plus récent. Le premier appel système n'implémente pas le paramètre I<flags>. Le dernier appel système implémente les valeurs de I<flags> décrite ci-dessus. La fonction enveloppe de la glibc utilisera B<eventfd2>() quand il est présent.

note: type: SS
en: Additional glibc features
fr: Fonctionnalités supplémentaires de la glibc

note: type: Plain text
en: The GNU C library defines an additional type, and two functions that attempt to abstract some of the details of reading and writing on an eventfd file descriptor:
fr: La bibliothèque C de GNU définie un type supplémentaire et deux fonctions qui tentent d'abstraire certains détails pour la lecture ou l'écriture avec des descripteurs de fichier eventfd :

note: type: Plain text
en: The functions perform the read and write operations on an eventfd file descriptor, returning 0 if the correct number of bytes was transferred, or -1 otherwise.
fr: Les fonctions effectuent des actions de lecture ou écriture sur le descripteur de fichier eventfd, en renvoyant 0 si un nombre correct d'octets a été transféré, ou -1 sinon.

note: type: SH
en: EXAMPLE
fr: EXEMPLE

note: type: Plain text
en: The following program creates an eventfd file descriptor and then forks to create a child process.  While the parent briefly sleeps, the child writes each of the integers supplied in the program's command-line arguments to the eventfd file descriptor.  When the parent has finished sleeping, it reads from the eventfd file descriptor.
fr: Le programme suivant crée un descripteur de fichier eventfd puis crée un processus fils. Alors que le père commence par s'endormir, le fils écrit tous les entiers fournis sur la ligne de commande au descripteur de fichier eventfd. Quand le père se réveille, il lit dans le descripteur de fichier eventfd.

note: type: Plain text
en: The following shell session shows a sample run of the program:
fr: La session shell suivante montre un exemple d'exécution du programme :

note: type: SS
en: Program source
fr: Source du programme

note: type: Plain text
en: #include E<lt>sys/eventfd.hE<gt>
    #include E<lt>unistd.hE<gt>
    #include E<lt>stdlib.hE<gt>
    #include E<lt>stdio.hE<gt>
    #include E<lt>stdint.hE<gt>             /* Definition of uint64_t */
fr: #include E<lt>sys/eventfd.hE<gt>
    #include E<lt>unistd.hE<gt>
    #include E<lt>stdlib.hE<gt>
    #include E<lt>stdio.hE<gt>
    #include E<lt>stdint.hE<gt>             /* Definition de uint64_t */

note: type: SH
en: SEE ALSO
fr: VOIR AUSSI

note: type: Plain text
en: This page is part of release 5.03 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
fr: Cette page fait partie de la publication 5.03 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man-pages/.

note: type: Plain text
en: This page is part of release 5.02 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
fr: Cette page fait partie de la publication 5.02 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man-pages/.

note: type: Plain text
en: This page is part of release 5.01 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
fr: Cette page fait partie de la publication 5.01 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man-pages/.
