/************************************************
 * File         : ktau/README
 * Version      : $Id: README,v 1.4 2005/10/19 22:56:16 suravee Exp $
 ***********************************************/
*******************
*KTAU Distribution*
*******************
	KTAU distribution is organized as in following hierarchy.

	ktau/patches/		: Contains patches for various versions of Linux kernel
	     src/		: Contains extension to Linux kernel which is independent
				  from version of the kernel.
             user-src/		: Contains user-space libraries and utilities.
	     misc/ 		: Work in progess
	     ktau_installation.log : shows a screenshot of installation step. 
	     DOCS		: KTAU Documentation.
	     LICENCE		: KTAU license file.
	     COPYRIGHT		: KTAU copy right file.	
		
********************
*Installation Steps*
********************
	1. Obtain a KTAU distribution.

 	2. Obtain a vanilla Linux kernel.

	3. To install the kernel extension, in ktau/src/linux-2.x/, run

		sh INSTALL-kernel.sh <path of kernel source> <KTAU patch name>

	    This script will patch the kernel source with the specified patch name, and
	    Then install the KTAU extension to Linux kernel.

	4. To install libraries and utilities, in ktau/user-src/src, run 
	
		make clean all install KERNEL_SRC=<path to kernel source>

	    This will build and put all the libraries and utilities in ktau/user-src/bin,
	    which must be included in $PATH variable. 

	5. At kernel source root, run make menuconfig and configure the kernel.
	   Configure KTAU as discussed the KTAU documentation
           (http://www.cs.uoregon.edu/research/ktau/) 	

	6. Compile and build the kernel as usual. At kernel root, run
		make clean dep bzImage modules modules_install 	(for Linux-2.4)
	or 	make clean bzImage modules modules_install	(for Linux-2.6)

	7. Install kernel image (bzImage for ix86) and configure the bootloader (i.e. lilo,
	    grub) to choose the installed kernel image.
