time(1) General Commands Manual time(1)
NOM
time - Chronometrer ou evaluer les ressources employees par une
commande simple
SYNOPSIS
time [option ...] commande [arguments ...]
DESCRIPTION
La fonction time lance le programme represente par la commande
indiquee, avec les arguments fournis. Lorsque la commande se termine,
time affiche un message sur la sortie d'erreur contenant des
statistiques sur l'execution du programme. Ces statistiques contiennent
(i) le temps ecoule entre l'invocation et la fin de la commande, (ii)
le temps CPU ecoule en mode utilisateur (la somme des valeurs tms_utime
et tms_cutime de la structure struct tms fournie par l'appel systeme
times(2)), et (iii) le temps CPU passe en mode systeme (la somme des
champs tms_stime et tms_cstime de la struct tms fournie par l'appel
systeme times(2)).
Note : certains interpreteurs (comme par exemple bash(1)) possedent une
commande time qui fournit des informations identiques sur l'utilisation
du temps et peut-etre d'autres ressources. Pour acceder a la commande
reelle, il se peut que vous soyez oblige d'indiquer le chemin complet
(quelque chose comme /usr/bin/time).
OPTIONS
-p Dans la localisation POSIX, utiliser le format traditionnel
"real %f\nuser %f\nsys %f\n
(avec des nombres exprimes en secondes) ou le nombre de
decimales dans le format %f n'est pas precise, mais suffisant
pour exprimer le top d'horloge precisement.
CODE DE RETOUR
Si la commande a ete invoquee, le code de sortie est celui de la
commande. Sinon, il s'agit de 127 si la commande n'a pas ete trouvee,
126 si elle a ete trouvee mais n'a pas pu etre invoquee, et une autre
valeur non nulle (1-125) si quelque chose d'autre a echoue.
ENVIRONNEMENT
Les variables LANG, LC_ALL, LC_CTYPE, LC_MESSAGES, LC_NUMERIC et
NLSPATH sont utilisees pour le texte et la sortie. PATH sert a
rechercher la commande.
VERSION GNU
Suit une description de la version GNU 1.7 de time. Contrairement au
nom de cet utilitaire, GNU ajoute un grand nombre d'informations
utiles, concernant non seulement le temps ecoule, mais egalement
d'autres ressources, comme la memoire, les entrees-sorties ou les
communications IPC (si disponibles). La sortie est formatee en
utilisant une chaine qui peut etre transmise avec l'option -f ou en
utilisant la variable d'environnement TIME.
La chaine de format par defaut est
%Uuser %Ssystem %Eelapsed %PCPU (%Xtext+%Ddata %Mmax)k
%Iinputs+%Ooutputs (%Fmajor+%Rminor)pagefaults %Wswaps
Lorsque l'option -p est fournie, le format de sortie (portable) est
utilise :
real %e
user %U
sys %S
Chaine de format
Le format est interprete comme d'habitude a la maniere de printf(3).
Les caracteres ordinaires sont copies directement, les tabulations,
sauts de lignes et barres obliques inversees (backslash) sont proteges
par \t, \en et \\. Un signe pourcent est represente par %%, sinon %
indique une conversion. Le programme time ajoutera toujours un saut de
ligne a la fin de la sortie. Les conversions se trouvent ci-dessous.
Toutes celles utilisees par tcsh(1) sont disponibles.
Temps
%E Temps reel ecoule (en [heures:]minutes:secondes).
%e (pas avec tcsh(1).) Temps reel ecoule (en secondes).
%S Nombre total de secondes-CPU passees par le processus en mode
noyau.
%U Nombre total de secondes-CPU passees par le processus en mode
utilisateur.
%P Pourcentage de CPU obtenu par cette tache, calcule comme (%U +
%S) / %E.
Memoire
%M Taille maximale du processus en memoire physique durant son
execution, en kilooctets.
%t (pas avec tcsh(1).) Taille moyenne du processus en memoire
physique durant son execution, en kilooctets.
%K Memoire moyenne (donnee + pile + code) utilisee par le
processus, en kilooctets.
%D Taille moyenne des donnees non partagees du processus, en
kilooctets.
%p (pas avec tcsh(1).) Taille moyenne de la pile non partagee du
processus, en kilooctets.
%X Taille moyenne du code partage du processus, en kilooctets.
%Z (pas avec tcsh(1).) Taille de page du systeme, en octets. Ceci
est une constante sur un systeme, mais varie de systeme en
systeme.
%F Nombre de fautes de pages majeures durant l'execution. Ce sont
les fautes ou des pages ont du etre rechargees depuis le disque.
%R Nombre de fautes de pages mineures durant l'execution. Ce sont
les fautes ou des pages ne sont plus valides, mais n'ont pas
encore ete reutilisees. Les donnees y sont encore presentes et
seules les tables systeme doivent etre mises a jour.
%W Nombre de fois ou le processus a ete envoye sur la memoire de
swap.
%c Nombre de fois ou le processus a ete preempte involontairement
(sa tranche de temps ayant expire).
%w Nombre de fois ou le processus a ete commute volontairement, en
passant en attente par exemple de la fin d'une entree-sortie.
Entrees/Sorties
%I Nombre de lectures depuis un fichier
%O Nombre d'ecritures dans un fichier
%r Nombre de messages recus par le processus sur un socket.
%s Nombre de messages envoyes par le processus sur un socket.
%k Nombre de signaux delivres au processus.
%C (pas avec tcsh(1).) Nom de la commande examinee avec ses
arguments.
%x (pas avec tcsh(1).) Code de retour de la commande.
Options GNU
-f format, --format=format
Preciser le format de sortie, en ecrasant celui mentionne
eventuellement dans la variable d'environnement TIME.
-p, --portability
Utiliser le format de sortie portable.
-o fichier, --output=fichier
Ne pas envoyer les resultats sur la sortie d'erreur standard,
mais ecraser le fichier indique.
-a, --append
En conjonction avec -o, ne pas ecraser le fichier, mais ajouter
les resultats a la fin.
-v, --verbose
Afficher des informations concernant le programme.
-q, --quiet
Ne pas signaler quand le programme se termine de maniere
anormale (quand commande se termine avec un signal) ou avec un
code de retour autre que zero.
Options standard GNU
--help Afficher un message d'aide sur la sortie standard et terminer
normalement.
-V, --version
Afficher le numero de version sur la sortie standard et terminer
normalement.
-- Terminer la liste des options.
BOGUES
Toutes les ressources ne sont pas disponibles avec toutes les versions
d'UNIX, ainsi certaines valeurs peuvent etre toujours a zero. La
selection proposee a ete essentiellement inspiree des donnees
disponibles sur des systemes BSD 4.2 ou 4.3.
La version 1.7 GNU de time ne supporte pas encore la localisation.
Le choix de la variable d'environnement TIME est une erreur. Il n'est
pas rare que des systemes comme autoconf(1) ou make(1) emploient une
variable avec le nom d'un utilitaire pour remplacer l'invocation
directe. L'utilisation de noms de variables comme MORE ou TIME au lieu
des noms de programmes conduit parfois a des problemes.
Il est plutot malheureux que -o ecrase le fichier plutot que d'y
ajouter ses informations (le comportement de -a devrait etre celui par
defaut).
Envoyez vos suggestions et vos rapports de bogues concernant GNU time a
bug-time@gnu.org. Veuillez indiquer la version de time que vous pouvez
connaitre en invoquant
time --version
ainsi que le systeme d'exploitation et le compilateur C utilises.
VOIR AUSSI
bash(1), tcsh(1), times(2), wait3(2)
TRADUCTION
La traduction francaise de cette page de manuel a ete creee par
Christophe Blaess , Stephan Rafin
, Thierry Vignaud ,
Francois Micaux, Alain Portal , Jean-Philippe
Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas
Huriaux , Nicolas Francois
, Florentin Duneau
, Simon Paillard , Denis Barbier , David Prevot
et Jean-Philippe MENGUAL
Cette traduction est une documentation libre ; veuillez vous reporter a
la GNU General Public License version 3
concernant les conditions
de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.
Si vous decouvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message a .
Pages du manuel de Linux 6.9.1 15 juin 2024 time(1)