README

   1 febootstrap - Bootstrap a basic Fedora system
   2 by Richard W.M. Jones (rjones@redhat.com)
   3 http://people.redhat.com/~rjones/febootstrap
   4 ----------------------------------------------------------------------
   5
   6 febootstrap is a Fedora equivalent to Debian's debootstrap.  You can
   7 use it to create a basic Fedora filesystem.
   8
   9 There are currently some restrictions compared to debootstrap.
  10
  11 For instructions, restrictions, examples etc. please read the manpage
  12 febootstrap(8).
  13
  14 Requirements
  15 ------------
  16
  17   fakeroot
  18     - Tested with version 1.11.
  19
  20   fakechroot >= 2.9 or 2.8 + patch
  21     - **** NB. KNOWN NOT TO WORK WITH 2.8 *****  You MUST apply
  22       the patch 'fakechroot-2.8-relchroot.patch' to the fakechroot
  23       sources and recompile.  Hopefully this patch will be included
  24       in future versions of fakechroot.
  25
  26   yum
  27     - Tested with version 3.2 (works best with 3.2.21 or above)
  28     - Needs network access to a Fedora repository, or a local
  29       Fedora mirror.
  30
  31   perldoc
  32     - This is just used to generate the manpage.
  33
  34   bash
  35
  36   gcc
  37
  38   qemu
  39     - If you want to test-run your systems.
  40
  41   libext2fs
  42   /sbin/mke2fs
  43     - These are part of e2fsprogs.
  44
  45 Building and installing
  46 -----------------------
  47
  48   ./configure
  49   make
  50   sudo make install
  51
  52 Note, if you want to run the scripts locally without installing,
  53 you have to set the $PATH to the current directory, ie:
  54
  55   PATH=$(pwd):$PATH
  56   febootstrap [...]
  57
  58 Debugging
  59 ---------
  60
  61 If you get segfaults while running febootstrap or errors in the %post
  62 scripts, these are often caused by some incompatibility in the
  63 emulation provided by fakeroot/fakechroot.  You can track them down by
  64 running the yum command explicitly.  Try:
  65
  66   fakeroot fakechroot -s \
  67     yum -y -c /tmp/repo \
  68       --disablerepo=\* --enablerepo=febootstrap \
  69       --noplugins --nogpgcheck \
  70       --installroot=/tmp/root \
  71       install "@Core"
  72
  73 where /tmp/repo would be a file like this (change repo and arch
  74 parameters as appropriate):
  75
  76   [febootstrap]
  77   name=febootstrap
  78   failovermethod=priority
  79   enabled=1
  80   gpgcheck=0
  81   mirrorlist=http://mirrors.fedoraproject.org/mirrorlist?repo=rawhide&arch=x86_64
  82
  83 You can insert gdb in the appropriate place in the fakeroot /
  84 fakechroot / yum command.
  85
  86 Feedback and bugs
  87 -----------------
  88
  89 Send feedback to rjones@redhat.com.  You can file bugs in
  90 http://bugzilla.redhat.com/