u-boot.git/tools/binman/README, branch v2019.10

binman: Add command-line support for replacing entries

2019-07-29T15:38:06Z

Add a 'replace' command to binman to permit entries to be replaced, either individually or all at once (using a filter). Signed-off-by: Simon Glass

binman: Add a few more features to the wishlist

2019-07-29T15:38:06Z

Add mention of a few other desirable features that may be implemented in the future. Signed-off-by: Simon Glass

binman: Allow updating entries that change size

2019-07-29T15:38:06Z

So far we don't allow entries to change size when repacking. But this is not very useful since it is common for entries to change size after an updated binary is built, etc. Add support for this, respecting the original offset/size/alignment constraints of the image layout. For this to work the original image must have been created with the 'allow-repack' property. This does not support entry types with sub-entries such as files and CBFS, but it does support sections. Signed-off-by: Simon Glass

binman: Update documentation for image creation

2019-07-29T15:38:06Z

There are a few more steps in the process now. Update the documentation to reflect this. Signed-off-by: Simon Glass

binman: Add info to allow safely repacking an image later

2019-07-29T15:38:06Z

At present it is not possible to discover the contraints to repacking an image (e.g. maximum section size) since this information is not preserved from the original image description. Add new 'orig-offset' and 'orig-size' properties to hold this. Add them to the main device tree in the image. Signed-off-by: Simon Glass

binman: Support updating entries in an existing image

2019-07-29T15:38:06Z

While it is useful and efficient to build images in a single pass from a unified description, it is sometimes desirable to update the image later. Add support for replace an existing file with one of the same size. This avoids needing to repack the file. Support for more advanced updates will come in future patches. Signed-off-by: Simon Glass

binman: Add an 'extract' command

2019-07-24T19:54:08Z

It is useful to be able to extract all binaries from the image, or a subset of them. Add a new 'extract' command to handle this. Signed-off-by: Simon Glass

binman: Allow for logging information to be displayed

2019-07-24T19:54:08Z

Binman generally operates silently but in some cases it is useful to see what Binman is actually doing at each step. Enable some logging output with different logging levels selectable via the -v flag. Signed-off-by: Simon Glass

binman: Support listing an image

2019-07-24T19:54:08Z

Add support for listing the entries in an image. This relies on the image having an FDT map. Signed-off-by: Simon Glass

binman: Allow entries to expand after packing

2019-07-24T19:54:08Z

Add support for detecting entries that change size after they have already been packed, and re-running packing when it happens. This removes the limitation that entry size cannot change after PackEntries() is called. Signed-off-by: Simon Glass