Bonnie++ integration (PSARC/2008/461)

[Danek Duvall]

I'm sponsoring this case for David Fan.  The requested release binding is
Patch (though to my knowledge there's no current intention to backport to
S10).  The case times out Monday, July 28.

Danek

======================================================================

1. Background

  This project proposes to integrate Bonnie++[1], a freeware benchmark
  suite that is aimed at performing a number of simple tests of hard
  drive and file system performance.  The program tests database type
  access to a single file (or a set of files if you wish to test more
  than 1G of storage), and it tests creation, reading, and deleting
  of small files which can simulate the usage of programs such as
  Squid, INN, or Maildir format email.  Bonnie++ was based on the code
  from Bonnie by Tim Bray[2]. Here is a summary of the difference
  between Bonnie 1.0 and Bonnie++ 1.0 is available at
  http://www.coker.com.au/bonnie++/diff.html

  This project intends to integrate into the SFW consolidation, and
  will be installed as SUNWbonnieplus.

  1.1  Name of Document Author/Supplier:

       david.fan at sun.com
       steve.le at sun.com

  1.2  Date of This Document:

       7/17/2008

2. Architecture

  The architecture, as relevant to integration in Solaris is simple.
  There are three executables: bonnie++, bon_csv2html, bon_csv2txt.
  Bonnie++ adds the facility to test more than 2G of storage on a 32bit
  machine, and tests for file creat(), stat(), unlink() operations.
  Also it will output in CSV spread-sheet format to standard output.
  If you use the "-q" option for quiet mode then the human-readable
  version will go to stderr so redirecting stdout to a file will get
  only the csv in the file.

  The program bon_csv2html takes csv format data on stdin and writes a
  HTML file on standard output which has a nice display of all the data.

  The program bon_csv2txt takes csv format data on stdin and writes a
  formatted plain text version on stdout, this was originally written
  to work with 80 column braille displays, but can also work well in email.

3. Dependencies

    Perl 5.0 or higher.

    SUNWperl(>=5.0)core & SUNWperl(>=5.0)usr are expected to be available
    on the system.

4. Interfaces

    Exported Interfaces
    -------------------
    SUNWbonnieplus             Uncommitted    Package name
    /usr/bin/bonnie++          Committed      Executable location
    /usr/bin/bon_csv2html      Committed      Executable location
    /usr/bin/bon_csv2txt       Committed      Executable location

    Imported Interfaces
    -------------------
    /usr/perl5/bin/perl        Committed      PSARC/1999/192

5. Man pages

    materials/bonnie++.8
    materials/bon_csv2html.1
    materials/bon_csv2txt.1

6. References

[1] http://sourceforge.net/projects/bonnie/
[2] http://www.coker.com.au/bonnie++/