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.

VERSIONS

       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.

STANDARDS

       POSIX.1-2008.

HISTORIQUE

       POSIX.1-2001, SVr4, 4.3BSD.

       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'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).

       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.

NOTES

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

           sysconf(_SC_CLK_TCK);

       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().

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⟩.