[Buildroot] [PATCH] docs/manual: add merged-bin details to customize rootfs

[Buildroot] [PATCH] docs/manual: add merged-bin details to customize rootfs

[Yann E. MORIN via buildroot]

As was done in dc7c6487cff0 (Makefile: check rootfs overlays with
BR2_ROOTFS_MERGED_USR enabled) to document how overlays should be
set up for the merged-usr case, and following 428ac6fcc4c2 (system:
add support for merged /usr/sbin (aka merged-bin), extend the
documentation to explain how rootfs overlays should be set up for
the merged-bin case.

Reported-by: Romain Naour <romain.naour@gmail.com>
Signed-off-by: Yann E. MORIN <yann.morin.1998@free.fr>
---
 docs/manual/customize-rootfs.adoc | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/manual/customize-rootfs.adoc b/docs/manual/customize-rootfs.adoc
index d334093748..5d8bcba778 100644
--- a/docs/manual/customize-rootfs.adoc
+++ b/docs/manual/customize-rootfs.adoc
@@ -28,6 +28,11 @@ When +BR2_ROOTFS_MERGED_USR+ is enabled, then the overlay must not
   such a situation, should the overlay have any programs or libraries,
   they should be placed in '/usr/bin', '/usr/sbin' and '/usr/lib'.
 +
+Additionally, when +BR2_ROOTFS_MERGED_BIN+ is enabled, then the overlay
+  must not contain the '/usr/sbin' directory, as Buildroot will create
+  it as a symbolic link to '/usr/bin'. In such a situation, should the
+  overlay have any program, they should be placed in '/usr/bin'.
++
 As shown in xref:customize-dir-structure[], the recommended path for
   this overlay is +board/<company>/<boardname>/rootfs-overlay+.
 
-- 
2.51.1

_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot

Re: [Buildroot] [PATCH] docs/manual: add merged-bin details to customize rootfs

[Julien Olivain via buildroot]

On 07/11/2025 22:40, Yann E. MORIN via buildroot wrote:
> As was done in dc7c6487cff0 (Makefile: check rootfs overlays with
> BR2_ROOTFS_MERGED_USR enabled) to document how overlays should be
> set up for the merged-usr case, and following 428ac6fcc4c2 (system:
> add support for merged /usr/sbin (aka merged-bin), extend the
> documentation to explain how rootfs overlays should be set up for
> the merged-bin case.
> 
> Reported-by: Romain Naour <romain.naour@gmail.com>
> Signed-off-by: Yann E. MORIN <yann.morin.1998@free.fr>

Applied to master, thanks.
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot

Re: [Buildroot] [PATCH] docs/manual: add merged-bin details to customize rootfs

[Peter Korsgaard]

>>>>> "Yann" == Yann E MORIN via buildroot <buildroot@buildroot.org> writes:

 > As was done in dc7c6487cff0 (Makefile: check rootfs overlays with
 > BR2_ROOTFS_MERGED_USR enabled) to document how overlays should be
 > set up for the merged-usr case, and following 428ac6fcc4c2 (system:
 > add support for merged /usr/sbin (aka merged-bin), extend the
 > documentation to explain how rootfs overlays should be set up for
 > the merged-bin case.

 > Reported-by: Romain Naour <romain.naour@gmail.com>
 > Signed-off-by: Yann E. MORIN <yann.morin.1998@free.fr>
 > ---
 >  docs/manual/customize-rootfs.adoc | 5 +++++
 >  1 file changed, 5 insertions(+)

 > diff --git a/docs/manual/customize-rootfs.adoc b/docs/manual/customize-rootfs.adoc
 > index d334093748..5d8bcba778 100644
 > --- a/docs/manual/customize-rootfs.adoc
 > +++ b/docs/manual/customize-rootfs.adoc
 > @@ -28,6 +28,11 @@ When +BR2_ROOTFS_MERGED_USR+ is enabled, then the overlay must not
 >    such a situation, should the overlay have any programs or libraries,
 >    they should be placed in '/usr/bin', '/usr/sbin' and '/usr/lib'.
 >  +
 > +Additionally, when +BR2_ROOTFS_MERGED_BIN+ is enabled, then the overlay
 > +  must not contain the '/usr/sbin' directory, as Buildroot will create
 > +  it as a symbolic link to '/usr/bin'. In such a situation, should the
 > +  overlay have any program, they should be placed in '/usr/bin'.

s/program/programs/. I will send a patch.

-- 
Bye, Peter Korsgaard
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot