aboutsummaryrefslogtreecommitdiff
path: root/libsanitizer/HOWTO_MERGE
diff options
context:
space:
mode:
authorMartin Liska <mliska@suse.cz>2018-10-31 12:09:26 +0100
committerMartin Liska <marxin@gcc.gnu.org>2018-10-31 11:09:26 +0000
commit95fba530b6f68f336090abb5699ae9f24d1e22e6 (patch)
treebc35e5b87241ba2aa2a43ad602eac7c6bf9940ff /libsanitizer/HOWTO_MERGE
parent2e71b5714df37470cbfa44eb1faefd4e1bc22648 (diff)
downloadgcc-95fba530b6f68f336090abb5699ae9f24d1e22e6.zip
gcc-95fba530b6f68f336090abb5699ae9f24d1e22e6.tar.gz
gcc-95fba530b6f68f336090abb5699ae9f24d1e22e6.tar.bz2
Update merge script and HOWTO_MERGE documentation.
2018-10-31 Martin Liska <mliska@suse.cz> * HOWTO_MERGE: Enhance documentation. * merge.sh: Add support for git as well. From-SVN: r265664
Diffstat (limited to 'libsanitizer/HOWTO_MERGE')
-rw-r--r--libsanitizer/HOWTO_MERGE9
1 files changed, 6 insertions, 3 deletions
diff --git a/libsanitizer/HOWTO_MERGE b/libsanitizer/HOWTO_MERGE
index 81121aa..a47a26a 100644
--- a/libsanitizer/HOWTO_MERGE
+++ b/libsanitizer/HOWTO_MERGE
@@ -3,7 +3,8 @@ track various ABI changes and GCC-specific patches carefully. Here is a
general list of actions required to perform the merge:
* Checkout recent GCC tree.
-* Run merge.sh script from libsanitizer directory.
+* Run merge.sh script from libsanitizer directory. The script accepts one
+ argument that is control version system (svn or git).
* Modify Makefile.am files into asan/tsan/lsan/ubsan/sanitizer_common/interception
directories if needed. In particular, you may need to add new source files
and remove old ones in source files list, add new flags to {C, CXX}FLAGS if
@@ -20,7 +21,7 @@ general list of actions required to perform the merge:
* Update ASan testsuite with corresponding tests from lib/asan/tests directory.
Not all tests can be migrated easily, so you don't need them all to be adapted.
* Modify configure.ac file if needed (e.g. if you need to add link against new
- library for sanitizer lilbs).
+ library for sanitizer libs).
* Add new target platforms in configure.tgt script if needed.
* Bump SONAME for sanitizer libraries in asan/tsan/ubsan libtool-version files
if ABI has changed.
@@ -30,7 +31,9 @@ general list of actions required to perform the merge:
* Run regression testing on at least three platforms (e.g. x86-linux-gnu, x86_64-linux-gnu,
aarch64-linux-gnu, arm-linux-gnueabi).
* Run {A, UB}San bootstrap on at least three platforms.
-* Compare ABI of corresponding libclang_rt-asan and newly build libasan libraries.
+* Compare ABI of corresponding libclang_rt.asan and newly build libasan libraries.
+ Similarly you can compare latest GCC release with the newly built libraries
+ (libasan.so.*, libubsan.so.*, libtsan.so*).
You can use a pretty good libabigail tool (https://sourceware.org/libabigail/index.html)
to perform such a comparision. Note, that the list of exported symbols may differ,
e.g. because libasan currently does not include UBSan runtime.