.\" -*- coding: UTF-8 -*- .\" Man page added by Dirk Eddelbuettel on 15 Apr 1996 .\" Thanks to Herbert Thielen for a patch .\" Copyright (C) Dirk Eddelbuettel but freely redistributable .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH TIME 1 "Debian GNU/Linux" .\" Always turn off hyphenation; it makes way too many mistakes in .\" technical documents. .nh .SH NOM time \- Lancer des programmes et résumer l'utilisation des ressources du système .SH SYNOPSIS .na .TP \fBtime\fP [ \fB\-apqvV\fP ] [ \fB\-f\fP\fI FORMAT\fP ] [ \fB\-o\fP\fI FICHIER\fP ] .br [ \fB\-\-append\fP ] [ \fB\-\-verbose\fP ] [ \fB\-\-quiet\fP ] [ \fB\-\-portability\fP ] .br [ \fB\-\-format=\fP\fIFORMAT\fP ] [ \fB\-\-output=\fP\fIFICHIER\fP ] [ \fB\-\-version\fP ] .br [ \fB\-\-help\fP ] \fICOMMANDE\fP [ \fIPARAMS\fP ] .ad b .if n .ad l .\" For nroff, turn off justification. .SH DESCRIPTION \fBtime\fP lance un programme \fICOMMANDE\fP avec des paramètres \fIPARAM...\fP donnés. Quand \fICOMMANDE\fP se termine, \fBtime\fP affiche des informations sur les ressources utilisées par \fICOMMANDE\fP (par défaut, sur la sortie d'erreur standard). Si \fICOMMANDE\fP quitte avec un autre retour que zéro, \fBtime\fP affiche un message d'avertissement et le code de retour. \fBtime\fP détermine les informations à afficher sur les ressources utilisées par la \fICOMMANDE\fP à partir de la chaîne \fIFORMAT\fP. Si aucun format n'est indiqué sur la ligne de commande mais que la variable d'environnement \fBTIME\fP est positionnée, sa valeur est utilisée pour le format. Sans cela, un format par défaut interne à \fBtime\fP est utilisé. Les otpions de \fBtime\fP doivent apparaître sur la ligne de commande avant \fICOMMANDE\fP. Tout ce qui vient après \fICOMMANDE\fP sur la ligne de commande est un paramètre de \fICOMMANDE\fP. .SH OPTIONS .TP \fB\-o\fP\fI FICHIER, \fP\fB\-\-output=\fP\fIFICHIER \fP Écrire les statistiques de l'utilisation des ressources dans \fIFICHIER\fP 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. .TP \fB\-a\fP, \fB\-\-append\fP 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\ ». .TP \fB\-f\fP\fI FORMAT, \fP\fB\-\-format\fP\fI FORMAT \fP Utiliser \fIFORMAT\fP comme chaîne de formatage pour contrôler l'affichage de \fBtime\fP. Voir les informations ci\-dessous. .TP \fB\-\-help\fP Afficher un résumé des options de la ligne de commande et quitter. .TP \fB\-p\fP, \fB\-\-portability\fP Utiliser la chaîne de format suivante conformément au standard POSIX 1003.2\ : real %e user %U sys %S .TP \fB\-v\fP, \fB\-\-verbose\fP 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. .TP \fB\-\-quiet\fP Ne pas renvoyer l'état du programme même s'il n'est pas zéro. .TP \fB\-V\fP, \fB\-\-version\fP Afficher le numéro de version de \fBtime\fP et quitter. .SH "FORMATAGE DE LA SORTIE" La chaîne de format \fIFORMAT\fP contrôle le contenu de la sortie de \fBtime\fP. 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 à \fBtime\fP 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 \fBprintf\fP(3). Une barre oblique inversée («\ \\ ») introduit une séquence d'échappement traduite en un seul caractère affichable sur la sortie. «\ \et\ » génère une tabulation, «\ \en\ » un retour à la ligne, «\ \e\e\ » 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. \fBtime\fP 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 («\ \en\ »). 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. .\" No blank line between the resource specifiers below so that they .\" are more compactly listed. .PD 0 Les spécificateurs de ressources, qui vont plus loin que ceux reconnus par la commande «\ time\ » de \fBtcsh\fP(1), sont\ : .RS .IP % Un signe «\ %\ » littéral. .IP C Nom et arguments de la ligne de commande de la commande à examiner. .IP D Taille moyenne des données non partagées du processus, en kilooctets. .IP E Temps réel (de la pendule) mis par le processus, en [heures:]minutes:secondes. .IP 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. .IP I Nombre d'entrées dans le système de fichiers par le processus. .IP K Mémoire moyenne (donnée + pile + code) utilisée par le processus, en kilooctets. .IP M Taille maximale du processus en mémoire physique durant son exécution, en kilooctets. .IP \fBO\fP Nombre de sorties du système de fichiers par le processus. .IP 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. .IP 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. .IP S Nombre total de secondes\-CPU passées par le système du fait du processus (en mode noyau). .IP U Nombre total de secondes\-CPU passées directement par le processus (en mode utilisateur). .IP W Nombre de fois où le processus a été envoyé sur la mémoire de swap. .IP X Taille moyenne du code partagé du processus, en kilooctets. .IP 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. .IP c Nombre de fois où le processus a été préempté involontairement (sa tranche de temps ayant expiré). .IP e Temps réel (sur la pendule) écoulé consommé par le processus, en secondes. .IP k Nombre de signaux délivrés au processus. .IP p Taille moyenne de la pile non partagée du processus, en kilooctets. .IP r Nombre de messages reçus par le processus sur un socket. .IP s Nombre de messages envoyés par le processus sur un socket. .IP t Taille moyenne du processus en mémoire physique, en kilooctets. .IP 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. .IP x Code de retour de la commande. .RS .SH 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 "\et%E real,\et%U user,\et%S sys\" ls \-Fs 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="\et%E,\et%k" # Si on utilise bash ou ksh setenv TIME "\et%E,\et%k" # Si on utilise csh ou tcsh time \-a \-o log emacs fofo Les utilisateurs de l'interpréteur \fBbash\fP doivent utiliser un chemin explicite pour lancer une commande \fBtime\fP externe, et non la variante de la commande interne à l'interpréteur. Sur un système où \fBtime\fP est installé dans \fI/usr/bin\fP, le premier exemple deviendrait /usr/bin/time wc /etc/hosts .SH 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 \fBtime\fP s'est arrêtée ou s'est mélangée entre le temps de fin du programme et celui passé par \fBtime\fP à 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 \fBtime\fP proviennent de l'appel système \fBwait3\fP(2). Les chiffres sont aussi bons que ceux renvoyés par \fBwait3\fP(2). Sur des systèmes n'ayant pas l'appel \fBwait3\fP(2) pour renvoyer des informations d'état, l'appel système \fBtimes\fP(2) est utilisé à la place. Il fournit toutefois beaucoup moins d'informations que \fBwait3\fP(2), donc sur de tels systèmes, \fBtime\fP 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. .SH DIAGNOSTICS La commande \fBtime\fP 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 \fBtime\fP 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. .SH AUTEUR \fBtime\fP a été écrit par David MacKenzie. Cette page de manuel a été ajoutée par Dirk Eddelbuettel , 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. .SH "VOIR AUSSI" \fBtcsh\fP(1), \fBprintf\fP(3) .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-Philippe MENGUAL . .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 .