Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] time - Chronométrer ou évaluer les ressources employées par une commande simple. [size=18] [b]Résumé[/b] [/size] [b][i]time [ options ] commande [ arguments... ] [/i][/b] [size=18] [b]Description[/b] [/size] La fonction [b]time[/b] lance le programme représenté par la [i]commande[/i] indiquée, avec les [i]arguments[/i] fournis. Lorsque la [i]commande[/i] se termine, [b]time[/b] affiche un message sur la sortie standard contenant des statistiques sur l'exécution 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 [i]tms_utime[/i] et [i]tms_cutime[/i] de la structure [i]struct tms[/i] fournie par l'appel système [b]times (2)),[/b] et (iii) le temps CPU passé en mode système (la somme des champs [i] tms_stime[/i] et [i]tms_cstime[/i] de la [i]struct tms[/i] fournie par l'appel système [b]times (2)).[/b] [size=18] [b]Options[/b] [/size] [b]-p[/b] [table][row][col]    [/col][col]Dans la localisation POSIX, utiliser le format traditionnel [b][/b] .in +5 "real %fenuser %fensys %fen" .in -5 [b][/b] (avec des nombres exprimés en secondes) où le nombre de décimales dans le format %f n'est pas précisé, mais suffisant pour exprimer le top d'horloge précisément.[/col][/row][/table] [size=18] [b]Environnement[/b] [/size] Les variables LANG, LC_ALL, LC_CTYPE, LC_MESSAGES, LC_NUMERIC, NLSPATH et PATH sont utilisées. La dernière sert à rechercher la [b]commande .[/b] Les autres servent au formatage du texte et de la sortie. [size=18] [b]Code renvoyÉ[/b] [/size] Si la [i]commande[/i] a été invoquée, le code de sortie est celui de la [b]commande .[/b] Sinon, il s'agit de 127 si la [i]commande[/i] n'a pas été trouvée, 126 si elle a été trouvée mais n'a pas pu être invoquée, et une autre valeur non-nulle (1-125) si quelque chose d'autre a échoué. [size=18] [b]Voir aussi[/b] [/size] [b]times (2),[/b] 2 [size=18] [b]Version gnu[/b] [/size] Suit une description de la version GNU 1.7 de [b]time .[/b] 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 mémoire, les entrées-sorties ou les communications IPC (si disponibles). La sortie est formatée en utilisant une chaîne qui peut être transmise avec l'option -f ou en utilisant la variable d'environnement TIME.     La chaîne de format par défaut est [b][/b] .in +3 %Uuser %Ssystem %Eelapsed %PCPU (%Xtext+%Ddata %Mmax)k [b][/b] %Iinputs+%Ooutputs (%Fmajor+%Rminor)pagefaults %Wswaps [b][/b] .in -3     Lorsque l'option -p est fournie, le format de sortie (portable) [b][/b] .in +3 real %e [b][/b] user %U [b][/b] sys %S [b][/b] .in -3 est utilisé. [b]Chaîne de format[/b] Le format est interprété comme d'habitude à la manière de [b]printf (3).[/b] Les caractères ordinaires sont copiés directement, les tabulations sauts de lignes et baskslashes sont protégés par et, en et ee. Un signe pourcent est représenté par %%, sinon % indique une conversion. Le programme [b]time[/b] ajoutera toujours un saut de ligne à la fin de la sortie. Les conversions se trouvent ci-dessous. Toutes celles utilisées par [b]tcsh (1)[/b] sont disponibles.     [b]Temps[/b] [b]%E[/b] [table][row][col]    [/col][col]Temps réel écoulé (en [heures:]minutes:secondes).[/col][/row][/table] [b]%e[/b] [table][row][col]    [/col][col](pas avec tcsh.) Temps réel écoulé (en secondes).[/col][/row][/table] [b]%S[/b] [table][row][col]    [/col][col]Nombre total de secondes-CPU passé par le processus en mode noyau.[/col][/row][/table] [b]%U[/b] [table][row][col]    [/col][col]Nombre total de secondes-CPU passé par le processus en mode utilisateur.[/col][/row][/table] [b]%P[/b] [table][row][col]    [/col][col]Pourcentage de CPU obtenu par ce job, calculé comme (%U + %S) / %E.[/col][/row][/table]     [b]Mémoire[/b] [b]%M[/b] [table][row][col]    [/col][col]Taille maximale du processus en mémoire physique durant son exécution, en kilo-octets.[/col][/row][/table] [b]%t[/b] [table][row][col]    [/col][col](pas avec tcsh) Taille moyenne du processus en mémoire physique durant son exécution, en kilo-octets.[/col][/row][/table] [b]%K[/b] [table][row][col]    [/col][col]Mémoire moyenne (donnée + pile + code) utilisée par le processus, en kilo-octets.[/col][/row][/table] [b]%D[/b] [table][row][col]    [/col][col]Taille moyenne des données non-partagées du processus, en kilo-octets.[/col][/row][/table] [b]%p[/b] [table][row][col]    [/col][col](pas avec tcsh.) Taille moyenne de la pile non-partagée du processus, en kilo-octets.[/col][/row][/table] [b]%X[/b] [table][row][col]    [/col][col]Taille moyenne du code partagé du processus, en kilo-octets.[/col][/row][/table] [b]%Z[/b] [table][row][col]    [/col][col](pas avec tcsh.) Taille de page du système, en octets. Ceci est une constante sur un système, mais varie de système en système.[/col][/row][/table] [b]%F[/b] [table][row][col]    [/col][col]Nombre de fautes de pages majeures durant l'exécution. Ce sont les fautes où des pages ont dû être rechargées depuis le disque.[/col][/row][/table] [b]%R[/b] [table][row][col]    [/col][col]Nombre de fautes de pages mineures durant l'exécution. Ce sont les fautes où des pages ne sont plus valides, mais n'ont pas encore été réutilisées. Les données y sont encore présentes et seules les tables système doivent être mises à jour.[/col][/row][/table] [b]%W[/b] [table][row][col]    [/col][col]Nombre de fois où le processus a été envoyé sur la mémoire de swap.[/col][/row][/table] [b]%c[/b] [table][row][col]    [/col][col]Nombre de fois où le processus a été préempté involontairement (sa tranche de temps ayant expiré).[/col][/row][/table] [b]%w[/b] [table][row][col]    [/col][col]Nombre de fois où le processus a été commuté volontairement, en passant en attente par exemple de la fin d'une entrée-sortie.[/col][/row][/table]     [b]Entrées/Sorties[/b] [b]%I[/b] [table][row][col]    [/col][col]Nombre de lecture depuis un fichier[/col][/row][/table] [b]%O[/b] [table][row][col]    [/col][col]Nombre d'écriture dans un fichier[/col][/row][/table] [b]%r[/b] [table][row][col]    [/col][col]Nombre de messages reçus par le processus sur une socket.[/col][/row][/table] [b]%s[/b] [table][row][col]    [/col][col]Nombre de messages envoyés par le processus sur une socket.[/col][/row][/table] [b]%k[/b] [table][row][col]    [/col][col]Nombre de signaux délivrés au processus.[/col][/row][/table] [b]%C[/b] [table][row][col]    [/col][col](pas avec tcsh.) Nom de la commande examinée avec ses arguments.[/col][/row][/table] [b]%x[/b] [table][row][col]    [/col][col](pas avec tcsh.) Code de retour de la commande.[/col][/row][/table] [size=18] [b]Options[/b] [/size] [b][i]-f FORMAT , --format= FORMAT[/i][/b] [table][row][col]    [/col][col]Préciser le format de sortie, en écrasant celui mentionné éventuellement dans la variable d'environnement TIME.[/col][/row][/table] [b]-p, --portability[/b] [table][row][col]    [/col][col]Utilise le format de sortie portable.[/col][/row][/table] [b][i]-o FICHIER , --output= FICHIER[/i][/b] [table][row][col]    [/col][col]Ne pas envoyer les résultats sur la sortie d'erreur standard, mais écraser le fichier indiqué.[/col][/row][/table] [b]-a, --append[/b] [table][row][col]    [/col][col]En conjonction avec -o, ne pas écraser le fichier, mais ajouter les résultats à la fin.[/col][/row][/table] [b]-v, --verbose[/b] [table][row][col]    [/col][col]Afficher des informations concernant le programme.[/col][/row][/table] [size=18] [b]Options[/b] [/size] [b]--help[/b] [table][row][col]    [/col][col]Afficher un message d'aide sur la sortie standard et se terminer normalement.[/col][/row][/table] [b]-V, --version[/b] [table][row][col]    [/col][col]Afficher un numéro de version sur la sortie standard et se terminer normalement.[/col][/row][/table] [b]--[/b] [table][row][col]    [/col][col]Fin de la liste des options.[/col][/row][/table] [size=18] [b]Bugs[/b] [/size] Toutes les ressources ne sont pas disponibles avec toutes les versions d'Unix, ainsi certaines valeurs peuvent être toujours à zéro. La sélection proposée a été essentiellement inspirée des données disponibles sur système 4.2 ou 4.3BSD.     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 systèmes comme autoconf ou make 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 programme conduit parfois à des problèmes.     Il est plutôt malheureux que -o écrase le fichier plutôt que d'y ajouter ses informations (le comportement de -a devrait être celui par défaut).     Envoyez vos rapports de bogues et suggestions pour la version GNU de [b]time[/b] à [b][/b] [i]bug-utils@prep.ai.mit.edu[/i] [b][/b] Indiquez bien la version de [b]time ,[/b] que vous employez, en invoquant [b][/b] [i]time --version[/i] [b][/b] ainsi que le système d'exploitation et le compilateur C utilisés. [size=18] [b]Voir aussi[/b] [/size] [b]tcsh (1),[/b] [b]times (2),[/b] [b]wait3 (2)[/b] [size=18] [b]Auteurs[/b] [/size] [/col][/row][/table] "David Keppel" [table][row][col]    [/col][col]Version originale.[/col][/row][/table] "David MacKenzie" [table][row][col]    [/col][col]POSIX, autoconf, GNU getopt, documentation, corrections de bogues et améliorations.[/col][/row][/table] "Arne Henrik Juul" [table][row][col]    [/col][col]Aide à la portabilité.[/col][/row][/table] "François Pinard" [table][row][col]    [/col][col]Aide à la portabilité.[/col][/row][/table] [size=18] [b]Traduction[/b] [/size] Christophe BLAESS, 2001-2003.
Fichier