summaryrefslogtreecommitdiffstats
path: root/import-layers/meta-virtualization/README
blob: f13de089673b407ca4ef534d42dd231790b27cd8 (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
72
73
74
75
76
77
78
79
meta-virtualization
===================

This layer provides support for building Xen, KVM, Libvirt, and associated
packages necessary for constructing OE-based virtualized solutions.

The bbappend files for some recipes (e.g. linux-yocto) in this layer need to
have 'virtualization' in DISTRO_FEATURES to have effect. To enable them, add
in configuration file the following line.

  DISTRO_FEATURES_append = " virtualization"

If meta-virtualization is included, but virtualization is not enabled as a
distro feature a warning is printed at parse time:

    You have included the meta-virtualization layer, but
    'virtualization' has not been enabled in your DISTRO_FEATURES. Some bbappend files
    may not take effect. See the meta-virtualization README for details on enabling
    virtualization support.

If you know what you are doing, this warning can be disabled by setting the following
variable in your configuration:

  SKIP_META_VIRT_SANITY_CHECK = 1

Depending on your use case, there are other distro features in meta-virtualization
that may also be enabled:

 - xen: enables xen functionality in various packages (kernel, libvirt, etc)
 - kvm: enables KVM configurations in the kernel and autoloads modules
 - aufs: enables aufs support in docker and linux-yocto
 - x11: enable xen and libvirt functionality related to x11
 - selinux: enables functionality in libvirt and lxc
 - systemd: enable systemd services and unit files (for recipes for support)
 - sysvinit: enable sysvinit scripts (for recipes with support)

Dependencies
------------
This layer depends on:

URI: git://github.com/openembedded/openembedded-core.git
branch: master
revision: HEAD
prio: default

URI: git://github.com/openembedded/meta-openembedded.git
branch: master
revision: HEAD
layers: meta-oe
        meta-networking
        meta-filesystems
        meta-python

BBFILE_PRIORITY_openembedded-layer = "4"

Required for Xen XSM policy:
URI: git://git.yoctoproject.org/meta-selinux
branch: master
revision: HEAD
prio: default

Maintenance
-----------

Send pull requests, patches, comments or questions to meta-virtualization@yoctoproject.org

Maintainers: Raymond Danks <ray.danks@se-eng.com>
             Bruce Ashfield <bruce.ashfield@gmail.com>

When sending single patches, please using something like:
$ git send-email -1 -M --to meta-virtualization@yoctoproject.org --subject-prefix='meta-virtualization][PATCH'

License
-------

All metadata is MIT licensed unless otherwise stated. Source code included
in tree for individual recipes is under the LICENSE stated in each recipe
(.bb file) unless otherwise stated.

OpenPOWER on IntegriCloud