1 files changed, 45 insertions, 0 deletions
diff --git a/c/src/tests/samples/fileio/fileio.doc b/c/src/tests/samples/fileio/fileio.doc
new file mode 100644
index 0000000000..30438f710d
--- /dev/null
+++ b/c/src/tests/samples/fileio/fileio.doc
@@ -0,0 +1,45 @@
+#
+#  fileio.doc,v 
+#
+#  COPYRIGHT (c) 1989-1999.
+#  On-Line Applications Research Corporation (OAR).
+#
+#  The license and distribution terms for this file may be
+#  found in the file LICENSE in this distribution or at
+#  http://www.OARcorp.com/rtems/license.html.
+#
+
+This sample implements some basic tests for the file systems
+available. It provides the following functionality:
+
+- perform basic file read/write tests on arbitrary file paths with
+selectable I/O buffer size
+- perform functions to evaluate FAT disk partition tables
+- perform functions to mount FAT disks to the file system tree
+
+A sample session might look like this:
+
+- start this system
+
+- select "p" (part_table_initialize) to read in the partition table of
+first harddisk, enter the device name "/dev/hda", when prompted
+
+- select "f" (fsmount) to try to mount the partitions
+  /dev/hda1../dev/hdc4 to corresponding mount points. Non-existant
+  partitions will report an error, but will not abort the tests
+
+- select "w" (write file) to create a new file on the mounted disk (or
+  in the IMFS). Enter the file name (e.g. "/mnt/hda1/test_1M.txt"),
+  the file size (e.g. 64K or 2M) and the buffer size to use for the
+  write calls (e.g. 32 or 4K). Then the sample will try to write the
+  corresponding file and print the time consumed and data rate achived.
+
+- select "r" (read file) to read a file (without displaying the
+  contents). It has similar parameters as "write file", but does not
+  query the file size.
+
+- select "s" to call the rtems shell with its various capabilities.
+
+
+
+