X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;f=README;h=5383dcb525fbbf11050253260791e71809c19458;hb=89e336ee166be538e376d288fb2b3fbbffd66d4c;hp=33087a78b06454ff83856b3219978b9ae23fe914;hpb=dd31db6b8575017d3a4f5bb56c6550e9138a2590;p=febootstrap.git

diff --git a/README b/README
index 33087a7..5383dcb 100644
--- a/README
+++ b/README
@@ -1,5 +1,6 @@
 febootstrap - Bootstrap a basic Fedora system
 by Richard W.M. Jones (rjones@redhat.com)
+http://people.redhat.com/~rjones/febootstrap
 ----------------------------------------------------------------------
 
 febootstrap is a Fedora equivalent to Debian's debootstrap.  You can
@@ -16,14 +17,14 @@ Requirements
   fakeroot
     - Tested with version 1.11.
 
-  fakechroot > 2.8 or 2.8 + patch
-    - NB. KNOWN NOT TO WORK WITH 2.8.  You MUST apply the patch
-      'fakechroot-2.8-relchroot.patch' to the fakechroot sources
-      and recompile.  Hopefully this patch will be included in
-      future versions of fakechroot.
+  fakechroot >= 2.9 or 2.8 + patch
+    - **** NB. KNOWN NOT TO WORK WITH 2.8 *****  You MUST apply
+      the patch 'fakechroot-2.8-relchroot.patch' to the fakechroot
+      sources and recompile.  Hopefully this patch will be included
+      in future versions of fakechroot.
 
   yum
-    - Tested with version 3.2.
+    - Tested with version 3.2 (works best with 3.2.21 or above)
     - Needs network access to a Fedora repository, or a local
       Fedora mirror.
 
@@ -32,11 +33,15 @@ Requirements
 
   bash
 
-  MAKEDEV
+  gcc
 
   qemu
     - If you want to test-run your systems.
 
+  libext2fs
+  /sbin/mke2fs
+    - These are part of e2fsprogs.
+
 Building and installing
 -----------------------
 
@@ -44,6 +49,40 @@ Building and installing
   make
   sudo make install
 
+Note, if you want to run the scripts locally without installing,
+you have to set the $PATH to the current directory, ie:
+
+  PATH=$(pwd):$PATH
+  febootstrap [...]
+
+Debugging
+---------
+
+If you get segfaults while running febootstrap or errors in the %post
+scripts, these are often caused by some incompatibility in the
+emulation provided by fakeroot/fakechroot.  You can track them down by
+running the yum command explicitly.  Try:
+
+  fakeroot fakechroot -s \
+    yum -y -c /tmp/repo \
+      --disablerepo=\* --enablerepo=febootstrap \
+      --noplugins --nogpgcheck \
+      --installroot=/tmp/root \
+      install "@Core"
+
+where /tmp/repo would be a file like this (change repo and arch
+parameters as appropriate):
+
+  [febootstrap]
+  name=febootstrap
+  failovermethod=priority
+  enabled=1
+  gpgcheck=0
+  mirrorlist=http://mirrors.fedoraproject.org/mirrorlist?repo=rawhide&arch=x86_64
+
+You can insert gdb in the appropriate place in the fakeroot /
+fakechroot / yum command.
+
 Feedback and bugs
 -----------------