README

   1 febootstrap - Bootstrapping tool for creating supermin appliances
   2 by Richard W.M. Jones (rjones@redhat.com)
   3 http://people.redhat.com/~rjones/febootstrap
   4 ----------------------------------------------------------------------
   5
   6 febootstrap is a tool for building supermin appliances.  These are
   7 tiny appliances [similar to virtual machines], usually around 100KB in
   8 size, which get fully instantiated on-the-fly in a fraction of a
   9 second when you need to boot one of them.
  10
  11 A complete description is in the febootstrap(8) man page.
  12
  13 IMPORTANT NOTE FOR USERS OF FEBOOTSTRAP 2.x:
  14   febootstrap 3.x is a complete rewrite.  febootstrap 2.x could only
  15   build Fedora distributions.  This version can build many varieties
  16   of Linux distros.  3.x only builds supermin appliances, it does not
  17   build chroots.  3.x does not build cross-distro, cross-release or
  18   cross-architecture systems.  If you want febootstrap 2.x, please use
  19   the 'febootstrap-2.x' branch from the git repository.
  20
  21 Requirements
  22 ------------
  23
  24   ocaml
  25
  26   ocaml findlib ("ocamlfind" program)
  27
  28   perldoc
  29     - This is just used to generate the manpage.
  30
  31   bash
  32
  33   gcc
  34
  35   gawk
  36
  37   libcom_err
  38   libext2fs
  39   /sbin/mke2fs
  40     - These are part of e2fsprogs.
  41
  42   /sbin/insmod.static
  43     - This is part of module-init-tools.  Note that Debian does NOT
  44       package this, you have to build it yourself (or copy the file
  45       from a Fedora machine which also works ...)
  46
  47 For Fedora/RHEL:
  48
  49   rpm
  50   yum
  51   yumdownloader
  52
  53 For Debian/Ubuntu:
  54
  55   dpkg
  56   aptitude
  57
  58 Optional
  59 --------
  60
  61 These are only needed if you plan to boot the supermin appliances you
  62 are building:
  63
  64   qemu >= 0.13
  65   kernel >= 2.6.36
  66
  67 Building and installing
  68 -----------------------
  69
  70   ./configure
  71   make
  72   sudo make install
  73
  74 Feedback and bugs
  75 -----------------
  76
  77 Send feedback to libguestfs@redhat.com.  You can file bugs in
  78 https://bugzilla.redhat.com/ (under "Fedora", "febootstrap")
  79