Man Page bw.1




NAME

     bw	- command used to measure system-wide bandwidth	 consump-
     tion


SYNOPSIS

     bw	args app params


DESCRIPTION

     The bw command measures  system-wide  bandwidth  consumption
     over the entire run of an application. If the application is
     the only load on the system, then all the bandwidth  can  be
     attributed	 to  that one application.  If there are multiple
     applications running on the system, then it is not	 possible
     to	attribute bandwidth to a specific one of them.

     The bw command is a wrapper for cpustat  measuring	 activity
     on	the memory controller counters.	Hence bw must be run with
     the necessary privileges to access	the performance	 counters
     on	a system wide basis.


OPTIONS

     The following options are supported:

     -g	file
	  If gnuplot is	available on the  path,	 then  produce	a
	  graph	showing	the bandwidth consumption over the entire
	  run of the application.

     -h	  Print	help information

     -o	file
	  Output the results of	the script  to	the  given  file,
	  rather than to stdout.

     -V	  Print	version	information

     -v	  Generate debug output

     The output	from  the  script  will	 show  system-wide  read,
     write,  and  total	bandwidth consumption over the run of the
     application. The results are in MB/s.


SEE ALSO

     analyzer(1),    collect(1),     er_archive(1),	er_cp(1),
     er_export(1),  er_mv(1),  er_print(1),  er_rm(1), er_src(1),
     and the Performance Analyzer manual.