Bonnie++ integration (PSARC/2008/461)

[Danek Duvall]

After some off-line discussion, I'm restarting this case, with the timeout
set for this Wednesday, 6 August.

The only change is that bonnie will now be installed in /usr/benchmarks,
with familiarity (f9y?) symlinks in /usr/bin (and the manpage obviously in
the default manpath).

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

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/benchmarks/bonnie++/bonnie++      Committed    Executable location
    /usr/benchmarks/bonnie++/bon_csv2html  Committed    Executable location
    /usr/benchmarks/bonnie++/bon_csv2txt   Committed    Executable location
    /usr/bin/bonnie++                      Committed    Symlink
    /usr/bin/bon_csv2html                  Committed    Symlink
    /usr/bin/bon_csv2txt                   Committed    Symlink

    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++/