head	1.3;
access;
symbols
	RELENG_5_5_0_RELEASE:1.1.2.1
	RELENG_5_5:1.1.2.1.0.6
	RELENG_5_5_BP:1.1.2.1
	RELENG_5_4_0_RELEASE:1.1.2.1
	RELENG_5_4:1.1.2.1.0.4
	RELENG_5_4_BP:1.1.2.1
	RELENG_5_3_0_RELEASE:1.1.2.1
	RELENG_5_3:1.1.2.1.0.2
	RELENG_5_3_BP:1.1.2.1
	RELENG_5:1.1.0.2;
locks; strict;
comment	@# @;


1.3
date	2004.12.05.04.16.36;	author obrien;	state dead;
branches;
next	1.2;

1.2
date	2004.11.06.17.19.55;	author pjd;	state Exp;
branches;
next	1.1;

1.1
date	2004.08.20.12.02.34;	author pjd;	state Exp;
branches
	1.1.2.1;
next	;

1.1.2.1
date	2004.09.14.16.02.32;	author pjd;	state Exp;
branches;
next	;


desc
@@


1.3
log
@Now as a full blown port.
@
text
@[ $FreeBSD: src/tools/tools/raidtest/README,v 1.2 2004/11/06 17:19:55 pjd Exp $ ]

This utility can be used to test performance of storage devices.
First, one need to generate file with I/O operations:

	# set mediasize=`diskinfo /dev/<device> | awk '{print $3}'`
	# set sectorsize=`diskinfo /dev/<device> | awk '{print $2}'`
	# raidtest genfile -s $mediasize -S $sectorsize -n 50000

It will generate test which contains 50000 I/O requests with random
size and random offset. Size is a multiple of sectorsize, but less than or
equal to 128kB (maxium size of I/O request). I/O request type (READ or WRITE)
is random as well.
All test data are stored in 'raidtest.data' file in current working directory.

To run test, one should type:

	# raidtest test -d /dev/<device> -n 10

This command will read test data from 'raidtest.data' file, run 10 processes
which will be used to send requests to the given device in parallel.
When test is finished you will see statistics:

	Bytes per second: <x>
	Requests per second: <y>

If you compare performance of two storage devices, use the same data file!


usage: raidtest genfile [-frw] <-s mediasize> [-S sectorsize] <-n nrequests> [file]
       raidtest test [-Rrw] <-d device> [-n processes] [file]

where:
	-d device	path to tested device
	-f		if raidtest.data file or specified file already exists,
			remove it and create new one
	-n nrequests	number of requests to generate
	-n processes	number of processes to run
	-r		generate/run only READ requests
	-R		generate random data for write requests
	-s		size of destination device
	-S		sector size of destination device
	-w		generate/run only WRITE requests
	file		path to the data file instead of default 'raidtest.data'

	-- Pawel Jakub Dawidek <pjd@@FreeBSD.org>
@


1.2
log
@Add description of all available options.
@
text
@d1 1
a1 1
[ $FreeBSD$ ]
@


1.1
log
@Add the raidtest tool, which can be used for performance tests of storage devices.
It uses random offsets, random requests size and random operation type (READ or
WRITE). It also allows to run many processes to send I/O requests in parallel.
@
text
@d29 17
@


1.1.2.1
log
@Add a tool for testing performance of storage devices.

Approved by:	re (scottl)
@
text
@@

