$Id: README-BUILD,v 1.10 2002/11/07 04:05:40 root Exp $

HOW TO BUILD YOUR OWN VERSION OF THE SUPERRESCUE DISK
-----------------------------------------------------

You need a Linux system with the following installed, in addition to
the normal utilities:

	mkisofs (from cdrtools 1.11a20 or later, or 1.10+zisofs patch)
	zisofs-tools (1.0.4 or later)

zisofs-tools, including the patch to cdrtools 1.10, is available at:

http://www.kernel.org/pub/linux/utils/fs/zisofs/

In addition, you need about 5 GB of free disk space.

You must build SuperRescue as root.  This build procedure *will*
create device nodes and other special files on your filesystem, as
well as files with weird permissions.

There is no promise that this will work on any system which doesn't
use the same mappings for the system uid/gid's as RedHat systems.  I
have not tested building SuperRescue on any other distribution.

NOTE: Version numbers differing only in a final letter (e.g. 1.2.1a
versus 1.2.1) matter only if you intend to make your own modified
versions of SuperRescue using the included build scripts.  If you are
using an earlier version differing only in the final letter, you can
download the buildtree tarball separately.  In that case, replace
$CDROM/buildtree.tar.gz below with the downloaded buildtree tarball.

 1. Create an empty directory on your target machine where you want to
    build.  Let's call this directory $BUILDROOT.
 
 2. Become root.
 
 3. Mount the SuperRescue CD-ROM.  Let's call the directory where the
    CD-ROM is mounted $CDROM.
 
 4. The build procedure varies somewhat depending on if the machine you
    are building on has the zisofs patch installed or not.  You can
    test this by:
 
 	ls -l $CDROM/compression-test-12345
 
    If this file is 12345 bytes in length, you have the zisofs patch
    installed.  Otherwise, you do not.
 
 5. Unpack the build tree:
 
 	cd $BUILDROOT
 	tar xvvpfz $CDROM/buildtree.tar.gz
 
    [Note: the "p" option to tar is absolutely vital.]
 
 6. Create the Builder file.  This should have your information in it,
    to distinguish your version from the one built by someone else:
 
 	echo 'Your Name <you@whereever.net>' > Builder
 
 7. Copy the root directory to the build tree:
 
 	cd root
 	tar xvvpfz $CDROM/root.tar.gz
 	cd ..
 
 8. Copy the usr directory to the build tree:
 
    If you DO have the zisofs patch installed:
 
 	cd usr
 	cp -a $CDROM/. .
 	cd ..
 
    If you DO NOT have the zisofs patch installed:
 
 	rmdir usr
 	mkzftree -u $CDROM usr
 
 9. Make whatever modifications you want.  Note, that if you want to
    install or remove RPMs it may be easier if you temporarily move the
    "usr" directory underneath the "root" and use the --root option to
    rpm.  For major changes, you may want to install the root and usr
    as separate partitions on a real hard disk and boot your system
    off it.
 
10. Run the make script, passing a version number as a parameter.  I'd
    really appreciate it if you would modify the version number so as
    not to confuse your version with the officially released version,
    perhaps by appending your initials:
 
 	./make.sh 2.0.0-you-1
 
11. Upload, burn to CD-ROM, whatever:

	cdrecord -v superrescue-2.0.0-you-1.iso