aboutsummaryrefslogtreecommitdiff
path: root/llvm_tools/README.md
diff options
context:
space:
mode:
authorJian Cai <jiancai@google.com>2020-07-28 15:02:33 -0700
committerJian Cai <jiancai@google.com>2020-08-03 20:22:00 +0000
commit9726f506eb43c95e3abc8df3253d42291c9d5d7b (patch)
tree9a489843f76d7a3bda79889e64564669f00723d5 /llvm_tools/README.md
parentf30ddd44636b4767889080bbf914cbea5f322258 (diff)
downloadtoolchain-utils-9726f506eb43c95e3abc8df3253d42291c9d5d7b.tar.gz
llvm_tools: add a tool to bisect clang crashes
Add a tool that downloads clang crash diagnoses from chrome-toolchain-artifacts/clang-crash-dignoses and send them to 4c server for bisection. BUG=chromium:1056904 TEST=local tests Change-Id: I75081259705c236a20173fc591d080c6b0504cc5 Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/third_party/toolchain-utils/+/2325008 Tested-by: Jian Cai <jiancai@google.com> Reviewed-by: George Burgess <gbiv@chromium.org>
Diffstat (limited to 'llvm_tools/README.md')
-rw-r--r--llvm_tools/README.md18
1 files changed, 18 insertions, 0 deletions
diff --git a/llvm_tools/README.md b/llvm_tools/README.md
index 547a3056..9c4a9c08 100644
--- a/llvm_tools/README.md
+++ b/llvm_tools/README.md
@@ -550,3 +550,21 @@ PYTHONPATH=../ ./nightly_revert_checker.py \
--llvm_dir llvm-project-copy \
--chromeos_dir ../../../../
```
+
+### `bisect_clang_crashes.py`
+
+This script downloads clang crash diagnoses from
+gs://chrome-toolchain-artifacts/clang-crash-diagnoses and send them to 4c for
+bisectiton.
+
+Usage example:
+
+```
+$ ./bisect_clang_crashes.py --4c 4c-cli --state_file ./output/state.json
+```
+
+The above command downloads the artifacts of clang crash diagnoses and send them
+to 4c server for bisection. The summary of submitted jobs will be saved in
+output/state.json under the current path. The output directory will be created
+automatically if it does not exist yet. To get more information of the submitted
+jobs, please refer to go/4c-cli.