README

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