perkamon - en to fr translation catalogue (53 entries)

note: type: TH
en: 2019-08-02
fr: 2 août 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: poll, ppoll - wait for some event on a file descriptor
fr: poll, ppoll - Attendre un événement concernant un descripteur de fichier

note: type: Plain text
en: B<#define _GNU_SOURCE>         /* See feature_test_macros(7) */
    B<#include E<lt>signal.hE<gt>>
    B<#include E<lt>poll.hE<gt>>
fr: B<#define _GNU_SOURCE>         /* Consultez feature_test_macros(7) */
    B<#include E<lt>signal.hE<gt>>
    B<#include E<lt>poll.hE<gt>>

note: type: Plain text
en: B<poll>()  performs a similar task to B<select>(2): it waits for one of a set of file descriptors to become ready to perform I/O.
fr: B<poll>() est une variation sur le thème de B<select>(2)\ : il attend que l'un des descripteurs de fichier soit prêt pour des entrées et sorties.

note: type: Plain text
en: The set of file descriptors to be monitored is specified in the I<fds> argument, which is an array of structures of the following form:
fr: L'ensemble de descripteurs de fichier à surveiller est indiqué dans l'argument I<fds>, qui est un tableau de structures de la forme suivante\ :

note: type: Plain text
en: struct pollfd {
        int   fd;         /* file descriptor */
        short events;     /* requested events */
        short revents;    /* returned events */
    };
fr: struct pollfd {
        int   fd;         /* Descripteur de fichier */
        short events;     /* Événements attendus    */
        short revents;    /* Événements détectés    */
    };

note: type: Plain text
en: The caller should specify the number of items in the I<fds> array in I<nfds>.
fr: L'appelant doit spécifier le nombre d'élément du tableau I<fds> dans I<nfds>.

note: type: Plain text
en: The field I<fd> contains a file descriptor for an open file.  If this field is negative, then the corresponding I<events> field is ignored and the I<revents> field returns zero.  (This provides an easy way of ignoring a file descriptor for a single B<poll>()  call: simply negate the I<fd> field.  Note, however, that this technique can't be used to ignore file descriptor 0.)
fr: Le champ I<fd> contient un descripteur de fichier pour un fichier ouvert. Si ce champ est négatif, alors le champ I<events> correspondant est ignoré et le champ I<revents> renvoie zéro (cela permet d'ignorer facilement un descripteur de fichier pour un seul appel B<poll>() : il suffit d'utiliser l'opposé du champ I<fd> ; remarquez cependant que cette technique ne peut pas être utilisée pour ignorer le descripteur de fichier 0).

note: type: Plain text
en: The field I<events> is an input parameter, a bit mask specifying the events the application is interested in for the file descriptor I<fd>.  This field may be specified as zero, in which case the only events that can be returned in I<revents> are B<POLLHUP>, B<POLLERR>, and B<POLLNVAL> (see below).
fr: Le champ I<events> est un paramètre d'entrée, un masque de bits indiquant les événements qui intéressent l'application pour le descripteur de fichier I<fd>. Ce champ peut être nul, auquel cas les seuls événements qui peuvent être renvoyés dans I<revents> sont B<POLLHUP>, B<POLLERR> et B<POLLNVAL> (voir ci-dessous).

note: type: Plain text
en: The field I<revents> is an output parameter, filled by the kernel with the events that actually occurred.  The bits returned in I<revents> can include any of those specified in I<events>, or one of the values B<POLLERR>, B<POLLHUP>, or B<POLLNVAL>.  (These three bits are meaningless in the I<events> field, and will be set in the I<revents> field whenever the corresponding condition is true.)
fr: Le champ I<revents> est un paramètre de sortie, rempli par le noyau avec les événements qui se sont effectivement produits, d'un des types demandés par I<events>, ou de l'une des valeurs B<POLLERR>, B<POLLHUP> ou B<POLLNVAL>. (Ces trois bits n'ont pas de signification dans la demande I<events>, et se trouvent positionnés dans la valeur de retour I<revents> si l'une des conditions correspondantes se produit.)

note: type: Plain text
en: If none of the events requested (and no error) has occurred for any of the file descriptors, then B<poll>()  blocks until one of the events occurs.
fr: Si aucun événement attendu (ni aucune erreur) ne s'est déjà produit, B<poll>() bloque jusqu'à ce que l'un des événements se produise.

note: type: Plain text
en: The I<timeout> argument specifies the number of milliseconds that B<poll>()  should block waiting for a file descriptor to become ready.  The call will block until either:
fr: L'argument I<timeout> définit le temps en milliseconde pendant lequel B<poll>() devrait bloquer en attendant que le descripteur de fichier soit prêt. L’appel bloquera jusqu’au premier événement suivant :

note: type: Plain text
en: a file descriptor becomes ready;
fr: un descripteur de fichier devient prêt ;

note: type: Plain text
en: the call is interrupted by a signal handler; or
fr: l’appel est interrompu par un gestionnaire de signal ;

note: type: Plain text
en: the timeout expires.
fr: le délai expire.

note: type: Plain text
en: Note that the I<timeout> interval will be rounded up to the system clock granularity, and kernel scheduling delays mean that the blocking interval may overrun by a small amount.  Specifying a negative value in I<timeout> means an infinite timeout.  Specifying a I<timeout> of zero causes B<poll>()  to return immediately, even if no file descriptors are ready.
fr: Remarquez que l’intervalle I<timeout> sera arrondi à la granularité de l'horloge système et que les délais d'ordonnancement du noyau signifient que l'intervalle de blocage pourrait être dépassé d'une petite quantité. Une valeur négative de I<timeout> signifie un délai infini, alors qu'un I<timeout> nul force B<epoll>() à se terminer immédiatement, même si aucun descripteur de fichier n'est prêt.

note: type: Plain text
en: The bits that may be set/returned in I<events> and I<revents> are defined in I<E<lt>poll.hE<gt>>:
fr: Les bits qui peuvent être activés ou renvoyés dans I<events> et I<revents> sont définis par I<E<lt>poll.hE<gt>>\ :

note: type: Plain text
en: There is data to read.
fr: Il y a des données en attente de lecture.

note: type: TP
en: B<POLLRDHUP> (since Linux 2.6.17)
fr: B<POLLRDHUP> (depuis Linux 2.6.17)

note: type: Plain text
en: Stream socket peer closed connection, or shut down writing half of connection.  The B<_GNU_SOURCE> feature test macro must be defined (before including I<any> header files)  in order to obtain this definition.
fr: Le correspondant sur une socket en mode flux a fermé la connexion, ou bien a terminé la partie écriture de la connexion. La macro de test de fonctionnalité B<_GNU_SOURCE> doit être définie (avant d'inclure I<tout> fichier d'en\(hytête) pour obtenir cette définition.

note: type: Plain text
en: When compiling with B<_XOPEN_SOURCE> defined, one also has the following, which convey no further information beyond the bits listed above:
fr: Lorsque B<_XOPEN_SOURCE> est défini à la compilation, les macros suivantes sont également définies (mais n'apportent pas d'informations supplémentaires par rapport aux bits listés ci\(hydessus\ :

note: type: Plain text
en: Equivalent to B<POLLIN>.
fr: Équivalent à B<POLLIN>.

note: POLLRDBAND is used in the DECnet protocol. type: Plain text
en: Priority band data can be read (generally unused on Linux).
fr: Des données prioritaires sont en attente de lecture (généralement inutilisé sous Linux).

note: type: Plain text
en: Equivalent to B<POLLOUT>.
fr: Équivalent à B<POLLOUT>.

note: type: Plain text
en: Priority data may be written.
fr: Des données prioritaires peuvent être écrites.

note: type: Plain text
en: Linux also knows about, but does not use B<POLLMSG>.
fr: Linux connaît aussi B<POLLMSG>, mais ne l'utilise pas.

note: type: Plain text
en: The relationship between B<poll>()  and B<ppoll>()  is analogous to the relationship between B<select>(2)  and B<pselect>(2): like B<pselect>(2), B<ppoll>()  allows an application to safely wait until either a file descriptor becomes ready or until a signal is caught.
fr: La relation entre B<poll>() et B<ppoll>() est similaire à la relation entre B<select>(2) et B<pselect>(2)\ : de même que B<pselect>(2), B<ppoll>() permet à une application d'attendre de façon sûre que soit un descripteur de fichier soit prêt, soit un signal soit reçu.

note: type: Plain text
en: Other than the difference in the precision of the I<timeout> argument, the following B<ppoll>()  call:
fr: Mise à part la différence de précision de l'argument I<timeout>, l'appel B<ppoll>() suivant\ :

note: type: Plain text
en: See the description of B<pselect>(2)  for an explanation of why B<ppoll>()  is necessary.
fr: Consultez la description de B<pselect>(2) pour une explication de la nécessité de B<ppoll>().

note: type: Plain text
en: If the I<sigmask> argument is specified as NULL, then no signal mask manipulation is performed (and thus B<ppoll>()  differs from B<poll>()  only in the precision of the I<timeout> argument).
fr: Si le paramètre I<sigmask> est défini comme NULL, aucune manipulation de masque de signaux n'est effectuée (et ainsi B<ppoll>() ne diffère de B<poll>() que dans la précision du paramètre I<timeout>).

note: type: Plain text
en: struct timespec {
        long    tv_sec;         /* seconds */
        long    tv_nsec;        /* nanoseconds */
    };
fr: struct timespec {
        long    tv_sec;         /* secondes     */
        long    tv_nsec;        /* nanosecondes */
    };

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

note: type: Plain text
en: On success, a positive number is returned; this is the number of structures which have nonzero I<revents> fields (in other words, those descriptors with events or errors reported).  A value of 0 indicates that the call timed out and no file descriptors were ready.  On error, -1 is returned, and I<errno> is set appropriately.
fr: En cas de réussite, ces appels renvoient une valeur positive représentant le nombre de structures ayant un champ I<revents> non nul, c'est-à-dire le nombre de structures pour lesquels un événement attendu, ou une erreur, s'est produit. Une valeur de retour nulle indique un dépassement du délai d'attente. En cas d'échec, ils renvoient -1, et I<errno> contient le code d'erreur.

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: The array given as argument was not contained in the calling program's address space.
fr: La table fournie en argument n'est pas dans l'espace d'adressage du processus appelant.

note: type: Plain text
en: A signal occurred before any requested event; see B<signal>(7).
fr: Un signal a été reçu avant qu'un événement intéressant ne se produise ; voir B<signal>(7).

note: type: Plain text
en: The I<nfds> value exceeds the B<RLIMIT_NOFILE> value.
fr: La valeur I<nfds> dépasse la valeur B<RLIMIT_NOFILE>.

note: type: Plain text
en: There was no space to allocate file descriptor tables.
fr: Pas assez de mémoire pour allouer la table des descripteurs de fichier.

note: library call was introduced in libc 5.4.28 type: Plain text
en: The B<poll>()  system call was introduced in Linux 2.1.23.  On older kernels that lack this system call, the glibc (and the old Linux libc)  B<poll>()  wrapper function provides emulation using B<select>(2).
fr: L'appel système B<poll>() a été introduit dans Linux 2.1.23. Sur les anciens noyaux sans cet appel système, la fonction enveloppe B<poll>() de la glibc (et de l'ancienne libc Linux) fournit une émulation en utilisant B<select>(2).

note: type: Plain text
en: The B<ppoll>()  system call was added to Linux in kernel 2.6.16.  The B<ppoll>()  library call was added in glibc 2.4.
fr: L'appel système B<ppoll>() a été introduit dans Linux 2.6.16. La fonction de bibliothèque correspondante a été ajoutée dans la glibc 2.4.

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

note: type: Plain text
en: Some implementations define the nonstandard constant B<INFTIM> with the value -1 for use as a I<timeout> for B<poll>().  This constant is not provided in glibc.
fr: Certaines implémentations définissent la constante symbolique non standard B<INFTIM> de valeur -1, à utiliser comme I<timeout> pour B<poll>(). Cette constante n'est pas fournie par la glibc.

note: type: Plain text
en: For a discussion of what may happen if a file descriptor being monitored by B<poll>()  is closed in another thread, see B<select>(2).
fr: Consultez B<select>(2) pour une discussion sur ce qui pourrait arriver si un descripteur de fichier surveillé par B<poll>() est fermé dans un autre thread.

note: type: SH
en: BUGS
fr: BOGUES

note: type: Plain text
en: See the discussion of spurious readiness notifications under the BUGS section of B<select>(2).
fr: Consultez la discussion sur les notifications non voulues dans la section BOGUES de B<select>(2).

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: TH
en: 2019-03-06
fr: 6 mars 2019

note: type: Plain text
en: is equivalent to I<atomically> executing the following calls:
fr: est équivalent à exécuter de façon I<atomique> les appels suivants\ :

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/.
