mirror/buildroot
1
0
Fork 0
mirror of https://gitlab.com/buildroot.org/buildroot.git synced 2026-08-08 00:20:38 -09:00
Code Issues Packages Projects Releases Wiki Activity

docs/manual: add merged-bin details to customize rootfs

Browse Source 
As was done in dc7c6487cf (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 428ac6fcc4 (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>
Signed-off-by: Julien Olivain <ju.o@free.fr>
This commit is contained in:
Yann E. MORIN
2025-11-07 22:40:09 +01:00
committed by Julien Olivain
parent 34a03bdba4
commit 6b53649bfa
1 changed files with 5 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
docs/manual/customize-rootfs.adoc
View File

@@ -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, such a situation, should the overlay have any programs or libraries,
they should be placed in '/usr/bin', '/usr/sbin' and '/usr/lib'. 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 As shown in xref:customize-dir-structure[], the recommended path for
this overlay is +board/<company>/<boardname>/rootfs-overlay+. this overlay is +board/<company>/<boardname>/rootfs-overlay+.