Provided by: bonnie++_2.00a+nmu1_amd64 bug

NAME

       getc_putc - program to test hard drive performance.

SYNOPSIS

       getc_putc  [-d  dir]  [-s  size(KiB)]  [-m  machine-name]  [-u  uid-to-use:gid-to-use] [-g
       gid-to-use]

DESCRIPTION

       This manual page documents briefly the getc_putc, program.

       This is a simple adjunct to the bonnie++ benchmark.  It is used to test  various  ways  of
       doing  IO  one  byte at a time, usually you don't need to do enough of this for it to be a
       performance issue for it to matter much which way you do it.  But sometimes it's necessary
       (for example whan parsing IO from a terminal and then launching another process which will
       take over all IO, such as a simple shell).

       The real benefits of this are to help settle some arguements about the performance of such
       things, and to educate novices about how bad per-byte IO really is.

OPTIONS

       For  getc_putc  every  option is of the form of a hyphen followed by a letter and then the
       next parameter contains the value.

       -d     the directory to use for the tests.

       -s     the size of the file for byte IO performance measured in  kilobytes.   NB  You  can
              specify the size in mega-bytes if you add 'm' to the end of the number.

              The  default for this test is to test with a 512MiB file.  Of the file only 1/64 of
              it will be used for write() and read() system calls (anything else takes too long).

       -m     name of the machine - for display purposes only.

       -u     user-id to use.  When running as root specify the UID to use for the tests.  It  is
              not recommended to use root, so if you really want to run as root then use -u root.
              Also if you want to specify the group to run as then use the user:group format.  If
              you specify a user by name but no group then the primary group of that user will be
              chosen.  If you specify a user by number and  no  group  then  the  group  will  be
              nogroup.

       -g     group-id  to  use.  Same as using :group for the -u parameter, just a different way
              to specify it for compatibility with other programs.

       -q     quiet mode. If specified then some of the  extra  informational  messages  will  be
              suppressed. Also the csv data will be the only output on standard out and the plain
              text data will be on standard error.  This  means  you  can  run  getc_putc  -q  >>
              file.csv to record your csv data.

OUTPUT

       The  primary  output is plain-text in 80 columns which is designed to fit well when pasted
       into email and which will work well with Braille displays.

       The second type of output is CSV (Comma Seperated Values).  This can  easily  be  imported
       into any spread-sheet or database program.

       For  every  test the result is a speed in KiB/s.  I do not display the CPU time because it
       presumably is 99% of the power of a single CPU (or something very close to that).

AUTHOR

       This program, it's manual page, and the Debian  package  were  written  by  Russell  Coker
       <russell@coker.com.au>.

       The  documentation,  the  Perl  scripts,  and  all  the  code  for testing the creation of
       thousands of files was written by Russell Coker, but the entire  package  is  under  joint
       copyright with Tim Bray.

SIGNALS

       Handles SIGINT and does a cleanup (which may take some time), a second SIGINT or a SIGQUIT
       will cause it to immidiately die.

       SIGXCPU and SIGXFSZ act like SIGINT.

       Ignores SIGHUP.

AVAILABILITY

       The source is available from http://www.coker.com.au/bonnie++ .

       See http://etbe.coker.com.au/category/benchmark for further information.

SEE ALSO

       bonnie++(8), zcav(8)

                                                                                     getc_putc(8)