clock_t times(struct tms *buf);
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.
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.
Dans les noyaux Linux antérieurs à la version 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 spécifié comme NULL, auquel cas times() renverra simplement un résulat de fonction. Toutefois, POSIX ne décrit pas ce comportement, et la plupart des autres implémentations Unix nécessite une valeur non-NULL pour buf.
Notez que clock(3) renvoie également une valeur 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 antérieurs, il s'agit du démarrage du système. Depuis Linux 2.6, cet instant est (2^32/HZ) - 300 (c'est-à-dire, à peu près 429 millions) 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 gettimeofday(2).
Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 15 octobre 1996 et révisée le 17 juillet 2008.
L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 times ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.
Dernière mise à jour : 17 juillet 2008