meta-virtualization
===================

The meta-virtualization layer is the authoritative resource for virtualization
technologies in OpenEmbedded / Yocto built distributions.  It provides support
or both hypervisor-based virtualization (such as KVM, Xen, and QEMU) and
system-level virtualization (Linux containers), along with the host and guest
technologies required to build complete solutions ranging from embedded systems
to full deep CNCF stack deployments.

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"

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
 - k8s: enables kubernetes configurations in the kernel, tools and configuration
 - 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)
 - seccomp: enable seccomp support for packages that have the capability.
 - vcontainer: enables vdkr/vpdmn virtual container runtime support, including
   kernel config fragments (9p, squashfs, overlayfs) and busybox utilities
   (base64, hexdump) required for container cross-install during image builds.

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

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

Required for Ceph:
URI: git://git.yoctoproject.org/meta-cloud-services
branch: master
revision: HEAD
prio: default

Required for cri-o:
URI: git://git.yoctoproject.org/meta-selinux
branch: master
revision: HEAD
prio: default

Community / Collaboration
------------------------

Repository: https://git.yoctoproject.org/cgit/cgit.cgi/meta-virtualization/
Mailing list: https://lists.yoctoproject.org/g/meta-virtualization
IRC: libera.chat #meta-virt channel

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

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

Maintainer: Bruce Ashfield <bruce.ashfield@gmail.com>
see MAINTAINERS for more specific information

When sending single patches, please using something like:
$ git send-email -1 -M --to meta-virtualization@lists.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.

