docs/customize-rootfs.txt

   1 // -*- mode:doc; -*-
   2 // vim: set syntax=asciidoc:
   3
   4 [[rootfs-custom]]
   5 Customizing the generated target filesystem
   6 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   7
   8 Besides changing one or another configuration through +make menuconfig+,
   9 there is a way to customize the resulting target filesystem.
  10
  11 Create a new directory called +extra+ in the top OpenADK directory.
  12 Put there a tree of directories and files that will be copied directly
  13 over the target filesystem (+root_*+) after everything is build, but
  14 before the firmware images or archives are created.
  15
  16 You can also point to another directory via:
  17 ---------------
  18  $ make extra=/foo/bar
  19 ---------------
  20
  21 You can start with the example configuration files from +root_*+.
  22 The +extra+ directory will never be deleted by any clean target to avoid
  23 loss of customized configuration data.
  24
  25 Another option is to configure a post-build action. This is available
  26 in +Global settings+. It must point to a script relative to the root
  27 of your openadk working copy. It will be invoked as part of the
  28 +-imageinstall+ step with $ADK_TOPDIR as first argument. You can use
  29 it e.g. to modify the +root_*+ filesystem before bundling it.