pv – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

pv – Überwachen Sie den Datenfortschritt durch eine Pipe

ZUSAMMENFASSUNG

pv [zur Auswahl] [FILE] ...
pv [-h|-V]

BESCHREIBUNG

pv zeigt den Fortschritt von Daten durch eine Pipeline an, indem es Informationen wie die Zeit angibt
verstrichen, Prozentsatz abgeschlossen (mit Fortschrittsbalken), aktuelle Durchsatzrate, Gesamtdaten
übertragen und voraussichtliche Ankunftszeit.

Um es zu verwenden, fügen Sie es mit den entsprechenden Optionen in eine Pipeline zwischen zwei Prozessen ein.
Seine Standardeingabe wird an seine Standardausgabe weitergeleitet und der Fortschritt erfolgt
angezeigt auf Standardfehler.

pv wird jedes gelieferte Exemplar kopieren FILE wiederum zur Standardausgabe (- bedeutet Standardeingabe) oder if
nicht FILEs angegeben werden, wird nur die Standardeingabe kopiert. Dies ist das gleiche Verhalten wie
Katze(1).

Ein einfaches Beispiel, um zu beobachten, wie schnell eine Datei übertragen wird nc(1):

pv Datei | nc -w 1 irgendwo.com 3000

Ein ähnliches Beispiel: Übertragen einer Datei aus einem anderen Prozess und Übergeben der erwarteten Größe
zu pv:

Katze Datei | pv -s 12345 | nc -w 1 irgendwo.com 3000

Ein komplizierteres Beispiel mit numerischer Ausgabe zur Einspeisung in die Dialog(1) Programm für a
Vollbild-Fortschrittsanzeige:

(Teer cf - .
| pv -n -s $(du -sb . | awk '{drucken $1}')
| gzip -9 > out.tgz) 2> & 1
| Dialog --Messgerät 'Fortschritt' 7 70

Erstellen eines Images einer Festplatte, Überspringen von Fehlern:

pv -EE / Dev / sda > disk-image.img

Ein Image zurück auf eine Festplatte schreiben:

pv disk-image.img > / Dev / sda

Eine Festplatte auf Null setzen:

pv < /dev/null > / Dev / sda

Beachten Sie Folgendes: Wenn die Eingabegröße nicht berechnet werden kann und die Ausgabe ein Blockgerät ist, dann
die Größe des Blockgeräts wird verwendet und pv stoppt automatisch bei dieser Größe als
if -S wurde gegeben.

(Nur Linux): Beobachten Sie, wie Dateideskriptor 3 von einem anderen Prozess geöffnet wurde 1234:

pv -d 1234:3

(Nur Linux): Beobachten aller vom Prozess 1234 verwendeten Dateideskriptoren:

pv -d 1234

OPTIONAL

pv bietet viele Optionen, die in Anzeigeschalter, Ausgabemodifikatoren usw. unterteilt sind
Allgemeine Optionen.

DISPLAY SWITCHES

Wenn keine Anzeigeschalter angegeben sind, pv verhält sich so, als ob -p, -t, -e, -rsowie -b gewesen
angegeben (d. h. alles außer der Durchschnittsrate ist eingeschaltet). Ansonsten werden nur diese angezeigt
Typen, die explizit eingeschaltet sind, werden angezeigt.

-P, --Fortschritt
Schalten Sie den Fortschrittsbalken ein. Wenn die Standardeingabe keine Datei ist und keine Größe angegeben wurde
(Mit -s Modifikator) kann der Fortschrittsbalken nicht anzeigen, wie nah der Abschluss ist
Die Übertragung erfolgt, sie bewegt sich also einfach nach links und rechts, um anzuzeigen, dass die Daten vorhanden sind
bewegend.

-T, --Timer
Schalten Sie den Timer ein. Dadurch wird die insgesamt verstrichene Zeit angezeigt pv wurde
Rennen für.

-e, --eta
Schalten Sie den ETA-Timer ein. Dies wird versuchen, basierend auf der vorherigen Übertragung zu erraten
Raten und die Gesamtdatengröße, wie lange es bis zur Fertigstellung dauern wird. Diese Option
hat keine Auswirkung, wenn die Gesamtdatengröße nicht ermittelt werden kann.

-ICH, --fineta
Schalten Sie den ETA-Timer ein, zeigen Sie jedoch stattdessen die voraussichtliche lokale Ankunftszeit an
übrige Zeit. Wenn die geschätzte Zeit mehr als 6 Stunden in der Zukunft liegt, wird das Datum angezeigt
auch gezeigt.

-R, --Bewertung
Schalten Sie den Tarifzähler ein. Dadurch wird die aktuelle Datenübertragungsrate angezeigt.

-a, --Durchschnittsrate
Schalten Sie den Durchschnittskurszähler ein. Dadurch wird die durchschnittliche Datenrate angezeigt
Bisher übertragen.

-B, - Bytes
Schalten Sie den Gesamtbytezähler ein. Dadurch wird die Gesamtdatenmenge angezeigt
bisher übertragen.

-T, --buffer-percent
Schalten Sie die Anzeige des Übertragungspuffer-Prozentsatzes ein. Hier wird der Prozentsatz angezeigt
den verwendeten Übertragungspuffer – beachten Sie jedoch den folgenden Vorbehalt %T in England, FORMATIERUNG Abschnitt
unten mit.

-EIN, --zuletzt geschrieben NUM
Letztes anzeigen NUM Bytes geschrieben – beachten Sie jedoch die Einschränkung unten %n / A in England, FORMATIERUNG
Abschnitt unten.

-F, --Format FORMAT
Ignorieren Sie die Optionen -p, -t, -e, -r, -a, -b, -Tsowie -A, und verwenden Sie stattdessen das Format
Schnur FORMAT um das Ausgabeformat zu bestimmen. Siehe die FORMATIERUNG Abschnitt unten.

-nicht, --numerisch
Numerische Ausgabe. Anstatt einen visuellen Hinweis auf den Fortschritt zu geben, pv wird eine geben
ganzzahliger Prozentsatz, einer pro Zeile, mit Standardfehler, geeignet für Piping (via
verschlungene Umleitung) in Dialog(1). Beachten Sie, dass -f ist nicht erforderlich, wenn -n is
verwendet werden.

Beachten Sie, dass wenn --numerisch wird verwendet, dann hinzufügen - Bytes wird die Anzahl der verursachen
Bisher verarbeitete Bytes werden anstelle eines Prozentsatzes ausgegeben. Wenn --line-mode ist auch
im Einsatz, dann wird anstelle von Bytes oder einem Prozentsatz die Anzahl der bisherigen Zeilen angegeben
Ausgang. Und schließlich, wenn --Timer wird ebenfalls verwendet, dann wird jeder Ausgabezeile ein Präfix vorangestellt
mit der bisher verstrichenen Zeit als Dezimalzahl in Sekunden.

-Q, --ruhig
Keine Leistung. Nützlich, wenn die -L Die Option wird allein verwendet, um nur die zu begrenzen
Übertragungsrate einer Leitung.

AUSGABE MODIFIKATOREN

-W, --Warten
Warten Sie, bis das erste Byte übertragen wurde, bevor Sie den Fortschritt anzeigen
Informationen oder die Berechnung etwaiger ETAs. Nützlich, wenn das Programm, an das Sie weiterleiten, oder
from benötigt vor dem Start zusätzliche Informationen, z. B. das Weiterleiten von Daten gpg(1) oder
mcrypt(1) die eine Passphrase erfordern, bevor Daten verarbeitet werden können.

-D, --Start verzögern SEK
Warte bis SEK Es sind Sekunden vergangen, bevor Fortschrittsinformationen angezeigt werden, z
Beispiel in einem Skript, in dem Sie nur dann einen Fortschrittsbalken anzeigen möchten, wenn die Ausführung beginnt
eine lange Zeit. Beachten Sie, dass dies eine Dezimalzahl wie 0.5 sein kann.

-s GRÖSSE, --Größe GRÖßE
Gehen Sie von der Gesamtmenge der zu übertragenden Daten aus GRÖßE Bytes bei der Berechnung
Prozentsätze und ETAs. Es können die gleichen Suffixe für „k“, „m“ usw. verwendet werden wie bei -L.

Hat keine Wirkung, wenn es mit verwendet wird -d PID um alle Dateideskriptoren eines Prozesses zu beobachten, aber
werde mit arbeiten -d PID:FD.

- l, --line-mode
Anstatt Bytes zu zählen, zählen Sie Zeilen (Zeilenumbruchzeichen). Der Fortschrittsbalken wird angezeigt
Nur verschieben, wenn eine neue Zeile gefunden wird und der Wert an übergeben wird -s Option wird sein
als Zeilenanzahl interpretiert. Beachten Sie, dass Dateigrößen nicht automatisch berechnet werden
Wenn diese Option verwendet wird, um zu vermeiden, dass alle Dateien zweimal gelesen werden müssen.

-0, --Null
Zählt Zeilen als nullterminiert. Diese Option impliziert --line-mode.

-i SEK, --Intervall SEK
Wartezeit SEK Sekunden zwischen Aktualisierungen. Standardmäßig wird jede Sekunde aktualisiert. Notiz
dass dies eine Dezimalzahl wie 0.1 sein kann.

-w BREITE, --Breite WIDTH
Angenommen, das Terminal ist WIDTH Zeichen breit, anstatt zu versuchen, es herauszufinden (oder
angenommen 80, wenn es nicht erraten werden kann).

-H HÖHE, --Höhe HEIGHT
Angenommen, das Terminal ist HEIGHT Reihen hoch, anstatt zu versuchen, es herauszufinden (oder
angenommen 25, wenn es nicht erraten werden kann).

-N NAME, --Name NAME/FUNKTION
Stellen Sie den Ausgabeinformationen ein Präfix voran NAME/FUNKTION. Nützlich in Verbindung mit -c wenn Sie
eine komplizierte Pipeline und Sie möchten verschiedene Teile davon unterscheiden können.

-F, --Macht
Ausgabe erzwingen. Normalerweise, pv gibt keine visuelle Anzeige aus, wenn der Standardfehler vorliegt
kein Terminal. Diese Option zwingt es dazu.

-C, --Mauszeiger
Verwenden Sie Escape-Sequenzen für die Cursorpositionierung, anstatt nur Wagenrückläufe zu verwenden.
Dies ist nützlich in Verbindung mit -N (Name), wenn Sie mehrere verwenden pv
Aufrufe in einer einzigen, langen Pipeline.

DATEN TRANSFER MODIFIKATOREN

-L BEWERTUNG, --Bewertungslimit PREIS
Beschränken Sie die Übertragung auf maximal PREIS Bytes pro Sekunde. Ein Suffix von „k“, „m“,
„g“ oder „t“ können hinzugefügt werden, um Kilobyte (*1024), Megabyte usw. anzugeben.

-B Bytes, --Puffergröße BYTE
Verwenden Sie eine Übertragungspuffergröße von BYTE Bytes. Ein Suffix von „k“, „m“, „g“ oder „t“ kann sein
hinzugefügt werden, um Kilobyte (*1024), Megabyte usw. anzugeben. Der Standardpuffer
Größe ist die Blockgröße des Dateisystems der Eingabedatei multipliziert mit 32 (maximal 512 KB).
oder 400 KB, wenn die Blockgröße nicht bestimmt werden kann.

-VS, --no-spleiß
Benutze niemals spleißen(2), auch wenn es normalerweise möglich wäre. Der spleißen(2) System
Ein Aufruf ist eine effizientere Methode zum Übertragen von Daten von oder zu einer Pipe als normal
besuch(2) und schreiben(2), bedeutet aber, dass der Transferpuffer nicht genutzt werden darf. Das
verhindert -A und -T von der Arbeit, also wenn Sie es verwenden möchten -A or -T dann brauchst du
benutzen -C, allerdings mit einem geringen Verlust an Übertragungseffizienz. (Diese Option hat keine
Wirkung auf Systeme, in denen spleißen(2) ist nicht verfügbar).

-IS, --skip-errors
Ignorieren Sie Lesefehler, indem Sie versuchen, die problematischen Abschnitte zu überspringen. Der
entsprechende Teile der Ausgabe sind Nullbytes. Zunächst nur ein paar Bytes
werden übersprungen, aber wenn es viele Fehler hintereinander gibt, werden die Überspringungen nach oben verschoben
in Stücke von 512. Dies soll ähnlich sein dd conv=sync,noerror aber
nicht so gründlich getestet.

Angeben -E zweimal, um einen Lesefehler nur einmal pro Datei zu melden, anstatt ihn zu melden
Jeder Bytebereich wurde übersprungen.

-S, --stop-at-size
Wenn eine Größe mit angegeben wurde -s, stoppen Sie die Datenübertragung, sobald so viele Bytes vorhanden sind
geschrieben wurde, anstatt bis zum Ende der Eingabe fortzufahren.

-d PID[:FD], --watchfd PID[:FD]
Beobachten Sie den Dateideskriptor, anstatt Daten zu übertragen FD des Prozesses PID, und zeigen Sie es
Fortschritt. Der pv Der Prozess wird beendet, wenn FD entweder in eine andere Datei wechselt,
ändert den Lese-/Schreibmodus oder wird geschlossen; andere Datenübertragungsmodifikatoren - und remote
control – darf mit dieser Option nicht verwendet werden.

Wenn nur a PID angegeben wird, wird dieser Prozess beobachtet und alles normal
Die geöffneten Dateien und Blockgeräte werden mit einem Fortschrittsbalken angezeigt. Der pv Prozessdefinierung
wird beendet, wenn der Vorgang ausgeführt wird PID Ausgänge.

-R PID, --Fernbedienung PID
If PID ist eine Instanz von pv das läuft schon, -R PID wird das verursachen
Die Instanz verhält sich so, als hätte sie stattdessen die Befehlszeile dieser Instanz erhalten.
Zum Beispiel, wenn pv -L 123K läuft mit der Prozess-ID 9876, dann läuft pv -R 9876
-L 321K führt dazu, dass eine Ratenbegrenzung von 321 KB anstelle von 123 KB verwendet wird. Notiz
dass einige Optionen während der Ausführung nicht geändert werden können, wie z -c, -l, -f, -D, -Esowie
-S.

ALLGEMEIN OPTIONAL

-P DATEI, --pidfile FILE
Speichern Sie die Prozess-ID von pv in FILE. Die Datei wird gekürzt, falls dies bereits der Fall ist
existiert und wird entfernt, wenn pv Ausgänge. Während pv läuft, enthält es eine
einzelne Zahl – die Prozess-ID von pv - gefolgt von einem Zeilenumbruch.

-H, --help
Drucken Sie eine Verwendungsmeldung auf der Standardausgabe und beenden Sie sie erfolgreich.

-V, --Version
Versionsinformationen auf Standardausgabe drucken und erfolgreich beenden.

FORMATIERUNG

Besitzt das -F Wenn die Option angegeben ist, wird das Ausgabeformat durch das angegebene Format bestimmt
Zeichenfolge. Innerhalb dieser Zeichenfolge können die folgenden Sequenzen verwendet werden:

%p Fortschrittsanzeige. Wird erweitert, um den verbleibenden Platz auszufüllen. Sollte nur einmal angegeben werden.
Gleichwertig -p.

%t Verstrichene Zeit. Gleichwertig -t.

%e ETA als verbleibende Zeit. Gleichwertig -e.

%I ETA als örtliche Fertigstellungszeit. Gleichwertig -I.

%r Aktuelle Datenübertragungsrate. Gleichwertig -r.

%a Durchschnittliche Datenübertragungsrate. Gleichwertig -a.

%b Bisher übertragene Bytes (oder Zeilen, falls -l angegeben wurde). Gleichwertig -b.

%T Prozentsatz des verwendeten Übertragungspuffers. Gleichwertig -T. Zeigt „{----}“ an, wenn die
Die Übertragung erfolgt mit spleißen(2), da das Spleißen zu oder von Rohren nicht erforderlich ist
der Puffer.

%n / A Letztes anzeigen n Geschriebene Bytes (z. B % 16A für die letzten 16 Bytes). Zeigt nur Punkte an
wenn die Übertragung durchgeführt wird spleißen(2), da dies beim Spleißen zu oder von Rohren der Fall ist
Verwenden Sie den Puffer nicht.

%N Namenspräfix gegeben durch -N. Mit Leerzeichen auf 9 Zeichen aufgefüllt und mit : angehängt.

%% Ein einzelner %.

Die Formatzeichenfolge entspricht dem Einschalten aller Anzeigeschalter `%N %b %T %t %r %a %p
%e'.

EXIT STATUS

Ein Exit-Status von 1 weist auf ein Problem mit dem hin -R or -P nach.

Jeder andere Exit-Status ist eine Bitmaske der folgenden:

2 Auf eine oder mehrere Dateien konnte nicht zugegriffen werden. Zustand(2)ed oder geöffnet.

4 Eine Eingabedatei war dieselbe wie die Ausgabedatei.

8 Interner Fehler beim Schließen einer Datei oder beim Wechseln zur nächsten Datei.

16 Beim Übertragen von Daten aus einer oder mehreren Eingabedateien ist ein Fehler aufgetreten.

32 Es wurde ein Signal erfasst, das zu einem vorzeitigen Ausstieg führte.

64 Speicherzuordnung fehlgeschlagen.

Ein Exit-Status von Null bedeutet, dass keine Probleme vorliegen.

Nutzen Sie PV online über die Dienste von onworks.net