README
1 # Copyright (c) International Business Machines Corp., 2002
2 #
3 # This program is free software; you can redistribute it and/or modify
4 # it under the terms of the GNU General Public License as published by
5 # the Free Software Foundation; either version 2 of the License, or
6 # (at your option) any later version.
7 #
8 # This program is distributed in the hope that it will be useful,
9 # but WITHOUT ANY WARRANTY; without even the implied warranty of
10 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
11 # the GNU General Public License for more details.
12 #
13 # You should have received a copy of the GNU General Public License
14 # along with this program; if not, write to the Free Software
15 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16 #
17
18 The directory consists of following:
19 diotest_routines.c: Routines to support the test programs.
20 diotest[1-6].c: 6 test programs with 30 test blocks.
21 Makefile: To compile the programs.
22
23 To run the programs:
24 1: Compile the programs
25 $ make
26 2: Execute the test script or the test programs individually.
27 $ ./diorun
28 Creates a "logfile" by default under current directory.
29 For any failures, look in the logfile for more information.
30
31 OR
32
33 $ <testprogram-name> [options]
34
35 Note:
36 -----
37 1: The script diorun gives different ways to run the tests. Add additional
38 test cases as needed.
39 2: For diotest3.c and diotest6.c fails randomly with a number of children
40 for bigger runs. The test fail with either data comparaision failures
41 or input/output errors during read. Two issues are identified with
42 buffered/direct read, write coherence and the problem is reported.
43 (bugzilla.linux.ibm.com - Bug# 862).
44
45 Any questions?
46 --------------
47 Send email to: nsharoff (a] us.ibm.com
48
49