pv - Интернет в облаке

ПРОГРАММА:

ИМЯ

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

СИНТАКСИС

pv [ВАРИАНТ] [ФАЙЛОВ] ...
pv [-h|-V]

ОПИСАНИЕ

pv показывает прогресс данных в конвейере, предоставляя такую ​​информацию, как время
прошедшее, процент выполнения (с индикатором выполнения), текущая пропускная способность, общие данные
передано, и ETA.

Чтобы использовать его, вставьте его в конвейер между двумя процессами с соответствующими параметрами.
Его стандартный ввод будет передан на стандартный вывод, и прогресс будет
показано при стандартной ошибке.

pv скопирует каждый предоставленный ФАЙЛОВ в свою очередь на стандартный вывод (- означает стандартный ввод), или если
нет ФАЙЛОВs указаны, просто стандартный ввод копируется. Это то же поведение, что и
кошка(1).

Простой пример, чтобы посмотреть, как быстро передается файл, используя nc(1):

pv файл | nc -w 1 where.com 3000

Аналогичный пример, передача файла из другого процесса и передача ожидаемого размера
в pv:

кошка файл | pv -s 12345 | nc -w 1 where.com 3000

Более сложный пример использования числового вывода для подачи в Диалог(1) программа для
полноэкранное отображение прогресса:

(смола cf - . \
| pv -n -s $ (du -sb . | AWK '{Распечатать $ 1} ') \
| GZIP -9 > аут.tgz) 2> & 1 \
| Диалог --измерять 'Прогресс' 7 70

Снимаем образ диска, пропускаем ошибки:

pv -ЕЕ / Dev / ПДД > образ диска.img

Запись образа обратно на диск:

pv образ диска.img > / Dev / ПДД

Обнуление диска:

pv < / DEV / ноль > / Dev / ПДД

Обратите внимание, что если размер входа не может быть вычислен, а выход - блочное устройство, тогда
будет использоваться размер блочного устройства и pv автоматически остановится на этом размере, как
if -S был дан.

(Только для Linux): просмотр дескриптора файла 3, открытого другим процессом 1234:

pv -d 1234:3

(Только для Linux): просмотр всех файловых дескрипторов, используемых процессом 1234:

pv -d 1234

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

pv принимает множество опций, которые разделены на переключатели дисплея, модификаторы вывода и
общие настройки.

ДИСПЛЕЙ ВЫКЛЮЧАТЕЛИ

Если переключатели дисплея не указаны, pv ведет себя как если бы -p, -t, -e, -r и -b было
дано (т.е. включено все, кроме средней скорости). В противном случае отображаются только те
будут показаны явно включенные типы.

-п, --прогресс
Включите индикатор выполнения. Если стандартный ввод не является файлом и размер не указан
(с -s модификатор), индикатор выполнения не может указывать, насколько близок к завершению
передача есть, поэтому он будет просто перемещаться влево и вправо, чтобы указать, что данные
перемещение.

-т, - таймер
Включите таймер. Это отобразит общее прошедшее время, которое pv было
бежит за.

-е, --эта
Включите таймер ETA. Будет предпринята попытка угадать на основе предыдущего переноса.
ставки и общий размер данных, сколько времени потребуется до завершения. Этот вариант
не будет иметь никакого эффекта, если невозможно определить общий размер данных.

-Я, --финета
Включите таймер ETA, но вместо этого покажите примерное местное время прибытия.
оставшееся время. Когда расчетное время более 6 часов в будущем, дата
показано также.

-р, --темп
Включите счетчик ставок. Это отобразит текущую скорость передачи данных.

-a --Средняя оценка
Включите счетчик средней ставки. Это отобразит среднюю скорость передачи данных.
перевод пока.

-б, - байты
Включите общий счетчик байтов. Это отобразит общий объем данных
перенесено пока.

-Т, --буфер-процент
Включите отображение процента буфера передачи. Это покажет процент
буфер передачи используется - но см. предостережение под %T в ФОРМАТИРОВАНИЕ .
внизу.

-А, --последнее написанное NUM
Показать последний NUM записано байтов - но см. предостережение под % nA в ФОРМАТИРОВАНИЕ
раздел ниже.

-Ф, --формат ФОРМАТ
Игнорируйте варианты -p, -t, -e, -r, -a, -b, -T и -A, а вместо этого используйте формат
string ФОРМАТ для определения формата вывода. Увидеть ФОРМАТИРОВАНИЕ раздел ниже.

-н, --числовой
Числовой вывод. Вместо визуальной индикации прогресса, pv даст
целое число в процентах, по одному на строку, при стандартной ошибке, подходит для трубопроводов (через
запутанное перенаправление) в Диалог(1). Обратите внимание, что -f не требуется, если -n is
использовался.

Обратите внимание, что если --числовой используется, затем добавляем - байты вызовет количество
обработанные до сих пор байты для вывода вместо процента; если --line-режим Также
используется, то вместо байтов или процентов количество строк на данный момент равно
выход. И наконец, если - таймер также используется, то каждая строка вывода имеет префикс
с прошедшим временем в виде десятичного числа секунд.

-д, --тихий
Нет вывода. Полезно, если -L опция используется сама по себе, чтобы просто ограничить
скорость передачи трубы.

ВЫВОД МОДИФИКАТОРЫ

-В, --ждать
Подождите, пока не будет передан первый байт, прежде чем показывать какой-либо прогресс
информацию или расчет любого ETA. Полезно, если программа, к которой вы подключаетесь, или
from требует дополнительной информации перед запуском, например, передача данных в GPG(1) или
Mcrypt(1) которые требуют парольной фразы перед обработкой данных.

-Д, --отложенный старт SEC / КОМИССИЯ ПО ЦЕННЫМ БУМАГАМ И БИРЖАМ
Подожди пока SEC / КОМИССИЯ ПО ЦЕННЫМ БУМАГАМ И БИРЖАМ прошло несколько секунд, прежде чем отобразилась какая-либо информация о прогрессе, для
пример в скрипте, где вы хотите показывать только индикатор выполнения, если он начинает принимать
долгое время. Обратите внимание, что это может быть десятичное число, например 0.5.

-s РАЗМЕР, --размер РАЗМЕР
Предположим, что общий объем передаваемых данных равен РАЗМЕР байтов при вычислении
проценты и расчетное время прибытия. Могут использоваться те же суффиксы «k», «m» и т. Д., Что и с -L.

Не действует при использовании с -d PID для просмотра всех файловых дескрипторов процесса, но
Будет работать с -d PID: FD.

-л, --line-режим
Вместо подсчета байтов подсчитайте строки (символы новой строки). Индикатор выполнения будет
перемещаться только тогда, когда будет найдена новая строка, и значение, переданное в -s вариант будет
интерпретируется как количество строк. Обратите внимание, что размеры файлов не рассчитываются автоматически.
когда используется эта опция, чтобы избежать необходимости читать все файлы дважды.

-0, --нулевой
Считать строки как завершенные нулем. Этот параметр подразумевает --line-mode.

-i ТРЦ, --интервал SEC / КОМИССИЯ ПО ЦЕННЫМ БУМАГАМ И БИРЖАМ
Подожди SEC / КОМИССИЯ ПО ЦЕННЫМ БУМАГАМ И БИРЖАМ секунд между обновлениями. По умолчанию обновляется каждую секунду. Примечание
что это может быть десятичная дробь, например 0.1.

-w ШИРИНА, --ширина ШИРИНА
Предположим, что терминал ШИРИНА шириной символов, вместо того, чтобы пытаться решить эту проблему (или
предполагая 80, если это невозможно угадать).

-H ВЫСОТА, --рост ВЫСОТА
Предположим, что терминал ВЫСОТА ряды высоко, вместо того, чтобы пытаться решить это (или
предполагая 25, если это невозможно угадать).

-N ИМЯ, --имя ИМЯ
Приставьте к выходной информации префикс ИМЯ. Полезно в сочетании с -c если у вас есть
сложный конвейер, и вы хотите иметь возможность различать его части.

-ф, --сила
Выход силы. Как обычно, pv не будет выводить визуальное отображение, если стандартная ошибка
не терминал. Эта опция заставляет его делать это.

-с, --курсор
Используйте escape-последовательности для позиционирования курсора, а не просто возврат каретки.
Это полезно в сочетании с -N (имя), если вы используете несколько pv
вызовы в одном длинном конвейере.

ДАННЫЕ ТРАНСФЕР МОДИФИКАТОРЫ

-L ТЕМП, --rate-limit СТАВКА
Ограничьте передачу до максимума СТАВКА байтов в секунду. Суффикс «к», «м»,
«g» или «t» могут быть добавлены для обозначения килобайт (* 1024), мегабайт и т. д.

-B БАЙТОВ, --размер буфера БАЙТОВ
Используйте размер буфера передачи БАЙТОВ байтов. Суффикс «k», «m», «g» или «t» может
добавляется для обозначения килобайт (* 1024), мегабайт и т. д. Буфер по умолчанию
size - размер блока файловой системы входного файла, умноженный на 32 (максимум 512 КБ),
или 400 КБ, если невозможно определить размер блока.

-С, - без стыковки
Никогда не использовать сращивание(2), даже если обычно это возможно. В сращивание(2) система
вызов - более эффективный способ передачи данных из канала или в канал, чем обычный
читать(2) и записывать(2), но означает, что буфер передачи нельзя использовать. Этот
предотвращает -A и -T от работы, поэтому, если вы хотите использовать -A or -T тогда тебе понадобится
использовать -C, за счет небольшой потери эффективности передачи. (Этот вариант не имеет
влияние на системы, где сращивание(2) недоступен).

-А ТАКЖЕ, --skip-ошибки
Игнорируйте ошибки чтения, пытаясь пропустить проблемные разделы. В
соответствующие части вывода будут нулевыми байтами. Сначала всего несколько байтов
будут пропущены, но если ошибок подряд много, то пропуски будут перемещаться вверх
к фрагментам по 512. Это похоже на dd conv = синхронизация, без ошибок но имеет
не был так тщательно протестирован.

Указывать -E дважды, чтобы сообщать об ошибке чтения только один раз для каждого файла, а не сообщать
пропущен каждый диапазон байтов.

-С, - стоп по размеру
Если размер был указан с -s, прекратите передачу данных, как только
был написан, вместо того, чтобы продолжать до конца ввода.

-d PID [: FD], --watchfd PID [: FD]
Вместо передачи данных смотрите файловый дескриптор FD процесса PID, и показать его
прогресс. В pv процесс завершится, когда FD либо переходит в другой файл,
меняет режим чтения / записи или закрывается; другие модификаторы передачи данных - и удаленные
control - не может использоваться с этой опцией.

Если бы только PID указан, то этот процесс будет отслеживаться, и все регулярные
файлы и блочные устройства, которые он открывает, будут отображаться с индикатором выполнения. В pv процесс
выйдет, когда процесс PID выходы.

-R ПИД, --дистанционный пульт PID
If PID является примером pv который уже запущен, -R PID вызовет это
instance, чтобы он действовал так, как если бы вместо этого ему была предоставлена ​​командная строка этого экземпляра.
Например, если pv -L 123k выполняется с идентификатором процесса 9876, затем выполняется pv -R 9876
-L 321k заставит его начать использовать ограничение скорости 321k вместо 123k. Примечание
что некоторые параметры нельзя изменить во время работы, например -c, -l, -f, -D, -E и
-S.

ОБЩАЯ ИНФОРМАЦИЯ ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

-P ФАЙЛ, --pidfile ФАЙЛОВ
Сохраните идентификатор процесса pv in ФАЙЛОВ. Файл будет обрезан, если он уже
существует и будет удален, когда pv выходы. В то время как pv запущен, он будет содержать
единственное число - идентификатор процесса pv - за которым следует новая строка.

-час, --Помогите
Распечатайте сообщение об использовании на стандартный вывод и успешно завершите работу.

-В, --версия
Распечатать информацию о версии на стандартном выходе и успешно завершить работу.

ФОРМАТИРОВАНИЕ

Если же линия индикатора -F задана опция, то выходной формат определяется заданным форматом
нить. В этой строке можно использовать следующие последовательности:

%p Индикатор. Расширяется, чтобы заполнить оставшееся пространство. Следует указывать только один раз.
Эквивалентно -p.

%t Пройденное время. Эквивалентно -t.

%e ETA как оставшееся время. Эквивалентно -e.

%I ETA как местное время завершения. Эквивалентно -I.

%r Текущая скорость передачи данных. Эквивалентно -r.

%a Средняя скорость передачи данных. Эквивалентно -a.

%b Передано до сих пор байтов (или строк, если -l было указано). Эквивалентно -b.

%T Процент используемого буфера передачи. Эквивалентно -T. Показывает "{----}", если
перевод осуществляется с сращивание(2), так как при сращивании с трубами не используются
буфер.

% nA Показать последний n записанных байтов (например, % 16A за последние 16 байт). Показывает только точки
если перевод осуществляется с сращивание(2), поскольку сращивание с трубами или с труб
не использовать буфер.

%N Префикс имени предоставлен -N. Дополняется до 9 символов пробелами и имеет суффикс:.

%% Один %.

Строка формата, эквивалентная включению всех переключателей дисплея: `% N %b %T %t %r %a %p
% e '.

ВЫХОД статус

Статус выхода 1 указывает на проблему с -R or -P настройки.

Любой другой статус выхода является битовой маской следующего:

2 Не удалось получить доступ к одному или нескольким файлам, состояние(2) изд, или открылся.

4 Входной файл был таким же, как выходной файл.

8 Внутренняя ошибка при закрытии файла или переходе к следующему файлу.

16 Произошла ошибка при передаче данных из одного или нескольких входных файлов.

32 Был пойман сигнал, который повлек за собой досрочный выход.

64 Не удалось выделить память.

Нулевой статус выхода указывает на отсутствие проблем.

Используйте pv онлайн с помощью сервисов onworks.net