diff options
author | George Burgess IV <gbiv@google.com> | 2023-12-27 13:17:24 -0700 |
---|---|---|
committer | Chromeos LUCI <chromeos-scoped@luci-project-accounts.iam.gserviceaccount.com> | 2024-01-11 22:41:18 +0000 |
commit | 920d0402afa219e41df68476828f814b2fba36ce (patch) | |
tree | 9133fec5051a40e7d81eb5e02e456b9022f383e1 | |
parent | 68d56fcaa3bc2d7d40128bbe605c68dec4a74e39 (diff) | |
download | toolchain-utils-920d0402afa219e41df68476828f814b2fba36ce.tar.gz |
fetch_cq_size_diff: add docs to README
BUG=b:316172272
TEST=None
Change-Id: I0ea0d1f0e6eb72b5b584d9b4adeb605c160300a1
Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/third_party/toolchain-utils/+/5154267
Tested-by: George Burgess <gbiv@chromium.org>
Commit-Queue: George Burgess <gbiv@chromium.org>
Reviewed-by: Bob Haarman <inglorion@chromium.org>
-rw-r--r-- | llvm_tools/README.md | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/llvm_tools/README.md b/llvm_tools/README.md index 8bd05bd9..8d0ff58c 100644 --- a/llvm_tools/README.md +++ b/llvm_tools/README.md @@ -565,3 +565,31 @@ Usage example: $ ./werror_logs.py aggregate \ --directory=${repo}/out/sdk/tmp/portage/dev-cpp/gtest-1.13.0-r12/cros-artifacts ``` + +## `fetch_cq_size_diff.py` + +This script should be runnable both inside and outside of the chroot. + +This script exists to help users fill in the llvm-next testing matrix. It's +capable of comparing the sizes of ChromeOS images, and the size of Chrome's +debuginfo. An example of this is: + +``` +$ ./fetch_cq_size_diff.py --image gs \ + gs://chromeos-image-archive/asurada-release/R122-15712.0.0/image.zip + gs://chromeos-image-archive/asurada-cq/R122-15712.0.0-92036-8761629109681962289/image.zip +``` + +For convenience, this script can also figure out what to compare from a CL, like +so: + +``` +$ ./fetch_cq_size_diff.py --image cl \ + https://chromium-review.googlesource.com/c/chromiumos/overlays/board-overlays/+/5126116/3 +``` + +In the above case, this script will find a completed CQ build associated with +PatchSet 3 of the given CL, and compare the `image.zip` generated by said build +with the image.zip generated by a release builder for the same board. CQ +attempts don't have to be entirely green for this; as long as there're a few +green boards to pick from, this script should be able to make a comparison. |