manual: customize-rootfs.txt: refactoring, misc. fixes and update

Signed-off-by: Samuel Martin <s.martin49@gmail.com>
Signed-off-by: Peter Korsgaard <jacmet@sunsite.dk>
This commit is contained in:
Samuel Martin 2012-11-11 03:14:45 +00:00 committed by Peter Korsgaard
parent a90382616c
commit 483a1f8281

View File

@ -4,7 +4,8 @@
Customizing the generated target filesystem Customizing the generated target filesystem
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
There are a few ways to customize the resulting target filesystem: Besides changing one or another configuration through +make *config+,
there are a few ways to customize the resulting target filesystem:
* Customize the target filesystem directly and rebuild the image. The * Customize the target filesystem directly and rebuild the image. The
target filesystem is available under +output/target/+. You can target filesystem is available under +output/target/+. You can
@ -12,28 +13,33 @@ There are a few ways to customize the resulting target filesystem:
rebuild the target filesystem image. This method allows you to do rebuild the target filesystem image. This method allows you to do
anything to the target filesystem, but if you decide to completely anything to the target filesystem, but if you decide to completely
rebuild your toolchain and tools, these changes will be lost. rebuild your toolchain and tools, these changes will be lost.
_Changes are not resistent to the +make clean+ command_.
* Create your own 'target skeleton'. You can start with the default * Create your own 'target skeleton'. You can start with the default
skeleton available under +system/skeleton+ and then customize it to skeleton available under +system/skeleton+ and then customize it to
suit your needs. The +BR2_ROOTFS_SKELETON_CUSTOM+ and suit your needs. The +BR2_ROOTFS_SKELETON_CUSTOM+ and
+BR2_ROOTFS_SKELETON_CUSTOM_PATH+ will allow you to specify the +BR2_ROOTFS_SKELETON_CUSTOM_PATH+ will allow you to specify the
location of your custom skeleton. At build time, the contents of the location of your custom skeleton. These options can be found in the
+System configuration+ menu. At build time, the contents of the
skeleton are copied to output/target before any package skeleton are copied to output/target before any package
installation. installation.
* In the Buildroot configuration, you can specify the path to a * In the Buildroot configuration, you can specify the path to a
post-build script, that gets called 'after' Buildroot builds all the *post-build script*, that gets called 'after' Buildroot builds all the
selected software, but 'before' the rootfs packages are selected software, but 'before' the rootfs packages are
assembled. The destination root filesystem folder is given as the assembled. The +BR2_ROOTFS_POST_BUILD_SCRIPT+ will allow you to
first argument to this script, and this script can then be used to specify the location of your post-build script. This option can be
copy programs, static data or any other needed file to your target found in the +System configuration+ menu. The destination root
filesystem. You should, however, use this feature with care. filesystem folder *is given as the first argument to this script,
Whenever you find that a certain package generates wrong or unneeded and this script can then be used to copy programs, static data or
files, you should fix that package rather than work around it with a any other needed file to your target filesystem. You should,
post-build cleanup script. however, use this feature with care. Whenever you find that a
certain package generates wrong or unneeded files, you should fix
that package rather than work around it with a post-build cleanup
script. _Among these first 3 methods, this one should be prefere_d.
* A special package, 'customize', stored in +package/customize+ can be * A special package, 'customize', stored in +package/customize+ can be
used. You can put all the files that you want to see in the final used. You can put all the files that you want to see in the final
target root filesystem in +package/customize/source+, and then target root filesystem in +package/customize/source+, and then
enable this special package in the configuration system. enable this special package in the configuration system. _This
method is marked as deprecated_.