direct/test-framework/tests/README

   1 NB THis directory uses a hacked version of fsx.c which is released under
   2 Apple Public Source License.
   3
   4 From what I have been able to determine, it is legally OK to release a hacked
   5 version for the purposes of testing.
   6
   7 If anyone knows otherwise, please contact me: manningc2@actrix.gen.nz
   8
   9
  10
  11 I find it best to run these tests in a ramfs to make them run faster (and
  12 not pound the disk).
  13
  14 A quick word about running some of these tests...
  15
  16
  17 There are two tests, one simulating nor and the other nand, labelled
  18
  19 *nor*.sh and *nand*.sh
  20
  21 These can be run in the local directory as follows:
  22 $ ./init_fw_update_test_nand.sh
  23 $ ./run_fw_update_test_nand.sh
  24
  25 NB These create simulation files in the current directory, so only one
  26 instance can be run in a directory.
  27
  28 The number of iterations can be set by adding a numerical parameter
  29
  30 $ ./init_fw_update_test_nand.sh
  31 $ ./run_fw_update_test_nand.sh 5000
  32
  33 Since the test creates snapshot files between each iteration the test is
  34 relatively slow if run against a hard disk. Far better to run against a ram
  35 disk
  36
  37 $ mkdir xxx
  38 $ mount -t tmpfs none xxx
  39 $ cd xxx
  40 $ cp ../*sh .
  41 $ ln -s ../yaffs_test yaffs_test
  42 $ ./init_fw_update_test_nand.sh
  43 $ ./run_fw_update_test_nand.sh
  44
  45 The above is also wrapped in a script called manage_nor_test.sh which
  46 creates all the above. The managed_nor_test.sh script accepts an optional
  47 parameter to specify an instance name. Named instances will create named
  48 directories.
  49
  50 If you want to run multuiple instances then it is easy to do so with
  51 xterm as follows:
  52
  53 $ xterm  -e "`pwd`/manage_nor_test.sh  1"&
  54 $ xterm  -e "`pwd`/manage_nor_test.sh  2"&
  55 $ xterm  -e "`pwd`/manage_nor_test.sh  3"&
  56 ...
  57
  58 Then there's launch_tests.sh which sets up a tmpfs directory and launches 3
  59 nor simulations and 3 nand simulations.
  60