xref: /third_party/ltp/testcases/kernel/io/direct_io/README

#   Copyright (c) International Business Machines  Corp., 2002
#
#   This program is free software;  you can redistribute it and/or modify
#   it under the terms of the GNU General Public License as published by
#   the Free Software Foundation; either version 2 of the License, or
#   (at your option) any later version.
#
#   This program is distributed in the hope that it will be useful,
#   but WITHOUT ANY WARRANTY;  without even the implied warranty of
#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See
#   the GNU General Public License for more details.
#
#   You should have received a copy of the GNU General Public License
#   along with this program;  if not, write to the Free Software
#   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
#

The directory consists of following:
	diotest_routines.c:	Routines to support the test programs.
	diotest[1-6].c:		6 test programs with 30 test blocks.
	Makefile:		To compile the programs.

To run the programs:
	1: Compile the programs
		$ make
	2: Execute the test script or the test programs individually.
		$ ./diorun
		Creates a "logfile" by default under current directory.
		For any failures, look in the logfile for more information.

		OR

		$ <testprogram-name> [options]

Note:
-----
1: The script diorun gives different ways to run the tests. Add additional
   test cases as needed.
2: For diotest3.c and diotest6.c fails randomly with a number of children
   for bigger runs. The test fail with either data comparaision failures
   or input/output errors during read. Two issues are identified with
   buffered/direct read, write coherence and the problem is reported.
   (bugzilla.linux.ibm.com - Bug# 862).

Any questions?
--------------
Send email to: nsharoff@us.ibm.com