CamouflageFS User Utilities README file
September 24, 2003
======================================================================

INTRO

CamouflageFS provides more effective cryptographic protection at a
reduced cost. CamouflageFS is implemented as an extension to the
Ext2 file system in Linux. CamouflageFS is mainly implemented in the
kernel (version 2.4.19 as of this writing) and requires no changes
to existing applications that do not wish to use the camouflage
capabilities. However, in order to take advantage of CamouflageFS,
some basic utilities (similar to 'cat' and 'cp') have been provided.


COMPILE

To create the utilities, simply type 'make'. We assumed you have
GNUmake (gmake) installed.

TEST

Make sure you have 64-bit file support (LFS) in your kernel and 
glibc. Run the ./test64 test at the command line. If the file
'foo' isn't huge (or the program returns -1 in its final output),
you need to get LFS. See http://www.suse.de/~aj/linux_lfs.html
for more detail.


UTILITIES

 cinfo - debugging utility
 cmark - mark (or unmark) the file as a CamouflageFS file
 readfile - like 'cat'
 writefile - like 'cp'
 test64 - test for LFS 
 testkey - test that key pointer manipulation will work inside
	kernel

CONTACT

If you have any questions, contact mel2008@columbia.edu.
