perkamon - en to fr translation catalogue (53 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: timer_create - create a POSIX per-process timer
fr: timer_create - Créer une minuterie POSIX pour un processus

note: type: Plain text
en: Link with I<-lrt>.
fr: Effectuez l'édition des liens avec l'option I<-lrt>.

note: type: Plain text
en: Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):
fr: Exigences de macros de test de fonctionnalités pour la glibc (consultez B<feature_test_macros>(7)) :

note: type: Plain text
en: B<timer_create>(): _POSIX_C_SOURCE\ E<gt>=\ 199309L
fr: B<timer_create>()\ : _POSIX_C_SOURCE\ E<gt>=\ 199309L

note: type: Plain text
en: B<timer_create>()  creates a new per-process interval timer.  The ID of the new timer is returned in the buffer pointed to by I<timerid>, which must be a non-null pointer.  This ID is unique within the process, until the timer is deleted.  The new timer is initially disarmed.
fr: B<timer_create>() crée une nouvelle minuterie pour un processus. L'identifiant de cette nouvelle minuterie est renvoyé dans le tampon pointé par I<timerid>, qui doit être un pointeur différent de NULL. L'identifiant est unique pour le processus, jusqu'à ce que la minuterie soit détruite. La nouvelle minuterie est initialement désarmée.

note: type: Plain text
en: The I<clockid> argument specifies the clock that the new timer uses to measure time.  It can be specified as one of the following values:
fr: Le paramètre I<clockid> indique l'horloge que la nouvelle minuterie utilise pour mesurer le temps. Il peut prendre une des valeurs suivantes :

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: Note: the CLOCK_MONOTONIC_RAW clock added for clock_gettime() in 2.6.28 is not supported for POSIX timers -- mtk, Feb 2009 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: TP
en: B<CLOCK_PROCESS_CPUTIME_ID> (since Linux 2.6.12)
fr: B<CLOCK_PROCESS_CPUTIME_ID> (depuis Linux 2.6.12)

note: type: Plain text
en: A clock that measures (user and system) CPU time consumed by (all of the threads in) the calling process.
fr: Une horloge qui mesure le temps CPU (utilisateur et système) consommé par le processus appelant (et tous ses threads).

note: type: TP
en: B<CLOCK_THREAD_CPUTIME_ID> (since Linux 2.6.12)
fr: B<CLOCK_THREAD_CPUTIME_ID> (depuis Linux 2.6.12)

note: The CLOCK_MONOTONIC_RAW that was added in 2.6.28 can't be used to create a timer -- mtk, Feb 2009 type: Plain text
en: A clock that measures (user and system) CPU time consumed by the calling thread.
fr: Une horloge qui mesure le temps CPU (utilisateur et système) consommé par le processus appelant.

note: type: Plain text
en: As well as the above values, I<clockid> can be specified as the I<clockid> returned by a call to B<clock_getcpuclockid>(3)  or B<pthread_getcpuclockid>(3).
fr: Comme pour les valeurs ci-dessus, I<clockid> peut être l'identifiant I<clockid> renvoyé par un appel à B<clock_getcpuclockid>(3) ou B<pthread_getcpuclockid>(3).

note: type: Plain text
en: The I<sevp> argument points to a I<sigevent> structure that specifies how the caller should be notified when the timer expires.  For the definition and general details of this structure, see B<sigevent>(7).
fr: Le paramètre I<sevp> pointe vers une structure I<sigevent> qui indique comment l'appelant devrait être notifié quand la minuterie expire. Pour la définition et des détails généraux sur cette structure, consultez B<sigevent>(7).

note: type: Plain text
en: The I<sevp.sigev_notify> field can have the following values:
fr: Le champ I<sevp.sigev_notify> peut avoir les valeurs suivantes\ :

note: type: Plain text
en: Don't asynchronously notify when the timer expires.  Progress of the timer can be monitored using B<timer_gettime>(2).
fr: Ne pas notifier de façon asynchrone quand la minuterie expire. La progression de la minuterie peut être observée en utilisant B<timer_gettime>(2).

note: type: Plain text
en: Upon timer expiration, generate the signal I<sigev_signo> for the process.  See B<sigevent>(7)  for general details.  The I<si_code> field of the I<siginfo_t> structure will be set to B<SI_TIMER>.  At any point in time, at most one signal is queued to the process for a given timer; see B<timer_getoverrun>(2)  for more details.
fr: Lors de l'expiration de la minuterie, produire le signal I<sigev_signo> pour le processus. Consultez B<sigevent>(7) pour des détails généraux. Le champ I<si_code> de la structure I<siginfo_t> sera mis à B<SI_TIMER>. À tout moment, au plus un signal est mis en attente pour le processus pour une horloge donnée ; consultez B<timer_getoverrun>(2) pour plus de détails.

note: type: Plain text
en: Upon timer expiration, invoke I<sigev_notify_function> as if it were the start function of a new thread.  See B<sigevent>(7)  for details.
fr: Lors de l'expiration de la minuterie, appeler I<sigev_notify_function> comme si elle était la fonction de démarrage d'un nouveau thread. Consultez B<sigevent>(7) pour plus de détails.

note: type: TP
en: B<SIGEV_THREAD_ID> (Linux-specific)
fr: B<SIGEV_THREAD_ID> (spécifique à Linux)

note: type: Plain text
en: As for B<SIGEV_SIGNAL>, but the signal is targeted at the thread whose ID is given in I<sigev_notify_thread_id>, which must be a thread in the same process as the caller.  The I<sigev_notify_thread_id> field specifies a kernel thread ID, that is, the value returned by B<clone>(2)  or B<gettid>(2).  This flag is intended only for use by threading libraries.
fr: Comme B<SIGEV_SIGNAL>, mais le signal est envoyé au thread dont l'identifiant est fourni dans I<sigev_notify_thread_id>, qui doit être un thread du même processus que le thread appelant. Le champ I<sigev_notify_thread_id> indique un identifiant de thread noyau, c'est-à-dire la valeur renvoyée par B<clone>(2) ou B<gettid>(2). Ce drapeau n'est destiné à être utilisé que par la bibliothèque des threads.

note: type: Plain text
en: Specifying I<sevp> as NULL is equivalent to specifying a pointer to a I<sigevent> structure in which I<sigev_notify> is B<SIGEV_SIGNAL>, I<sigev_signo> is B<SIGALRM>, and I<sigev_value.sival_int> is the timer ID.
fr: Une valeur NULL pour I<sevp> équivaut à indiquer un pointeur vers une structure I<sigevent> dans laquelle I<sigev_notify> vaut B<SIGEV_SIGNAL>, I<sigev_signo> vaut B<SIGALRM> et I<sigev_value.sival_int> vaut l'identifiant de l'horloge.

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

note: type: Plain text
en: On success, B<timer_create>()  returns 0, and the ID of the new timer is placed in I<*timerid>.  On failure, -1 is returned, and I<errno> is set to indicate the error.
fr: S'il réussit, B<timer_create>() renvoie zéro et l'identifiant de la nouvelle minuterie est placé dans I<*timerid>. En cas d'erreur, il renvoie -1 et I<errno> contient le code d'erreur.

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: Temporary error during kernel allocation of timer structures.
fr: Erreur temporaire lors de l'allocation de la structure de la minuterie par le noyau.

note: type: Plain text
en: Clock ID, I<sigev_notify>, I<sigev_signo>, or I<sigev_notify_thread_id> is invalid.
fr: L'identifiant d'horloge, I<sigev_notify>, I<sigev_signo> ou I<sigev_notify_thread_id> n'est pas valable.

note: glibc layer: malloc() type: Plain text
en: Could not allocate memory.
fr: Impossible d'allouer de la mémoire.

note: type: Plain text
en: This system call is available since Linux 2.6.
fr: Cet appel système est disponible depuis Linux 2.6.

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

note: type: Plain text
en: A program may create multiple interval timers using B<timer_create>().
fr: Un programme peut créer plusieurs minuterie en utilisant B<timer_create>().

note: type: Plain text
en: Timers are not inherited by the child of a B<fork>(2), and are disarmed and deleted during an B<execve>(2).
fr: Les minuteries ne sont pas héritées par ses enfants lors d'un B<fork>(2) et sont désarmées et détruites lors d'un appel système B<execve>(2).

note: type: Plain text
en: The kernel preallocates a "queued real-time signal" for each timer created using B<timer_create>().  Consequently, the number of timers is limited by the B<RLIMIT_SIGPENDING> resource limit (see B<setrlimit>(2)).
fr: Le noyau alloue par avance un « signal temps réel en attente » pour chaque minuterie créée par B<timer_create>(). De ce fait, le nombre de minuteries est limité par la limite de ressources B<RLIMIT_SIGPENDING> (voir B<setrlimit>(2)).

note: type: Plain text
en: The timers created by B<timer_create>()  are commonly known as "POSIX (interval) timers".  The POSIX timers API consists of the following interfaces:
fr: Les minuteries créée par B<timer_create>() sont communément appelées « horloges (d'intervalle) POSIX ». L'API des minuteries POSIX est constituée des interfaces suivantes :

note: type: Plain text
en: B<timer_create>(): Create a timer.
fr: B<timer_create>() : Créer une minuterie.

note: type: Plain text
en: B<timer_settime>(2): Arm (start) or disarm (stop) a timer.
fr: B<timer_settime>(2) : Armer (démarrer) ou désarmer (stopper) une minuterie.

note: type: Plain text
en: B<timer_gettime>(2): Fetch the time remaining until the next expiration of a timer, along with the interval setting of the timer.
fr: B<timer_gettime>(2) : Récupérer le temps restant jusqu'à l'expiration suivante d'une minuterie, en plus de l'intervalle de la minuterie.

note: type: Plain text
en: B<timer_getoverrun>(2): Return the overrun count for the last timer expiration.
fr: B<timer_getoverrun>(2) : Renvoyer le décompte de dépassements pour la dernière expiration de la minuterie.

note: type: Plain text
en: B<timer_delete>(2): Disarm and delete a timer.
fr: B<timer_delete>(2) : Désarmer et détruire une minuterie.

note: type: Plain text
en: Since Linux 3.10, the I</proc/[pid]/timers> file can be used to list the POSIX timers for the process with PID I<pid>.  See B<proc>(5)  for further information.
fr: Depuis Linux 3.10, le fichier I</proc/[pid]/timers> peut être utilisé pour lister les minuteries POSIX du processus de PID I<pid>. Consultez B<proc>(5) pour plus de détails.

note: See nptl/sysdeps/unix/sysv/linux/timer_create.c type: Plain text
en: Part of the implementation of the POSIX timers API is provided by glibc.  In particular:
fr: Une partie de l'implémentation des minuteries POSIX est fournie par la glibc. En particulier :

note: See the glibc source file kernel-posix-timers.h for the structure that glibc uses to map user-space timer IDs to kernel timer IDs The kernel-level timer ID is exposed via siginfo.si_tid. type: Plain text
en: The timer IDs presented at user level are maintained by glibc, which maps these IDs to the timer IDs employed by the kernel.
fr: Les identifiants de minuteries fournis au niveau utilisateur sont maintenus par la glibc, qui fait la correspondance avec les identifiants utilisés par le noyau.

note: type: SH
en: EXAMPLE
fr: EXEMPLE

note: type: Plain text
en: The program below takes two arguments: a sleep period in seconds, and a timer frequency in nanoseconds.  The program establishes a handler for the signal it uses for the timer, blocks that signal, creates and arms a timer that expires with the given frequency, sleeps for the specified number of seconds, and then unblocks the timer signal.  Assuming that the timer expired at least once while the program slept, the signal handler will be invoked, and the handler displays some information about the timer notification.  The program terminates after one invocation of the signal handler.
fr: Le programme ci-dessous reçoit deux paramètres : une durée de sommeil, en seconde, et une fréquence de minuterie en nanosecondes. Le programme établit un gestionnaire pour le signal qu'il utilise avec la minuterie, puis il bloque le signal, crée et arme une minuterie qui expire à la fréquence donnée, s'endort pendant la durée indiquée et enfin débloque le signal de la minuterie. En supposant que la minuterie ait expiré au moins une fois pendant le sommeil du programme, le gestionnaire de signal sera appelé et le gestionnaire de signal affiche des informations concernant la notification de la minuterie. Le programme se termine après un appel au gestionnaire de signal.

note: type: Plain text
en: In the following example run, the program sleeps for 1 second, after creating a timer that has a frequency of 100 nanoseconds.  By the time the signal is unblocked and delivered, there have been around ten million overruns.
fr: Dans l'exemple d'exécution qui suit, le programme s'endort pour une seconde après avoir créé une minuterie de d'une fréquence de 100 nanosecondes. Le temps que le signal soit débloqué et fournit, il y a eu environ dix millions de dépassements.

note: type: Plain text
en: $ B<./a.out 1 100>
    Establishing handler for signal 34
    Blocking signal 34
    timer ID is 0x804c008
    Sleeping for 1 seconds
    Unblocking signal 34
    Caught signal 34
        sival_ptr = 0xbfb174f4;     *sival_ptr = 0x804c008
        overrun count = 10004886
fr: $ B<./a.out 1 10>
    Establishing handler for signal 34
    Blocking signal 34
    timer ID is 0x804c008
    Sleeping for 1 seconds
    Unblocking signal 34
    Caught signal 34
        sival_ptr = 0xbfb174f4;     *sival_ptr = 0x804c008
        overrun count = 10004886

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

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