home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-3.iso / Tools / disk / IOZone.README < prev    next >
Encoding:
Text File  |  1994-07-10  |  10.1 KB  |  207 lines
  1. This is a Benchmark Program for HD-Performance.
  2. You need a compiler to use it!!
  3.  
  4. cc -O iozone.c -o iozone
  5.  
  6. From the 'iozone help' output:
  7. ------
  8.  
  9. IOZONE: help mode
  10.  
  11.        'IO Zone' Benchmark Program
  12.  
  13.        Author: Bill Norcott (norcott_bill@tandem.com)
  14.                1060 Hyde Avenue
  15.                San Jose, CA  95129
  16.  
  17.   Copyright 1991, 1992   William D. Norcott
  18.  
  19.   License to freely use and distribute this software is hereby granted 
  20.   by the author, subject to the condition that this copyright notice 
  21.   remains intact.  The author retains the exclusive right to publish 
  22.   derivative works based on this work, including, but not limited to, 
  23.   revised versions of this work
  24.  
  25.   This test writes a X MEGABYTE sequential file in Y byte chunks, then
  26.   rewinds it  and reads it back.  [The size of the file should be
  27.   big enough to factor out the effect of any disk cache.].  Finally,
  28.   IOZONE deletes the temporary file
  29.         
  30.   The file is written (filling any cache buffers), and then read.  If the
  31.   cache is >= X MB, then most if not all the reads will be satisfied from
  32.   the cache.  However, if it is less than or equal to .5X MB, then NONE of
  33.   the reads will be satisfied from the cache.  This is becase after the 
  34.   file is written, a .5X MB cache will contain the upper .5 MB of the test
  35.   file, but we will start reading from the beginning of the file (data
  36.   which is no longer in the cache)
  37.         
  38.   In order for this to be a fair test, the length of the test file must
  39.   be AT LEAST 2X the amount of disk cache memory for your system.  If
  40.   not, you are really testing the speed at which your CPU can read blocks
  41.   out of the cache (not a fair test)
  42.         
  43.   IOZONE does not normally test the raw I/O speed of your disk or system.
  44.   It tests the speed of sequential I/O to actual files.  Therefore, this
  45.   measurement factors in the efficiency of you machines file system,
  46.   operating system, C compiler, and C runtime library.  It produces a 
  47.   measurement which is the number of bytes per second that your system
  48.   can read or write to a file.  
  49.  
  50.   You use IOZONE to test the I/O speed of a UNIX 'RAW DEVICE' such
  51.   as a tape drive, hard disk drive, floppy disk drive, etc.  To do this,
  52.   you must define the symbol NO_DELETE when you compile IOZONE.  If you
  53.   fail to define NO_DELETE, IOZONE will treat the raw device as a 
  54.   temporary file, and WILL DELETE THE RAW DEVICE after the test completes!
  55.   When testing raw devices, any UNIX buffer caching is bypassed.  IOZONE
  56.   still is using the read()/write() system calls, so you are not quite
  57.   testing the device at the low level of say, disk controller diagnostics.
  58.   On the other hand, that kind of testing is highly system- and device-
  59.   specific, and my goal for IOZONE has been to build a highly portable
  60.   benchmark -- not one which is tied to a particular operating system or
  61.   hardware configuration.  In practice, I have tested raw disk and tape
  62.   peripherals and the results are very close to the manufacturer's specs
  63.   for those devices.
  64.  
  65.   For V1.06, IOZONE adds the 'auto test' feature.  This is activated
  66.   by the command:  'iozone auto' .  The auto test runs IOZONE repeatedly  
  67.   using record sizes from 512 to 8192 bytes, and file sizes from 1 to 16
  68.   megabytes.  It creates a table of results.
  69.         
  70.   For V1.06, IOZONE lets you specify the number of file system sizes and      
  71.   record lengths to test when using auto mode.  Define the constants
  72.   MEGABYTES_ITER_LIMIT and RECLEN_ITER_LIMIT as seen below      
  73.         
  74.   For V1.09 you can show the development help by typing 'iozone help'
  75.         
  76.   For V1.10 IOzone traps SIGINT (user interrupt) and SIGTERM
  77.   (kill from shell) signals and deletes the temporary file
  78.         
  79.   For V1.11 IOzone requires no compilation flags for AIX
  80.   Also, come miscellaneous cleanups have been made to the source
  81.         
  82.   For V1.12 IOzone support has been added for the MIPS RISCos,
  83.   Tandem Non-StopUX, and Tandem GUARDIAN 90 operating systems.
  84.   IOzone is now a 'Conforming POSIX.1 Application'  (IEEE Std 1003.1-1988)
  85.         
  86.   For V1.14 IOzone supports Next and QNX systems.  It also prints out
  87.   the name of the operating system when run.  There is now the option
  88.   to force IOzone to flush all writes to disk via fsync()
  89.   Defining USE_FSYNC will make IOzone include in its measurements the time
  90.   it takes to actually write the data onto disk, as opposed to
  91.   just writing into the system cache.  BSD UNIX and SVR4 support fsync(),
  92.   but SVR3 and generic POSIX systems do not.  I have enabled USE_FSYNC
  93.   for the systems which support it
  94.         
  95.   For V1.14, we now officially support AT&T SVR4.  It has worked just
  96.   fine using SVR4 with previous versions of IOzone.  Also, for systems
  97.   which use the times() function, we calculate the 'base time' the first
  98.   time we ever call time_so_far(), then subtract this time from all
  99.   future measurements.  This increases the precision of our measurement
  100.   and fixes a loss-of-precision problem which occurred on some systems
  101.         
  102.   For V1.15, add the NO_DELETE symbol.  If you define NO_DELETE during
  103.   the compilation (e.g., for UNIX systems compile with cc -DNO_DELETE),
  104.   IOzone will not delete the 'temporary' file which it reads & writes.
  105.   This is REQUIRED when testing RAW DEVICES such as disks and tape drives!
  106.         
  107.  
  108.   This program has been ported and tested on the following computer
  109.   operating systems:
  110.  
  111.     Vendor             Operating System    Notes on compiling IOzone
  112.     -------------------------------------------------------------------------
  113.     Apollo          Domain/OS           no cc switches -- BSD domain
  114.     AT&T               UNIX System V Release 4
  115.     AT&T 6386WGS       AT&T UNIX 5.3.2     can't get it to compile with cc
  116.                           It should work with gcc via:
  117.                           'gcc -ansi -o iozone iozone.c'
  118.     Generic AT&T       UNIX System V R3    may need cc -DSVR3
  119.     Convergent         Unisys/AT&T Sys5r3  cc -DCONVERGENT -o iozone iozone.c
  120.     Digital Equipment  ULTRIX V4.1 
  121.     Digital Equipment  VAX/VMS V5.4        see below **         
  122.     Digital Equipment  VAX/VMS (POSIX) 
  123.     Hewlett-Packard    HP-UX 7.05
  124.     IBM                AIX Ver. 3 rel. 1
  125.     Interactive        UNIX System V R3    
  126.     Microsoft          MS-DOS 3.3          tested Borland, Microsoft C
  127.     MIPS               RISCos 4.52
  128.     NeXt               NeXt OS 2.x
  129.     OSF                OSF/1
  130.     Portable!          POSIX 1003.1-1988   may need to -D_POSIX_SOURCE
  131.     QNX                QNX 4.0
  132.     SCO                UNIX System V/386 3.2.2
  133.     SCO                XENIX 2.3
  134.     SCO                XENIX 3.2
  135.     Silicon Graphics   UNIX                cc -DSGI -o iozone iozone.c
  136.     Sony Microsystems  UNIX                same as MIPS
  137.     Sun Microsystems   SUNOS 4.1.1
  138.     Tandem Computers   GUARDIAN 90         1. call the source file IOZONEC
  139.                                            2. C/IN IOZONEC/IOZONE;RUNNABLE
  140.                                            3. RUN IOZONE
  141.     Tandem Computers   Non-Stop UX
  142.         
  143.     ** for VMS, define iozone as a foreign command via this DCL command:       
  144.  
  145.        $IOZONE :== $SYS$DISK:[]IOZONE.EXE      
  146.  
  147.        this lets you pass the command line arguments to IOZONE
  148.  
  149.   Acknowledgements to the following persons for their feedback on IOzone:       
  150.  
  151.   Andy Puchrik, Michael D. Lawler, Krishna E. Bera, Sam Drake, John H. Hartman, 
  152.   Ted Lyszczarz, Bill Metzenthen, Jody Winston, Clarence Dold, Axel
  153.   Dan Hildebrand, Joe Nordman, Bob Fritz, Jeff Johnson
  154.         
  155.   --- MODIFICATION HISTORY:
  156.  
  157.  
  158.     3/7/91 William D. Norcott (Bill.Norcott@nuo.mts.dec.com)
  159.                                created
  160.  
  161.     3/22/91 Bill Norcott       tested on OSF/1 ... it works
  162.  
  163.     3/24/91 Bill Norcott       V1.02 -- use calloc in TURBOC to
  164.                                        fix bug with their malloc
  165.  
  166.     3/25/91 Bill Norcott       V1.03 -- add ifdef for XENIX
  167.                                        
  168.     3/27/91 Bill Norcott       V1.04 -- Includes for SCO UNIX
  169.                                        
  170.     4/26/91 Bill Norcott       V1.05 -- support AIX and SUNos, check
  171.                                        length of read() and write()
  172.     4/26/91 Bill Norcott       V1.06 -- tabulate results of a series 
  173.                                        of tests
  174.     5/17/91 Bill Norcott       V1.07 -- use time() for VMS
  175.     5/20/91 Bill Norcott       V1.08 -- use %ld for Turbo C and
  176.                                        use #ifdef sun to bypass
  177.                                        inclusion of limits.h
  178.     6/19/91 Bill Norcott       V1.09 -- rid #elif to support HP-UX and 
  179.                                        Silicon Graphics UNIX, and
  180.                                        add #ifdef SGI
  181.                                        add #ifdef CONVERGENT
  182.                                        for Convergent Technologies
  183.                                        also add help option
  184.     7/2/91 Bill Norcott        V1.10 -- delete file if get SIGINT
  185.                                        or SIGTERM
  186.     8/20/91 Bill Norcott       V1.11 -- require no flags with AIX
  187.     11/4/91 Bill Norcott       V1.12 -- support MIPS RISCos
  188.                                          Tandem NonStop-UX, and
  189.                                         IEEE Std POSIX 1003.1-1988
  190.     12/4/91 Bill Norcott       V1.13 -- support NeXT; tell host OS type
  191.     1/23/92 Bill Norcott      V1.14 -- support QNX & use calloc() for buffer
  192.     5/1/92 Bill Norcott      V1.15 -- support SVR4; fix loss of precision
  193.                                        in times() function.  
  194.                                        support Interactive UNIX
  195.                                        detect ANSI if no O/S
  196.                                        Also, define for generic SVR3
  197.                                        Apollo Domain/OS
  198.                                        Define NO_DELETE and iozone wont
  199.                                        delete the temp file.  Needed to
  200.                                        test raw devices without deleting
  201.                                        them
  202.     10/28/92 Bill Norcott    V1.16 -- bug fix: some unsigned longs changed
  203.                                       to unsigned in V1.15 caused problem
  204.                                       so change back.  Also, note problems
  205.                      with AT&T 6386WGS systems
  206.  
  207.