.\" -*- coding: UTF-8 -*- .\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992 .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified by Michael Haardt (michael@moria.de) .\" Modified Sat Jul 24 14:29:17 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 961203 and 001211 and 010326 by aeb@cwi.nl .\" Modified 001213 by Michael Haardt (michael@moria.de) .\" Modified 13 Jun 02, Michael Kerrisk .\" Added note on nonstandard behavior when SIGCHLD is ignored. .\" Modified 2004-11-16, mtk, Noted that the nonconformance when .\" SIGCHLD is being ignored is fixed in Linux 2.6.9; other minor changes .\" Modified 2004-12-08, mtk, in Linux 2.6 times() return value changed .\" 2005-04-13, mtk .\" Added notes on nonstandard behavior: Linux allows 'buf' to .\" be NULL, but POSIX.1 doesn't specify this and it's nonportable. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH times 2 "30 mars 2023" "Pages du manuel de Linux 6.05.01" .SH NOM times \- Obtenir les statistiques temporelles du processus .SH BIBLIOTHÈQUE Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP) .SH SYNOPSIS .nf \fB#include \fP .PP \fBclock_t times(struct tms *\fP\fIbuf\fP\fB);\fP .fi .SH DESCRIPTION La fonction \fBtimes\fP() stocke les durées statistiques du processus en cours dans la structure \fIstruct tms\fP pointée par \fIbuf\fP. La structure \fIstruct tms\fP est définie ainsi dans \fI\fP\ : .PP .in +4n .EX 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 */ .EE .in .PP Le champ \fItms_utime\fP contient le temps CPU écoulé en exécutant les instructions du processus appelant. Le champ \fItms_stime\fP contient le temps CPU passé dans les fonctions système exécutées pour le compte du processus appelant. .PP Le champ \fItms_cutime\fP contient la somme des valeurs de \fItms_utime\fP et \fItms_cutime\fP pour tous les processus enfant terminés ayant été attendus. Le champ \fItms_cstime\fP contient la somme des valeurs de \fItms_stime\fP et \fItms_cstime\fP pour tous les processus enfant terminés ayant été attendus. .PP Les durées des processus enfant terminés (et de leurs descendants) sont ajoutées au moment où \fBwait\fP(2) ou \fBwaitpid\fP(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. .PP Toutes les durées sont exprimées en tops d'horloge. .SH "VALEUR RENVOYÉE" \fBtimes\fP() 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 \fIclock_t\fP. En cas d'erreur \fI(clock_t)\ \-1\fP est renvoyé et \fIerrno\fP est défini pour préciser l'erreur. .SH ERREURS .TP \fBEFAULT\fP \fItms\fP pointe en dehors de l'espace d'adressage du processus. .SH VERSIONS Sous Linux, l'argument \fIbuf\fP peut être NULL, auquel cas \fBtimes\fP() 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 \fIbuf\fP. .SH STANDARDS POSIX.1\-2008. .SH HISTORIQUE POSIX.1\-2001, SVr4, 4.3BSD. .PP Dans POSIX.1\-1996, le symbole \fBCLK_TCK\fP (défini dans \fI\fP) est indiqué en voie d'obsolescence. Il est désormais obsolète. .PP .\" See the description of times() in XSH, which says: .\" The times of a terminated child process are included... when wait() .\" or waitpid() returns the process ID of this terminated child. Avant Linux antérieurs à\ 2.6.9, si le traitement de \fBSIGCHLD\fP est configuré avec \fBSIG_IGN\fP, alors les durées des enfants terminés sont automatiquement incluses dans les champs \fItms_cstime\fP et \fItms_cutime\fP, bien que POSIX.1\-2001 précise que ceci ne doit se produire que si le processus appelant a fait un \fBwait\fP(2) pour ses enfants. Cette non conformité est corrigée depuis Linux\ 2.6.9. .PP .\" .PP .\" On older systems the number of clock ticks per second is given .\" by the variable HZ. Sous Linux, «\ l'instant arbitraire dans le passé\ » à partir duquel la valeur renvoyée par \fBtimes\fP() 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 \fI(2\[ha]32/HZ) \-\ 300\fP\ 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 \fIclock_t\fP, 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 \fBclock_gettime\fP(2). .PP SVr1\-3 renvoie un \fIlong\fP et les membres de la structure sont de type \fItime_t\fP bien qu'ils stockent des tops d'horloge et pas des secondes depuis l'époque. V7 utilisait des \fIlong\fP pour les membres des structures, car il n'avait pas encore de type \fItime_t\fP. .SH NOTES Le nombre de tops d'horloge par seconde peut être obtenu en utilisant\ : .PP .in +4n .EX sysconf(_SC_CLK_TCK); .EE .in .PP Notez que \fBclock\fP(3) renvoie aussi des valeurs de type \fIclock_t\fP, mais cette valeur est mesurée en unités de \fBCLOCKS_PER_SEC\fP, pas en tops d'horloge utilisés par \fBtimes\fP(). .SH BOGUES .\" The problem is that a syscall return of -4095 to -1 .\" is interpreted by glibc as an error, and the wrapper converts .\" the return value to -1. .\" http://marc.info/?l=linux-kernel&m=119447727031225&w=2 .\" "compat_sys_times() bogus until jiffies >= 0" .\" November 2007 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ù \fBtimes\fP() peut retourner \fB\-1\fP, 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 \fBclock_t\fP. .SH "VOIR AUSSI" \fBtime\fP(1), \fBgetrusage\fP(2), \fBwait\fP(2), \fBclock\fP(3), \fBsysconf\fP(3), \fBtime\fP(7) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot et Jean-Pierre Giraud . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .