diff options
Diffstat (limited to 'binary_search_tool/sysroot_wrapper/README')
-rw-r--r-- | binary_search_tool/sysroot_wrapper/README | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/binary_search_tool/sysroot_wrapper/README b/binary_search_tool/sysroot_wrapper/README new file mode 100644 index 00000000..599d700d --- /dev/null +++ b/binary_search_tool/sysroot_wrapper/README @@ -0,0 +1,28 @@ +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 + + + |