From: Yann E. MORIN Date: Sun, 3 Jul 2016 19:01:58 +0000 (+0200) Subject: docs/manual: document BR2_ROOTFS_POST_FAKEROOT_SCRIPT X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=14463d9319731b13aa0a7dc25207fb545eb23ee4;p=buildroot.git docs/manual: document BR2_ROOTFS_POST_FAKEROOT_SCRIPT Signed-off-by: "Yann E. MORIN" Cc: Peter Korsgaard Signed-off-by: Peter Korsgaard --- diff --git a/docs/manual/customize-rootfs.txt b/docs/manual/customize-rootfs.txt index 558bd724dd..44fc460670 100644 --- a/docs/manual/customize-rootfs.txt +++ b/docs/manual/customize-rootfs.txt @@ -61,7 +61,7 @@ In addition, you may also use these environment variables: stored - +BASE_DIR+: the base output directory -Below two more methods of customizing the target filesystem are +Below three more methods of customizing the target filesystem are described, but they are not recommended. Direct modification of the target filesystem:: @@ -104,4 +104,35 @@ This method is not recommended because it duplicates the entire skeleton, which prevents taking advantage of the fixes or improvements brought to the default skeleton in later Buildroot releases. +Post-fakeroot scripts (+BR2_ROOTFS_POST_FAKEROOT_SCRIPT+):: ++ +When aggregating the final images, some parts of the process requires + root rights: creating device nodes in `/dev`, setting permissions or + ownership to files and directories... To avoid requiring actual root + rights, Buildroot uses +fakeroot+ to simulate root rights. This is not + a complete substitute for actually being root, but is enough for what + Buildroot needs. ++ +Post-fakeroot scripts are shell scripts that are called at the 'end' of + the fakeroot phase, 'right before' the filesystem image generator is + called. As such, they are called in the fakeroot context. ++ +Post-fakeroot scripts can be useful in case you need to tweak the + filesystem to do modifications that are usually only available to the + root user. ++ +.Note: +It is recommended to use the existing mechanisms to set file permissions + or create entries in `/dev` (see xref:customize-device-permission[]) or + to create users (see xref:customize-users[]) ++ +.Note: +The difference between post-build scripts (above) and fakeroot scripts, + is that post-build scripts are not called in the fakeroot context. ++ +.Note; +Using `fakeroot` is not an absolute substitute for actually being root. + `fakeroot` only ever fakes the file access rights and types (regular, + block-or-char device...) and uid/gid; these are emulated in-memory. + include::customize-device-permission-tables.txt[]