Statistics
| Branch: | Revision:

root / synthbench / bonnie++ / zcav.8 @ 0:839f52ef7657

History | View | Annotate | Download (2.9 kB)

1 0:839f52ef7657 louridas
.TH zcav 8
2 0:839f52ef7657 louridas
.SH "NAME"
3 0:839f52ef7657 louridas
zcav \- program to test raw hard drive throughput.
4 0:839f52ef7657 louridas
5 0:839f52ef7657 louridas
.SH "SYNOPSIS"
6 0:839f52ef7657 louridas
.B zcav
7 0:839f52ef7657 louridas
.I [\-b block\-size[:chunk\-size]] [\-c count] [\-n num_blocks] [\-w]
8 0:839f52ef7657 louridas
.I [\-u uid\-to\-use:gid\-to\-use] [\-g gid\-to\-use]
9 0:839f52ef7657 louridas
.I [\-f] file\-name
10 0:839f52ef7657 louridas
11 0:839f52ef7657 louridas
.SH "DESCRIPTION"
12 0:839f52ef7657 louridas
This manual page documents briefly the
13 0:839f52ef7657 louridas
.BR zcav ,
14 0:839f52ef7657 louridas
program.
15 0:839f52ef7657 louridas
.P
16 0:839f52ef7657 louridas
Modern hard drives have a constant rotational speed but have varying numbers
17 0:839f52ef7657 louridas
of sectors per track (outside tracks are longer and have more sectors). This
18 0:839f52ef7657 louridas
is referred to as Zoned Constant Angular Velocity (or ZCAV). The outer tracks
19 0:839f52ef7657 louridas
will have a higher data transfer rate due to having more sectors per track,
20 0:839f52ef7657 louridas
these tracks generally have the lower track/sector numbers.
21 0:839f52ef7657 louridas
.P
22 0:839f52ef7657 louridas
This program tests the ZCAV performance of a hard drive, by reading the entire
23 0:839f52ef7657 louridas
data on it a specified number of times. The file name given as the first
24 0:839f52ef7657 louridas
parameter, it can be specified as
25 0:839f52ef7657 louridas
.BR \- ,
26 0:839f52ef7657 louridas
for standard input. This file will be opened as read\-only and in usual
27 0:839f52ef7657 louridas
operation it will be
28 0:839f52ef7657 louridas
.BR /dev/hdX
29 0:839f52ef7657 louridas
or
30 0:839f52ef7657 louridas
.BR /dev/ide/host0/busX/targetY/lun0/disc
31 0:839f52ef7657 louridas
depending on whether you use devfs or not (NB operating systems other than
32 0:839f52ef7657 louridas
Linux will have different device names).
33 0:839f52ef7657 louridas
.P
34 0:839f52ef7657 louridas
The output should be able to be easily graphed with
35 0:839f52ef7657 louridas
.BR gnuplot
36 0:839f52ef7657 louridas
which is what I use to view the results.
37 0:839f52ef7657 louridas
38 0:839f52ef7657 louridas
.SH "OPTIONS"
39 0:839f52ef7657 louridas
40 0:839f52ef7657 louridas
.TP
41 0:839f52ef7657 louridas
.B \-b
42 0:839f52ef7657 louridas
the size (in Meg) of the blocks to read/write (default 100M), optionally
43 0:839f52ef7657 louridas
followed by a ':' and the chunk size for read/write operations (default 1M).
44 0:839f52ef7657 louridas
Note that the chunk size must be less than or equal to the block size and
45 0:839f52ef7657 louridas
must also be significantly less than the size of the RAM in the machine.
46 0:839f52ef7657 louridas
Also note that for the write test there will be a fsync() after writing every
47 0:839f52ef7657 louridas
chunk.
48 0:839f52ef7657 louridas
49 0:839f52ef7657 louridas
.TP
50 0:839f52ef7657 louridas
.B \-c
51 0:839f52ef7657 louridas
the number of times to read/write the entire disk.
52 0:839f52ef7657 louridas
53 0:839f52ef7657 louridas
.TP
54 0:839f52ef7657 louridas
.B \-n
55 0:839f52ef7657 louridas
the amount of data (in Meg) to read/write on each pass (default the entire device).
56 0:839f52ef7657 louridas
57 0:839f52ef7657 louridas
.TP
58 0:839f52ef7657 louridas
.B \-f
59 0:839f52ef7657 louridas
the file\-name for the input data. This isn't needed on well configured
60 0:839f52ef7657 louridas
systems that have a recent Glibc where you can specify the file name without
61 0:839f52ef7657 louridas
the \-f flag.
62 0:839f52ef7657 louridas
63 0:839f52ef7657 louridas
.TP
64 0:839f52ef7657 louridas
.B \-u
65 0:839f52ef7657 louridas
user\-id to use.  When running as root specify the UID to run the tests as, it
66 0:839f52ef7657 louridas
is not recommended to use root, so if you want to run as root use
67 0:839f52ef7657 louridas
.B \-u root.
68 0:839f52ef7657 louridas
Also if you want to specify the group to run as then use the
69 0:839f52ef7657 louridas
.B user:group
70 0:839f52ef7657 louridas
format.  If you specify a user by name but no group then the primary group of
71 0:839f52ef7657 louridas
that user will be chosen.  If you specify a user by number and no group then
72 0:839f52ef7657 louridas
the group will be
73 0:839f52ef7657 louridas
.B nogroup.
74 0:839f52ef7657 louridas
75 0:839f52ef7657 louridas
.TP
76 0:839f52ef7657 louridas
.B \-g
77 0:839f52ef7657 louridas
group\-id to use.  Same as using
78 0:839f52ef7657 louridas
.B :group
79 0:839f52ef7657 louridas
for the
80 0:839f52ef7657 louridas
.B \-u
81 0:839f52ef7657 louridas
parameter, just a different way to specify it for compatibility with other
82 0:839f52ef7657 louridas
programs.
83 0:839f52ef7657 louridas
84 0:839f52ef7657 louridas
.TP
85 0:839f52ef7657 louridas
.B \-w
86 0:839f52ef7657 louridas
write zero blocks to the disk instead of reading from the disk - will destroy data!
87 0:839f52ef7657 louridas
88 0:839f52ef7657 louridas
.SH "AUTHOR"
89 0:839f52ef7657 louridas
This program, it's manual page, and the Debian package were written by
90 0:839f52ef7657 louridas
Russell Coker <russell@coker.com.au>.
91 0:839f52ef7657 louridas
92 0:839f52ef7657 louridas
.SH "AVAILABILITY"
93 0:839f52ef7657 louridas
The source is available from http://www.coker.com.au/bonnie++ .
94 0:839f52ef7657 louridas
.P
95 0:839f52ef7657 louridas
See http://etbe.coker.com.au/category/benchmark for further information.