summaryrefslogtreecommitdiffstats
path: root/README
blob: f0850e0c67045ec3d24b13e9a519494ff4addeaf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
febootstrap - Bootstrapping tool for creating supermin appliances
by Richard W.M. Jones (rjones@redhat.com)
http://people.redhat.com/~rjones/febootstrap
----------------------------------------------------------------------

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.

A complete description is in the febootstrap(8) man page.

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
------------

  ocaml

  ocaml findlib ("ocamlfind" program)

  perldoc
    - This is just used to generate the manpage.

  bash

  gcc

  qemu
    - Only if you need to test-boot appliances.

  gawk

  libcom_err
  libext2fs
  /sbin/mke2fs
    - These are part of e2fsprogs.

  /sbin/insmod.static
    - This is part of module-init-tools.  Note that Debian does NOT
      package this, you have to build it yourself (or copy the file
      from a Fedora machine which also works ...)

Optional
--------
(but you will need a package manager for your Linux distro)

  yum
  rpm
  apt-get
  dpkg

Building and installing
-----------------------

  ./configure
  make
  sudo make install

Feedback and bugs
-----------------

Send feedback to libguestfs@redhat.com.  You can file bugs in
https://bugzilla.redhat.com/ (under "Fedora", "febootstrap")