1getc_putc(8)                System Manager's Manual               getc_putc(8)
2
3
4

NAME

6       getc_putc - program to test hard drive performance.
7
8

SYNOPSIS

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

DESCRIPTION

15       This manual page documents briefly the getc_putc, program.
16
17       This is a simple adjunct to the bonnie++ benchmark.  It is used to test
18       various  ways of doing IO one byte at a time, usually you don't need to
19       do enough of this for it to be a performance issue  for  it  to  matter
20       much  which  way  you do it.  But sometimes it's necessary (for example
21       whan parsing IO from a terminal  and  then  launching  another  process
22       which will take over all IO, such as a simple shell).
23
24       The  real benefits of this are to help settle some arguements about the
25       performance of such things, and to educate novices about how  bad  per-
26       byte IO really is.
27
28

OPTIONS

30       For  getc_putc  every  option  is of the form of a hyphen followed by a
31       letter and then the next parameter contains the value.
32
33       -d     the directory to use for the tests.
34
35       -s     the size of the file for byte IO performance measured  in  kilo‐
36              bytes.  NB You can specify the size in mega-bytes if you add 'm'
37              to the end of the number.
38
39              The default for this test is to test with a 512MiB file.  Of the
40              file  only 1/64 of it will be used for write() and read() system
41              calls (anything else takes too long).
42
43
44       -m     name of the machine - for display purposes only.
45
46
47       -u     user-id to use.  When running as root specify the UID to use for
48              the  tests.  It is not recommended to use root, so if you really
49              want to run as root then use -u root.  Also if you want to spec‐
50              ify  the group to run as then use the user:group format.  If you
51              specify a user by name but no group then the  primary  group  of
52              that  user  will be chosen.  If you specify a user by number and
53              no group then the group will be nogroup.
54
55
56       -g     group-id to use.  Same as using :group  for  the  -u  parameter,
57              just  a different way to specify it for compatibility with other
58              programs.
59
60
61       -q     quiet mode. If specified then some of  the  extra  informational
62              messages  will be suppressed. Also the csv data will be the only
63              output on standard out and the plain text data will be on  stan‐
64              dard  error.  This means you can run getc_putc -q >> file.csv to
65              record your csv data.
66
67

OUTPUT

69       The primary output is plain-text in 80 columns which is designed to fit
70       well  when pasted into email and which will work well with Braille dis‐
71       plays.
72
73       The second type of output is CSV (Comma Seperated  Values).   This  can
74       easily be imported into any spread-sheet or database program.
75
76       For  every  test  the result is a speed in KiB/s.  I do not display the
77       CPU time because it presumably is 99% of the power of a single CPU  (or
78       something very close to that).
79
80

AUTHOR

82       This  program, it's manual page, and the Debian package were written by
83       Russell Coker <russell@coker.com.au>.
84
85       The documentation, the Perl scripts, and all the code for  testing  the
86       creation  of  thousands  of files was written by Russell Coker, but the
87       entire package is under joint copyright with Tim Bray.
88
89

SIGNALS

91       Handles SIGINT and does a cleanup (which may take some time), a  second
92       SIGINT or a SIGQUIT will cause it to immidiately die.
93
94       SIGXCPU and SIGXFSZ act like SIGINT.
95
96       Ignores SIGHUP.
97
98

AVAILABILITY

100       The source is available from http://www.coker.com.au/bonnie++ .
101
102       See  http://etbe.coker.com.au/category/benchmark  for  further informa‐
103       tion.
104
105

SEE ALSO

107       bonnie++(8), zcav(8)
108
109
110
111                                                                  getc_putc(8)
Impressum