perkamon - en to fr translation catalogue (46 entries)

note: type: TH
en: 2023-05-03
fr: 3 mai 2023

note: type: TH
en: Linux man-pages 6.05.01
fr: Pages du manuel de Linux 6.05.01

note: type: SH
en: NAME
fr: NOM

note: type: Plain text
en: getitimer, setitimer - get or set value of an interval timer
fr: getitimer, setitimer - Lire/écrire la valeur d'une temporisation

note: type: SH
en: LIBRARY
fr: BIBLIOTHÈQUE

note: type: Plain text
en: Standard C library (I<libc>, I<-lc>)
fr: Bibliothèque C standard (I<libc>, I<-lc>)

note: type: Plain text
en: These system calls provide access to interval timers, that is, timers that initially expire at some point in the future, and (optionally) at regular intervals after that.  When a timer expires, a signal is generated for the calling process, and the timer is reset to the specified interval (if the interval is nonzero).
fr: Ces appels système donnent accès à des temporisations d'intervalle, c'est-à-dire des temporisations qui expirent en premier à un moment du futur et (éventuellement) à des intervalles réguliers après lui. Lorsqu'une temporisation expire, un signal est envoyé au processus appelant et la temporisation est réinitialisée à l'intervalle spécifié (s'il n'est pas nul).

note: type: Plain text
en: Three types of timers\[em]specified via the I<which> argument\[em]are provided, each of which counts against a different clock and generates a different signal on timer expiration:
fr: Trois types de minuteries — indiquées par le paramètre I<which> — sont fournis, chacun comptant par rapport à une horloge différente et générant un signal différent à l'expiration de la minuterie :

note: type: Plain text
en: This timer counts down in real (i.e., wall clock) time.  At each expiration, a B<SIGALRM> signal is generated.
fr: Cette minuterie compte en temps réel (à savoir celui de la pendule murale). À chaque expiration, un signal B<SIGALRM> est généré.

note: type: Plain text
en: This timer counts down against the user-mode CPU time consumed by the process.  (The measurement includes CPU time consumed by all threads in the process.)  At each expiration, a B<SIGVTALRM> signal is generated.
fr: Cette minuterie compte par rapport au temps du processeur en mode utilisateur consommé par le processus (la mesure comprend le temps processeur consommé par tous les threads du processus). À chaque expiration, un signal B<SIGVTALRM> est généré.

note: type: Plain text
en: This timer counts down against the total (i.e., both user and system)  CPU time consumed by the process.  (The measurement includes CPU time consumed by all threads in the process.)  At each expiration, a B<SIGPROF> signal is generated.
fr: Cette minuterie compte par rapport au temps total de processeur (à savoir celui de l'utilisateur et du système) consommé par le processus (la mesure comprend le temps processeur consommé par tous les threads du processus). À chaque expiration, un signal B<SIGPROF> est généré.

note: type: Plain text
en: In conjunction with B<ITIMER_VIRTUAL>, this timer can be used to profile user and system CPU time consumed by the process.
fr: Conjuguée à B<ITIMER_VIRTUAL>, cette minuterie peut être utilisée pour tracer le temps processeur du système et de l'utilisateur consommé par le processus.

note: type: Plain text
en: A process has only one of each of the three types of timers.
fr: Un processus n'a qu'un des trois types de minuterie.

note: type: Plain text
en: Timer values are defined by the following structures:
fr: Les valeurs des temporisations sont définies avec les structures suivantes\ :

note: type: Plain text
en: The function B<getitimer>()  places the current value of the timer specified by I<which> in the buffer pointed to by I<curr_value>.
fr: La fonction B<getitimer>() met la valeur actuelle de la temporisation indiquée dans I<which> dans le tampon vers lequel pointe I<curr_value>.

note: type: Plain text
en: The I<it_value> substructure is populated with the amount of time remaining until the next expiration of the specified timer.  This value changes as the timer counts down, and will be reset to I<it_interval> when the timer expires.  If both fields of I<it_value> are zero, then this timer is currently disarmed (inactive).
fr: La sous-structure I<it_value> est peuplée par la quantité de temps restant avant la prochaine expiration de la minuterie indiquée. Cette valeur change pendant le décompte de la minuterie et sera réinitialisée à I<it_interval> quand la minuterie expirera. Si les deux champs de I<it_value> sont nuls, cette minuterie est alors désarmée (inactive).

note: type: Plain text
en: The I<it_interval> substructure is populated with the timer interval.  If both fields of I<it_interval> are zero, then this is a single-shot timer (i.e., it expires just once).
fr: La sous-structure I<it_interval> est peuplée par l'intervalle de la temporisation. Si les deux champs de I<it_interval> sont nuls, il s'agit d'une minuterie à un temps (c'est-à-dire qu'elle n'expire qu'une fois).

note: type: Plain text
en: The function B<setitimer>()  arms or disarms the timer specified by I<which>, by setting the timer to the value specified by I<new_value>.  If I<old_value> is non-NULL, the buffer it points to is used to return the previous value of the timer (i.e., the same information that is returned by B<getitimer>()).
fr: La fonction B<setitimer>() arme ou désarme la temporisation indiquée dans I<which>, en positionnant la valeur de la temporisation sur la valeur indiquée par I<new_value>. Si I<old_value> n'est pas NULL, le tampon vers lequel il pointe est utilisé pour renvoyer la valeur précédente de la temporisation (c'est-à-dire la même information renvoyée par B<getitimer>()).

note: type: Plain text
en: If either field in I<new_value.it_value> is nonzero, then the timer is armed to initially expire at the specified time.  If both fields in I<new_value.it_value> are zero, then the timer is disarmed.
fr: Si un champ I<new_value.it_value> est positif, la minuterie est armée pour expirer en premier au moment spécifié. Si les deux champs de I<new_value.it_value> valent zéro, la minuterie est désarmée.

note: type: Plain text
en: The I<new_value.it_interval> field specifies the new interval for the timer; if both of its subfields are zero, the timer is single-shot.
fr: Le champ I<new_value.it_interval> indique le nouvel intervalle de la minuterie ; si ses deux sous-champs sont nuls, la minuterie est configurée pour n'expirer qu'une seule fois.

note: type: SH
en: RETURN VALUE
fr: VALEUR RENVOYÉE

note: type: Plain text
en: On success, zero is returned.  On error, -1 is returned, and I<errno> is set to indicate the error.
fr: En cas de succès, zéro est renvoyé. En cas d'erreur, B<-1> est renvoyé et I<errno> est définie pour préciser l'erreur.

note: type: SH
en: ERRORS
fr: ERREURS

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<which> is not one of B<ITIMER_REAL>, B<ITIMER_VIRTUAL>, or B<ITIMER_PROF>; or (since Linux 2.6.22) one of the I<tv_usec> fields in the structure pointed to by I<new_value> contains a value outside the range [0, 999999].
fr: I<which> n'est ni B<ITIMER_REAL>, ni B<ITIMER_VIRTUAL>, ni B<ITIMER_PROF> ; ou (depuis Linux 2.6.22) un des champs I<tv_usec> dans la structure pointée par I<new_value> contient une valeur hors de l'intervalle [0, 999999].

note: type: Plain text
en: The standards are silent on the meaning of the call:
fr: Les normes ne donnent pas la signification de l'appel :

note: type: Plain text
en: Many systems (Solaris, the BSDs, and perhaps others)  treat this as equivalent to:
fr: De nombreux systèmes d'exploitation (Solaris, les BSD et peut-être d'autres) le traitent comme étant équivalent à :

note: type: Plain text
en: In Linux, this is treated as being equivalent to a call in which the I<new_value> fields are zero; that is, the timer is disabled.  I<Don't use this Linux misfeature>: it is nonportable and unnecessary.
fr: Dans Linux, il est traité comme étant équivalent à un appel dans lequel les champs de I<new_value> sont égaux à zéro, ce qui correspondrait à une temporisation désactivée. I<N'utilisez pas cette non-fonctionnalité de Linux> : elle est non portable et inutile.

note: type: SH
en: HISTORY
fr: HISTORIQUE

note: type: Plain text
en: POSIX.1-2001, SVr4, 4.4BSD (this call first appeared in 4.2BSD).  POSIX.1-2008 marks B<getitimer>()  and B<setitimer>()  obsolete, recommending the use of the POSIX timers API (B<timer_gettime>(2), B<timer_settime>(2), etc.) instead.
fr: POSIX.1-2001, SVr4, 4.4BSD (cet appel est apparu dans 4.2BSD). POSIX.1-2008 marque B<getitimer>() et B<setitimer>() comme étant obsolètes, en recommandant d'utiliser à la place l'API des temporisations POSIX (B<timer_gettime>(2), B<timer_settime>(2), etc.).

note: type: Plain text
en: Timers will never expire before the requested time, but may expire some (short) time afterward, which depends on the system timer resolution and on the system load; see B<time>(7).  (But see BUGS below.)  If the timer expires while the process is active (always true for B<ITIMER_VIRTUAL>), the signal will be delivered immediately when generated.
fr: Les temporisations n'expirent jamais avant la fin du temps demandé, mais elles peuvent expirer après un court moment après la fin, qui dépend de la résolution de l’horloge système et de la charge du système ; consultez B<time>(7) (mais consultez la section BOGUES ci\(hydessous). Si la temporisation expire alors que le processus est actif (toujours vrai avec B<ITIMER_VIRTUAL>), le signal sera délivré immédiatement après sa création.

note: type: Plain text
en: A child created via B<fork>(2)  does not inherit its parent's interval timers.  Interval timers are preserved across an B<execve>(2).
fr: Un enfant créé avec B<fork>(2) n'hérite pas des temporisations périodiques de son parent. Les temporisations périodiques sont conservées au travers d'un B<execve>(2).

note: type: Plain text
en: POSIX.1 leaves the interaction between B<setitimer>()  and the three interfaces B<alarm>(2), B<sleep>(3), and B<usleep>(3)  unspecified.
fr: POSIX.1 laisse indéterminées les interactions entre B<setitimer>() et les trois interfaces B<alarm>(2), B<sleep>(3) et B<usleep>(3).

note: type: SH
en: BUGS
fr: BOGUES

note: type: Plain text
en: The generation and delivery of a signal are distinct, and only one instance of each of the signals listed above may be pending for a process.  Under very heavy loading, an B<ITIMER_REAL> timer may expire before the signal from a previous expiration has been delivered.  The second signal in such an event will be lost.
fr: Sous Linux, l'émission et la réception d'un signal sont distinctes, et une seule instance de chacun des signaux peut être en attente pour un processus. Il est ainsi possible qu'avec une charge système très élevée, une temporisation B<ITIMER_REAL> expire avant que le signal d'une expiration précédente n'ait été reçu. Le second signal sera alors perdu.

note: type: Plain text
en: Before Linux 2.6.16, timer values are represented in jiffies.  If a request is made set a timer with a value whose jiffies representation exceeds B<MAX_SEC_IN_JIFFIES> (defined in I<include/linux/jiffies.h>), then the timer is silently truncated to this ceiling value.  On Linux/i386 (where, since Linux 2.6.13, the default jiffy is 0.004 seconds), this means that the ceiling value for a timer is approximately 99.42 days.  Since Linux 2.6.16, the kernel uses a different internal representation for times, and this ceiling is removed.
fr: Avant Linux 2.6.16, les valeurs des temporisations sont exprimées en «\ jiffies\ ». Si une temporisation est initialisée à une valeur en jiffies dépassant la constante B<MAX_SEC_IN_JIFFIES> (définie dans I<include/linux/jiffies.h>), la temporisation est silencieusement tronquée à cette valeur maximale. Sous Linux sur i386 (où, depuis Linux 2.6.13, un jiffy correspond par défaut à 4 millisecondes), cela signifie que la valeur maximale d'une temporisation est environ 99,42 jours. Depuis Linux 2.6.16, le noyau utilise une représentation interne du temps différente et le plafond est supprimé.

note: 4 Jul 2005: It looks like this bug may remain in Linux 2.4.x. http://lkml.org/lkml/2005/7/1/165 type: Plain text
en: On certain systems (including i386), Linux kernels before Linux 2.6.12 have a bug which will produce premature timer expirations of up to one jiffy under some circumstances.  This bug is fixed in Linux 2.6.12.
fr: Sur certains systèmes (y compris i386), les noyaux Linux avant Linux 2.6.12 ont un bogue qui cause des expirations prématurées de temporisation, avec une avance pouvant aller jusqu'à un jiffy dans certaines circonstances. Ce bogue est corrigé dans Linux 2.6.12.

note: Bugzilla report 25 Apr 2006: http://bugzilla.kernel.org/show_bug.cgi?id=6443 "setitimer() should reject noncanonical arguments" type: Plain text
en: POSIX.1-2001 says that B<setitimer>()  should fail if a I<tv_usec> value is specified that is outside of the range [0, 999999].  However, up to and including Linux 2.6.21, Linux does not give an error, but instead silently adjusts the corresponding seconds value for the timer.  From Linux 2.6.22 onward, this nonconformance has been repaired: an improper I<tv_usec> value results in an B<EINVAL> error.
fr: Selon POSIX.1-2001, B<setitimer>() devrait échouer si la valeur de I<tv_usec> fournie est hors de l'intervalle [0, 999999]. Cependant, dans les noyaux de version inférieure ou égale à Linux 2.6.21, Linux ne renvoie pas d'erreur, et se contente d'ajuster la valeur de I<tv_sec> correspondante. Depuis Linux 2.6.22, cette non conformité a été corrigée\ ; une valeur non valable de I<tv_usec> résulte en une erreur B<EINVAL>.

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

note: type: TH
en: 2023-02-12
fr: 12 février 2023

note: type: TH
en: Linux man-pages 6.03
fr: Pages du manuel de Linux 6.03

note: type: Plain text
en: struct itimerval {
        struct timeval it_interval; /* Interval for periodic timer */
        struct timeval it_value;    /* Time until next expiration */
    };
fr: struct itimerval {
        struct timeval it_interval;  /* Intervalle pour les
                                         minuteries périodiques */
        struct timeval it_value;     /* Délai jusqu'à la prochaine
                                         expiration */
    };

note: type: Plain text
en: struct timeval {
        time_t      tv_sec;         /* seconds */
        suseconds_t tv_usec;        /* microseconds */
    };
fr: struct timeval {
        time_t tv_sec;                /* secondes        */
        suseconds_t tv_usec;          /* microsecondes   */
    };

note: type: TH
en: Linux man-pages 6.05
fr: Pages du manuel de Linux 6.05

note: type: TH
en: 2023-03-30
fr: 30 mars 2023

note: type: TH
en: Linux man-pages 6.04
fr: Pages du manuel de Linux 6.04
