times(2)

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.