pv - Online di Awan

PROGRAM:

NAMA

pv - memantau kemajuan data melalui pipa

RINGKASAN

pv [PILIHAN] [FILE] ...
pv [-h|-V]

DESKRIPSI

pv menunjukkan kemajuan data melalui pipa dengan memberikan informasi seperti waktu
berlalu, persentase selesai (dengan bilah kemajuan), tingkat throughput saat ini, total data
ditransfer, dan ETA.

Untuk menggunakannya, masukkan ke dalam pipa di antara dua proses, dengan opsi yang sesuai.
Input standarnya akan diteruskan ke output standarnya dan kemajuannya akan
ditampilkan pada kesalahan standar.

pv akan menyalin setiap yang disediakan FILE pada gilirannya ke keluaran standar (- berarti masukan standar), atau jika
tidak FILEs ditentukan hanya input standar yang disalin. Ini adalah perilaku yang sama dengan
kucing(1).

Contoh sederhana untuk melihat seberapa cepat file ditransfer menggunakan nc(1):

pv fillet | nc -w 1 di suatu tempat.com 3000

Contoh serupa, mentransfer file dari proses lain dan melewati ukuran yang diharapkan
untuk pv:

kucing fillet | pv -s 12345 | nc -w 1 di suatu tempat.com 3000

Contoh yang lebih rumit menggunakan output numerik untuk dimasukkan ke dalam dialog(1) program untuk a
tampilan kemajuan layar penuh:

(ter cf - . \
| pv -n -s $(du -sb . | Wow '{mencetak $1}') \
| gzip -9 > keluar.tgz) 2> & 1 \
| dialog --mengukur 'Kemajuan' 7 70

Mengambil gambar disk, melewatkan kesalahan:

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

Menulis gambar kembali ke disk:

pv disk-image.img > / Dev / sda

Meniadakan disk:

pv < /dev/nol > / Dev / sda

Perhatikan bahwa jika ukuran input tidak dapat dihitung, dan outputnya adalah perangkat blok, maka
ukuran perangkat blok akan digunakan dan pv akan secara otomatis berhenti pada ukuran itu sebagai
if -S telah diberikan.

(Khusus Linux): Menonton deskriptor file 3 dibuka oleh proses lain 1234:

pv -d 1234:3

(Khusus Linux): Menonton semua deskriptor file yang digunakan oleh proses 1234:

pv -d 1234

PILIHAN

pv mengambil banyak opsi, yang dibagi menjadi sakelar tampilan, pengubah keluaran, dan
pilihan umum.

DISPLAY BERALIH

Jika tidak ada sakelar tampilan yang ditentukan, pv berperilaku seolah-olah -p, -t, -e, -r, dan -b telah
diberikan (yaitu semuanya kecuali tarif rata-rata diaktifkan). Jika tidak, hanya tampilan itu
jenis yang secara eksplisit diaktifkan akan ditampilkan.

-P, --kemajuan
Aktifkan bilah kemajuan. Jika input standar bukan file dan tidak ada ukuran yang diberikan
(dengan -s pengubah), bilah kemajuan tidak dapat menunjukkan seberapa dekat dengan penyelesaian
transfernya adalah, jadi itu hanya akan bergerak ke kiri dan ke kanan untuk menunjukkan bahwa data tersebut
bergerak.

-T, --pengatur waktu
Hidupkan pengatur waktu. Ini akan menampilkan total waktu yang telah berlalu pv telah
berlari untuk.

-e, --eta
Nyalakan pengatur waktu ETA. Ini akan mencoba menebak, berdasarkan transfer sebelumnya
tarif dan total ukuran data, berapa lama sebelum selesai. Pilihan ini
tidak akan berpengaruh jika total ukuran data tidak dapat ditentukan.

-SAYA, --baik saja
Nyalakan penghitung waktu ETA, tetapi tampilkan perkiraan waktu kedatangan lokal, bukan
waktu tersisa. Ketika perkiraan waktu lebih dari 6 jam di masa depan, tanggalnya adalah
ditampilkan juga.

-R, --kecepatan
Nyalakan penghitung tarif. Ini akan menampilkan kecepatan transfer data saat ini.

-Sebuah, --Harga rata-rata
Nyalakan penghitung tarif rata-rata. Ini akan menampilkan kecepatan rata-rata data
transfer sejauh ini.

-B, --byte
Hidupkan penghitung byte total. Ini akan menampilkan jumlah total data
ditransfer sejauh ini.

-T, --buffer-persen
Nyalakan tampilan persentase buffer transfer. Ini akan menunjukkan persentase
buffer transfer sedang digunakan - tetapi lihat peringatan di bawah %T dalam FORMAT bagian
di bawah.

-SEBUAH, --terakhir-tertulis NUM
Tunjukkan yang terakhir NUM byte ditulis - tetapi lihat peringatan di bawah %nA dalam FORMAT
bagian di bawah ini.

-F, --format FORMAT
Abaikan opsinya -p, -t, -e, -r, -a, -b, -T, dan -A, dan sebagai gantinya gunakan format
string FORMAT untuk menentukan format keluaran. Lihat FORMAT bagian di bawah ini.

-N, --numerik
Keluaran numerik. Alih-alih memberikan indikasi visual kemajuan, pv akan memberikan
persentase bilangan bulat, satu per baris, pada kesalahan standar, cocok untuk pemipaan (melalui
pengalihan berbelit-belit) ke dialog(1). Perhatikan bahwa -f tidak diperlukan jika -n is
sedang digunakan.

Perhatikan bahwa jika --numerik sedang digunakan, lalu tambahkan --byte akan menyebabkan jumlah
byte yang diproses sejauh ini menjadi output, bukan persentase; jika --mode-garis juga
digunakan, maka alih-alih byte atau persentase, jumlah baris sejauh ini adalah
keluaran. Dan akhirnya, jika --pengatur waktu juga digunakan, maka setiap jalur keluaran diawali
dengan waktu yang telah berlalu sejauh ini, sebagai angka desimal detik.

-Q, --diam
Tidak ada keluaran. Berguna jika -L opsi sedang digunakan sendiri untuk membatasi
kecepatan transfer pipa.

KELUARAN PEMODIFIKASI

-W, --tunggu
Tunggu hingga byte pertama telah ditransfer sebelum menunjukkan kemajuan apa pun
informasi atau menghitung ETA apapun. Berguna jika program yang Anda tuju atau
dari memerlukan informasi tambahan sebelum dimulai, misalnya menyalurkan data ke dalam gpg(1) atau
mcrypt(1) yang memerlukan frasa sandi sebelum data dapat diproses.

-D, --penundaan-mulai SEC
Tunggu sampai SEC detik telah berlalu sebelum menampilkan informasi kemajuan apa pun, untuk
contoh dalam skrip di mana Anda hanya ingin menampilkan bilah kemajuan jika mulai mengambil
waktu yang lama. Perhatikan bahwa ini dapat berupa desimal seperti 0.5.

-s UKURAN, --ukuran UKURAN
Asumsikan jumlah total data yang akan ditransfer adalah UKURAN byte saat menghitung
persentase dan ETA. Sufiks yang sama dari "k", "m" dll dapat digunakan sebagai dengan -L.

Tidak berpengaruh jika digunakan dengan -d PID untuk menonton semua deskriptor file dari suatu proses, tetapi
Akan bekerja dengan -d PID:FD.

-aku, --mode-garis
Alih-alih menghitung byte, hitung baris (karakter baris baru). Bilah kemajuan akan
hanya bergerak ketika baris baru ditemukan, dan nilai diteruskan ke -s pilihan akan
diartikan sebagai jumlah baris. Perhatikan bahwa ukuran file tidak dihitung secara otomatis
ketika opsi ini digunakan, untuk menghindari keharusan membaca semua file dua kali.

-0, --batal
Hitung baris sebagai null dihentikan. Opsi ini menyiratkan --line-mode.

-i DETIK, --selang SEC
Tunggu SEC detik di antara pembaruan. Standarnya adalah memperbarui setiap detik. Catatan
bahwa ini dapat berupa desimal seperti 0.1.

-w LEBAR, --lebar LEBAR
Asumsikan terminalnya adalah LEBAR karakter yang luas, alih-alih mencoba menyelesaikannya (atau
dengan asumsi 80 jika tidak dapat ditebak).

-H TINGGI, --tinggi TINGGI
Asumsikan terminalnya adalah TINGGI baris tinggi, alih-alih mencoba menyelesaikannya (atau
dengan asumsi 25 jika tidak dapat ditebak).

-N NAMA, --nama NAMA
Awalan informasi keluaran dengan NAMA. Berguna dalam hubungannya dengan -c jika Anda memiliki
pipa yang rumit dan Anda ingin dapat membedakan bagian-bagian yang berbeda.

-F, --memaksa
Keluaran paksa. Biasanya, pv tidak akan menampilkan tampilan visual apa pun jika kesalahan standar adalah
bukan terminal. Opsi ini memaksanya untuk melakukannya.

-C, --kursor
Gunakan urutan pelarian pemosisian kursor alih-alih hanya menggunakan carriage return.
Ini berguna dalam hubungannya dengan -N (nama) jika Anda menggunakan banyak pv
doa dalam satu, panjang, pipa.

DATA TRANSFER PEMODIFIKASI

-L KECEPATAN, --rate-batas MENILAI
Batasi transfer hingga maksimum MENILAI byte per detik. Sebuah akhiran dari "k", "m",
"g", atau "t" dapat ditambahkan untuk menunjukkan kilobyte (*1024), megabyte, dan seterusnya.

-B BYTE, --ukuran buffer BYTE
Gunakan ukuran buffer transfer sebesar BYTE byte. Sufiks dari "k", "m", "g", atau "t" bisa
ditambahkan untuk menunjukkan kilobyte (*1024), megabyte, dan seterusnya. Buffer bawaan
size adalah ukuran blok sistem file file input dikalikan dengan 32 (maks. 512kb),
atau 400kb jika ukuran blok tidak dapat ditentukan.

-C, --tanpa sambungan
Jangan pernah gunakan sambatan(2), bahkan jika itu biasanya mungkin. NS sambatan(2) sistem
panggilan adalah cara yang lebih efisien untuk mentransfer data dari atau ke pipa daripada biasa
Baca baca(2) dan menulis(2), tetapi berarti buffer transfer tidak dapat digunakan. Ini
mencegah -A dan -T dari bekerja, jadi jika Anda ingin menggunakan -A or -T maka Anda akan membutuhkan
untuk menggunakan -C, dengan biaya kerugian kecil dalam efisiensi transfer. (Opsi ini tidak memiliki
efek pada sistem di mana sambatan(2) tidak tersedia).

-E, --lewati-kesalahan
Abaikan kesalahan baca dengan mencoba melewati bagian yang menyinggung. NS
bagian yang sesuai dari output akan menjadi byte nol. Awalnya hanya beberapa byte
akan dilewati, tetapi jika ada banyak kesalahan berturut-turut maka lompatan akan naik
menjadi potongan 512. Ini dimaksudkan agar mirip dengan dd konv=sinkronisasi, tidak ada kesalahan tetapi telah
belum diuji secara menyeluruh.

Menentukan -E dua kali untuk hanya melaporkan kesalahan baca sekali per file, alih-alih melaporkan
setiap rentang byte dilewati.

-S, --berhenti-pada-ukuran
Jika ukuran ditentukan dengan -s, berhenti mentransfer data setelah memiliki banyak byte
telah ditulis, alih-alih melanjutkan ke akhir input.

-d PID[:FD], --watchfd PID[:FD]
Alih-alih mentransfer data, tonton deskriptor file FD proses PID, dan tunjukkan
kemajuan. NS pv proses akan keluar ketika FD baik perubahan ke file yang berbeda,
mengubah mode baca/tulis, atau ditutup; pengubah transfer data lainnya - dan remote
kontrol - tidak dapat digunakan dengan opsi ini.

Jika hanya a PID ditentukan, maka proses itu akan diawasi, dan semuanya teratur
file dan blokir perangkat yang dibukanya akan ditampilkan dengan bilah kemajuan. NS pv proses
akan keluar saat proses PID keluar.

-R PID, --terpencil PID
If PID adalah contoh dari pv yang sudah berjalan, -R PID akan menyebabkan itu
instance untuk bertindak seolah-olah telah diberikan baris perintah instance ini.
Sebagai contoh, jika pv -L 123k sedang berjalan dengan ID proses 9876, lalu berjalan pv -R 9876
-L 321k akan menyebabkannya mulai menggunakan batas tarif 321k, bukan 123k. Catatan
bahwa beberapa opsi tidak dapat diubah saat berjalan, seperti -c, -l, -f, -D, -E, dan
-S.

UMUM PILIHAN

-P MENGAJUKAN, --pidfile FILE
Simpan ID proses dari pv in FILE. File akan terpotong jika sudah
ada, dan akan dihapus ketika pv keluar. Ketika pv sedang berjalan, itu akan berisi
nomor tunggal - ID proses dari pv - diikuti oleh baris baru.

-H, --membantu
Cetak pesan penggunaan pada output standar dan keluar dengan sukses.

-V, --Versi: kapan
Cetak informasi versi pada keluaran standar dan keluar dengan sukses.

FORMAT

Jika -F opsi diberikan, maka format output ditentukan oleh format yang diberikan
rangkaian. Dalam string itu, urutan berikut dapat digunakan:

%p Bilah kemajuan. Memperluas untuk mengisi ruang yang tersisa. Seharusnya hanya ditentukan sekali.
Setara dengan -p.

%t Waktu berlalu. Setara dengan -t.

%e ETA sebagai waktu yang tersisa. Setara dengan -e.

%I ETA sebagai waktu penyelesaian setempat. Setara dengan -I.

%r Kecepatan transfer data saat ini. Setara dengan -r.

%a Kecepatan transfer data rata-rata. Setara dengan -a.

%b Byte yang ditransfer sejauh ini (atau baris jika -l telah ditentukan). Setara dengan -b.

%T Persentase buffer transfer yang digunakan. Setara dengan -T. Menampilkan "{----}" jika
transfer sedang dilakukan dengan sambatan(2), karena penyambungan ke atau dari pipa tidak menggunakan
penyangga.

%nA Tunjukkan yang terakhir n byte ditulis (mis %16A untuk 16 byte terakhir). Hanya menunjukkan titik
jika transfer dilakukan dengan sambatan(2), karena penyambungan ke atau dari pipa tidak
tidak menggunakan buffer.

%N Awalan nama diberikan oleh -N. Diisi dengan 9 karakter dengan spasi, dan diakhiri dengan :.

%% Tunggal %.

Format string yang setara dengan menyalakan semua sakelar tampilan adalah `%N %b %T %t %r %a %p
%e'.

EXIT STATUS

Status keluar 1 menunjukkan masalah dengan -R or -P Pilihan.

Status keluar lainnya adalah bitmask dari berikut ini:

2 Satu atau lebih file tidak dapat diakses, Stat(2) ed, atau dibuka.

4 File input sama dengan file output.

8 Kesalahan internal dengan menutup file atau pindah ke file berikutnya.

16 Terjadi kesalahan saat mentransfer data dari satu atau beberapa file masukan.

32 Sebuah sinyal tertangkap yang menyebabkan keluar lebih awal.

64 Alokasi memori gagal.

Status keluar nol menunjukkan tidak ada masalah.

Gunakan pv online menggunakan layanan onworks.net