ref-manual: add Gentoo package list for build host setup
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
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
@@ -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
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
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_PageThanks,
Antonin