X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;f=README;h=99c4d3652abb6cfcc8958ff3e2eb140645ebc9f9;hb=cae4aad47dfa49a541a5df463ce35c05e4678de4;hp=e9391e8792093e84063ab1480fafb2243a3a88ff;hpb=2c02cadef79f6e488f203ecc7e0d1eda0fafe849;p=febootstrap.git diff --git a/README b/README index e9391e8..99c4d36 100644 --- a/README +++ b/README @@ -1,44 +1,63 @@ -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 - MAKEDEV + gcc + + gawk - upx - - Ultimate Packer for eXecutables, for minimizing binaries + libcom_err + libext2fs + /sbin/mke2fs + - These are part of e2fsprogs. + +For Fedora/RHEL: + + rpm + yum + yumdownloader - qemu - - If you want to test-run your systems. +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 Building and installing ----------------------- @@ -50,5 +69,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") +