xenial (1) pipemeter.1.gz

Provided by: pipemeter_1.1.3-1_amd64 bug

NAME

       pipemeter - measure speed of data going through a pipe/redirection

SYNOPSIS

       pipemeter  [  -alV  ]  [ -s size ] [ -b block_size ] [ -m max_block_size ] [ -i interval ] [ -f infile -f
       infile2 ] infile infile2 ...

DESCRIPTION

       pipemeter simply takes input on stdin, and redirects it to its stdout. While doing this, it measures  how
       fast  the  data is moving through it.  Alternatively, with the -s parameter, shows a progress bar as data
       is piped through it.  All output generated by pipemeter is written to stderr.

       While running in progress mode, pipemeter will display the ETA (Estimated Time of Arrival). When exiting,
       it  will change this field to show the elapsed time for the program. In rate-only mode, it will just show
       elapsed time.

       Note that as of pipemeter 0.8, Adaptive Block Sizing is used to speed up the movement of data through it.
       It will increase, or sometimes decrease, the block size in an attempt to find the one that works best for
       the combination of input and output. This also helps it deal better with,  for  instance,  a  temporarily
       busy disk. You can use -a to turn it off.

       -s, --size size
              Sets the size of the input, and turns on the progress bar.

       -b, --blocksize block_size
              Sets  the size of blocks, in bytes, to move through the program at once. Default is 8192. A suffix
              of    K    means    Kilobytes(x*1024)    means     Megabytes(x*1024*1024),     and     G     means
              Gigabytes(x*1024*1024*1024).

       -m, --maxblock max_block_size
              Sets the maxium block size for adaptive block sizing. Default is 8M.

       -i, --interval interval
              Specify the number of seconds between updates on the speed and/or progress bar.

       -f, --file infile
              infile  specifies  a  file  to  be  read  instead of stdin. It will also automatically turn on the
              progress bar if a size can be determined. Multiple occurances of -f will read  the  files  in  the
              order  they  are  specified  on  the cmdline, and sizes will be added to eachother. Note that this
              option remains for backward compatibility, it is far simpler  to  just  specify  the  input  files
              without options.

       -F, --list listfile
              specifies  a  file  to  read  in  the  list  of  input  files from. Each line is a path to a file,
              terminated by a newline.

       -r, --report
              report only mode. This causes the program to suppress  outputting/calculating  while  running.  It
              will print out only one line.

       -a, --autooff
              turn  off adaptive block sizing. Sometimes ABS can use insane amounts of RAM, such as when reading
              and writing to RAM disks.

       -V, --version
              Prints a version number and exits.

       -l, --log
              Turns on logging mode. Uses only newlines, no returns.

AUTHOR

       Written by Clint Byrum <cbyrum@spamaps.org>

       Copyright © 2006 Clint Byrum
       This is free software; see the source for copying conditions.  There  is  NO   warranty;   not  even  for
       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

                                                                                                    PIPEMETER(1)