Seth Woolley's Man Viewer

Manual for time - man time

([section] manual, -k keyword, -K [section] search, -f whatis)
man plain no title

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)

References for this manual (incoming links)