time(1) General Commands Manual time(1)

time - změří čas vykonání příkazu nebo vypíše využití zdrojů

time [option ...] command [argument ...]

Příkaz time spustí zadaný program příkaz s uvedenými argumenty. Když příkaz skončí, time vypíše na standardní chybový vystup zprávu se časovými statistikami o běhu programu. Tyto statistiky se skládají z (i) skutečného uběhnutého času od spuštění do ukončení, (ii) CPU času uživatele (součet hodnot tms_utime a tms_cutime ze struct tms, navrácené voláním times(2)), a (iii) CPU času systému (součet hodnot tms_stime a tms_cstime ze struct tms navrácené voláním times(2)).

Note: some shells (e.g., bash(1)) have a built-in time command that provides similar information on the usage of time and possibly other resources. To access the real command, you may need to specify its pathname (something like /usr/bin/time).

Pokud je locale nastaveno na POSIX, použije tradiční přesný formát

"real %f\nuser %f\nsys %f\n"

(s čísly v sekundách) kde počet desetinných míst ve výstupu pro %f není určen, ale dostačuje k vyjádření přesnosti systému (clock tick accuracy) a je nejméně jedno.

Pokud byl příkaz spuštěn, je návratovou hodnotou návratová hodnota příkazu. V opačném případě je to 127, pokud příkaz nebyl nalezen, 126, pokud byl nalezen, ale nemohl být spuštěn a další nenulová hodnota (1–125), pokud se pokazilo něco jiného.

The variables LANG, LC_ALL, LC_CTYPE, LC_MESSAGES, LC_NUMERIC, and NLSPATH are used for the text and formatting of the output. PATH is used to search for command.

Následuje popis GNU verze 1.7 programu time. Bez ohledu na název utility obsahuje její výstup spoustu užitečných informací, nejen o využitém času, ale i o dalších zdrojích jako pamět, I/O a IPC volání (kde je to možné). Výstup je formátován pomocí formátovacího řetězce, který může být určen volbou -f nebo proměnnou prostředí TIME.

Výchozí hodnota formátovacího řetězce je


%Uuser %Ssystem %Eelapsed %PCPU (%Xtext+%Ddata %Mmax)k
%Iinputs+%Ooutputs (%Fmajor+%Rminor)pagefaults %Wswaps

Pokud je použita volba -p, je použit (přenositelný) výstupní formát:


real %e
user %U
sys %S

Formát je interpretován způsobem obvyklým z printf. Obyčejné znaky jsou použity přímo, tabulátor, nový řádek a zpětné lomítko jsou escapovány pomocí \t, \n a \\, znak % je reprezentován jako %%, samostatně označuje převod. Program time vždy sám přidá závěrečný konec řádku. The conversions follow. Jsou podporovány všechny, které používá tcsh(1).

Čas

%E
Skutečný uplynulý čas ([hodiny:]minuty:sekundy).
%e
(Není v tcsh(1).) Skutečný uplynulý čas (v sekundách).
%S
Celkový počet sekund CPU, které proces strávil v módu jádra.
%U
Celkový počet sekund CPU, které proces strávil v uživatelském módu.
%P
Procentní podíl z CPU, který proces dostal, spočtený jako (%U + %S) / %E.

Paměť

%M
Maximální velikost fyzické paměti využité procesem, dosažená za jeho běhu, v kilobajtech.
%t
(Není v tcsh(1).) Průměrná fyzické paměti využité procesem, v kilobajtech.
%K
Průměrné celkové (data+zásobník+text) využití paměti procesem, v kilobajtech.
%D
Průměrná velikost odsdíleného prostoru dat procesu, v kilobajtech.
%p
(Není v tcsh(1).) Průměrná velikost odsdíleného prostoru zásobníku procesu, v kilobajtech.
%X
Průměrná velikost odsdíleného prostoru textu, v kilobajtech.
%Z
(Není v tcsh(1).) Velikost stránky systému, v bajtech. Toto je systémová konstanta, která se mezi systémy liší.
%F
Počet závažných stránkovacích chyb, ke kterým došlo při běhu procesu. To jsou případy, kdy musela být stránka načtena z disku.
%R
Počet podružných stránkovacích chyb. To jsou chyby stránek, které nejsou platné, ale ještě nebyly zabrány jinými virtuálními stránkami. Tudíž data ve stránce jsou stále platná, ale tabulky systému musejí být aktualizovány.
%W
Kolikrát byl proces odstránkován z paměti.
%c
Kolikrát proces nedobrovolně změnil kontext (protože vypršel přidělený čas).
%w
Počet čekání: kolikrát program dobrovolně změnil kontext, např. při čekání na dokončení I/O operace.

I/O

%I
Number of file system inputs by the process.
%O
Number of file system outputs by the process.
%r
Počet zpráv socketů přijatých procesem.
%s
Počet zpráv socketů odeslaných procesem.
%k
Počet signálů doručených procesu.
%C
(Není v tcsh(1).) Jméno a argumenty příkazové řádky časovaného příkazu.
%x
(Není v tcsh(1).) Návratová hodnota příkazu.

Určuje výstupní formát, má přednost před určením formátu proměnnou prostředí TIME.
Použije přenositený výstupní formát.
Neposílá výsledek na stderr, ale přepíše určený soubor.
(Použito společně s -o.) Nepřepíše soubor, připojí výsledek k němu.
Ukecaný výstup obsahující vše, o čem program ví.
Don't report abnormal program termination (where command is terminated by a signal) or nonzero exit status.

Vypíše návod k použití na standardní výstup a bezchybně skončí.
Vypíše číslo verze na standardní výstup a bezchybně skončí.
--
Konec seznamu voleb.

Některé zdroje nejsou v některých verzích UNIXu měřeny, takže některé hodnoty mohou být nahlášeny jako nuly. Současný výběr byl z velké části inspirován daty, které poskytují verze 4.2 nebo 4.3BSD.

GNU time ve verzi 1.7 ještě není lokalizován. Tudíž neimplementuje požadavky POSIX.

Proměnná prostředí TIME byla vybrána špatně. Není nezvyklé, že systémy jako autoconf(1) nebo make(1) používají proměnnou prostředí s názvem programu k určení utility, která má být použita. Použití proměnných jako MORE nebo TIME pro volby programů (namísto úplných cest k programům) často způsobuje potíže.

To, že -o přepisuje namísto připojení se zdá být jako nepříliš štastné řešení. (Tj. volba -a by měla být výchozí.)

Nápady a hlášení chyb v GNU time posílejte na bug-time@gnu.org. Prosím uvedte verzi programu time, kterou získáte spuštěním


time --version

a operační systém a použitý překladač C.

bash(1), tcsh(1), times(2), wait3(2)

Překlad této příručky do češtiny vytvořili Pavel Heimlich <tropikhajma@gmail.com>

Tento překlad je bezplatná dokumentace; Přečtěte si GNU General Public License Version 3 nebo novější ohledně podmínek autorských práv. Neexistuje ŽÁDNÁ ODPOVĚDNOST.

Pokud narazíte na nějaké chyby v překladu této příručky, pošlete e-mail na adresu translation-team-cs@lists.sourceforge.net.

2. května 2024 Linux man-pages 6.8