Ubuntu Manpage: time - Lancer des programmes et résumer l'utilisation des ressources du système

NOM

       time - Lancer des programmes et résumer l'utilisation des ressources du système

SYNOPSIS

       time   [ -apqvV ] [ -f FORMAT ] [ -o FICHIER ]
              [ --append ] [ --verbose ] [ --quiet ] [ --portability ]
              [ --format=FORMAT ] [ --output=FICHIER ] [ --version ]
              [ --help ] COMMANDE [ PARAMS ]

DESCRIPTION

       time lance un programme COMMANDE avec des paramètres PARAM... donnés. Quand COMMANDE se
       termine, time affiche des informations sur les ressources utilisées par COMMANDE (par
       défaut, sur la sortie d'erreur standard). Si COMMANDE quitte avec un autre retour que
       zéro, time affiche un message d'avertissement et le code de retour.

       time détermine les informations à afficher sur les ressources utilisées par la COMMANDE à
       partir de la chaîne FORMAT. Si aucun format n'est indiqué sur la ligne de commande mais
       que la variable d'environnement TIME est positionnée, sa valeur est utilisée pour le
       format. Sans cela, un format par défaut interne à time est utilisé.

       Les otpions de time doivent apparaître sur la ligne de commande avant COMMANDE. Tout ce
       qui vient après COMMANDE sur la ligne de commande est un paramètre de COMMANDE.

OPTIONS

-o FICHIER, --output=FICHIER
Écrire les statistiques de l'utilisation des ressources dans FICHIER au lieu du
flux de la sortie standard. Par défaut, cela écrase le fichier, détruisant son
contenu précédent. Cette option sert à récupérer des informations sur des
programmes interactifs ou qui produisent un affichage sur la sortie d'erreur
standard.

-a, --append
Mettre les informations de l'utilisation des ressources à la fin du fichier de
sortie au lieu de l'écraser. Cette option n'est utile qu'avec l'option « -o » ou
« --output ».

-f FORMAT, --format FORMAT
Utiliser FORMAT comme chaîne de formatage pour contrôler l'affichage de time. Voir
les informations ci-dessous.

--help Afficher un résumé des options de la ligne de commande et quitter.

-p, --portability
Utiliser la chaîne de format suivante conformément au standard POSIX 1003.2 :
real %e
user %U
sys %S

-v, --verbose
Utiliser le format d'affichage interne qui affiche toute les informations
disponibles sur l'utilisation des ressources par le programme sur une ligne dédiée,
avec une description en anglais de sa signification.

--quiet
Ne pas renvoyer l'état du programme même s'il n'est pas zéro.

-V, --version
Afficher le numéro de version de time et quitter.

FORMATAGE DE LA SORTIE

La chaîne de format FORMAT contrôle le contenu de la sortie de time. La chaîne de format
peut être définie en utilisant les options « -f » ou « --format », « -v » ou
« --verbose », « -p » ou « --portability ». Si elles ne sont pas données mais si la
variable d'environnement « TIME » est positionnée, sa valeur est utilisée pour le
formatage. Sans cela, un format par défaut interne à time est utilisé. Le format par
défaut est :
%Uuser %Ssystem %Eelapsed %PCPU (%Xtext+%Ddata %Mmax)k
%Iinputs+%Ooutputs (%Fmajor+%Rminor)pagefaults %Wswaps

La chaîne de formatage consiste généralement dans des « spécificateurs de ressource »
interprétés en texte brut. Un signe pour-cent (« % ») dans la chaîne de formatage fait
interpréter les caractères consécutifs comme un spécificateur de ressource, ce qui revient
aux caractères de formatage de la fonction printf(3).

Une barre oblique inversée (« \[u00A0]») introduit une séquence d'échappement traduite en
un seul caractère affichable sur la sortie. « \t » génère une tabulation, « \n » un retour
à la ligne, « \\ » une barre oblique inversée. Une barre oblique inversée suivie d'un
autre caractère affiche un point d'interrogation (« ? ») suivi d'une barre oblique pour
indiquer qu'une séquence d'échappement non valide a été donnée.

Tout autre texte dans la chaîne de formatage est copié tel quel sur la sortie. time
affiche toujours un retour à la ligne après les informations sur l'utilisation des
ressources, donc en principe, les chaînes de formatage ne se terminent pas par un
caractère de retour à la ligne (« \n »).

Il existe de nombreuses spécifications des ressources. Toutes les ressources ne sont pas
examinées par toutes les versions d'Unix, donc certaines valeurs pourraient renvoyer zéro.
Tout caractère après un signe pour-cent non listé dans le tableau ci-dessous affiche un
point d'interrogation (« ? ») suivi du caractère, pour indiquer qu'un spécificateur de
ressource non valide a été fourni.

Les spécificateurs de ressources, qui vont plus loin que ceux reconnus par la commande
« time » de tcsh(1), sont :
% Un signe « % » littéral.
C Nom et arguments de la ligne de commande de la commande à examiner.
D Taille moyenne des données non partagées du processus, en kilooctets.
E Temps réel (de la pendule) mis par le processus, en
[heures:]minutes:secondes.
F Nombre d'erreurs majeures ou exigeant une E/S qui se sont produites durant
l'exécution du processus. Il s'agit d'erreurs par lesquelles la page est
sortie de la mémoire primaire.
I Nombre d'entrées dans le système de fichiers par le processus.
K Mémoire moyenne (donnée + pile + code) utilisée par le processus, en
kilooctets.
M Taille maximale du processus en mémoire physique durant son exécution, en
kilooctets.
O Nombre de sorties du système de fichiers par le processus.
P Pourcentage du processeur utilisé par ce processus. Il s'agit des temps
utilisateur + système divisés par le temps total d'exécution. Il affiche
aussi un signe de pourcentage.
R Nombre d'erreurs de pages mineures ou rattrapables. Ce sont les erreurs où
des pages ne sont plus valides (et donc sont des erreurs), mais n'ont pas
encore été remplacées par d'autres pages virtuelles. Les données y sont
encore présentes et seules les tables système doivent être mises à jour.
S Nombre total de secondes-CPU passées par le système du fait du processus (en
mode noyau).
U Nombre total de secondes-CPU passées directement par le processus (en mode
utilisateur).
W Nombre de fois où le processus a été envoyé sur la mémoire de swap.
X Taille moyenne du code partagé du processus, en kilooctets.
Z Taille de page du système, en octets. Cela est une constante sur un système,
mais varie de système en système.
c Nombre de fois où le processus a été préempté involontairement (sa tranche
de temps ayant expiré).
e Temps réel (sur la pendule) écoulé consommé par le processus, en secondes.
k Nombre de signaux délivrés au processus.
p Taille moyenne de la pile non partagée du processus, en kilooctets.
r Nombre de messages reçus par le processus sur un socket.
s Nombre de messages envoyés par le processus sur un socket.
t Taille moyenne du processus en mémoire physique, en kilooctets.
w Nombre de fois où le processus a été commuté volontairement, en passant en
attente par exemple de la fin d'une entrée-sortie.
x Code de retour de la commande.

EXEMPLES

       Pour lancer la commande « wc /etc/hosts » et afficher les informations par défaut :
            time wc /etc/hosts

       Pour lancer la commande « ls -Fs » et afficher le temps d'utilisateur, du système et
       total :
            time -f "\t%E real,\t%U user,\t%S sys

       Pour éditer le fichier FOFO et que « time » indique le temps écoulé et le nombre de
       signaux dans le fichier « journal » (log), en lisant la chaîne de formatage depuis la
       variable d'environnement « TIME » :
            export TIME="\t%E,\t%k" # Si on utilise bash ou ksh
            setenv TIME "\t%E,\t%k" # Si on utilise csh ou tcsh
            time -a -o log emacs fofo

       Les utilisateurs de l'interpréteur bash doivent utiliser un chemin explicite pour lancer
       une commande time externe, et non la variante de la commande interne à l'interpréteur. Sur
       un système où time est installé dans /usr/bin, le premier exemple deviendrait
            /usr/bin/time wc /etc/hosts

ATTENTION

       Le temps écoulé n'est pas calculé de manière atomique pendant l'exécution du programme ;
       donc dans des circonstances étranges (si la commande time s'est arrêtée ou s'est mélangée
       entre le temps de fin du programme et celui passé par time à calculer), il pourrait être
       beaucoup plus important que le temps d'exécution réel.

       Quand le temps d'exécution d'une commande est proche de zéro, certaines valeurs (comme le
       pourcentage de processeur utilisé) pourraient afficher zéro (ce qui est faux) ou un point
       d'interrogation.

       La plupart des informations affichées par time proviennent de l'appel système wait3(2).
       Les chiffres sont aussi bons que ceux renvoyés par wait3(2). Sur des systèmes n'ayant pas
       l'appel wait3(2) pour renvoyer des informations d'état, l'appel système times(2) est
       utilisé à la place. Il fournit toutefois beaucoup moins d'informations que wait3(2), donc
       sur de tels systèmes, time indique la majorité des informations comme étant de zéro.

       Les valeurs « %I » et « %O » sont censées n'être que des entrées et sorties « réelles » et
       elles n'incluent pas celles fournies par les périphériques de mise en cache. Le sens des
       valeurs E/S « réelles » indiquées par « %I » et « %O » peut être mélangé sur les stations
       de travail, surtout celles sans disque.

DIAGNOSTICS

       La commande time signale quand le programme quitte, s'arrête ou quand un signal de fin lui
       est envoyé. Si le programme quitte normalement, le code de retour de time est celui du
       programme exécuté et analysé. Sinon, le code de retour est 128 et le numéro du signal qui
       a arrêté ou terminé le programme.

AUTEUR

       time a été écrit par David MacKenzie. Cette page de manuel a été ajoutée par Dirk
       Eddelbuettel <edd@debian.org>, le responsable Debian GNU/Linux, pour une utilisation dans
       la distribution Debian GNU/Linux, mais elle peut bien sûr être utilisée pour les autres.

VOIR AUSSI

       tcsh(1), printf(3)

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-Philippe MENGUAL
       <jpmengual@debian.org>
       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⟩.

                                         Debian GNU/Linux                                 TIME(1)