diff options
Diffstat (limited to 'lib/msandr/README.txt')
-rw-r--r-- | lib/msandr/README.txt | 40 |
1 files changed, 0 insertions, 40 deletions
diff --git a/lib/msandr/README.txt b/lib/msandr/README.txt deleted file mode 100644 index 81a87c694083..000000000000 --- a/lib/msandr/README.txt +++ /dev/null @@ -1,40 +0,0 @@ -Experimental DynamoRIO-MSAN plugin (codename "MSanDR"). -Supports Linux/x86_64 only. - -Building: - 1. First, download and build DynamoRIO: - (svn co https://dynamorio.googlecode.com/svn/trunk dr && \ - cd dr && mkdir build && cd build && \ - cmake -DDR_EXT_DRMGR_STATIC=ON -DDR_EXT_DRSYMS_STATIC=ON \ - -DDR_EXT_DRUTIL_STATIC=ON -DDR_EXT_DRWRAP_STATIC=ON \ - -DDR_EXT_DRX_STATIC=ON .. && \ - make -j10 && make install) - - 2. Download and build DrMemory (for DrSyscall extension) - (svn co http://drmemory.googlecode.com/svn/trunk/ drmemory && \ - cd drmemory && mkdir build && cd build && \ - cmake -DDynamoRIO_DIR=`pwd`/../../dr/exports/cmake .. && \ - make -j10 && make install) - - NOTE: The line above will build a shared DrSyscall library in a non-standard - location. This will require the use of LD_LIBRARY_PATH when running MSanDR. - To build a static DrSyscall library (and link it into MSanDR), add - -DDR_EXT_DRSYSCALL_STATIC=ON to the CMake invocation above, but - beware: DrSyscall is LGPL. - - 3. Now, build LLVM with two extra CMake flags: - -DDynamoRIO_DIR=<path_to_dynamorio>/exports/cmake - -DDrMemoryFramework_DIR=<path_to_drmemory>/exports64/drmf - - This will build a lib/clang/$VERSION/lib/linux/libclang_rt.msandr-x86_64.so - -Running: - <path_to_dynamorio>/exports/bin64/drrun -c lib/clang/$VERSION/lib/linux/libclang_rt.msandr-x86_64.so -- test_binary - -MSan unit tests contain several tests for MSanDR (use MemorySanitizerDr.* gtest filter). - -Debugging: - Add -DCMAKE_BUILD_TYPE=Debug to the first and/or second cmake invocation(s). - Add -debug -v to drrun invocation line (right before -c). - Add -checklevel 1 to drrun (as the first argument) to make debug DR faster. - |