/* 
* Copyright (c) 2004 by Sun Microsystems, Inc.
# All rights reserved.
#
*/ 

TEST NAME 

      bonnie - file system and disk I/O benchmark 

SYNOPSIS 

      ./bonnie.sh -i -m -s -d 

DESCRIPTION 

      bonnie is a file system and disk I/O benchmark and measurement tool that
      analyzes file system performance and bottlenecks. It exercises sequential
      input and output (per char, per block, and per rewrite) and performs
      random seeks.

      The script bonnie.sh runs the bonnie benchmark with varying numbers of
      iterations (repetitions) and file sizes, and summarizes the
      results. Average values are calculated for all executed iterations.

      bonnie can also be used as a system stress test. When used as a stress
      test, 100 to 500 iterations are necessary. File sizes can vary depending
      on available disk or RAID space. Verify that the required space is
      available in /export/home or the scratch directory before starting the
      benchmark (see the storage driver test plan you want for more
      information).

      The test can be executed either as root or as a user, although a user
      account might experience permission problems when writing or removing
      files from some directories.

OPERANDS 

      -i   Number of iterations; the default is 5.

      -m   Machine name/label; the default is 'uname -n'.

      -s   File size; the default is 200 Mbytes.

      -d   Scratch directory; the default directory is /export/home/bonnie.tmp. If 
           -d is set, bonnie writes files to the specified directory instead 
           of the default directory.

SETUP 

      Copy the bonnie directory tree to /export/home or to another directory on
      your local system. If the /export/home/bonnie.tmp directory already exists,
      change its permissions (sh environment) to 777:

      # chmod 777 /export/home/bonnie.tmp 

      Make sure /export/home or the scratch directory is located on the disk
      connected to the controller being tested.

OUTPUT 

      Test results are stored in /export/home/bonnie.tmp/bonnie.results by default or
      in scratch_directory/bonnie.results if -d scratch_directory is set.

                    -------Sequential Output-------- ---Sequential Input-- --Random--
                    -Per Char- --Block--- -Rewrite-- -Per Char- --Block--- --Seeks---
      Machine    MB K/sec %CPU K/sec %CPU K/sec %CPU K/sec %CPU K/sec %CPU  /sec %CPU
      Sun4/260   78   285 90.9   650 26.4   305 20.0   282 95.5   803 28.3  38.5 15.2
      Mips M2k  180   387 44.0   442  6.1   360  5.4   416 48.1  1701 14.8  26.3  3.1
      Sequent    95   140 97.8  1017 66.2   251 17.7   122 95.7   713 34.9  31.0 15.9
      4M i386    25   130 90.5   199 26.1   179 46.1   121 93.5   400 59.7  10.5 23.8
      NeXT      125   241 94.7   347 39.3   253 31.7   246 94.8   772 49.6  27.7 20.8
      VAX 8650  200   208 89.0   232  8.3   143  7.4   197 65.0   373  8.6  17.3  4.6

DURATION 

	It depends on the storage type and the parameters specified by user. For example,
	it takes less than 4 minutes using the following parameters on Ultra 320 SCSI 
	disks.

POSSIBLE CONCURRENT TESTS 

      None 

EXAMPLES 

      /bonnie.sh -i 100 & 

