pv - En ligne dans le Cloud

PROGRAMME:

Nom

pv - surveiller la progression des données à travers un tuyau

SYNOPSIS

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

DESCRIPTION

pv montre la progression des données à travers un pipeline en donnant des informations telles que l'heure
écoulé, pourcentage terminé (avec barre de progression), débit actuel, données totales
transféré, et ETA.

Pour l'utiliser, insérez-le dans un pipeline entre deux processus, avec les options appropriées.
Son entrée standard sera transmise à sa sortie standard et la progression sera
affiché sur l'erreur standard.

pv copiera chaque fourni DOSSIER à son tour en sortie standard (- signifie entrée standard), ou si
aucune DOSSIERs sont spécifiés, juste l'entrée standard est copiée. C'est le même comportement que
cat (1).

Un exemple simple pour voir à quelle vitesse un fichier est transféré en utilisant nc(1):

pv filet | nc -w 1 quelque part.com 3000

Un exemple similaire, transférer un fichier d'un autre processus et passer la taille attendue
à pv:

cat filet | pv -s 12345 | nc -w 1 quelque part.com 3000

Un exemple plus compliqué utilisant une sortie numérique pour alimenter le dialogue(1) programme pour un
affichage de la progression en plein écran :

(le goudron cf - . \
| pv -n -s $(du -sb . | awk '{imprimer $1}') \
| gzip -9 > out.tgz) 2> et 1 \
| dialogue --jauge 'Le progrès' 7 70

Prendre une image d'un disque, ignorer les erreurs :

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

Réécriture d'une image sur un disque :

pv image-disque.img > / Dev / sda

Remise à zéro d'un disque :

pv < /dev/zéro > / Dev / sda

Notez que si la taille d'entrée ne peut pas être calculée et que la sortie est un périphérique de bloc, alors
la taille du périphérique de bloc sera utilisée et pv s'arrêtera automatiquement à cette taille comme
if -S avait été donné.

(Linux uniquement) : observation du descripteur de fichier 3 ouvert par un autre processus 1234 :

pv -d 1234:3

(Linux uniquement) : regarder tous les descripteurs de fichiers utilisés par le processus 1234 :

pv -d 1234

OPTIONS

pv prend de nombreuses options, qui sont divisées en commutateurs d'affichage, modificateurs de sortie et
Options générales.

DISPLAY INTERRUPTEURS

Si aucun commutateur d'affichage n'est spécifié, pv se comporte comme si -p, -t, -e, -r et -b avait été
donné (c'est-à-dire que tout sauf le taux moyen est activé). Sinon, seuls ceux qui affichent
les types explicitement activés seront affichés.

-p, --le progrès
Allumez la barre de progression. Si l'entrée standard n'est pas un fichier et qu'aucune taille n'a été indiquée
(À l' -s modificateur), la barre de progression ne peut pas indiquer à quel point
le transfert est, donc il se déplacera juste à gauche et à droite pour indiquer que les données sont
en mouvement.

-t, --minuteur
Allumez la minuterie. Cela affichera le temps total écoulé que pv a été
courir pour.

-e, --eta
Activez la minuterie ETA. Cela tentera de deviner, sur la base du transfert précédent
taux et la taille totale des données, combien de temps il faudra avant l'achèvement. Cette option
n'aura aucun effet si la taille totale des données ne peut pas être déterminée.

-JE, --fineta
Activez la minuterie ETA, mais affichez l'heure d'arrivée locale estimée au lieu de
temps restant. Lorsque l'heure estimée est supérieure à 6 heures dans le futur, la date est
montré aussi.

-r, --taux
Allumez le compteur de taux. Cela affichera le taux actuel de transfert de données.

-une, --taux moyen
Activez le compteur de taux moyen. Cela affichera le taux moyen de données
transfert jusqu'à présent.

-b, --octets
Activez le compteur total d'octets. Cela affichera la quantité totale de données
transféré jusqu'à présent.

-T, --tampon-pourcentage
Activez l'affichage du pourcentage de tampon de transfert. Cela montrera le pourcentage de
le tampon de transfert en cours d'utilisation - mais voir la mise en garde sous %T dans le MISE EN PAGE
ci-dessous.

-UNE, --dernière-écrite NUM
Afficher le dernier NUM octets écrits - mais voir la mise en garde sous %n / a dans le MISE EN PAGE
section ci-dessous.

-F, --format Format
Ignorer les options -p, -t, -e, -r, -a, -b, -T et -A, et utilisez plutôt le format
un magnifique Format pour déterminer le format de sortie. Voir le MISE EN PAGE section ci-dessous.

-n, --numérique
Sortie numérique. Au lieu de donner une indication visuelle des progrès, pv donnera un
pourcentage entier, un par ligne, sur erreur standard, adapté à la tuyauterie (via
redirection alambiquée) en dialogue(1). Noter que -f n'est pas obligatoire si -n is
utilisé.

Notez que si --numérique est en cours d'utilisation, puis en ajoutant --octets entraînera le nombre de
octets traités jusqu'à présent à sortir au lieu d'un pourcentage ; si --ligne-mode est également
en cours d'utilisation, alors au lieu d'octets ou d'un pourcentage, le nombre de lignes jusqu'à présent est
sortir. Et enfin, si --minuteur est également utilisé, alors chaque ligne de sortie est préfixée
avec le temps écoulé jusqu'à présent, sous forme de nombre décimal de secondes.

-q, --silencieux
Aucune sortie. Utile si le -L l'option est utilisée seule pour simplement limiter le
taux de transfert d'un tuyau.

SORTIE MODIFICATEURS

-W, --attendre
Attendez que le premier octet ait été transféré avant d'afficher la progression
informations ou le calcul des ETA. Utile si le programme vers lequel vous dirigez ou
from requiert des informations supplémentaires avant de démarrer, par exemple la transmission de données dans gpg(1) ou
mcrypt(1) qui nécessitent une phrase secrète avant que les données puissent être traitées.

-RÉ, --départ différé SEC
Attendre jusqu'à SEC secondes se sont écoulées avant d'afficher des informations de progression, par exemple
exemple dans un script où vous ne voulez afficher une barre de progression que si cela commence à prendre
un long moment. Notez qu'il peut s'agir d'un nombre décimal tel que 0.5.

-s TAILLE, --Taille TAILLE
Supposons que la quantité totale de données à transférer soit TAILLE octets lors du calcul
pourcentages et ETA. Les mêmes suffixes de "k", "m" etc peuvent être utilisés comme avec -L.

N'a aucun effet si utilisé avec -d PID pour surveiller tous les descripteurs de fichiers d'un processus, mais
travaillera avec -d PID : FD.

-l, --ligne-mode
Au lieu de compter les octets, comptez les lignes (caractères de nouvelle ligne). La barre de progression sera
ne bouge que lorsqu'une nouvelle ligne est trouvée, et la valeur passée au -s l'option sera
interprété comme un nombre de lignes. Notez que les tailles de fichiers ne sont pas calculées automatiquement
lorsque cette option est utilisée, pour éviter d'avoir à lire tous les fichiers deux fois.

-0, --nul
Compter les lignes comme terminées par un zéro. Cette option implique --line-mode.

-i SECONDE, --intervalle SEC
Attendez SEC secondes entre les mises à jour. La valeur par défaut est de mettre à jour toutes les secondes. Noter
que cela peut être un nombre décimal tel que 0.1.

-w LARGEUR, --largeur LARGEUR
Supposons que le terminal est LARGEUR caractères au lieu d'essayer de le résoudre (ou
en supposant 80 s'il ne peut pas être deviné).

-H LA TAILLE, --la taille HAUTEUR
Supposons que le terminal est HAUTEUR rangées de haut, au lieu d'essayer de le résoudre (ou
en supposant 25 s'il ne peut pas être deviné).

-N NOM --Nom Nom
Préfixez les informations de sortie avec Nom. Utile en conjonction avec -c si tu as
un pipeline compliqué et vous voulez pouvoir en distinguer les différentes parties.

-F, --Obliger
Forcer la sortie. Normalement, pv ne produira aucun affichage visuel si l'erreur standard est
pas un terminal. Cette option l'oblige à le faire.

-c, --le curseur
Utilisez des séquences d'échappement de positionnement du curseur au lieu d'utiliser uniquement des retours chariot.
Ceci est utile en conjonction avec -N (nom) si vous utilisez plusieurs pv
appels dans un seul et long pipeline.

DONNEES TRANSFERT MODIFICATEURS

-L TAUX, --taux-limite EN PLUSIEURS FOIS
Limiter le transfert à un maximum de EN PLUSIEURS FOIS octets par seconde. Un suffixe de "k", "m",
« g » ou « t » peuvent être ajoutés pour désigner les kilo-octets (*1024), les méga-octets, etc.

-B OCTETS, --taille du tampon OCTETS
Utilisez une taille de tampon de transfert de OCTETS octets. Un suffixe de « k », « m », « g » ou « t » peut
être ajouté pour désigner les kilo-octets (*1024), les méga-octets, etc. Le tampon par défaut
size est la taille de bloc du système de fichiers du fichier d'entrée multipliée par 32 (512 Ko max),
ou 400 Ko si la taille du bloc ne peut pas être déterminée.

-Ç, --pas d'épissure
Ne jamais utiliser épissure(2), même si cela serait normalement possible. Les épissure(2) système
call est un moyen plus efficace de transférer des données depuis ou vers un canal que la normale
lirede Géographie (2) et avec la écrire(2), mais signifie que le tampon de transfert ne peut pas être utilisé. Cette
empêche -A et -T de travailler, donc si vous voulez utiliser -A or -T alors vous aurez besoin
à utiliser -C, au prix d'une petite perte d'efficacité de transfert. (Cette option n'a pas
effet sur les systèmes où épissure(2) n'est pas disponible).

-ET, --ignorer les erreurs
Ignorez les erreurs de lecture en essayant de sauter les sections incriminées. Les
les parties correspondantes de la sortie seront des octets nuls. Au début seulement quelques octets
sera ignoré, mais s'il y a beaucoup d'erreurs d'affilée, les sauts augmenteront
à des morceaux de 512. Ceci est destiné à être similaire à dd conv=sync, pas d'erreur mais a
pas été aussi minutieusement testé.

Spécifier -E deux fois pour ne signaler une erreur de lecture qu'une seule fois par fichier, au lieu de signaler
chaque plage d'octets est ignorée.

-S, --arrêt-à-taille
Si une taille a été spécifiée avec -s, arrêtez le transfert de données une fois que de nombreux octets ont
été écrit, au lieu de continuer jusqu'à la fin de la saisie.

-d PID[:FD], --watchfd PID[:FD]
Au lieu de transférer des données, regardez le descripteur de fichier FD de processus PID, et montrer son
le progrès. Les pv le processus se terminera lorsque FD soit passe à un autre fichier,
change de mode lecture/écriture, ou est fermé ; autres modificateurs de transfert de données - et à distance
control - ne peut pas être utilisé avec cette option.

Si seulement un PID est spécifié, alors ce processus sera surveillé et tous les
les fichiers et les périphériques bloqués qu'il ouvre seront affichés avec une barre de progression. Les pv processus
quittera lorsque le processus PID sorties.

-R PID, --à distance PID
If PID est une instance de pv qui tourne déjà, -R PID provoquera que
instance pour agir comme si elle avait reçu la ligne de commande de cette instance à la place.
Par exemple, si pv -L 123K s'exécute avec l'ID de processus 9876, puis s'exécute pv -R 9876
-L 321K le fera commencer à utiliser une limite de débit de 321k au lieu de 123k. Noter
que certaines options ne peuvent pas être modifiées pendant l'exécution, telles que -c, -l, -f, -D, -E et
-S.

GÉNÉRAL OPTIONS

-P DÉPOSER, --pidfile DOSSIER
Enregistrez l'ID de processus de pv in DOSSIER. Le fichier sera tronqué s'il est déjà
existe et sera supprimé lorsque pv sorties. Tandis que pv est en cours d'exécution, il contiendra un
numéro unique - l'ID de processus de pv - suivi d'une nouvelle ligne.

-h, --Aidez-moi
Imprimez un message d'utilisation sur la sortie standard et quittez avec succès.

-V, --version
Imprimez les informations de version sur la sortie standard et quittez avec succès.

MISE EN PAGE

Si la -F option est donnée, alors le format de sortie est déterminé par le format donné
chaîne de caractères. Dans cette chaîne, les séquences suivantes peuvent être utilisées :

%p Barre de progression. S'agrandit pour remplir l'espace restant. Ne doit être spécifié qu'une seule fois.
Équivalent à -p.

%t Temps écoulé. Équivalent à -t.

%e ETA comme temps restant. Équivalent à -e.

%I ETA comme heure locale d'achèvement. Équivalent à -I.

%r Taux de transfert de données actuel. Équivalent à -r.

%a Taux de transfert de données moyen. Équivalent à -a.

%b Octets transférés jusqu'à présent (ou lignes si -l a été précisé). Équivalent à -b.

%T Pourcentage du tampon de transfert utilisé. Équivalent à -T. Affiche "{----}" si le
le transfert se fait avec épissure(2), puisque l'épissure vers ou depuis des tuyaux n'utilise pas
le tampon.

%n / a Afficher le dernier n octets écrits (par exemple % 16A pour les 16 derniers octets). Affiche uniquement les points
si le transfert se fait avec épissure(2), étant donné que l'épissure vers ou depuis les tuyaux ne
pas utiliser le tampon.

%N Préfixe du nom donné par -N. Complété à 9 caractères avec des espaces, et suffixé par :.

%% Un seul %.

La chaîne de format équivalente à l'activation de tous les commutateurs d'affichage est `%N %b %T %t %r %a %p
%e'.

EXIT STATUT

Un état de sortie de 1 indique un problème avec le -R or -P options.

Tout autre état de sortie est un masque binaire des éléments suivants :

2 Impossible d'accéder à un ou plusieurs fichiers, état(2) ed, ou ouvert.

4 Un fichier d'entrée était le même que le fichier de sortie.

8 Erreur interne lors de la fermeture d'un fichier ou du passage au fichier suivant.

16 Une erreur s'est produite lors du transfert des données d'un ou plusieurs fichiers d'entrée.

32 Un signal a été capté qui a provoqué une sortie prématurée.

64 L'allocation de mémoire a échoué.

Un état de sortie zéro indique qu'il n'y a aucun problème.

Utilisez pv en ligne en utilisant les services onworks.net