X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;f=README;h=2c42b2ee4aa2ae0aeab84b3063d3685270eb5398;hb=2e1e2d686ca8f819c202d2ed4e8a5c5758451f26;hp=5f2a8a7f9a48af547f9cb9d2d63bd775da1d84e9;hpb=1ef78043a28df140e5302a4e00635e3d0792dbeb;p=febootstrap.git diff --git a/README b/README index 5f2a8a7..2c42b2e 100644 --- a/README +++ b/README @@ -1,37 +1,66 @@ -febootstrap - Bootstrap a basic Fedora system +febootstrap - Bootstrapping tool for creating supermin appliances 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 -use it to create a basic Fedora filesystem. +febootstrap is a tool for building supermin appliances. These are +tiny appliances [similar to virtual machines], usually around 100KB in +size, which get fully instantiated on-the-fly in a fraction of a +second when you need to boot one of them. -There are currently some restrictions compared to debootstrap. +A complete description is in the febootstrap(8) man page. -For instructions, restrictions, examples etc. please read the manpage -febootstrap(8). +IMPORTANT NOTE FOR USERS OF FEBOOTSTRAP 2.x: + febootstrap 3.x is a complete rewrite. febootstrap 2.x could only + build Fedora distributions. This version can build many varieties + of Linux distros. 3.x only builds supermin appliances, it does not + build chroots. 3.x does not build cross-distro, cross-release or + cross-architecture systems. If you want febootstrap 2.x, please use + the 'febootstrap-2.x' branch from the git repository. Requirements ------------ - fakeroot - - Tested with version 1.11. + ocaml - 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. - - yum - - Tested with version 3.2. - - Needs network access to a Fedora repository, or a local - Fedora mirror. + ocaml findlib ("ocamlfind" program) perldoc - This is just used to generate the manpage. bash + gcc + + gawk + + libcom_err + libext2fs + /sbin/mke2fs + - These are part of e2fsprogs. + +For Fedora/RHEL: + + rpm + yum + yumdownloader + +For Debian/Ubuntu: + + dpkg + aptitude + +Optional +-------- + +These are only needed if you plan to boot the supermin appliances you +are building: + + qemu >= 0.13 + kernel >= 2.6.36 + + zlib - if your kernel uses gzipped modules + Building and installing ----------------------- @@ -42,5 +71,6 @@ Building and installing Feedback and bugs ----------------- -Send feedback to rjones@redhat.com. You can file bugs in -http://bugzilla.redhat.com/ +Send feedback to libguestfs@redhat.com. You can file bugs in +https://bugzilla.redhat.com/ (under "Fedora", "febootstrap") +