NAVN¶

time - afvikl programmer og summer forbruget af systemressourcer

SYNOPSIS¶

time

[ -apqvV ] [ -f FORMAT ] [ -o FIL ]
[ --append ] [ --verbose ] [ --quiet ] [ --portability ]
[ --format=FORMAT ] [ --output=FIL ] [ --version ]
[ --help ] KOMMANDO [ ARGUMENTER ]

BESKRIVELSE¶

time afvikler programmet KOMMANDO med et angivet argument ARG.... Når KOMMANDO afsluttes viser time information om ressourcer brugt af KOMMANDO (på standardfejl, som standard). Hvis KOMMANDO findes med ikke-nul status viser time en advarselsbesked og afslutningsstatussen.

time bestemmer hvilken information der skal vises om ressourcerne brugt af KOMMANDO fra strengen FORMAT. Hvis intet format er angivet på kommandolinjen, men miljøvariablen TIME er angivet, så bruges dennes værdi som formatet. Ellers bruges et standardformat indbygget i time.

Tilvalg til time skal fremgår af kommandolinjen før KOMMANDO. Alt på kommandolinjen efter KOMMANDO sendes som argumenter til KOMMANDO.

TILVALG¶

-o FIL, --output=FIL

Skriv ressourcens forbrugsstatistik til FIL i stedet for til standardfejl. Som standard overskrives filen, så det tidligere indhold går tabt. Dette tilvalg er nyttigt til at indsamle information om interaktive programmer, og programmer der sender indhold ud på standardfejl.

-a, --append

Tilføj ressourcens forbrugsinformation til resultatfilen i stedet for at overskrive den. Dette tilvalg er kun nyttigt med tilvalgene »-o« eller »--output«.

-f FORMAT, --format FORMAT

Brug FORMAT som formatstrengen der kontrollerer resultatet af time. Se nedenfor for yderligere information.

--help

Vis en summering af kommandolinjetilvalgene og afslut.

-p, --portability

Brug den følgende formatstren for overholdelse af POSIX-standarden 1003.2:
real %e
user %U
sys %S

-v, --verbose

Brug det indbyggede uddybende format, der viser hver tilgængelig informationsdel om programmets ressourceforbrug på dets egen linje, med en engelsk beskrivelse af dets betydning.

--quiet

Rapporter ikke status for programmet selv om status er forskellig fra nul.

-V, --version

Vis versionsnummeret for time og afslut.

Formatering af resultatet¶

Formatstrengen FORMAT kontroller indholdet af time- resultatet. Formatstrengen kan angives via tilvalgene »-f« eller »--format«, »-v« eller »--verbose«, eller »-p« eller »--portability«. Hvis de ikke er angivet men TIME- miljøvariablen er angivet, så bruges dets værdi som formatstrengen. Ellers bruges en indbygget standard. Standardformatet er:
%Uuser %Ssystem %Eelapsed %PCPU (%Xtext+%Ddata %Mmax)k
%Iinputs+%Ooutputs (%Fmajor+%Rminor)pagefaults %Wswaps

Formatstrengen består normalt af »ressourcespecifikatorer« indblandet med ren tekst. Et procentegn (»%«) i formatstrengen gør at de følgende tegn fortolkes som en ressourcespecifikator, der svarer til formateringstegnene i funktionen printf(3).

En baglæns skråstreg (»\«) introducerer en »baglæns skråstreg undvigelse«, der oversættes til et enkelt udskrivningstegn i resultatet. »\t« viser et indryk-tegn (tab), »\n« viser en ny linje og »\\« viser en baglæns skråstreg. En baglæns skråstreg fulgt af et andet tegn viser et spørgsmålstegn (»?«) fulgt af en baglæns skråstreg for at indikere at en ugyldig baglæns skråstreg undvigelse blev angivet.

Anden tekst i formatstrengen kopieres ordret til resultatet. time indsætter altid en ny linje efter udskrivning af informationen om ressourceforbrug, så normalt ender formatstrenge ikke med et ny linje-tegn (eller »\n).«

Der er mange ressourcespecifikationer. Ikke alle ressourcer måles af alle versioner af Unix, så nogle af værdierne kan blive rapporteret som nul. Et tegn fulgt af et procenttegn, der ikke er vist i tabellen nedenfor medfører at et spørgsmåltegn (»?«) bliver vist, fulgt af det tegn, for at indikere at en ugyldig ressourcespecifikator blev angivet.

Ressourcespecifikatorerne, der er et supersæt af dem genkendt af den indbyggede tcsh(1) »time«-kommando, er:

EKSEMPLER¶

For at afvikle kommandoen »wc /etc/hosts« og vise standardinformationen:
time wc /etc/hosts

For at afvikle kommandoen »ls -Fs« og vis bare brugeren, systemet og samlet tidsforbrug:
time -f "\t%E real,\t%U user,\t%S sys" ls -Fs

For at redigere filen BORK og få »time« til at tilføje det forløbne tidsforbrug og antallet af signaler til filen »log«, så læs formatstrengen fra miljøvariablen »TIME«:
export TIME="\t%E,\t%k" # If using bash or ksh
setenv TIME "\t%E,\t%k" # If using csh or tcsh
time -a -o log emacs bork

Brugere af bash- skallen skal bruge en eksplicit sti for at afvikle den eksterne time- kommando og ikke den skalindbyggede variant. På systemer hvor time er installeret i /usr/bin, vil det første eksempel være
/usr/bin/time wc /etc/hosts

PRÆCISION¶

Den forløbne tid indsamles ikke atomisk med afviklignen af programmet; det medfører, i bizarre omstændigheder (hvis kommandoen time bliver stoppet eller skiftet ud i mellemtiden hvor programmet der tages tid på og når time beregner hvor lang tid afviklingen tog), kan være meget længere end den faktiske kørselstid.

Når den afviklende tid for en kommando er meget lig nul, kan nogle værdier (f.eks. anvendt cpu-procent) blive rapporteret som enten nul (hvilket er forkert) eller som et spørgsmåltegn.

Den meste information vist af time er afledt fra wait3(2)-systemkald. Tallene er kun så gode som dem returneret af wait3(2). På systemer, der ikke har et wait3(2)-kald, der returnerer statusinformation, så bruges times(2)-systemkaldet i stedet for. Det tilbyder dog meget mindre information end wait3(2), så på disse systemer rapporterer time de fleste ressourcer som nul.

Værdierne »%I« og »%O« er antagelig kun »reelle« inddata og uddata og inkluderer ikke dem fra mellemlagrende enheder. Meningen for »reelle« I/O rapporteret af »%I« og »%O« kan være forvirrende for arbejdsstationer, specielt dem uden diske.

DIAGNOSTIK¶

Kommandoen time returnerer når programmet stopper, eller bliver afsluttet af et signal. Hvis programmet blev afsluttet stoppet normalt er returværdien for time returværdien for programmet det afviklede og målte. Ellers er returværdien 128 plus nummeret for signalet, der fik programmet til at stoppe eller afslutte.

FORFATTER¶

time blev skrevet af David MacKenzie. Denne manualside blev tilføjet af Dirk Eddelbuettel <edd@debian.org>, Debian GNU/Linux-vedligeholderen, for brug i Debian GNU/Linux-distributionen men kan selvfølgelig bruges af andre.

SE OGSŶ

tcsh(1), printf(3)

OVERSÆTTELSE¶

Oversættere af denne manual til dansk Joe Hansen <joedalton2@yahoo.dk>

Denne oversættelse er gratis dokumentation; læs GNU General Public License version 3 eller nyere for ophavsretbetingelser. Der er INGEN ANSVAR.

Hvis du støder på fejl i oversættelsen af ​​denne vejledning, skal du sende en besked til debian-l10n-danish@lists.debian.org.