"SfR Fresh" - the SfR Freeware/Shareware Archive 
Member "bonnie++-1.94/getc_putc.8" of archive bonnie++-1.94.tgz:
Caution: As a special service "SfR Fresh" has tried to format the requested manual source page into HTML format but links to other man pages may be missing or even errorneous.
Alternatively you can here view or download the uninterpreted manual source code.
That can be also achieved for any archive member file by clicking within an archive contents listing on the first character of the file(path) respectively on the according byte size field.
Table of Contents
getc_putc - program to test hard drive performance.
getc_putc
[-d dir] [-s size(KiB)] [-m machine-name] [-u uid-to-use:gid-to-use] [-g gid-to-use]
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.
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 40MiB file. Of the file only 1/32 of it
will be used for write() and read() system calls (anything else takes too
long), and only 1/4 of it will be used for locked getc() and putc().
- -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.
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).
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.
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.
The source is available from http://www.coker.com.au/bonnie++
.
See http://etbe.coker.com.au/category/benchmark for further information.
bonnie++(8), zcav(8)
Table of Contents