Man Nanosleep en français
NANOSLEEP(2)              Manuel du programmeur Linux             NANOSLEEP(2)



 

NOM


       nanosleep - Arreter l'execution pendant une duree donnee.

 

SYNOPSIS


       #define _POSIX_C_SOURCE 199309 #include 

       int nanosleep(const struct timespec *req, struct timespec *rem);

 

DESCRIPTION






       nanosleep()  suspend  l'execution  du programme en cours pour une duree
       valant au moins *req.  Cette fonction peut se  terminer  plus  tot  que
       prevu  si un signal a ete recu par le processus. Dans ce cas, elle ren-
       voie -1, positionne errno a  la  valeur  EINTR,  et  inscrit  le  temps
       restant  dans  la  structure pointee par rem a moins que rem soit NULL.
       La  valeur  de  *rem  peut  etre  utilisee  pour  rappeler  a   nouveau
       nanosleep() afin de terminer la pause.

       La  structure timespec est utilisee pour indiquer l'intervalle de temps
       en nano-secondes.  Elle est definie dans  et a la  forme  suiv-
       ante

              struct timespec {
                  time_t tv_sec;        /* secondes */
                  long   tv_nsec;       /* nano-secondes */
              };

       La  valeur  du  champ  nano-seconde  doit  etre  dans  l'intervalle 0 a
       999 999 999.

       Par rapport a  sleep(3)  et  usleep(3),  nanosleep()  a  l'avantage  de
       n'affecter  aucun  signal,  d'etre  au  standard  POSIX, de fournir une
       meilleure resolution, et de permettre de continuer facilement  un  som-
       meil interrompu par un signal.

 

VALEUR RENVOYEE


       S'il  s'endort de maniere reussie pendant l'intervalle de temps demande
       En cas d'erreur ou d'interruption, l'appel systeme nanosleep()  renvoie
       0.  Si l'appel est interrompu par un gestionnaire de signaux ou rencon-
       tre une erreur, il renvoie -1 et ecrit errno en consequence.

 

ERREURS


       EFAULT Probleme lors de la copie d'information  a  partir  de  l'espace
              utilisateur.

       EINTR  La  pause  a ete interrompue par un signal non-bloque delivre au
              processus. Le temps restant de sommeil a ete inscrit  dans  *rem
              pour que le processus puisse terminer facilement son sommeil.

       EINVAL La  valeur  du  champ  tv_nsec  n'est  pas dans l'intervalle 0 a
              999 999 999 ou tv_sec est negatif.

 

BOGUES


       L'implementation actuelle de nanosleep() est construite sur  le  mecan-
       isme  de  temporisation  du  noyau, qui dispose d'une resolution valant
       1/HZ s (voir time(7))).  Ainsi, nanosleep() dormira toujours  pour  une
       duree au moins egale au temps specifie, mais il peut prendre jusqu'a 10
       ms de plus (i386) avant de faire redemarrer le processus.  Pour la meme
       raison, la valeur retournee dans *rem en cas d'interruption par un sig-
       nal est arrondie au multiple superieur de 1/HZ s.


   Ancien comportement
       Afin de pouvoir supporter des applications necessitant des pauses  plus
       precises  (par exemple pour le controle de peripheriques materiels avec
       un delai critique), nanosleep() pouvait aussi offrir des pauses jusqu'a
       2 ms, effectuees avec des boucles actives d'une precision de l'ordre de
       la micro-seconde, lorsque le processus etait mis sous le controle  d'un
       ordonnanceur  temps reel comme SCHED_FIFO ou SCHED_RR.  Cette extension
       particuliere a ete retire dans le noyau 2.5.39. Elle est donc  toujours
       presence dans les noyaux 2.4, mais plus dans les noyaux 2.6.

       Dans  Linux  2.4, si nanosleep() est arrete par un signal (par exemple,
       SIGTSTP), l'appel echoue avec l'erreur EINTR apres que le processus ait
       repris  avec  un signal SIGCONT.  Si l'appel systeme est, par la suite,
       relance, le temps passe par le processus dans l'etat arrete  n'est  pas
       comptabilise dans l'intervalle de sommeil.

 

CONFORMITE


       POSIX.1-2001.

 

VOIR AUSSI


       timer_create(2), sched_setscheduler(2), sleep(3), usleep(3)

 

TRADUCTION


       Ce   document   est  une  traduction  realisee  par  Christophe  Blaess
        le  14 octobre 1996  et  revisee  le
       14 aot 2006.

       L'equipe  de  traduction a fait le maximum pour realiser une adaptation
       francaise de qualite. La version anglaise la plus a jour de ce document
       est  toujours  consultable  via la commande :  LANG=C man 2 nanosleep .
       N'hesitez pas a signaler a l'auteur ou au  traducteur,  selon  le  cas,
       toute erreur dans cette page de manuel.



Linux 2.6.9                     24 octobre 2004                   NANOSLEEP(2)