NOM

       times - Obtenir les statistiques temporelles du processus

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <sys/times.h>

       clock_t times(struct tms *buf);

DESCRIPTION

       La fonction times() stocke les durées statistiques du processus en cours dans la structure
       struct tms pointée par buf. La structure struct tms est définie ainsi dans <sys/times.h> :

           struct tms {
               clock_t tms_utime;  /* durée utilisateur          */
               clock_t tms_stime;  /* durée système              */
               clock_t tms_cutime; /* durée utilisateur des enfants */
               clock_t tms_cstime; /* durée système des enfants     */

       Le champ tms_utime contient le temps CPU écoulé en exécutant les instructions du processus
       appelant.  Le  champ  tms_stime  contient  le  temps  CPU passé dans les fonctions système
       exécutées 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  enfant  terminés  ayant été attendus. Le champ tms_cstime contient la somme des
       valeurs de tms_stime et tms_cstime pour tous  les  processus  enfant  terminés  ayant  été
       attendus.

       Les durées des processus enfant terminés (et de leurs descendants) sont ajoutées au moment
       où wait(2) ou waitpid(2) renvoient leur numéro de PID.  En  particulier,  les  durées  des
       petits-enfants que l'enfant n'a pas attendu ne sont jamais vues.

       Toutes les durées sont exprimées en tops d'horloge.

VALEUR RENVOYÉE

       times()  renvoie  le nombre de tops d'horloge écoulés depuis un instant arbitraire dans le
       passé. Cette valeur peut déborder de l'intervalle contenu dans un clock_t. En cas d'erreur
       (clock_t) -1 est renvoyé et errno est défini pour préciser l'erreur.

ERREURS

       EFAULT tms pointe en dehors de l'espace d'adressage du processus.

STANDARDS

       POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.

NOTES

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

           sysconf(_SC_CLK_TCK);

       Dans  POSIX.1-1996,  le  symbole  CLK_TCK  (défini  dans  <time.h>)  est  indiqué  en voie
       d'obsolescence. Il est désormais obsolète.

       Avant Linux antérieurs à 2.6.9, si le traitement de SIGCHLD est  configuré  avec  SIG_IGN,
       alors  les  durées  des  enfants  terminés  sont  automatiquement incluses dans les champs
       tms_cstime et tms_cutime, bien que POSIX.1-2001 précise que ceci ne doit se  produire  que
       si  le  processus  appelant  a  fait un wait(2) pour ses enfants. Cette non conformité est
       corrigée depuis Linux 2.6.9.

       Sous Linux, l'argument buf peut être NULL,  auquel  cas  times()  renvoie  simplement  son
       résultat.  Cependant,  ce  comportement  n'est  pas  spécifié par POSIX, et la plupart des
       implémentations requièrent une valeur non NULL de buf.

       Notez que clock(3) renvoie aussi des valeurs  de  type  clock_t,  mais  cette  valeur  est
       mesurée en unités de CLOCKS_PER_SEC, pas en tops d'horloge utilisés par times().

       Sous  Linux, « l'instant arbitraire dans le passé » à partir duquel la valeur renvoyée par
       times() est mesuré a varié suivant les versions du noyau. Sous Linux 2.4 et précédents, il
       s'agit du démarrage du système. Depuis Linux 2.6, cet instant est (2^32/HZ) - 300 secondes
       avant le démarrage du système. Cette variabilité à travers les versions  du  noyau  (et  à
       travers  les  implémentations  UNIX)  combinée  avec  le  fait que la valeur renvoyée peut
       déborder de la plage de clock_t, signifie que les applications portables seraient  avisées
       de  ne  pas  utiliser  cette  valeur.  Pour  mesurer  les modifications d'un temps écoulé,
       utilisez plutôt clock_gettime(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'époque. 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  système  Linux  sur  certaines   architectures
       (notamment i386) fait que sous linux 2.6, il y a une petite fenêtre de temps (41 secondes)
       après le démarrage où times() peut retourner  -1,  indiquant  à  tort  qu'une  erreur  est
       apparue.  Le  même  problème peut survenir lorsque les enveloppes de valeurs renvoyées ont
       passé la valeur maximum qui puisse être stockée dans clock_t.

VOIR AUSSI

       time(1), getrusage(2), wait(2), clock(3), sysconf(3), time(7)

TRADUCTION

       La traduction française de cette  page  de  manuel  a  été  créée  par  Christophe  Blaess
       <https://www.blaess.fr/christophe/>,  Stéphan  Rafin  <stephan.rafin@laposte.net>, Thierry
       Vignaud <tvignaud@mandriva.com>, François Micaux, Alain  Portal  <aportal@univ-montp2.fr>,
       Jean-Philippe    Guérard   <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)   <jean-
       luc.coulon@wanadoo.fr>,   Julien    Cristau    <jcristau@debian.org>,    Thomas    Huriaux
       <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin
       Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,  Denis
       Barbier  <barbier@debian.org>,  David  Prévot  <david@tilapin.org>  et  Jean-Pierre Giraud
       <jean-pierregiraud@neuf.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter  à  la  GNU  General
       Public   License   version 3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  concernant  les
       conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un
       message à ⟨debian-l10n-french@lists.debian.org⟩.