perkamon - en to fr translation catalogue (63 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: timerfd_create, timerfd_settime, timerfd_gettime - timers that notify via file descriptors
fr: timerfd_create, timerfd_settime, timerfd_gettime - Minuteries qui informent par l'intermédiaire de descripteurs de fichier

note: type: Plain text
en: These system calls create and operate on a timer that delivers timer expiration notifications via a file descriptor.  They provide an alternative to the use of B<setitimer>(2)  or B<timer_create>(2), with the advantage that the file descriptor may be monitored by B<select>(2), B<poll>(2), and B<epoll>(7).
fr: Ces appels système créent et opèrent sur une minuterie qui fournit des notifications d'expiration par un descripteur de fichier. Ils fournissent une alternative à B<setitimer>(2) ou B<timer_create>(2) avec l'avantage que le descripteur de fichier peut être surveillé avec B<select>(2), B<poll>(2) ou B<epoll>(7).

note: type: Plain text
en: The use of these three system calls is analogous to the use of B<timer_create>(2), B<timer_settime>(2), and B<timer_gettime>(2).  (There is no analog of B<timer_getoverrun>(2), since that functionality is provided by B<read>(2), as described below.)
fr: L'utilisation de ces trois appels système est analogue à l'utilisation de B<timer_create>(2), B<timer_settime>(2) et B<timer_gettime>(2). (Il n'y a pas d'équivalent à B<timer_getoverrun>(2) puisque cette fonctionnalité est fournie par B<read>(2), comme décrit ci-dessous)

note: type: Plain text
en: A settable system-wide real-time clock.
fr: Une horloge temps réel configurable à l'échelle du système.

note: type: Plain text
en: A nonsettable monotonically increasing clock that measures time from some unspecified point in the past that does not change after system startup.
fr: Une horloge non configurable, toujours croissante qui mesure le temps depuis un instant non spécifié dans le passé et qui ne change pas après le démarrage du système.

note: type: Plain text
en: Starting with Linux 2.6.27, the following values may be bitwise ORed in I<flags> to change the behavior of B<timerfd_create>():
fr: À partir de Linux 2.6.27, les valeurs suivantes peuvent être incluses avec un OU binaire dans I<flags> pour changer le comportement de B<timerfd_create>() :

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: Plain text
en: In Linux versions up to and including 2.6.26, I<flags> must be specified as zero.
fr: Dans les versions de Linux jusqu'à la version 2.6.26 incluse, I<flags> doit être nul.

note: type: Plain text
en: B<timerfd_settime>()  arms (starts) or disarms (stops)  the timer referred to by the file descriptor I<fd>.
fr: B<timerfd_settime>() arme (démarre) ou désarme (stoppe) la minuterie à laquelle se réfère le descripteur de fichier I<fd>.

note: type: Plain text
en: struct timespec {
        time_t tv_sec;                /* Seconds */
        long   tv_nsec;               /* Nanoseconds */
    };
fr: struct timespec {
        time_t tv_sec;                /* Secondes */
        long   tv_nsec;               /* Nanosecondes */
    };

note: type: Plain text
en: struct itimerspec {
        struct timespec it_interval;  /* Interval for periodic timer */
        struct timespec it_value;     /* Initial expiration */
    };
fr: struct itimerspec {
        struct timespec it_interval;  /* Intervalle pour les
                                         minuteries périodiques */
        struct timespec it_value;     /* Expiration initiale */
    };

note: type: Plain text
en: I<new_value.it_value> specifies the initial expiration of the timer, in seconds and nanoseconds.  Setting either field of I<new_value.it_value> to a nonzero value arms the timer.  Setting both fields of I<new_value.it_value> to zero disarms the timer.
fr: I<new_value.it_value> spécifie l'expiration initiale de la minuterie, en secondes et nanosecondes. Une valeur non nulle dans un des champs de I<new_value.it_value> arme la minuterie. La minuterie est désarmée si les deux champs de I<new_value.it_value> sont mis à zéro.

note: type: Plain text
en: Setting one or both fields of I<new_value.it_interval> to nonzero values specifies the period, in seconds and nanoseconds, for repeated timer expirations after the initial expiration.  If both fields of I<new_value.it_interval> are zero, the timer expires just once, at the time specified by I<new_value.it_value>.
fr: Une valeur non nulle dans un des champs de I<new_value.it_interval> configure la période, en secondes et nanosecondes, pour une expiration répétitive après l'expiration initiale. Si les deux champs de I<new_value.it_interval> sont nuls, la minuterie expirera qu'une seule fois, dont l'heure est spécifiée dans I<new_value.it_value>.

note: type: Plain text
en: If the I<old_value> argument is not NULL, then the I<itimerspec> structure that it points to is used to return the setting of the timer that was current at the time of the call; see the description of B<timerfd_gettime>()  following.
fr: Si le paramètre I<old_value> n'est pas égal à NULL. la structure I<itimerspec> vers laquelle il pointe est utilisée pour renvoyer la configuration de la minuterie au moment de l'appel ; consultez la description de B<timerfd_gettime>() ci-dessous.

note: type: Plain text
en: B<timerfd_gettime>()  returns, in I<curr_value>, an I<itimerspec> structure that contains the current setting of the timer referred to by the file descriptor I<fd>.
fr: B<timerfd_gettime>() renvoie, dans I<curr_value>, une structure I<itimerspec> qui contient les paramètres actuels de la minuterie auquel le descripteur de fichier I<fd> fait référence.

note: type: Plain text
en: The I<it_value> field returns the amount of time until the timer will next expire.  If both fields of this structure are zero, then the timer is currently disarmed.  This field always contains a relative value, regardless of whether the B<TFD_TIMER_ABSTIME> flag was specified when setting the timer.
fr: Le champ I<it_value> renvoie la durée jusqu'à la prochaine expiration. Si les deux champs de cette structure sont nuls, alors la minuterie est actuellement désactivée. Ce champ contient toujours une valeur relative, sans tenir compte d'un attribut B<TFD_TIMER_ABSTIME> qui aurait été spécifié quand la minuterie a été configurée.

note: type: Plain text
en: The I<it_interval> field returns the interval of the timer.  If both fields of this structure are zero, then the timer is set to expire just once, at the time specified by I<curr_value.it_value>.
fr: Le champ I<it_interval> renvoie la période de la minuterie. Si les deux champs de cette structure sont nuls, alors la minuteries est configurée pour n'expirer qu'une seule fois, à l'heure spécifiée par I<curr_value.it_value>.

note: type: SS
en: Operating on a timer file descriptor
fr: Opérations sur un descripteur de fichier de minuterie

note: type: Plain text
en: The file descriptor returned by B<timerfd_create>()  supports the following operations:
fr: Le descripteur de fichier renvoyé par B<timerfd_create>() gère les opérations suivante :

note: type: Plain text
en: If the timer has already expired one or more times since its settings were last modified using B<timerfd_settime>(), or since the last successful B<read>(2), then the buffer given to B<read>(2)  returns an unsigned 8-byte integer (I<uint64_t>)  containing the number of expirations that have occurred.  (The returned value is in host byte order\(emthat is, the native byte order for integers on the host machine.)
fr: Si la minuterie a déjà expirée une fois ou plus depuis que sa configuration a été modifiée la dernière fois à l'aide de B<timerfd_settime>() ou depuis la dernière lecture avec B<read>(2) qui a réussi, alors le tampon fourni à B<read>(2) renvoie un entier non signé sur 8 octets (I<uint64_t>) qui contient le nombre d'expirations qui se sont produites. (La valeur renvoyée 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: If no timer expirations have occurred at the time of the B<read>(2), then the call either blocks until the next timer expiration, or fails with the error B<EAGAIN> if the file descriptor has been made nonblocking (via the use of the B<fcntl>(2)  B<F_SETFL> operation to set the B<O_NONBLOCK> flag).
fr: Si aucune expiration ne s'est produite au moment de l'appel à B<read>(2), l'appel bloquera jusqu'à la prochaine expiration ou échouera avec l'erreur B<EAGAIN> si le descripteur de fichier est en mode non bloquant (l'opération B<fcntl>(2) B<F_SETFL> a été utilisée avec un attribut B<O_NONBLOCK>).

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 file descriptor is readable (the B<select>(2)  I<readfds> argument; the B<poll>(2)  B<POLLIN> flag)  if one or more timer expirations have occurred.
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 une expiration (ou plus) de la minuterie s'est produite.

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

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 timer object have been closed, the timer is disarmed and its resources 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 minuterie ont été fermés, les ressources pour cet objet sont libérées par le noyau.

note: type: SS
en: fork(2) semantics
fr: Sémantique de fork(2)

note: type: Plain text
en: After a B<fork>(2), the child inherits a copy of the file descriptor created by B<timerfd_create>().  The file descriptor refers to the same underlying timer object as the corresponding file descriptor in the parent, and B<read>(2)s in the child will return information about expirations of the timer.
fr: Après un B<fork>(2), le fils hérite d'une copie du descripteur de fichier créé par B<timerfd_create>(). Le descripteur de fichier se réfère à la même minuterie sous-jacente que le descripteur de fichier correspondant du père, et un B<read>(2) du fils renverra les informations sur la minuterie.

note: type: SS
en: execve(2) semantics
fr: Sémantique de execve(2)

note: type: Plain text
en: A file descriptor created by B<timerfd_create>()  is preserved across B<execve>(2), and continues to generate timer expirations if the timer was armed.
fr: Un descripteur de fichier créé par B<timerfd_create>() est conservé au travers d'un B<execve>(2), et continue à générer des expirations de minuterie si la minuterie a été armée.

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

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

note: type: Plain text
en: B<timerfd_settime>()  and B<timerfd_gettime>()  return 0 on success; on error they return -1, and set I<errno> to indicate the error.
fr: En cas de réussite, B<timerfd_settime>() et B<timerfd_gettime>() renvoient 0. Sinon ils renvoient -1 et B<errno> contient le code d'erreur.

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: B<timerfd_create>()  can fail with the following errors:
fr: B<timerfd_create>() peut échouer avec les erreurs suivantes :

note: type: Plain text
en: The I<clockid> argument is neither B<CLOCK_MONOTONIC> nor B<CLOCK_REALTIME>;
fr: Le paramètre I<clockid> n'est ni B<CLOCK_MONOTONIC> ni B<CLOCK_REALTIME>;

note: type: Plain text
en: I<flags> is invalid; or, in Linux 2.6.26 or earlier, I<flags> is nonzero.
fr: I<flags> n'est pas correct ; ou, pour les versions de Linux 2.6.26 ou ultérieures, I<flags> n'est pas nul.

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: 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 kernel memory to create the timer.
fr: Pas assez de mémoire noyau pour créer la minuterie.

note: type: Plain text
en: B<timerfd_settime>()  and B<timerfd_gettime>()  can fail with the following errors:
fr: B<timerfd_settime>() et B<timerfd_gettime>() peuvent échouer avec les erreurs suivantes :

note: type: Plain text
en: I<fd> is not a valid file descriptor.
fr: I<fd> n'est pas un descripteur de fichier valable.

note: type: Plain text
en: I<new_value>, I<old_value>, or I<curr_value> is not valid a pointer.
fr: I<new_value>, I<old_value> ou I<curr_value> n'est pas un pointeur valable.

note: type: Plain text
en: I<fd> is not a valid timerfd file descriptor.
fr: I<fd> n'est pas un descripteur de fichier de minuterie valable.

note: type: Plain text
en: B<timerfd_settime>()  can also fail with the following errors:
fr: B<timerfd_settime>() peut aussi échouer avec les erreurs suivantes :

note: type: Plain text
en: I<new_value> is not properly initialized (one of the I<tv_nsec> falls outside the range zero to 999,999,999).
fr: I<new_value> n'est pas initialisé correctement (un des champs I<tv_nsec> est en dehors de l'intervalle allant de 0 à 999 999 999).

note: This case only checked since 2.6.29, and 2.2.2[78].some-stable-version. In older kernel versions, no check was made for invalid flags. type: Plain text
en: I<flags> is invalid.
fr: I<flags> n'est pas correct.

note: type: Plain text
en: These system calls are available on Linux since kernel 2.6.25.  Library support is provided by glibc since version 2.8.
fr: Ces appels système sont disponibles sous Linux depuis le noyau 2.6.25. La glibc les gère depuis la version 2.8.

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

note: type: Plain text
en: These system calls are Linux-specific.
fr: Ces appels système sont spécifiques à Linux.

note: type: SH
en: BUGS
fr: BOGUES

note: 2.6.29 type: Plain text
en: Currently, B<timerfd_create>()  supports fewer types of clock IDs than B<timer_create>(2).
fr: Actuellement, B<timerfd_create>() prend en charge moins de type d'identifiants d'horloges que B<timer_create>(2).

note: type: SH
en: EXAMPLE
fr: EXEMPLE

note: type: Plain text
en: The following program creates a timer and then monitors its progress.  The program accepts up to three command-line arguments.  The first argument specifies the number of seconds for the initial expiration of the timer.  The second argument specifies the interval for the timer, in seconds.  The third argument specifies the number of times the program should allow the timer to expire before terminating.  The second and third command-line arguments are optional.
fr: Le programme suivant crée une minuterie puis surveille sa progression. Le programme accepte jusqu'à trois paramètres en ligne de commande. Le premier paramètre spécifie le nombre de secondes pour l'expiration initiale de la minuterie. Le deuxième paramètre spécifie la période de la minuterie, en secondes. Le troisième paramètre spécifie le nombre de fois que le programme doit permettre à la minuterie d'expirer avant de quitter. Le deuxième et le troisième paramètre sont optionnels.

note: type: Plain text
en: The following shell session demonstrates the use of the program:
fr: La session interactive suivante montre l'utilisation de ce programme\ :

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

note: The commented out code here is what we currently need until the required stuff is in glibc /* Link with -lrt */ #define _GNU_SOURCE #include <sys/syscall.h> #include <unistd.h> #include <time.h> #if defined(__i386__) #define __NR_timerfd_create 322 #define __NR_timerfd_settime 325 #define __NR_timer
en: #include E<lt>sys/timerfd.hE<gt>
    #include E<lt>time.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/timerfd.hE<gt>
    #include E<lt>time.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>        /* Définition 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/.
