Skip to contentSkip to conversation

ref-manual: add Gentoo package list for build host setup

PATCH In review Aurelien DESBRIERES 2 participants 4 messages Apr 2 – Apr 3

lore
Share & tools
lore
#0 lore raw

cover ref-manual: add Gentoo package list for build host setup

The documentation currently has no Gentoo section under 'Required Packages for the Build Host'. Third-party guides commonly reference incorrect Gentoo package atoms (dev-util/chrpath, app-text/chrpath, dev-util/cpio) which do not exist in the Portage tree, causing confusion for Gentoo users trying to set up a Yocto build host.

This patch adds a Gentoo-specific section with verified package atoms and notes on the common naming mistakes, along with a reminder about Python version compatibility for Scarthgap/Nanbield.

Verified on Gentoo Linux (OpenRC, amd64) against the Portage tree as of April 2026.

Aurelien DESBRIERES (1):
ref-manual: system-requirements: add Gentoo package list

 .../ref-manual/system-requirements.rst        | 42 +++++++++++++++++++
 1 file changed, 42 insertions(+)
Signature · 1 line
2.52.0
#1 lore raw

PATCH 1/1 ref-manual: system-requirements: add Gentoo package list

The documentation lacked a Gentoo section under 'Required Packages for the Build Host'. Several third-party guides reference incorrect Gentoo package atoms (e.g. dev-util/chrpath, app-text/chrpath, dev-util/cpio) which do not exist in the Gentoo Portage tree.

Add a Gentoo-specific section with verified package atoms:

- app-admin/chrpath  (not dev-util/chrpath)
- app-arch/cpio      (not dev-util/cpio)
- dev-build/cmake    (not dev-util/cmake)

Also note Python version compatibility: python:3.11 or python:3.12 should be preferred over 3.13 for Scarthgap/Nanbield compatibility.

Gentoo is noted as unsupported but the information helps users on this distribution avoid common pitfalls.

---
 .../ref-manual/system-requirements.rst        | 42 +++++++++++++++++++
 1 file changed, 42 insertions(+)
documentation/ref-manual/system-requirements.rst +42 -0
index b427e2c64..4bacc7b2a 100644
@@ -361,6 +361,48 @@ previous step):
 
    $ export PATH="${PATH}:${textooldir}/tl/bin/x86_64-linux"
 
+Gentoo Packages
+~~~~~~~~~~~~~~~
+
+Here are the packages needed to build an image on a headless system
+with a supported Gentoo Linux distribution:
+
+.. code-block:: shell
+
+   emerge -av \
+     dev-vcs/git \
+     dev-lang/python:3.11 \
+     dev-python/pip \
+     dev-util/diffstat \
+     app-admin/chrpath \
+     sys-apps/texinfo \
+     dev-libs/glib \
+     sys-apps/file \
+     app-arch/xz-utils \
+     sys-libs/zlib \
+     dev-build/cmake \
+     dev-lang/perl \
+     app-misc/screen \
+     app-shells/bash \
+     sys-process/lsof \
+     app-arch/cpio \
+     app-arch/tar \
+     sys-apps/util-linux \
+     sys-apps/gawk \
+     dev-vcs/git \
+     net-misc/socat \
+     sys-apps/lsof
+
+.. note::
+
+   Gentoo is not an officially supported distribution. Package names
+   were verified against the Gentoo Portage tree. Note that
+   ``chrpath`` is found under ``app-admin/chrpath`` (not
+   ``dev-util/chrpath``), and ``cpio`` under ``app-arch/cpio`` (not
+   ``dev-util/cpio``). For Python version compatibility with Yocto
+   releases, prefer ``dev-lang/python:3.11`` or ``dev-lang/python:3.12``
+   over 3.13.
+
 .. _system-requirements-buildtools:
 
 Required Git, tar, Python, make and gcc Versions
Signature · 1 line
2.52.0
#2 lore raw
In reply to Aurelien DESBRIERES

Hi,

Quoted 6 lines · aurelien

The documentation currently has no Gentoo section under 'Required Packages for the Build Host'. Third-party guides commonly reference incorrect Gentoo package atoms (dev-util/chrpath, app-text/chrpath, dev-util/cpio) which do not exist in the Portage tree, causing confusion for Gentoo users trying to set up a Yocto build host.

Quoted 6 lines

This patch adds a Gentoo-specific section with verified package atoms and notes on the common naming mistakes, along with a reminder about Python version compatibility for Scarthgap/Nanbield.

Verified on Gentoo Linux (OpenRC, amd64) against the Portage tree as of April 2026.

The reason we don't list some popular distributions here is because they are not tested on our test infrastructure (our so called Autobuilder [1]). For that reason, listing untested distributions here would come at risk of breakage for people without us being able to support and properly test things on our side.

Also, adding new distributions here comes at a cost, as we need to maintain the package list over time for these distributions as well.

I suggest you propose this change to the Wiki instead [2]?

[1]: https://autobuilder.yoctoproject.org/valkyrie/
[2]: https://wiki.yoctoproject.org/wiki/Main_Page

Thanks,
Antonin

#3 lore raw

Hi Antonin,

Perfect, I will.

Thanks,

Aurelien

Le ven. 3 avr. 2026 à 10:06, Antonin Godard <[email protected]> a écrit :

Quoted 36 lines

Hi,

Quoted 6 lines · aurelien

The documentation currently has no Gentoo section under 'Required Packages for the Build Host'. Third-party guides commonly reference incorrect Gentoo package atoms (dev-util/chrpath, app-text/chrpath, dev-util/cpio) which do not exist in the Portage tree, causing confusion for Gentoo users trying to set up a Yocto build host.

Quoted 6 lines

This patch adds a Gentoo-specific section with verified package atoms and notes on the common naming mistakes, along with a reminder about Python version compatibility for Scarthgap/Nanbield.

Verified on Gentoo Linux (OpenRC, amd64) against the Portage tree as of April 2026.

The reason we don't list some popular distributions here is because they are not
tested on our test infrastructure (our so called Autobuilder [1]). For that reason, listing untested distributions here would come at risk of breakage for
people without us being able to support and properly test things on our side.

Also, adding new distributions here comes at a cost, as we need to maintain the
package list over time for these distributions as well.

I suggest you propose this change to the Wiki instead [2]?

[1]: https://autobuilder.yoctoproject.org/valkyrie/
[2]: https://wiki.yoctoproject.org/wiki/Main_Page

Thanks,
Antonin