OS Manuals

/usr/bin/pv

Terminal-based tool for monitoring data progress through a pipeline

From pv 1.12.7-r0 (os), captured 2026-11-05 by running pv --help (exit 0). permalink

Usa
ge:
pv
[OP
TIO
N]
[FI
LE]
...
Con
cat
ena
te
FIL
E(s
),
or
sta
nda
rd
inp
ut,
to
sta
nda
rd
out
put
,
wit
h
mon
ito
rin
g.

  -p, --progress
  s
  h
  o
  w
  p
  r
  o
  g
  r
  e
  s
  s
  b
  a
  r
  -t, --timer
  s
  h
  o
  w
  e
  l
  a
  p
  s
  e
  d
  t
  i
  m
  e
  -e, --eta
  s
  h
  o
  w
  e
  s
  t
  i
  m
  a
  t
  e
  d
  t
  i
  m
  e
  o
  f
  a
  r
  r
  i
  v
  a
  l
  (
  c
  o
  m
  p
  l
  e
  t
  i
  o
  n
  )
  -I, --fineta
  s
  h
  o
  w
  a
  b
  s
  o
  l
  u
  t
  e
  e
  s
  t
  i
  m
  a
  t
  e
  d
  t
  i
  m
  e
  o
  f
  a
  r
  r
  i
  v
  a
  l
  (
  c
  o
  m
  p
  l
  e
  t
  i
  o
  n
  )
  -r, --rate
  s
  h
  o
  w
  d
  a
  t
  a
  t
  r
  a
  n
  s
  f
  e
  r
  r
  a
  t
  e
  c
  o
  u
  n
  t
  e
  r
  -a, --average-rate
  s
  h
  o
  w
  d
  a
  t
  a
  t
  r
  a
  n
  s
  f
  e
  r
  a
  v
  e
  r
  a
  g
  e
  r
  a
  t
  e
  c
  o
  u
  n
  t
  e
  r
  -b, --bytes
  s
  h
  o
  w
  n
  u
  m
  b
  e
  r
  o
  f
  b
  y
  t
  e
  s
  t
  r
  a
  n
  s
  f
  e
  r
  r
  e
  d
  -T, --buffer-percent
  s
  h
  o
  w
  p
  e
  r
  c
  e
  n
  t
  a
  g
  e
  o
  f
  t
  r
  a
  n
  s
  f
  e
  r
  b
  u
  f
  f
  e
  r
  i
  n
  u
  s
  e
  -A, --last-written NUM
  s
  h
  o
  w
  N
  U
  M
  b
  y
  t
  e
  s
  l
  a
  s
  t
  w
  r
  i
  t
  t
  e
  n
  -F, --format FORMAT
  s
  e
  t
  o
  u
  t
  p
  u
  t
  f
  o
  r
  m
  a
  t
  t
  o
  F
  O
  R
  M
  A
  T
  -n, --numeric
  o
  u
  t
  p
  u
  t
  p
  e
  r
  c
  e
  n
  t
  a
  g
  e
  s
  ,
  n
  o
  t
  v
  i
  s
  u
  a
  l
  i
  n
  f
  o
  r
  m
  a
  t
  i
  o
  n
  -q, --quiet
  d
  o
  n
  o
  t
  o
  u
  t
  p
  u
  t
  a
  n
  y
  t
  r
  a
  n
  s
  f
  e
  r
  i
  n
  f
  o
  r
  m
  a
  t
  i
  o
  n
  a
  t
  a
  l
  l

  -8, --bits
  s
  h
  o
  w
  n
  u
  m
  b
  e
  r
  o
  f
  b
  i
  t
  s
  t
  r
  a
  n
  s
  f
  e
  r
  r
  e
  d
  -k, --si
  t
  r
  e
  a
  t
  s
  u
  f
  f
  i
  x
  e
  s
  a
  s
  m
  u
  l
  t
  i
  p
  l
  e
  s
  o
  f
  1
  0
  0
  0
  r
  a
  t
  h
  e
  r
  t
  h
  a
  n
  1
  0
  2
  4
  -W, --wait
  d
  i
  s
  p
  l
  a
  y
  n
  o
  t
  h
  i
  n
  g
  u
  n
  t
  i
  l
  f
  i
  r
  s
  t
  b
  y
  t
  e
  t
  r
  a
  n
  s
  f
  e
  r
  r
  e
  d
  -D, --delay-start SEC
  d
  i
  s
  p
  l
  a
  y
  n
  o
  t
  h
  i
  n
  g
  u
  n
  t
  i
  l
  S
  E
  C
  s
  e
  c
  o
  n
  d
  s
  h
  a
  v
  e
  p
  a
  s
  s
  e
  d
  -s, --size SIZE
  s
  e
  t
  e
  s
  t
  i
  m
  a
  t
  e
  d
  d
  a
  t
  a
  s
  i
  z
  e
  t
  o
  S
  I
  Z
  E
  b
  y
  t
  e
  s
  -g, --gauge
  i
  f
  s
  i
  z
  e
  u
  n
  k
  n
  o
  w
  n
  ,
  s
  h
  o
  w
  r
  a
  t
  e
  v
  s
  m
  a
  x
  r
  a
  t
  e
  -l, --line-mode
  c
  o
  u
  n
  t
  l
  i
  n
  e
  s
  i
  n
  s
  t
  e
  a
  d
  o
  f
  b
  y
  t
  e
  s
  -0, --null
  l
  i
  n
  e
  s
  a
  r
  e
  n
  u
  l
  l
  -
  t
  e
  r
  m
  i
  n
  a
  t
  e
  d
  -i, --interval SEC
  u
  p
  d
  a
  t
  e
  e
  v
  e
  r
  y
  S
  E
  C
  s
  e
  c
  o
  n
  d
  s
  -m, --average-rate-window SEC
  c
  o
  m
  p
  u
  t
  e
  a
  v
  e
  r
  a
  g
  e
  r
  a
  t
  e
  o
  v
  e
  r
  p
  a
  s
  t
  S
  E
  C
  s
  e
  c
  o
  n
  d
  s
  (
  d
  e
  f
  a
  u
  l
  t
  3
  0
  s
  )
  -w, --width WIDTH
  a
  s
  s
  u
  m
  e
  t
  e
  r
  m
  i
  n
  a
  l
  i
  s
  W
  I
  D
  T
  H
  c
  h
  a
  r
  a
  c
  t
  e
  r
  s
  w
  i
  d
  e
  -H, --height HEIGHT
  a
  s
  s
  u
  m
  e
  t
  e
  r
  m
  i
  n
  a
  l
  i
  s
  H
  E
  I
  G
  H
  T
  r
  o
  w
  s
  h
  i
  g
  h
  -N, --name NAME
  p
  r
  e
  f
  i
  x
  v
  i
  s
  u
  a
  l
  i
  n
  f
  o
  r
  m
  a
  t
  i
  o
  n
  w
  i
  t
  h
  N
  A
  M
  E
  -u, --bar-style STYLE
  s
  e
  t
  d
  e
  f
  a
  u
  l
  t
  b
  a
  r
  s
  t
  y
  l
  e
  t
  o
  S
  T
  Y
  L
  E
  -x, --extra-display SPEC
  a
  l
  s
  o
  s
  e
  n
  d
  p
  r
  o
  g
  r
  e
  s
  s
  t
  o
  S
  P
  E
  C
  -9, --conemu
  s
  e
  t
  t
  e
  r
  m
  i
  n
  a
  l
  p
  r
  o
  g
  r
  e
  s
  s
  s
  t
  a
  t
  e
  w
  i
  t
  h
  O
  S
  C
  9
  ;
  4
  (
  C
  o
  n
  E
  m
  u
  )
  -v, --stats
  o
  u
  t
  p
  u
  t
  t
  r
  a
  n
  s
  f
  e
  r
  s
  t
  a
  t
  i
  s
  t
  i
  c
  s
  a
  t
  t
  h
  e
  e
  n
  d
  -f, --force
  o
  u
  t
  p
  u
  t
  e
  v
  e
  n
  i
  f
  s
  t
  a
  n
  d
  a
  r
  d
  e
  r
  r
  o
  r
  i
  s
  n
  o
  t
  a
  t
  e
  r
  m
  i
  n
  a
  l
  -c, --cursor
  u
  s
  e
  c
  u
  r
  s
  o
  r
  p
  o
  s
  i
  t
  i
  o
  n
  i
  n
  g
  e
  s
  c
  a
  p
  e
  s
  e
  q
  u
  e
  n
  c
  e
  s

  -o, --output FILE
  w
  r
  i
  t
  e
  o
  u
  t
  p
  u
  t
  t
  o
  F
  I
  L
  E
  i
  n
  s
  t
  e
  a
  d
  o
  f
  s
  t
  d
  o
  u
  t
  -L, --rate-limit RATE
  l
  i
  m
  i
  t
  t
  r
  a
  n
  s
  f
  e
  r
  t
  o
  R
  A
  T
  E
  b
  y
  t
  e
  s
  p
  e
  r
  s
  e
  c
  o
  n
  d
  -B, --buffer-size BYTES
  u
  s
  e
  a
  b
  u
  f
  f
  e
  r
  s
  i
  z
  e
  o
  f
  B
  Y
  T
  E
  S
  -C, --no-splice
  n
  e
  v
  e
  r
  u
  s
  e
  s
  p
  l
  i
  c
  e
  (
  )
  ,
  a
  l
  w
  a
  y
  s
  u
  s
  e
  r
  e
  a
  d
  /
  w
  r
  i
  t
  e
  -J, --pipe-buffer-size BYTES
  s
  e
  t
  t
  h
  e
  p
  i
  p
  e
  b
  u
  f
  f
  e
  r
  s
  i
  z
  e
  t
  o
  B
  Y
  T
  E
  S
  -E, --skip-errors
  s
  k
  i
  p
  r
  e
  a
  d
  e
  r
  r
  o
  r
  s
  i
  n
  i
  n
  p
  u
  t
  -Z, --error-skip-block BYTES
  s
  k
  i
  p
  e
  r
  r
  o
  r
  s
  i
  n
  B
  Y
  T
  E
  S
  b
  l
  o
  c
  k
  s
  a
  t
  a
  t
  i
  m
  e
  -S, --stop-at-size
  s
  t
  o
  p
  a
  f
  t
  e
  r
  -
  -
  s
  i
  z
  e
  b
  y
  t
  e
  s
  h
  a
  v
  e
  b
  e
  e
  n
  t
  r
  a
  n
  s
  f
  e
  r
  r
  e
  d
  -Y, --sync
  f
  l
  u
  s
  h
  c
  a
  c
  h
  e
  t
  o
  d
  i
  s
  k
  a
  f
  t
  e
  r
  e
  v
  e
  r
  y
  w
  r
  i
  t
  e
  -K, --direct-io
  u
  s
  e
  d
  i
  r
  e
  c
  t
  I
  /
  O
  t
  o
  b
  y
  p
  a
  s
  s
  c
  a
  c
  h
  e
  -O, --sparse
  t
  r
  y
  t
  o
  s
  e
  e
  k
  i
  n
  s
  t
  e
  a
  d
  o
  f
  w
  r
  i
  t
  i
  n
  g
  n
  u
  l
  l
  b
  y
  t
  e
  s
  -X, --discard
  d
  i
  s
  c
  a
  r
  d
  i
  n
  p
  u
  t
  i
  n
  s
  t
  e
  a
  d
  o
  f
  w
  r
  i
  t
  i
  n
  g
  t
  o
  o
  u
  t
  p
  u
  t
  -U, --store-and-forward FILE
  w
  r
  i
  t
  e
  a
  l
  l
  i
  n
  p
  u
  t
  t
  o
  F
  I
  L
  E
  b
  e
  f
  o
  r
  e
  w
  r
  i
  t
  i
  n
  g
  t
  o
  o
  u
  t
  p
  u
  t

  -d, --watchfd PID[:FD]|=NAME|@LISTFILE
  w
  a
  t
  c
  h
  f
  i
  l
  e
  F
  D
  o
  p
  e
  n
  e
  d
  b
  y
  p
  r
  o
  c
  e
  s
  s
  P
  I
  D
  -R, --remote PID
  u
  p
  d
  a
  t
  e
  s
  e
  t
  t
  i
  n
  g
  s
  o
  f
  p
  r
  o
  c
  e
  s
  s
  P
  I
  D
  -Q, --query PID
  s
  h
  o
  w
  p
  r
  o
  g
  r
  e
  s
  s
  o
  f
  p
  r
  o
  c
  e
  s
  s
  P
  I
  D
  -M, --monitor in|0|out|1|both|2
  r
  u
  n
  a
  c
  o
  m
  m
  a
  n
  d
  a
  n
  d
  m
  o
  n
  i
  t
  o
  r
  i
  t
  s
  s
  t
  a
  n
  d
  a
  r
  d
  i
  n
  p
  u
  t
  ,
  o
  u
  t
  p
  u
  t
  ,
  o
  r
  b
  o
  t
  h

  -P, --pidfile FILE
  s
  a
  v
  e
  p
  r
  o
  c
  e
  s
  s
  I
  D
  i
  n
  F
  I
  L
  E
  -h, --help
  s
  h
  o
  w
  t
  h
  i
  s
  h
  e
  l
  p
  a
  n
  d
  e
  x
  i
  t
  -V, --version
  s
  h
  o
  w
  v
  e
  r
  s
  i
  o
  n
  i
  n
  f
  o
  r
  m
  a
  t
  i
  o
  n
  a
  n
  d
  e
  x
  i
  t

Sup
por
ted
for
mat
seq
uen
ces
:

  %
  p
  %
  {
  p
  r
  o
  g
  r
  e
  s
  s
  }
  %
  {
  p
  r
  o
  g
  r
  e
  s
  s
  -
  a
  m
  o
  u
  n
  t
  -
  o
  n
  l
  y
  }
  %
  {
  p
  r
  o
  g
  r
  e
  s
  s
  -
  b
  a
  r
  -
  o
  n
  l
  y
  }
  %
  {
  p
  r
  o
  g
  r
  e
  s
  s
  -
  c
  o
  n
  e
  m
  u
  }
  %
  {
  b
  a
  r
  -
  p
  l
  a
  i
  n
  }
  %
  {
  b
  a
  r
  -
  b
  l
  o
  c
  k
  }
  %
  {
  b
  a
  r
  -
  g
  r
  a
  n
  u
  l
  a
  r
  }
  %
  {
  b
  a
  r
  -
  s
  h
  a
  d
  e
  d
  }
  %
  t
  %
  {
  t
  i
  m
  e
  r
  }
  %
  e
  %
  {
  e
  t
  a
  }
  %
  I
  %
  {
  f
  i
  n
  e
  t
  a
  }
  %
  r
  %
  {
  r
  a
  t
  e
  }
  %
  a
  %
  {
  a
  v
  e
  r
  a
  g
  e
  -
  r
  a
  t
  e
  }
  %
  b
  %
  {
  b
  y
  t
  e
  s
  }
  %
  {
  t
  r
  a
  n
  s
  f
  e
  r
  r
  e
  d
  }
  %
  {
  r
  a
  t
  i
  o
  }
  %
  T
  %
  {
  b
  u
  f
  f
  e
  r
  -
  p
  e
  r
  c
  e
  n
  t
  }
  %
  A
  %
  {
  l
  a
  s
  t
  -
  w
  r
  i
  t
  t
  e
  n
  }
  %
  L
  %
  {
  p
  r
  e
  v
  i
  o
  u
  s
  -
  l
  i
  n
  e
  }
  %
  N
  %
  {
  n
  a
  m
  e
  }
  %
  {
  s
  g
  r
  :
  c
  o
  l
  o
  u
  r
  ,
  .
  .
  .
  }

Ple
ase
rep
ort
any
bug
s
to:
htt
ps:
//c
ode
ber
g.o
rg/
iva
rch
/pv
/is
sue
s
Options (51)
OptionDescriptionSource
-p, --progresshelp
-t, --timerhelp
-e, --etahelp
-I, --finetahelp
-r, --ratehelp
-a, --average-ratehelp
-b, --byteshelp
-T, --buffer-percenthelp
-A, --last-written NUMhelp
-F, --format FORMAThelp
-n, --numerichelp
-q, --quiethelp
-8, --bitshelp
-k, --sihelp
-W, --waithelp
-D, --delay-start SEChelp
-s, --size SIZEhelp
-g, --gaugehelp
-l, --line-modehelp
-0, --nullhelp
-i, --interval SEChelp
-m, --average-rate-window SEChelp
-w, --width WIDTHhelp
-H, --height HEIGHThelp
-N, --name NAMEhelp
-u, --bar-style STYLEhelp
-x, --extra-display SPEChelp
-9, --conemuhelp
-v, --statshelp
-f, --forcehelp
-c, --cursorhelp
-o, --output FILEhelp
-L, --rate-limit RATEhelp
-B, --buffer-size BYTEShelp
-C, --no-splicehelp
-J, --pipe-buffer-size BYTEShelp
-E, --skip-errorshelp
-Z, --error-skip-block BYTEShelp
-S, --stop-at-sizehelp
-Y, --synchelp
-K, --direct-iohelp
-O, --sparsehelp
-X, --discardhelp
-U, --store-and-forward FILEhelp
-d, --watchfd PID[:FD]|=NAME|@LISTFILEhelp
-R, --remote PIDhelp
-Q, --query PIDhelp
-M, --monitor in|0|out|1|both|2help
-P, --pidfile FILEhelp
-h, --helphelp
-V, --versionhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.