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

Pages du manuel de Linux 6.8                       2 mai 2024                                           times(2)