pv

pv - Informationen zu Datenflüssen anzeigen

Aufruf

Optionen

Unix	GNU	Parameter	Beschreibung

Exit-Status

Wert	Beschreibung
0	Erfolg
>0	Fehler

Konfiguration

Dateien

Datei	Beschreibung

Anhang

---

Dokumentation

Man-Page

1. prep(1)

Beschreibung

Beispielausgabe

 24.2GB 0:44:21 [4.45MB/s] [=============>                     ] 40% ETA 1:05:38

Informationen

• Verstrichene Zeit
• Prozentsatz
• Fortschrittsbalken
• Aktuelle Durchsatzrate
• Insgesamt übertragene Daten
• Erwartete Zeit bis zum Abschluss (ETA)

Anwendungen

1. Ersatz für cat mit Fortschrittsanzeige
   • stdin wird an stdout weitergeleitet, der Fortschritt wird auf dem stderr angezeigt
2. Einsatz als Filter
   • In einer Pipeline zwischen zwei Prozessen

Installation

sudo apt install pv

Anwendung

Ersatz für cat

Eine Datei kopieren

pv QUELLDATEI > ZIELDATEI

pv als Filter

pv übergibt eine 2 GiB große Datei wichtiges_backup.img an dd, das diese auf das (nicht-existente) Gerät "festplatte" schreibt:

sudo dd if=/media/externe_festplatte/wichtige_backup.img | pv -s 2g | dd of=/dev/festplatte

Öffne eine Datei mit cat und leite sie durch pv, wobei umfassende Statistiken erstellt werden.

Von dort wird an netcat (nc) übergeben, dass die Datei an ein System (Host) auf Port 7345 sendet:

cat datei | pv -petra | nc ubuntuusers.de 7345
dd if=/dev/sda | pv -s 100G | pigz | ssh root@mx10.foxtom.de -p 2227 'dd of=/media/daten/backup/mx20/sdaMx20_2022-04-25.img.gz'

Single core CPU I/O

Mit dd aus /dev/urandom lesen und nach /dev/null schreiben. Dabei werden 1000 MiB als 100% definiert:

dd if=/dev/urandom bs=1M count=1000 | pv -petra -s 1000m > /dev/null

Freien Speicherplatz mit Nullen überschreiben

sudo pv < /dev/zero > ZIELDATEI

Übertragungsgeschwindigkeit messen

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

pv DATEI | nc -w 1 irgendwo.com 3000

Ein ähnliches Beispiel, bei dem eine Datei von einem anderen Prozess übertragen und die erwartete Größe an pv übergeben wird:

cat DATEI |  pv -s 12345 |  nc -w 1 irgendwo.com 3000

Ausgabe mit dialog

Ein komplizierteres Beispiel, bei dem eine numerische Ausgabe in das Programm dialog(1) für einen Vollbildmodus eingegeben wird Fortschrittsanzeige:

(tar cf - . \
 |  pv -n -s $(du -sb . | awk '{print $1}') \
 |  gzip -9 > out.tgz) 2>&1 \
 |  dialog --gauge 'Fortschritt' 7 70

Image einer Festplatte erstellen (Fehler überspringen)

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

Zurückschreiben eines Images

sudo pv disk-image.img > /dev/sda

Nullen einer Festplatte

pv < /dev/zero > /dev/sda

Beachten Sie, dass, wenn die Eingabegröße nicht berechnet werden kann und die Ausgabe ein Blockgerät ist, die Größe der block wird verwendet und pv stoppt automatisch bei dieser Größe, als ob -S gegeben worden wäre.

(nur Linux): Beobachten von Dateideskriptor 3 geöffnet von einem anderen Prozess 1234:

pv-d 1234:3

Nur Linux

Überwachen aller Dateideskriptoren, die von Prozess 1234 verwendet werden:

pv-d 1234

COMMON SWITCHES

Befehl	Aufgabe
pv -ptebar	Zeigen Sie einen Fortschrittsbalken, die verstrichene Zeit, die geschätzte Fertigstellungszeit, den Bytezähler, die Durchschnittsrate und den aktuellen Mietpreis.
pv -Betlap	Zeigen Sie einen Fortschrittsbalken, die verstrichene Zeit, die geschätzte Fertigstellungszeit, den Zeilenzähler und die Durchschnittsrate an. Zählen von Zeilen statt Bytes.
pv -t	Zeigt nur die verstrichene Zeit an - nützlich als einfacher Timer, zB Schlaf 10m.
pv -pterb	Das Standardverhalten: Fortschrittsbalken, verstrichene Zeit, geschätzte Fertigstellungszeit, aktuelle Rate und Byte-Zähler.

Syntax

pv [OPTION] [DATEI]...
pv [-h|-V]

Rückgabewert

Bitmaske	Beschreibung
0	Erfolg
1	Problem mit den Optionen -R oder -P hin
2	Eine oder mehrere Dateien konnten nicht aufgerufen, gestat(2)ed oder geöffnet werden.
4	Eine Eingabedatei war die gleiche 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 empfangen, das einen vorzeitigen Ausstieg verursachte.
64	Speicherzuweisung fehlgeschlagen.