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  (Esti-
       mated 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     Giga-
              bytes(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 compat-
              ibility, it is far simpler to just specify the input files with-
              out 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.
              Turns on logging mode. Uses only newlines, no returns.

AUTHOR

       Written by Clint Byrum <cbyrum@spamaps.org>

COPYRIGHT

       Copyright (C) 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)