# `meta-qcom-distro` This layer provides a reference distribution configuration for Qualcomm Linux. This layer defines the image recipes and package groups. ## Distribution configuration The following table provides an introduction to the distribution configurations, which are available on [GitHub](https://github.com/qualcomm-linux/meta-qcom-distro/tree/master/conf/distro). | Distribution configuration | Description | | --- | --- | | `conf/distro/qcom-distro.conf` | This distribution configuration file defines the `qcom-distro` distribution.
You can use the `qcom-distro` distribution in the following example command:



>
>
> kas shell meta-qcom/ci/rb3gen2-core-kit.yml:meta-qcom/ci/qcom-distro.yml:meta-qcom/ci/linux-qcom-6.18.yml
> bitbake qcom-multimedia-image
> Copy to clipboard



The `meta-qcom-distro/conf/distro/include/qcom-base.inc` configuration
defines common DISTRO\_FEATURES. The `meta-qcom-distro/conf/distro/qcom-distro.conf` configuration
adds the following features:



>
>
>



The Yocto Project documentation defines these distribution features at
[Distribution features](https://docs.yoctoproject.org/singleindex.html#distro-features). | | `conf/distro/qcom-distro-catchall.conf` | This distribution configuration file defines Qualcomm reference distribution with Wayland
with SELinux-enabled and OStree. It adds `selinux` and `sota` to `DISTRO_FEATURES`. | | `conf/distro/qcom-distro-kvm.conf` | This distribution configuration file defines Qualcomm reference distribution with Wayland and KVM.
It adds `kvm` to `DISTRO_FEATURES` and configures the `qcomflash` directory so that
the `xbl_config_kvm.elf` file is flashed to the `xbl_config` partition on the storage when flashing using QDL or PCAT.


Note


`qcom-distro-kvm` is currently supported only on QCS8300 (iq-8275-evk) and QCS9100 (iq-9075-evk) platforms. | | `conf/distro/qcom-distro-selinux.conf` | This distribution configuration file defines Qualcomm reference distribution with Wayland
with SELinux-enabled. It adds `selinux` to `DISTRO_FEATURES`. | | `conf/distro/qcom-distro-sota.conf` | This distribution configuration file defines Qualcomm reference distribution with Wayland
where OTA is also enabled. It adds `sota` to `DISTRO_FEATURES`, which is done by inheriting `conf/distro/sota.conf.inc` file available in `meta-updater`. | | `conf/distro/include/qcom-base.inc` | INIT\_MANAGER is set to `systemd`.
For Yocto Project documentation on INIT\_MANAGER,
see [INIT_MANAGER](https://docs.yoctoproject.org/singleindex.html#term-INIT_MANAGER).
Other DISTRO\_FEATURES enabled are:


DISTRO_FEATURES:append = " \
efi \
glvnd \
minidebuginfo \
opencl \
overlayfs \
pam \
pni-names \
security \
tpm2 \
virtualization \
wifi \
x11 \
"
Copy to clipboard


To understand the purpose of these DISTRO\_FEATURES, see
[Distribution features](https://docs.yoctoproject.org/singleindex.html#distro-features).


This file selects `systemd` as INIT\_MANAGER. | ## Package groups Package groups are defined in `meta-qcom` and `meta-qcom-distro`. The following table provides an introduction to the package groups: | Package group | Description | | --- | --- | | `packagegroup-qcom-benchmark.bb` | Package group to bring in benchmarking packages. | | `packagegroup-qcom-security.bb` | Package group to bring in packages required for security. | | `packagegroup-qcom-test-pkgs.bb` | Package group to bring in packages required to test images. | | `packagegroup-qcom-utilities.bb` | Userspace utilities for Qualcomm platforms. | | `packagegroup-qcom-virtualization.bb` | Package group to bring in packages required for virtualization. | ## Image recipes The `meta-qcom-distro` Qualcomm Linux metadata layer defines image recipes, which are available on [GitHub](https://github.com/qualcomm-linux/meta-qcom-distro/tree/master/recipes-products/images). The following table lists various images, their `IMAGE_FEATURES`, and the functions that the images serve: | Image recipe | Description of the image | | --- | --- | | `qcom-minimal-image.bb` | Defines a small `rootfs` to boot to the shell.


The `IMAGE_FEATURES` enabled are as follows:


IMAGE_FEATURES += "splash tools-debug allow-root-login post-install-logging enable-adbd"
Copy to clipboard


For more information about `IMAGE_FEATURES`, see
[Image features](https://docs.yoctoproject.org/master/singleindex.html#image-features). | | `qcom-console-image.bb` | Extends `qcom-minimal-image` by adding more packages
and enabling more `IMAGE_FEATURES`:


IMAGE_FEATURES += "${@bb.utils.contains('DISTRO_FEATURES', 'sota', '', 'package-management', d)} \
ssh-server-openssh"
Copy to clipboard | | `qcom-multimedia-image.bb` | Requires `DISTRO_FEATURE` wayland and it includes
all the multimedia packages in `rootfs`. | | `qcom-multimedia-proprietary-image.bb` | An image built on top of multimedia image for proprietary features.
This image is compatible only with aarch64 (ARMv8). | | `qcom-container-orchestration-image.bb` | An image built on top of the multimedia proprietary image with Kubernetes and container runtime packages. | ## QDL flashing tool QDL is a flashing tool that communicates with the USB devices to upload flash loader to the device. The flash loader flashes the images to universal flash storage (UFS) or embedded multimedia card (eMMC) built into the device. For more information about `QDL flashing`, see [QDL](https://docs.qualcomm.com/bundle/publicresource/topics/80-80022-254/flash_images.html). Last Published: May 10, 2026 [Previous Topic meta-qcom](https://docs.qualcomm.com/bundle/publicresource/80-80022-27/topics/meta_qcom.md) [Next Topic meta-qcom-extras](https://docs.qualcomm.com/bundle/publicresource/80-80022-27/topics/meta_qcom_extras.md)