Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       timer_settime,  timer_gettime  -  Armer,  desarmer  et recuperer l'etat
       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'edition des liens avec l'option -lrt.

   Exigences de macros de test de fonctionnalites  pour  la  glibc  (consultez
   feature_test_macros(7)) :

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

DESCRIPTION

       timer_settime()  arme  et desarme la minuterie indiquee par timerid. Le
       parametre  new_value  est  une  structure  itimerspec  qui  indique  la
       nouvelle  valeur initiale et le nouvel intervalle pour la minuterie. La
       structure itimerspec est definie comme ceci :

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

           struct itimerspec {
               struct timespec it_interval;  /* Intervalle pour les
                                                minuteries periodiques */
               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 mesuree en fonction de l'horloge  qui  a
       ete indiquee lorsque la minuterie a ete creee avec timer_create().

       Si new_value->it_value indique une valeur non nulle (c'est-a-dire qu'un
       de ses champs n'est pas nul), alors timer_settime() arme  (demarre)  la
       minuterie,  en  la configurant pour qu'elle expire au moment donnee (si
       la  minuterie  etait  deja  armee,  sa  configuration  precedente   est
       remplacee).  Si new_value->it_value a une valeur nulle (c'est-a-dire si
       ses deux champs sont nuls), alors la minuterie est desarmee.

       Le champ new_value->it_interval indique la periode de la minuterie,  en
       secondes et nanosecondes. Si ce champ n'est pas nul alors a chaque fois
       qu'une minuterie armee expire,  la  minuterie  est  rechargee  avec  la
       valeur  indiquee 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
       defini par it_value est ecoule.

       Par    defaut,    le    temps    d'expiration   initial   indique   par
       new_value->it_value est interprete par rapport a l'instant  actuel  sur
       l'horloge  de la minuterie au moment de l'appel. Ceci peut etre modifie
       en indiquant TIMER_ABSTIME dans flags, new_value->it_value etant  alors
       interprete  comme  une  valeur  absolue  mesuree  sur  l'horloge  de la
       minuterie ; c'est-a-dire que la minuterie expirera quand la  valeur  de
       l'horloge  atteint  la  valeur  indiquee par new_value->it_value. Si le
       temps  absolu  indique  est  deja  passe,  alors  la  minuterie  expire
       immediatement    et    le    compteur    de    depassement   (consultez
       timer_getoverrun(2)) est positionne en consequence.

       Si  la  valeur  de  l'horloge  CLOCK_REALTIME  est  ajustee  et  qu'une
       minuterie absolue basee sur cette horloge est armee, alors l'expiration
       de cette minuterie sera ajustee  en  consequence.  Les  ajustements  de
       l'horloge CLOCK_REALTIME n'ont aucun effet sur les minuteries relatives
       basees sur cette horloge.

       Si old_value n'est pas NULL, alors elle renvoie l'intervalle  precedent
       de la minuterie (dans old_value->it_interval) et la duree qu'il restait
       avant l'expiration suivante de la minuterie (dans old_value->it_value).

       timer_gettime() renvoie dans le tampon pointe par curr_value  le  temps
       restant  avant  l'expiration  suivante  et l'intervalle de la minuterie
       indiquee par timerid. Le temps restant avant l'expiration suivante  est
       renvoye  dans  curr_value->it_value ;  il  s'agit toujours d'une valeur
       relative, que le drapeau TIMER_ABSTIME soit utilise ou non  lorsque  la
       minuterie  est  armee.  Si la valeur renvoyee dans curr_value->it_value
       est nulle, alors la minuterie etait  desarmee  au  moment  de  l'appel.
       L'intervalle de la minuterie est renvoyee dans curr_value->it_interval.
       Si la valeur renvoyee dans curr_value->it_interval est nulle, alors  il
       s'agit d'une minuterie a un coup.

VALEUR RENVOY'EE

       En  cas de reussite, timer_settime() et timer_gettime() renvoient zero.
       En cas d'erreur, -1 est renvoye et errno indique le code d'erreur.

ERREURS

       Ces fonctions peuvent echouer 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 echouer avec les erreurs suivantes :

       EINVAL new_value.it_value  est  negatif ; ou new_value.it_value.tv_nsec
              est negatif ou superieur a 999,999,999.

VERSIONS

       Ces appels systemes sont disponibles depuis Linux 2.6.

CONFORMIT'E

       POSIX.1-2001

EXEMPLE

       Consultez timer_create(2).

VOIR AUSSI

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

COLOPHON

       Cette page fait partie de  la  publication  3.27  du  projet  man-pages
       Linux.  Une description du projet et des instructions pour signaler des
       anomalies      peuvent      etre       trouvees       a       l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

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

       Nicolas   Francois   et   l'equipe   francophone   de   traduction   de
       Debian (2006-2009).

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

       Vous  pouvez  toujours avoir acces a la version anglaise de ce document
       en utilisant la commande << man -L C <section> <page_de_man> >>.

Linux                           20 fevrier 2009               TIMER_SETTIME(2)