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

NOM

       times - Obtenir les statistiques temporelles du processus

SYNOPSIS

       #include <sys/times.h>

       clock_t times(struct tms *buf);

DESCRIPTION

       La  fonction  times()  stocke  les  durees statistiques du processus en
       cours dans la structure struct tms pointee par buf. La structure struct
       tms est definie ainsi dans <sys/times.h> :

           struct tms {
               clock_t tms_utime;  /* duree utilisateur          */
               clock_t tms_stime;  /* duree systeme              */
               clock_t tms_cutime; /* duree utilisateur des fils */
               clock_t tms_cstime; /* duree systeme des fils     */

       Le  champ  tms_utime  contient  le  temps  CPU  ecoule en executant les
       instructions du processus appelant.  Le  champ  tms_stime  contient  le
       temps  CPU passe dans les fonctions systeme executees pour le compte du
       processus appelant. Le champ tms_cutime contient la somme  des  valeurs
       de  tms_utime et tms_cutime pour tous les processus fils termines ayant
       ete attendus. Le champ tms_cstime contient  la  somme  des  valeurs  de
       tms_stime et tms_cstime pour tous les processus fils termines ayant ete
       attendus.

       Les durees des processus fils termines (et de leurs  descendants)  sont
       ajoutees  au  moment  ou wait(2) ou waitpid(2) renvoient leur numero de
       PID. En particulier, les durees des petits-fils que  le  fils  n'a  pas
       attendu ne sont jamais vues.

       Toutes les durees sont exprimees en tops d'horloge.

VALEUR RENVOY'EE

       times()  renvoie  le nombre de tops d'horloge ecoules depuis un instant
       arbitraire dans le passe. Cette valeur peut  deborder  de  l'intervalle
       contenu  dans  un  clock_t. En cas d'erreur (clock_t) -1 est renvoye et
       errno contient le code d'erreur.

CONFORMIT'E

       SVr4, BSD 4.3, POSIX.1-2001.

NOTES

       Le nombre de tops d'horloge par seconde peut etre obtenu en utilisant :

           sysconf(_SC_CLK_TCK);

       Dans POSIX.1-1996,  le  symbole  CLK_TCK  (defini  dans  <time.h>)  est
       indique en voie d'obsolescence. Il est desormais obsolete.

       Sous  les  noyaux Linux anterieurs a 2.6.9, si le traitement de SIGCHLD
       est configure avec SIG_IGN alors les durees des enfants  termines  sont
       automatiquement incluses dans les champs tms_cstime et tms_cutime, bien
       que POSIX.1-2001 precise que  ceci  ne  doit  se  produire  que  si  le
       processus  appelant  a  fait  un  wait(2)  pour  ses enfants. Cette non
       conformite est corrigee depuis Linux 2.6.9.

       Sous Linux, l'argument buf peut etre NULL, auquel cas  times()  renvoie
       simplement  son resultat. Cependant, ce comportement n'est pas specifie
       par POSIX, et la plupart des implementations requierent une valeur  non
       NULL de buf.

       Notez  que  clock(3)  renvoie  aussi  des valeurs de type clock_t, mais
       cette valeur est mesuree en  unites  de  CLOCKS_PER_SEC,  pas  en  tops
       d'horloge utilises par times().

       Sous Linux, << l'instant arbitraire dans le passe >> a partir duquel la
       valeur renvoyee par times() est mesure a varie suivant les versions  du
       noyau. Sous Linux 2.4 et precedents, il s'agit du demarrage du systeme.
       Depuis Linux 2.6, cet instant est (2^32/HZ) - 300 (c'est-a-dire, a  peu
       pres  429 millions)  secondes  avant  le  demarrage  du  systeme. Cette
       variabilite  a  travers  les  versions  du  noyau  (et  a  travers  les
       implementations Unix) combinee avec le fait que la valeur renvoyee peut
       deborder  de  la  plage  de  clock_t,  signifie  que  les  applications
       portables  seraient  avisees  de  ne  pas  utiliser  cette valeur. Pour
       mesurer  les  modifications  d'un   temps   ecoule,   utilisez   plutot
       gettimeofday(2).

   Historique
       SVr1-3  renvoie  un  long  et  les membres de la structure sont de type
       time_t bien qu'ils stockent des tops  d'horloge  et  pas  des  secondes
       depuis l'epoque. V7 utilisait des long pour les membres des structures,
       car il n'avait pas encore de type time_t.

BOGUES

       Une limitation des conventions  d'appel  systeme  Linux  sur  certaines
       architectures  (notamment  i386)  fait  que  sous linux 2.6, il y a une
       petite fenetre de temps (41 secondes) apres  le  demarrage  ou  times()
       peut  retourner -1, indiquant a tort qu'une erreur est apparue. Le meme
       probleme peut survenir lorsque les enveloppes de valeurs renvoyees  ont
       passe la valeur maximum qui puisse etre stockee dans clockid_t.

VOIR AUSSI

       time(1), getrusage(2), wait(2), clock(3), sysconf(3), 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/>.

       Christophe  Blaess  <URL:http://www.blaess.fr/christophe/> (1996-2003),
       Alain  Portal  <URL:http://manpagesfr.free.fr/>  (2003-2006).    Julien
       Cristau 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> >>.