| Kostya Serebryany | 1e172b4 | 2011-11-30 01:07:02 +0000 | [diff] [blame] | 1 | AddressSanitizer RT |
| 2 | ================================ |
| 3 | This directory contains sources of the AddressSanitizer (asan) run-time library. |
| 4 | We are in the process of integrating AddressSanitizer with LLVM, stay tuned. |
| 5 | |
| 6 | Directory structre: |
| Kostya Serebryany | 1e172b4 | 2011-11-30 01:07:02 +0000 | [diff] [blame] | 7 | README.txt : This file. |
| Alexey Samsonov | 5b1f020 | 2012-09-06 06:39:02 +0000 | [diff] [blame] | 8 | Makefile.mk : File for make-based build. |
| 9 | CMakeLists.txt : File for cmake-based build. |
| Kostya Serebryany | 1e172b4 | 2011-11-30 01:07:02 +0000 | [diff] [blame] | 10 | asan_*.{cc,h} : Sources of the asan run-time lirbary. |
| Kostya Serebryany | 1e172b4 | 2011-11-30 01:07:02 +0000 | [diff] [blame] | 11 | scripts/* : Helper scripts. |
| Alexey Samsonov | 5b1f020 | 2012-09-06 06:39:02 +0000 | [diff] [blame] | 12 | tests/* : ASan unit tests. |
| 13 | lit_tests/* : ASan output tests. |
| Kostya Serebryany | 1e172b4 | 2011-11-30 01:07:02 +0000 | [diff] [blame] | 14 | |
| Alexey Samsonov | 5b1f020 | 2012-09-06 06:39:02 +0000 | [diff] [blame] | 15 | Also ASan runtime needs the following libraries: |
| 16 | lib/interception/ : Machinery used to intercept function calls. |
| 17 | lib/sanitizer_common/ : Code shared between ASan and TSan. |
| Kostya Serebryany | 1e172b4 | 2011-11-30 01:07:02 +0000 | [diff] [blame] | 18 | |
| Alexey Samsonov | 5b1f020 | 2012-09-06 06:39:02 +0000 | [diff] [blame] | 19 | Currently ASan runtime can be built by both make and cmake build systems. |
| 20 | (see compiler-rt/make and files Makefile.mk for make-based build and |
| 21 | files CMakeLists.txt for cmake-based build). |
| Kostya Serebryany | 1e172b4 | 2011-11-30 01:07:02 +0000 | [diff] [blame] | 22 | |
| Alexey Samsonov | 5b1f020 | 2012-09-06 06:39:02 +0000 | [diff] [blame] | 23 | ASan unit and output tests work only with cmake. You may run this |
| 24 | command from the root of your cmake build tree: |
| Kostya Serebryany | 1e172b4 | 2011-11-30 01:07:02 +0000 | [diff] [blame] | 25 | |
| Alexey Samsonov | 5b1f020 | 2012-09-06 06:39:02 +0000 | [diff] [blame] | 26 | make check-asan |
| Kostya Serebryany | 1e172b4 | 2011-11-30 01:07:02 +0000 | [diff] [blame] | 27 | |
| Alexey Samsonov | 5b1f020 | 2012-09-06 06:39:02 +0000 | [diff] [blame] | 28 | For more instructions see: |
| 29 | http://code.google.com/p/address-sanitizer/wiki/HowToBuild |