diff options
| author | Yann E. MORIN <yann.morin.1998@free.fr> | 2013-07-10 00:00:31 +0200 |
|---|---|---|
| committer | Peter Korsgaard <jacmet@sunsite.dk> | 2013-07-10 08:52:21 +0200 |
| commit | f1f97b3a0587df7a44249ccf3e47c6d0d3087fa0 (patch) | |
| tree | b41c703a1d62d56111d11704e4a836e4e958a960 /docs | |
| parent | 575dac6922e9a20153a4f3526929618271b226c8 (diff) | |
system: add option to pass extra args to post-build and post-image scripts
It can be useful to have different configuration use the same post-build
and/or post-image scripts as they share a common infrastructure, but yet
have minor differentiation.
This option allows passing zero or more additional arguments to each
post-build or post-image script.
The same set of extra arguments are passed to all scripts, it is not
possible to pass different arguments to each script.
[Peter: fix help text, post-image gets called with the images dir]
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr>
Cc: Baruch Siach <baruch@tkos.co.il>
Signed-off-by: Peter Korsgaard <jacmet@sunsite.dk>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/manual/customize-rootfs.txt | 19 |
1 files changed, 12 insertions, 7 deletions
diff --git a/docs/manual/customize-rootfs.txt b/docs/manual/customize-rootfs.txt index 7ff8d8b1e..49a6b4b44 100644 --- a/docs/manual/customize-rootfs.txt +++ b/docs/manual/customize-rootfs.txt @@ -69,15 +69,20 @@ specify a space-separated list of scripts in the found in the +System configuration+ menu as well. Each of those scripts will be called with the path to the +images+ -output directory as first and unique argument, and will be executed -with the main Buildroot source directory as the current -directory. Those scripts will be executed as the user that executes -Buildroot, which should normally not be the root user. Therefore, any -action requiring root permissions in one of these _post-image scripts_ -will require special handling (usage of fakeroot or sudo), which is -left to the script developer. +output directory as first argument, and will be executed with the main +Buildroot source directory as the current directory. Those scripts will +be executed as the user that executes Buildroot, which should normally +not be the root user. Therefore, any action requiring root permissions +in one of these _post-image scripts_ will require special handling +(usage of fakeroot or sudo), which is left to the script developer. Just like for the _post-build scripts_ mentioned above, you also have access to the following environment variables from your _post-image scripts_: +BUILDROOT_CONFIG+, +HOST_DIR+, +STAGING_DIR+, +TARGET_DIR+, +BINARIES_DIR+ and +BASE_DIR+. + +Additionally, each of the +BR2_ROOTFS_POST_BUILD_SCRIPT+ and ++BR2_ROOTFS_POST_IMAGE_SCRIPT+ scripts will be passed the arguments +specified in +BR2_ROOTFS_POST_SCRIPT_ARGS+ (if that is not empty). +All the scripts will be passed the exact same set of arguments, it +is not possible to pass different sets of arguments to each script. |