aboutsummaryrefslogtreecommitdiff
path: root/binary_search_tool/sysroot_wrapper/README.md
blob: 89904a0bfb05d085ab3133f84c04d7cbc7c5d3b5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
# Sysroot wrapper

This is a set of scripts to use when triaging compiler problem by using
the bisecting functionality included in the `sysroot_wrapper.hardened`.
The only script that you need to create for your triaging problem is the
`test_script.sh` (The ones in this directory are here only as an example).

Before running the binary searcher tool you will need to run the setup script:

```
./sysroot_wrapper/setup.sh ${board} ${remote_ip} ${package}
```

This setup script will ensure your `$BISECT_DIR` is properly populated and
generate a common variable script for the convenience of the scripts in
`./sysroot_wrapper`

To run the binary searcher tool with these scripts, execute it like this:

```
./binary_search_state.py \
  --get_initial_items=./sysroot_wrapper/get_initial_items.sh \
  --switch_to_good=./sysroot_wrapper/switch_to_good.sh \
  --switch_to_bad=./sysroot_wrapper/switch_to_bad.sh \
  --test_script=./sysroot_wrapper/test_script.sh \
  --noincremental \
  --file_args \
  2>&1 | tee /tmp/binary_search.log
```

Finally once done you will want to run the cleanup script:
`./sysroot_wrapper/cleanup.sh`

For more information on how to use the `sysroot_wrapper` to do object file
triaging see: https://sites.google.com/a/google.com/chromeos-toolchain-team-home2/home/team-tools-and-scripts/bisecting-compiler-problems