diff options
Diffstat (limited to 'llvm_tools/README.md')
-rw-r--r-- | llvm_tools/README.md | 55 |
1 files changed, 43 insertions, 12 deletions
diff --git a/llvm_tools/README.md b/llvm_tools/README.md index e2ef34f1..8072155e 100644 --- a/llvm_tools/README.md +++ b/llvm_tools/README.md @@ -156,16 +156,6 @@ $ ./patch_manager.py \ --failure_mode disable_patches ``` -For example, to remove all patches that no longer apply: - -``` -$ ./patch_manager.py \ - --svn_version 367622 \ - --patch_metadata_file /abs/path/to/patch/file \ - --src_path /abs/path/to/src/tree \ - --failure_mode remove_patches -``` - For example, to bisect a failing patch and stop at the first bisected patch: ``` @@ -244,7 +234,7 @@ $ ./auto_llvm_bisection.py --start_rev 369410 --end_rev 369420 \ --last_tested /abs/path/to/last_tested_file.json \ --extra_change_lists 513590 1394249 \ --options latest-toolchain nochromesdk \ - --chroot_path /path/to/chromeos/chroot \ + --chromeos_path /path/to/chromeos/chroot \ --builder eve-release-tryjob ``` @@ -449,7 +439,7 @@ of commits as well as differential reviews. Usage: ``` -./get_upstream_patch.py --chroot_path /abs/path/to/chroot --start_sha llvm +./get_upstream_patch.py --chromeos_path /abs/path/to/chroot --start_sha llvm --sha 174c3eb69f19ff2d6a3eeae31d04afe77e62c021 --sha 174c3eb69f19ff2d6a3eeae31d04afe77e62c021 --differential D123456 ``` @@ -552,3 +542,44 @@ Note that it's recommended to 'seed' the state file with a most recent upload date. This can be done by running this tool *once* with a `--last_date` flag. This flag has the script override whatever's in the state file (if anything) and start submitting all crashes uploaded starting at the given day. + +### `werror_logs.py` + +This tool exists to help devs reason about `-Werror` instances that _would_ +break builds, were the `FORCE_DISABLE_WERROR` support in the compiler wrapper +not enabled. + +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. |