Provided by: lmbench-doc_3.0-a9-1_all bug

NAME

       bw_file_rd - time the reading and summing of a file

SYNOPSIS

       bw_file_rd  [  -P <parallelism> ] [ -W <warmups> ] [ -N <repetitions> ]
       size file

DESCRIPTION

       bw_file_rd times the read of the specified file in  64KB  blocks.  Each
       block  is summed up as a seried of 4 byte integers in an unrolled loop.
       Results are reported in megabytes read per second.

       The data is not accessed in the user program; the benchmark  relies  on
       the  operating  systems read interface to have actually moved the data.
       Systems that implement page flipping may fool this benchmark.

       The benchmark is intended to be used on a file that is in memory, i.e.,
       the  benchmark  is  a reread benchmark.  Other file benchmarking can be
       done with lmdd(8).

       The size specification may end with ‘‘k’’ or ‘‘m’’ to mean kilobytes (*
       1024) or megabytes (* 1024 * 1024).

OUTPUT

       Output format is "%0.2f %.2f\n", megabytes, megabytes_per_second, i.e.,

       8.00 25.33

MEMORY UTILIZATION

       This benchmark can move up to three times the requested  memory.   Most
       Unix  systems  implement  the  read  system call as a bcopy from kernel
       space to  user  space.   Bcopy  will  use  2-3  times  as  much  memory
       bandwidth:  there  is  one  read  from  the  source  and a write to the
       destionation.  The write usually results in a cache line read and  then
       a write back of the cache line at some later point.  Memory utilization
       might be reduced by  1/3  if  the  processor  architecture  implemented
       ‘‘load  cache  line’’ and ‘‘store cache line’’ instructions (as well as
       ‘‘getcachelinesize’’).

ACKNOWLEDGEMENT

       Funding  for  the  development  of  this  tool  was  provided  by   Sun
       Microsystems Computer Corporation.

SEE ALSO

       lmbench(8).

AUTHOR

       Carl Staelin and Larry McVoy

       Comments, suggestions, and bug reports are always welcome.

(c)1994 Larry McVoy                 $Date$                       BW_FILE_RD(8)