share/doc/papers/diskperf/tests.ms

   1 .\" Copyright (c) 1983 The Regents of the University of California.
   2 .\" All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. All advertising materials mentioning features or use of this software
  13 .\"    must display the following acknowledgement:
  14 .\"     This product includes software developed by the University of
  15 .\"     California, Berkeley and its contributors.
  16 .\" 4. Neither the name of the University nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\"     @(#)tests.ms    6.2 (Berkeley) 4/16/91
  33 .\" $FreeBSD: src/share/doc/papers/diskperf/tests.ms,v 1.5 1999/08/28 00:18:04 peter Exp $
  34 .\" $DragonFly: src/share/doc/papers/diskperf/tests.ms,v 1.2 2003/06/17 04:36:56 dillon Exp $
  35 .\"
  36 .ds RH Tests
  37 .NH
  38 Tests
  39 .PP
  40 Our battery of tests consists of four programs,
  41 read_8192, write_8192, write_4096
  42 and rewrite_8192 originally written by [McKusick83]
  43 to evaluate the performance of the new file system in 4.2BSD.
  44 These programs all follow the same model and are typified by
  45 read_8192 shown here.
  46 .DS
  47 #define BUFSIZ 8192
  48 main( argc, argv)
  49 char **argv;
  50 {
  51         char buf[BUFSIZ];
  52         int i, j;
  53
  54         j = open(argv[1], 0);
  55         for (i = 0; i < 1024; i++)
  56                 read(j, buf, BUFSIZ);
  57 }
  58 .DE
  59 The remaining programs are included in appendix A.
  60 .PP
  61 These programs read, write with two different blocking factors,
  62 and rewrite logical files in structured file system on the disk
  63 under test.
  64 The write programs create new files while the rewrite program
  65 overwrites an existing file.
  66 Each of these programs represents an important segment of the
  67 typical UNIX file system activity with the read program
  68 representing by far the largest class and the rewrite the smallest.
  69 .PP
  70 A blocking factor of 8192 is used by all programs except write_4096.
  71 This is typical of most 4.2BSD user programs since a standard set of
  72 I/O support routines is commonly used and these routines buffer
  73 data in similar block sizes.
  74 .PP
  75 For each test run, a empty eight Kilobyte block
  76 file system was created in the target
  77 storage system.
  78 Then each of the four tests was run and timed.
  79 Each test was run three times;
  80 the first to clear out any useful data in the cache,
  81 and the second two to insure that the experiment
  82 had stablized and was repeatable.
  83 Each test operated on eight Megabytes of data to
  84 insure that the cache did not overly influence the results.
  85 Another file system was then initialized using a
  86 basic blocking factor of four Kilobytes and the same tests
  87 were run again and timed.
  88 A command script for a run appears as follows:
  89 .DS
  90 #!/bin/csh
  91 set time=2
  92 echo "8K/1K file system"
  93 newfs /dev/rhp0g eagle
  94 mount /dev/hp0g /mnt0
  95 mkdir /mnt0/foo
  96 echo "write_8192 /mnt0/foo/tst2"
  97 rm -f /mnt0/foo/tst2
  98 write_8192 /mnt0/foo/tst2
  99 rm -f /mnt0/foo/tst2
 100 write_8192 /mnt0/foo/tst2
 101 rm -f /mnt0/foo/tst2
 102 write_8192 /mnt0/foo/tst2
 103 echo "read_8192 /mnt0/foo/tst2"
 104 read_8192 /mnt0/foo/tst2
 105 read_8192 /mnt0/foo/tst2
 106 read_8192 /mnt0/foo/tst2
 107 umount /dev/hp0g
 108 .DE
 109 .ds RH Results
 110 .bp