summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorHung-Te Lin <hungte@chromium.org>2019-09-28 10:23:28 +0800
committerPatrick Georgi <pgeorgi@google.com>2019-09-30 11:09:22 +0000
commit544bc2693a515b5fa72c767d637a9f99f998a572 (patch)
tree02d580e847c46884f3b6f7c8b67643d28702ebff
parente088721f715602df84503c960deb562064af5718 (diff)
util/chromeos: revise description for more utility scripts in future
The description.md and README.md was explicitly made for downloading or extracting some resources, but we need to add more Chrome OS related scripts soon; so the description should be revised. Also changed README.md for better markdown style, for example - Use #, ## to replace the old '-' headers - Use code format for file names - Use code block for example of shell execution Change-Id: Icc3677fa318b03f4aee1b0f5fb13b2095f2afe64 Signed-off-by: Hung-Te Lin <hungte@chromium.org> Reviewed-on: https://review.coreboot.org/c/coreboot/+/35664 Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Patrick Georgi <pgeorgi@google.com>
-rw-r--r--util/chromeos/README.md25
-rw-r--r--util/chromeos/description.md6
2 files changed, 16 insertions, 15 deletions
diff --git a/util/chromeos/README.md b/util/chromeos/README.md
index 3c3d721a3c..7a3897d8a0 100644
--- a/util/chromeos/README.md
+++ b/util/chromeos/README.md
@@ -1,27 +1,28 @@
-Chrome OS binary extraction
-===========================
+# Chrome OS Scripts
-These scripts can be used to extract System Agent reference code
-and other blobs (e.g. mrc.bin, refcode, VGA option roms) from a
-Chrome OS recovery image.
+These scripts can be used to access or generate Chrome OS resources, for example
+to extract System Agent reference code and other blobs (e.g. `mrc.bin`, refcode,
+VGA option roms) from a Chrome OS recovery image.
-crosfirmware.sh
----------------
+## crosfirmware.sh
-crosfirmware.sh downloads a Chrome OS recovery image from the recovery
+`crosfirmware.sh` downloads a Chrome OS recovery image from the recovery
image server, unpacks it, extracts the firmware update shell archive,
extracts the firmware images from the shell archive.
To download all Chrome OS firmware images, run
+```
$ ./crosfirmware.sh
+```
To download, e.g. the Panther firmware image, run
+```
$ ./crosfirmware.sh panther
+```
-extract_blobs.sh
-----------------
+## extract_blobs.sh
-extract_blobs.sh extracts the blobs from a Chrome OS firmware image.
+`extract_blobs.sh` extracts the blobs from a Chrome OS firmware image.
Right now it will produce the ME firmware blob, IFD, VGA option rom,
-and mrc.bin
+and `mrc.bin`.
diff --git a/util/chromeos/description.md b/util/chromeos/description.md
index d2da57770e..840e58927e 100644
--- a/util/chromeos/description.md
+++ b/util/chromeos/description.md
@@ -1,3 +1,3 @@
-These scripts can be used to extract System Agent reference code and
-other blobs (e.g. mrc.bin, refcode, VGA option roms) from a Chrome OS
-recovery image. `C`
+These scripts can be used to access Chrome OS resources, for example to extract
+System Agent reference code and other blobs (e.g. mrc.bin, refcode, VGA option
+roms) from a Chrome OS recovery image. `C`