summaryrefslogtreecommitdiffstats
path: root/tools/binman/README
diff options
context:
space:
mode:
authorSimon Glass <sjg@chromium.org>2019-07-20 12:24:15 -0600
committerSimon Glass <sjg@chromium.org>2019-07-29 09:38:06 -0600
commita6cb995096c40ecd6597e20d792851ac7f80004e (patch)
tree53c627ff17381b4eceeb0156e226c4602ed07b2c /tools/binman/README
parentbb5edc1d3c0ebc989dfaa7d1e57cdde15d61f2e0 (diff)
downloadu-boot-a6cb995096c40ecd6597e20d792851ac7f80004e.tar.gz
u-boot-a6cb995096c40ecd6597e20d792851ac7f80004e.tar.xz
u-boot-a6cb995096c40ecd6597e20d792851ac7f80004e.zip
binman: Add command-line support for replacing entries
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 <sjg@chromium.org>
Diffstat (limited to 'tools/binman/README')
-rw-r--r--tools/binman/README22
1 files changed, 18 insertions, 4 deletions
diff --git a/tools/binman/README b/tools/binman/README
index 5e8f9fd480..b4f6392ab7 100644
--- a/tools/binman/README
+++ b/tools/binman/README
@@ -589,9 +589,24 @@ that there is an 'fdtmap' entry in the image. For example:
$ binman replace -i image.bin section/cbfs/u-boot
which will write the contents of the file 'u-boot' from the current directory
-to the that entry. If the entry size changes, you must add the 'allow-repack'
-property to the original image before generating it (see above), otherwise you
-will get an error.
+to the that entry, compressing if necessary. If the entry size changes, you must
+add the 'allow-repack' property to the original image before generating it (see
+above), otherwise you will get an error.
+
+You can also use a particular file, in this case u-boot.bin:
+
+ $ binman replace -i image.bin section/cbfs/u-boot -f u-boot.bin
+
+It is possible to replace all files from a source directory which uses the same
+hierarchy as the entries:
+
+ $ binman replace -i image.bin -I indir
+
+Files that are missing will generate a warning.
+
+You can also replace just a selection of entries:
+
+ $ binman replace -i image.bin "*u-boot*" -I indir
Logging
@@ -959,7 +974,6 @@ Some ideas:
- Allow easy building of images by specifying just the board name
- Support building an image for a board (-b) more completely, with a
configurable build directory
-- Support updating binaries in an image (with repacking)
- Support adding FITs to an image
- Support for ARM Trusted Firmware (ATF)
- Detect invalid properties in nodes