diff options
author | Thomas Petazzoni <thomas.petazzoni@free-electrons.com> | 2011-10-10 10:46:39 +0200 |
---|---|---|
committer | Peter Korsgaard <jacmet@sunsite.dk> | 2011-10-25 09:46:01 +0200 |
commit | 41c1cb44cd60819f8ba20024e23e431c00b279d7 (patch) | |
tree | 8ec316f1602e4e9a8fff272aeeb1a2a36eb5fdd1 /docs/manual/customize-rootfs.txt | |
parent | e55af699b5cb3d9286e19e19c8aaeb14bcdf0a38 (diff) | |
download | buildroot-novena-41c1cb44cd60819f8ba20024e23e431c00b279d7.tar.gz buildroot-novena-41c1cb44cd60819f8ba20024e23e431c00b279d7.zip |
manual: convert existing documentation to the asciidoc format
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
Acked-by: Luca Ceresoli <luca@lucaceresoli.net>
Acked-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Reviewed-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
Signed-off-by: Peter Korsgaard <jacmet@sunsite.dk>
Diffstat (limited to 'docs/manual/customize-rootfs.txt')
-rw-r--r-- | docs/manual/customize-rootfs.txt | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/docs/manual/customize-rootfs.txt b/docs/manual/customize-rootfs.txt new file mode 100644 index 000000000..8c3ea82ad --- /dev/null +++ b/docs/manual/customize-rootfs.txt @@ -0,0 +1,36 @@ +Customizing the generated target filesystem +------------------------------------------- + +There are a few ways to customize the resulting target filesystem: + +* Customize the target filesystem directly and rebuild the image. The + target filesystem is available under +output/target/+. You can + simply make your changes here and run make afterwards - this will + rebuild the target filesystem image. This method allows you to do + anything to the target filesystem, but if you decide to completely + rebuild your toolchain and tools, these changes will be lost. + +* Create your own 'target skeleton'. You can start with the default + skeleton available under +fs/skeleton+ and then customize it to suit + your needs. The +BR2_ROOTFS_SKELETON_CUSTOM+ and + +BR2_ROOTFS_SKELETON_CUSTOM_PATH+ will allow you to specify the + location of your custom skeleton. At build time, the contents of the + skeleton are copied to output/target before any package + installation. + +* In the Buildroot configuration, you can specify the path to a + post-build script, that gets called 'after' Buildroot builds all the + selected software, but 'before' the rootfs packages are + assembled. The destination root filesystem folder is given as the + first argument to this script, and this script can then be used to + copy programs, static data or any other needed file to your target + filesystem. You should, 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. + +* 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 + target root filesystem in +package/customize/source+, and then + enable this special package in the configuration system. + |