Документация по LinuxLinuxDoc.Ru 🔍

time - измеряет время выполнения простой команды или использование ресурсов

НАЗВАНИЕ
time - измеряет время выполнения простой команды или
использование ресурсов

СИНТАКСИС
time [опции] команда [аргументы...]

ОПИСАНИЕ
Команда time запускает определенную программу команда с
заданными аргументами. При завершении программы команда,
time записывает в стандартный поток вывода сообщение,
которое включает статистику о времени выполнения заданной
программы. Эта статистика показывает: (1) полное время
прошедшее между вызовом и завершением программы, (2) время
процессора, использованное командой (сумма величин
tms_utime и tms_cutime из структуры struct tms,
возвращенные функцией times(2)), и (3) время процессора,
использованное системой (сумма величин tms_stime и
tms_cstime из структуры struct tms, возвращенные функцией
times(2)).

ОПЦИИ
-p В локали POSIX, используется точный традиционный
формат
"real %f\nuser %f\nsys %f\n"
(с числами в секундах) где десятичные числа в
выводе для %f не являются точными, но достаточны,
чтобы отобразить правильное время.

ОКРУЖЕНИЕ
Используются переменные окружения LANG, LC_ALL, LC_CTYPE,
LC_MESSAGES, LC_NUMERIC, NLSPATH и PATH. Последняя
используется для поиска программы команда. Остальные
используются для форматированного вывода.

СТАТУС ЗАВЕРШЕНИЯ
Если была вызвана программа команда, то статус завершения
будет такой же как и у вызванной программы команда. В
противном случае он будет равен 127, если команда не была
найдена. 126, если программа была найдена, но не была
вызвана. В остальных случаях возвращаются значения от 1
до 125, если произошла какая-то другая ошибка.

ВЕРСИЯ GNU
Ниже описывается версия GNU 1.7 команды time. Версия GNU
выводит дополнительную полезную информацию, не только об
использованном времени, но также статистику об
использовании других ресурсов: память, ввод/вывод и вызовы
IPC (если эта информация доступна). Вывод форматируется,
используя строку форматирования, которая может быть
определена опцией -f или переменной окружения TIME.

По умолчанию строка формата выглядит так:
%Uuser %Ssystem %Eelapsed %PCPU (%Xtext+%Ddata %Mmax)k
%Iinputs+%Ooutputs (%Fmajor+%Rminor)pagefaults %Wswaps

Когда задана опция -p, тогда используется следующий формат
real %e
user %U
sys %S

Строка форматирования
Формат интерпретируется обычно также, как функцией printf.
Простые символы напрямую копируются. Символ табуляции,
смвол новой строки и символ возврата экранируются: \t, \n
and \\. Знак процента записывается следующим образом: %%.
А символ % означает преобразование. Программа time всегда
добавляет в конце символ новой строки. Используются
следующие типы преобразования. Поддерживаются все типы,
используемые tcsh(1).

Время

%E Полное прошедшее время (в формате
[часы:]минуты:секунды).

%e (Нет в tcsh.) Полное прошедшее время (в секундах).

%S Общее процессорное время использованное системой (в
секундах).

%U Общее процессорное время использованное процессом
(в секундах).

%P Величина (в процентах) использования процессора
этой задачей. Вычисляется по формуле (%U + %S) /
%E.

Память

%M Максимальный размер резидентной памяти, занятой
процессом в течении времени выполнения (в
килобайтах).

%t (Нет в tcsh.) Средний размер резидентной памяти,
занятой процессом (в килобайтах).

%K Средний размер используемой памяти процессом (в
целом (данные+стек+текст)) (в килобайтах).

%D Средний размер области неразделяемой памяти
процесса (в килобайтах).

%p (Нет в tcsh.) Средний размер неразделяемого стека
процесса (в килобайтах).

%X Средний размер неразделяемого пространства текста
процесса (в килобайтах).

%Z (Нет в tcsh.) Размер системной страницы памяти (в
байтах). Это константа, которая определена в
системе (имеет разные значения в различных
системах).

%F Число ошибочных страниц, которые возникли в течении
выполнения процесса. Эти ошибки возникают, когда
страницы читаются с диска.

%R Число неопасных ошибочных страниц, которые могут
быть восстановлены. Эти ошибочные страницы
неправильные, но они могут быть взяты из других
виртуальных страниц. Т.о. данные страницы могут
быть правильные, но при этом системные таблицы
должны быть обновлены.

%W Число, которое показывает, сколько раз процесс был
записан в файл подкачки из основной памяти.

%c Число, которое показывает, сколько раз
непроизвольно был переключен контекст программы
(потомучто истек промежуток времени).

%w Число ожиданий: время, в течении которого
преднамеренно был переключен контекст программы, за
исключением того, пока ожидалось завершение
операции ввода/вывода.

I/O

%I Число чтений процессом из файловой системы.

%O Число записей процессом в файловую систему.

%r Число сообщений, полученные процессом из сокета.

%s Число сообщений, отправленных процессом в сокет.

%k Число сигналов, доставленных процессу.

%C (Нет в tcsh.) Имя процесса и его строка аргументов
командной строки.

%x (Нет в tcsh.) Статус завершения команды.

ОПЦИИ GNU
-f ФОРМАТ, --format=ФОРМАТ
Определенный формат вывода, возможно определен в
переменной окружения TIME.

-p, --portability
Использовать переносимый формат вывода.

-o ФАЙЛ, --output=ФАЙЛ
Не посылать результат в стандартный поток ошибок
(stderr), но переписывает определенный файл.

-a, --append
(Используется вместе с опцией -o.) Не переписывает,
а добавляет.

-v, --verbose
Подробно выводит производимые действия над
программой.

СТАНДАРТНЫЕ ОПЦИИ GNU
--help Выводит подсказку на стандартный вывод и завершает
свою работу.

--version
Выводит на стандартный вывод информацию о версии
программы и завершает свою работу.

-- Используется для обозначения конца списка
параметров.

ОШИБКИ
Не все ресурсы могут быть измерены некоторыми версиями
Unix. Т.о. некоторые значения могут быть нулевыми. Это
главным образом описано в BSD 4.2 или 4.3.

Версия GNU 1.7 программы time не локализована. Т.к. это
не требует POSIX.

Переменная окружения TIME была не лучшим выбором. Она
нередко используется программами autoconf или make,
которые используют переменные окружения с именем утилиты,
чтобы изменить используемую утилиту. Использование,
например MORE или TIME для опций к программам (вместо
путей к программе) может привести к затруднениям.

К сожалению, опция -o позволяет перезаписать файл, вместо
добавления к нему. (Т.о. опция -a должна быть установлена
по умолчанию.)

Предложения и сообщения об ошибках для версии GNU команды
time отправляйте на адрес
bug-utils@prep.ai.mit.edu
Пожалуйста включите в письмо версию команды time , которую
вы можете получить запустив вкомандной строке
time --version
А также используемую операционную систему и компилятор C.

АВТОРЫ
David Keppel
Оригинальная версия.

David MacKenzie
Помощь с POSIX, опциями GNU, документацией.
Исправление ошибок и улучшения.

Arne Henrik Juul
Помощь с переносимостью.

Francois Pinard
Помощь с переносимостью.
Читать новости Linux в Telegram
Linux - time - измеряет время выполнения простой команды или использование ресурсов
Мы в соцсетях ✉