filebench(1)							   User Commands						      filebench(1)

NAME

       filebench - framework of workloads to measure and compare filesystem performance

SYNOPSIS

       /usr/benchmarks/filebench/bin/filebench profile

       /usr/benchmarks/filebench/bin/filebench -c stats_dir...

DESCRIPTION

       filebench runs workloads to measure and compare filesystem performance.

       Full documentation can be found at the performance community at: http://www.opensolaris.org

OPTIONS

       The following options are supported:

       -c stats_dir...	  Generates  a HTML file (index.html) that is a comparison of the specified directories. stats_dir specifies the directory
			  or directories in which the results are stored.

OPERANDS

       The following operands are supported:

       profile	  Specifies the name of the configuration file ending in .prof. The configuration file specifies:

		      o      what workloads to run,

		      o      what parameters to run,

		      o      the directory path on which to operate, and

		      o      the directory path in which to store the results.

EXIT STATUS

       The following exit values are returned:

       0    Successful completion.

       1    An error occurred.

       2    Invalid command line options were specified.

EXAMPLES

       Example 1 Running the Multi-stream Sequential Read Workload

       The following example runs the workloads described in the configuration file named sqread.prof:

	 # filebench sqread

       Example 2 Comparing Multiple Runs

       The following example compares the results of two previous runs.

       This example assumes that the results from the two previous  filebench  runs  were  located  in	the  directories:  /stats/wombat-zfs-noel-
       Jun_27_2007-15h_45m_33s and /stats/wombat-ufs-noel-Jun_27_2007-15h_52m_11s.

       This example generates a HTML file named index.html in your current working directory.

	 # filebench -c /stats/wombat-zfs-noel-Jun_27_2007-15h_45m_33s 
	       /stats/wombat-ufs-noel-Jun_27_2007-15h_52m_11s

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWfilebench		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Uncommitted		   |
       +-----------------------------+-----------------------------+

SEE ALSO

       attributes(5)

SunOS 5.11							    9 Oct 2007							      filebench(1)