Provided by: manpages-fr-dev_3.65d1p1-1_all bug

NOM

       timer_settime,  timer_gettime  - Armer, désarmer et récupérer l'état d'une minuterie POSIX
       d'un processus

SYNOPSIS

       #include <time.h>

       int timer_settime(timer_t timerid, int flags,
                         const struct itimerspec *new_value,
                         struct itimerspec * old_value);
       int timer_gettime(timer_t timerid, struct itimerspec *curr_value);

       Effectuez l'édition des liens avec l'option -lrt.

   Exigences   de   macros   de   test   de   fonctionnalités   pour    la    glibc    (consultez
   feature_test_macros(7)) :

       timer_settime(), timer_gettime(): _POSIX_C_SOURCE >= 199309L

DESCRIPTION

       timer_settime()  arme et désarme la minuterie indiquée par timerid. Le paramètre new_value
       est un pointeur vers une structure itimerspec qui indique la nouvelle valeur  initiale  et
       le nouvel intervalle pour la minuterie. La structure itimerspec est définie comme ceci :

           struct timespec {
               time_t tv_sec;                /* Secondes */
               long   tv_nsec;               /* Nanosecondes */
           };

           struct itimerspec {
               struct timespec it_interval;  /* Intervalle pour les
                                                minuteries périodiques */
               struct timespec it_value;     /* Expiration initiale */
           };

       Chacune  des  sous-structures  de  la  structure itimerspec est une structure timespec qui
       permet d'indiquer une valeur en secondes et en nanosecondes. Ces valeurs sont  mesurée  en
       fonction  de  l'horloge  qui  a  été  indiquée  lorsque  la  minuterie  a  été  créée avec
       timer_create(2).

       Si new_value->it_value indique une valeur non nulle  (c'est-à-dire  qu'un  de  ses  champs
       n'est  pas nul), alors timer_settime() arme (démarre) la minuterie, en la configurant pour
       qu'elle expire au moment donnée (si  la  minuterie  était  déjà  armée,  sa  configuration
       précédente  est remplacée). Si new_value->it_value a une valeur nulle (c'est-à-dire si ses
       deux champs sont nuls), alors la minuterie est désarmée.

       Le champ new_value->it_interval indique  la  période  de  la  minuterie,  en  secondes  et
       nanosecondes. Si ce champ n'est pas nul alors à chaque fois qu'une minuterie armée expire,
       la minuterie est  rechargée  avec  la  valeur  indiquée  dans  new_value->it_interval.  Si
       new_value->it_interval  est  nul, alors la minuterie n'expire qu'une fois, une fois que le
       temps défini par it_value est écoulé.

       Par défaut, le temps d'expiration initial indiqué par new_value->it_value  est  interprété
       par  rapport  à  l'instant actuel sur l'horloge de la minuterie au moment de l'appel. Ceci
       peut être modifié en indiquant TIMER_ABSTIME dans flags, new_value->it_value  étant  alors
       interprété  comme  une valeur absolue mesurée sur l'horloge de la minuterie ; c'est-à-dire
       que la minuterie expirera quand la valeur de l'horloge  atteint  la  valeur  indiquée  par
       new_value->it_value.  Si le temps absolu indiqué est déjà passé, alors la minuterie expire
       immédiatement et le compteur de dépassement (consultez timer_getoverrun(2)) est positionné
       en conséquence.

       Si la valeur de l'horloge CLOCK_REALTIME est ajustée et qu'une minuterie absolue basée sur
       cette  horloge  est  armée,  alors  l'expiration  de  cette  minuterie  sera  ajustée   en
       conséquence.  Les  ajustements  de  l'horloge  CLOCK_REALTIME  n'ont  aucun  effet sur les
       minuteries relatives basées sur cette horloge.

       Si old_value n'est pas NULL, alors il pointe vers un tampon qui est utilisé pour  renvoyer
       l'intervalle  précédent  de  la  minuterie (dans old_value->it_interval) et la durée qu'il
       restait avant l'expiration suivante de la minuterie (dans old_value->it_value).

       timer_gettime() renvoie dans le tampon  pointé  par  curr_value  le  temps  restant  avant
       l'expiration  suivante  et  l'intervalle  de  la  minuterie indiquée par timerid. Le temps
       restant avant l'expiration suivante est  renvoyé  dans  curr_value->it_value ;  il  s'agit
       toujours  d'une  valeur relative, que le drapeau TIMER_ABSTIME soit utilisé ou non lorsque
       la minuterie est armée. Si la valeur renvoyée dans curr_value->it_value est  nulle,  alors
       la  minuterie  était  désarmée  au  moment  de  l'appel.  L'intervalle de la minuterie est
       renvoyée dans curr_value->it_interval. Si la valeur renvoyée dans  curr_value->it_interval
       est nulle, alors il s'agit d'une minuterie à un coup.

VALEUR RENVOYÉE

       En cas de réussite, timer_settime() et timer_gettime() renvoient zéro. En cas d'erreur, -1
       est renvoyé et errno indique le code d'erreur.

ERREURS

       Ces fonctions peuvent échouer avec les erreurs suivantes :

       EFAULT new_value, old_value ou curr_value n'est pas un pointeur valable.

       EINVAL timerid n'est pas valable

       timer_settime() peut échouer avec les erreurs suivantes :

       EINVAL new_value.it_value est  négatif ;  ou  new_value.it_value.tv_nsec  est  négatif  ou
              supérieur à 999,999,999.

VERSIONS

       Ces appels systèmes sont disponibles depuis Linux 2.6.

CONFORMITÉ

       POSIX.1-2001.

EXEMPLE

       Consultez timer_create(2).

VOIR AUSSI

       timer_create(2), timer_getoverrun(2), time(7)

COLOPHON

       Cette  page  fait partie de la publication 3.65 du projet man-pages Linux. Une description
       du projet et des  instructions  pour  signaler  des  anomalies  peuvent  être  trouvées  à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis    2010,    cette   traduction   est   maintenue   à   l'aide   de   l'outil   po4a
       <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du  projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Nicolas François et l'équipe francophone de traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>  ou  par  un  rapport  de  bogue   sur   le   paquet
       manpages-fr.

       Vous  pouvez  toujours  avoir  accès  à la version anglaise de ce document en utilisant la
       commande « man -L C <section> <page_de_man> ».