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, \n 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.06 31 octobre 2023 time(1)