TIME(1) Manuel de l'utilisateur Linux TIME(1)
NOM
time(1,2,n) - Chronomtrer ou valuer les ressources employes par une com-
mande simple.
SYNOPSIS
time(1,2,n) [options] commande [arguments...]
DESCRIPTION
La fonction time(1,2,n) lance le programme reprsent par la commande
indique, avec les arguments fournis. Lorsque la commande se termine,
time(1,2,n) affiche un message sur la sortie standard contenant des statis-
tiques sur l'excution du programme. Ces statistiques contiennent (i)
le temps coul entre l'invocation et la fin de la commande, (ii) le
temps CPU coul en mode utilisateur (la somme des valeurs tms_utime
et tms_cutime de la structure struct tms fournie par l'appel systme
times(2)), et (iii) le temps CPU pass en mode systme (la somme des
champs tms_stime et tms_cstime de la struct tms fournie par l'appel
systme times(2)).
OPTIONS
-p Dans la localisation POSIX, utiliser le format traditionnel
"real %f\nuser %f\nsys %f\n"
(avec des nombres exprims en secondes) o le nombre de
dcimales dans le format %f n'est pas prcis, mais suffisant
pour exprimer le top d'horloge prcisment.
ENVIRONNEMENT
Les variables LANG, LC_ALL, LC_CTYPE, LC_MESSAGES, LC_NUMERIC, NLSPATH
et PATH sont utilises. La dernire sert rechercher la commande.
Les autres servent au formatage du texte et de la sortie.
CODE RENVOY
Si la commande a t invoque, le code de sortie est celui de la
commande. Sinon, il s'agit de 127 si la commande n'a pas t
trouve, 126 si elle a t trouve mais n'a pas pu tre invoque,
et une autre valeur non-nulle (1-125) si quelque chose d'autre a
chou.
VOIR AUSSI
times(2),
VERSION GNU
Suit une description de la version(1,3,5) GNU 1.7 de time(1,2,n). Contrairement au
nom de cet utilitaire, GNU ajoute un grand nombre d'informations
utiles, concernant non seulement le temps coul, mais galement
d'autres ressources, comme la mmoire, les entres-sorties ou les
communications IPC (si disponibles). La sortie est formate en util-
isant une chane qui peut tre transmise avec l'option -f ou en util-
isant la variable d'environnement TIME.
La chane de format par dfaut 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)
real %e
user %U
sys %S
est utilis.
Chane de format
Le format est interprt comme d'habitude la manire de
printf(1,3,1 builtins)(3). Les caractres ordinaires sont copis directement, les
tabulations sauts de lignes et baskslashes sont protgs par \t, \n
et \\. Un signe pourcent est reprsent par %%, sinon % indique une
conversion. Le programme time(1,2,n) ajoutera toujours un saut de ligne la
fin de la sortie. Les conversions se trouvent ci-dessous. Toutes
celles utilises par tcsh(1) sont disponibles.
Temps
%E Temps rel coul (en [heures:]minutes:secondes).
%e (pas avec tcsh.) Temps rel coul (en secondes).
%S Nombre total de secondes-CPU pass par le processus en mode
noyau.
%U Nombre total de secondes-CPU pass par le processus en mode
utilisateur.
%P Pourcentage de CPU obtenu par ce job, calcul comme (%U + %S) /
%E.
Mmoire
%M Taille maximale du processus en mmoire physique durant son
excution, en kilo-octets.
%t (pas avec tcsh) Taille moyenne du processus en mmoire physique
durant son excution, en kilo-octets.
%K Mmoire moyenne (donne + pile + code) utilise par le pro-
cessus, en kilo-octets.
%D Taille moyenne des donnes non-partages du processus, en
kilo-octets.
%p (pas avec tcsh.) Taille moyenne de la pile non-partage du pro-
cessus, en kilo-octets.
%X Taille moyenne du code partag du processus, en kilo-octets.
%Z (pas avec tcsh.) Taille de page du systme, en octets. Ceci est
une constante sur un systme, mais varie de systme en
systme.
%F Nombre de fautes de pages majeures durant l'excution. Ce sont
les fautes o des pages ont d tre recharges depuis le
disque.
%R Nombre de fautes de pages mineures durant l'excution. Ce sont
les fautes o des pages ne sont plus valides, mais n'ont pas
encore t rutilises. Les donnes y sont encore
prsentes et seules les tables systme doivent tre mises
jour.
%W Nombre de fois o le processus a t envoy sur la mmoire
de swap.
%c Nombre de fois o le processus a t prempt involontaire-
ment (sa tranche de temps ayant expir).
%w Nombre de fois o le processus a t commut volontairement,
en passant en attente par exemple de la fin d'une entre-sor-
tie.
Entres/Sorties
%I Nombre de lecture depuis un fichier
%O Nombre d'criture dans un fichier
%r Nombre de messages reus par le processus sur une socket.
%s Nombre de messages envoys par le processus sur une socket.
%k Nombre de signaux dlivrs au processus.
%C (pas avec tcsh.) Nom de la commande examine avec ses argu-
ments.
%x (pas avec tcsh.) Code de retour de la commande.
OPTIONS GNU
-f FORMAT, --format=FORMAT
Prciser le format de sortie, en crasant celui mentionn
ventuellement dans la variable d'environnement TIME.
-p, --portability
Utilise le format de sortie portable.
-o FICHIER, --output=FICHIER
Ne pas envoyer les rsultats sur la sortie d'erreur standard,
mais craser le fichier indiqu.
-a, --append
En conjonction avec -o, ne pas craser le fichier, mais ajouter
les rsultats la fin.
-v, --verbose
Afficher des informations concernant le programme.
OPTIONS STANDARDS GNU
--help Afficher un message d'aide(1,5) sur la sortie standard et se terminer
normalement.
-V, --version
Afficher un numro de version(1,3,5) sur la sortie standard et se ter-
miner normalement.
-- Fin de la liste des options.
BOGUES
Toutes les ressources ne sont pas disponibles avec toutes les versions
d'Unix, ainsi certaines valeurs peuvent tre toujours zro. La
slection propose a t essentiellement inspire des donnes
disponibles sur systme 4.2 ou 4.3BSD.
La version(1,3,5) 1.7 GNU de time(1,2,n) ne supporte pas encore la localisation.
Le choix de la variable d'environnement TIME est une erreur. Il n'est
pas rare que des systmes comme autoconf ou make emploient une vari-
able 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 programme conduit parfois des problmes.
Il est plutt malheureux que -o crase le fichier plutt que d'y
ajouter ses informations (le comportement de -a devrait tre celui par
dfaut).
Envoyez vos rapports de bogues et suggestions pour la version(1,3,5) GNU de
time(1,2,n)
bug-utils@prep.ai.mit.edu
Indiquez bien la version(1,3,5) de time(1,2,n) , que vous employez, en invoquant
time(1,2,n) --version
ainsi que le systme d'exploitation et le compilateur C utiliss.
VOIR AUSSI
tcsh(1), times(2), wait3(2)
AUTEURS
David Keppel
Version originale.
David MacKenzie
POSIX, autoconf, GNU getopt(1,3,3 Getopt::Std), documentation, corrections
de bogues et amliorations.
Arne Henrik Juul
Aide la portabilit.
Franois Pinard
Aide la portabilit.
TRADUCTION
Christophe BLAESS, 2001-2003.
LDP 23 juillet 2003 TIME(1)