X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=lustre-iokit%2Fsgpdd-survey%2FREADME.sgpdd-survey;h=c1f3337bbd09e31bdfafd32084ae3020ece2ec5d;hb=294c39d488fcd95a523466c7726ff1b5a8327890;hp=171d7fc4fddcf0fe0c373ad6e2405a234e96b875;hpb=0bcfe7071363db98913b26235c60843dd55b549a;p=fs%2Flustre-release.git

diff --git a/lustre-iokit/sgpdd-survey/README.sgpdd-survey b/lustre-iokit/sgpdd-survey/README.sgpdd-survey
index 171d7fc..c1f3337 100644
--- a/lustre-iokit/sgpdd-survey/README.sgpdd-survey
+++ b/lustre-iokit/sgpdd-survey/README.sgpdd-survey
@@ -11,7 +11,6 @@ Requirements
   raw device support
   sg3_utils
 
-
 Overview
 --------
 
@@ -31,10 +30,15 @@ number of concurrent stripe files.
 The device(s) used must meet one of two tests:
 SCSI device:
 	Must appear in the output of 'sg_map'
+	(make sure the kernel module "sg" is loaded)
 Raw device:
 	Must appear in the output of 'raw -qa'
-You may not mix raw and SCSI devices in the test specification.
 
+	If you need to create raw devices in order to use this tool, note that
+	raw device 0 can not be used due to a bug in certain versions of the
+	"raw" utility (including that shipped with RHEL4U4.)
+
+You may not mix raw and SCSI devices in the test specification.
 
 Running
 -------
@@ -43,6 +47,8 @@ The script must be customised according to the particular device under test
 and where it should keep its working files.   Customisation variables are
 described clearly at the start of the script.
 
+e.g.: scsidevs=/dev/sda size=128 crghi=16 thrhi=32 ./sgpdd-survey
+
 When the script runs, it creates a number of working files and a pair of
 result files.  All files start with the prefix given by ${rslt}.
 
@@ -64,7 +70,6 @@ I/O buffers, "ENOMEM" is printed.
 If not all the sgp_dd instances successfully reported a bandwidth number
 "failed" is printed.
 
-
 Visualising Results
 -------------------
 
@@ -75,6 +80,7 @@ with varying queue depth.  If the series (varying numbers of concurrent
 regions) all seem to land on top of each other, it shows the device is
 phased by seeks at the given record size.
 
-
-The included script, parse.pl will process output files and create .csv files fo spreadsheet import
+The included script "plot-sgpdd" will process output files and create
+.dat (similar to csv) files for spreadsheet import. It also plots the 
+results directly using gnuplot and creates .png files.