This is the TESTING for ext2hide by Jason McManus, Copyleft 2006

*****************************************************************************
** SKIP TO THE "HOW TO TEST" SECTION IF YOU DON'T WANT TO READ ALL OF THIS **
*****************************************************************************

Hi, thanks for beta-testing my ext2hide program.  I'll just give you a quick
summary on what it is and how to do it, so you can get to the test.  There's
more information in the README, if you are interested.

ext2hide is a tool I wrote to test the possibility of using the Reserved
Space block I discovered in the ext2 filesystem specifications to store
hidden, inaccessible files on an ext2/3 filesystem.  It started out as a
small project, but has turned into what may be a useful utility, and I have
worked hard on making this package thorough and complete.

The tests included do NOT do any actual writing to your filesystem; they
generate temporary files, format those temporary files, and run the tests
there, on the 3 block sizes that ext2 uses.  If there is any skepticism of
this fact, note that these tests can run as only a regular user, and your
actual filesystem devices are only writable by root (or the kernel,
obviously).

I have extensively tested this on my own systems (2.4 and 2.6), using both
the temporary files and my actual LIVE filesystem, and have never run into
data corruption problems, because I use the actual Ext2 libraries to
calculate the locations where the data can be stored.  Also, when using the
program normally, it will prompt before ANY action is taken to write to the
filesystem.

There is more information in the various README, WARNING and INSTALL files
in this directory, but for now, let's proceed to the test.

*************************************************
                HOW TO TEST
*************************************************

1.  Download and install the e2fsprogs-devel package using your package
management system, or from the site: http://e2fsprogs.sourceforge.net/.
(you can skip this, and attempt to use the included binary "ext2hide"
program, but it may not work on your system.  Try running it as "ext2hide -h"
if you would like to see.)

2.  Run "./Build all" in this directory to (re)build the binary.

3.  Run the "./Test.pl" script in this directory.  The first time you run
it, it will ask you to set up some work files.  Just say yes to all of the
prompts (4 of them).  

4.  If you received any errors, paste the output of the script into an
email, along with the output of "./Build bugreport", and send it to me at
the address listed below.

That's it!  You're done.

**********************
More extensive testing
**********************

The test script is useful for automated testing, but cannot necessarily give
the in-depth coverage provided by normal usage.  The following are some of
the more thorough test cases I have developed.  Please feel free to perform
any of the test cases below.  There is no test plan for them, but once you
are familiar with the project, they should be fairly straightforward.

* Run all commands on all 3 block sizes at all verbosity levels
* Run extract/write/delete file with full pathname
* Run all commands/options at all verbosity levels
* Run extract/write/delete with < 1-block and > 1-block files
* Write single and multiple files to fill entire reserved space

Any other test plans you can come up with would be fine, also.

Also, bug reports from normal usage are solicited, and highly valuable.
Please report ANY bugs, caveats, feature requests, etc. to the addresses or
locations below.

*************************************************

Thank you very much for testing this program.  I appreciate any and all
feedback you can give me.  Feel free to browse through the contents of this
directory and read the various files, and let me know what you think, what
could be corrected, etc.

Cheers,
-Jason

You can reach me in the following ways:

"infi" on irc.freenode.net.
<ext2hide AT gmail DOT com>
Via my project page at: http://sourceforge.net/projects/ext2hide

-- END TESTING --
