From 6b53649bfadbdc42cfa659965056105af987e6e3 Mon Sep 17 00:00:00 2001 From: "Yann E. MORIN" Date: Fri, 7 Nov 2025 22:40:09 +0100 Subject: [PATCH] docs/manual: add merged-bin details to customize rootfs 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 Signed-off-by: Yann E. MORIN Signed-off-by: Julien Olivain --- 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///rootfs-overlay+.