fa3c5e3056
In the common case of not specifying a size, we are already running "du" over the image to figure out how big it is. Leverage that by saving it's output and displaying a pruned list of big files when requested. We add a flag to show a summarised option (files >10MiB) and another to show full output, should you wish that level of detail. "Invocation" documentation is updated (and formatted a little better while we're here). Change-Id: I255800790a62fed1c82fcd311f1cc29c9867766d
29 lines
1.3 KiB
ReStructuredText
29 lines
1.3 KiB
ReStructuredText
Invocation
|
|
==========
|
|
|
|
The scripts can generally just be run. Options can be set on the
|
|
command line or by exporting variables to override those present in
|
|
lib/img-defaults. -h to get help.
|
|
|
|
The image building scripts expect to be able to invoke commands with
|
|
sudo, so if you want them to run non-interactively, you should either
|
|
run them as root, with sudo -E, or allow your build user to run any
|
|
sudo command without password.
|
|
|
|
Using the variable ``ELEMENTS_PATH`` will allow to specify multiple
|
|
elements locations. It is a colon (:) separated path list, and it
|
|
will work in a first path/element found, first served approach. The
|
|
included elements tree is used when no path is supplied, and is added
|
|
to the end of the path if a path is supplied.
|
|
|
|
By default, the image building scripts will not overwrite existing
|
|
disk images, allowing you to compare the newly built image with the
|
|
existing one. To change that behaviour, set the variable
|
|
``OVERWRITE_OLD_IMAGE`` to any value that isn't ``0``.
|
|
|
|
Setting the variable ``DIB_SHOW_IMAGE_USAGE`` will print out a
|
|
summarised disk-usage report for the final image of files and
|
|
directories over 10MiB in size. Setting ``DIB_SHOW_IMAGE_USAGE_FULL``
|
|
will show all files and directories. These settings can be useful
|
|
additions to the logs in automated build situations where debugging
|
|
image-growth may be important.
|