X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;f=README;h=2c42b2ee4aa2ae0aeab84b3063d3685270eb5398;hb=2e1e2d686ca8f819c202d2ed4e8a5c5758451f26;hp=abe832af0514a63123c0beaf43b18cd76df90d8b;hpb=79d6fc6bba2e279baf59f27b8dd8fd728ed65de1;p=febootstrap.git diff --git a/README b/README index abe832a..2c42b2e 100644 --- a/README +++ b/README @@ -1,44 +1,65 @@ -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.9 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 + + libcom_err + libext2fs + /sbin/mke2fs + - These are part of e2fsprogs. + +For Fedora/RHEL: + + rpm + yum + yumdownloader + +For Debian/Ubuntu: + + dpkg + aptitude - upx - - Ultimate Packer for eXecutables, for minimizing binaries +Optional +-------- - qemu - - If you want to test-run your systems. +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 ----------------------- @@ -50,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") +