$Id: README-BUILD,v 1.5 2001/04/15 01:39:00 hpa 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:

	mkdosfs (2.2 with the 2.88 MB diskimage patch[*], or later)
	mkisofs (1.13 or later; included with cdrecord 1.9 or later)

In addition, you need about 2 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. Unpack the build tree:

	cd $BUILDROOT
	tar xvvpfz $CDROM/buildtree.tar.gz

   [Note: the "p" option to tar is absolutely vital.]

5. 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

6. Copy the root and usr directories to the build tree:

	cd root
	tar xvvpfz $CDROM/root.tar.gz
	cd ../usr
	cp -a $CDROM/. .
	cd ..

7. 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.

8. 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 1.2.1-you-1

9. Upload, burn to CD-ROM, whatever...


[*] The following patch is required against stock dosfstools-2.2.  The
RedHat RPM dosfstools-2.2-4 seems to include it by default.  Later
versions of dosfstools might have this patch integrated; I don't know
for sure either way.

--- dosfstools-2.2/mkdosfs/mkdosfs.c.2.88	Wed Sep 29 12:58:40 1999
+++ dosfstools-2.2/mkdosfs/mkdosfs.c	Wed Sep 29 12:59:13 1999
@@ -627,6 +627,10 @@ establish_params (int device_num,int siz
 	      param.sect = 18;
 	      param.head = 2;
 	      break;
+	    case 5760:
+	      param.sect = 36;
+	      param.head = 2;
+	      break;
 	    default:
 	      /* fake values */
 	      param.sect = 32;
