TIMES

Index

NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
NOTES
CONFORMITÉ
HISTORIQUE
VOIR AUSSI
TRADUCTION

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 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 fils */
clock_t tms_cstime; /* durée système des fils     */

};

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 fils terminés ayant été attendus. Le champ tms_cstime contient la somme des valeurs de tms_stime et tms_cstime pour tous les processus fils terminés ayant été attendus.
Les durées des processus fils 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-fils que le fils 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é. Sous Linux 2.4 et précédents, il s'agit du démarrage du système. Depuis Linux 2.6, il s'agit de (2^32/HZ) - 300 secondes (soit environ 429 millions de secondes) avant le démarrage du système. Cette valeur peut déborder de l'intervalle contenu dans un clock_t. En cas d'erreur (clock_t) -1 est renvoyé et errno contient le code d'erreur.

NOTES

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

: sysconf(_SC_CLK_TCK);

Dans POSIX-1996, le symbole CLK_TCK (défini dans <time.h>) est indiqué en voie d'obsolescence. Il est désormais obsolète.
Sous les noyaux 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() 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 des valeurs de type clock_t qui ne sont pas mesurées en tops d'horloge mais en CLOCKS_PER_SEC.

CONFORMITÉ

SVr4, BSD 4.3, POSIX.1-2001.

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 le 1er janvier 1970. V7 utilisait des long pour les membres des structures, car il n'avait pas encore de type time_t.
Sur les anciens systèmes, le nombre de tops d'horloge par seconde est donné par la variable HZ.

VOIR AUSSI

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

TRADUCTION

Cette page de manuel a été traduite et mise à jour par Christophe Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par Alain Portal <aportal AT univ-montp2 DOT fr> jusqu'en 2006.
La traduction de cette page de manuel est basée sur les traductions disponibles sur http://manpagesfr.free.fr/, mais est gérée par l'équipe francophone de traduction de Debian au travers de la liste de discussion debian-l10n-french.
Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C <section> <page_de_man> ».

Création : octobre 2007