.. index:: DISTRO

******
Distro
******

The CoreOS layer provide the following :term:`DISTRO`:

.. _ref-distro-belden-coreos:
.. index:: belden-coreos.conf

``belden-coreos.conf``
==================================

This distro is the base distribution of the CoreOS project.

This distro is automatically selected in the default ``build/conf/local.conf``
created by the ``oe-init-build-env`` script. It is set in this file as follow::

    DISTRO ?= "belden-coreos"

This distribution is similar to Poky, the reference distribution of the Yocto
Project. But with some change:


:term:`SANITY_TESTED_DISTROS` is set to Debian 11, as it's the only host 
operating system supported.

The init system was changed to `SystemD` by setting `INIT_MANAGER` to
`systemd`.

Theses default :external:ref:`DISTRO_FEATURES <ref-features-distro>` are enabled:: 

    bluetooth usbhost pci ipv4 ipv6 wifi multiarch usrmerge ptest

.. note::

    Distribution based on CoreOS must extend the CoreOS distro by having the
    following line at the beginning of the distro configuration file::

        require conf/distro/belden-coreos.conf

    Example for ``conf/distro/custom-distro.conf``::

        require conf/distro/belden-coreos.conf
        DISTRO = "custom-distro"
        DISTRO_NAME = "CustomDistro OS (Based on Belden CoreOS)"
        MAINTAINER = "CustomDistro OS Team"

    .. warning::

        The ``belden-coreos`` distro define a sane set of default policies.
        Distribution based on CoreOS can only be supported by the CoreOS team if
        theses default policies and choices are not changed.