[PATCH 0/1] ref-manual: add Gentoo package list for build host setup

[PATCH 0/1] ref-manual: add Gentoo package list for build host setup

[Aurelien DESBRIERES]

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(+)

-- 
2.52.0

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

[Aurelien DESBRIERES]

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.

Signed-off-by: Aurelien DESBRIERES <aurelien@hackers.camp>
---
 .../ref-manual/system-requirements.rst        | 42 +++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst
index b427e2c64..4bacc7b2a 100644
--- a/documentation/ref-manual/system-requirements.rst
+++ b/documentation/ref-manual/system-requirements.rst
@@ -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
-- 
2.52.0

Re: [docs] [PATCH 0/1] ref-manual: add Gentoo package list for build host setup

[Antonin Godard]

Hi,

On Thu Apr 2, 2026 at 4:42 PM CEST, aurelien wrote:
> 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.

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

Re: [docs] [PATCH 0/1] ref-manual: add Gentoo package list for build host setup

[Aurelien DESBRIERES]

[-- Attachment #1: Type: text/plain, Size: 1567 bytes --]

Hi Antonin,

Perfect, I will.

Thanks,

Aurelien

Le ven. 3 avr. 2026 à 10:06, Antonin Godard <antonin.godard@bootlin.com> a
écrit :

> Hi,
>
> On Thu Apr 2, 2026 at 4:42 PM CEST, aurelien wrote:
> > 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.
>
> 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
>

[-- Attachment #2: Type: text/html, Size: 2237 bytes --]