3 # Run as: CLANG=bin/clang ZLIB_SRC=src/zlib \
4 # build_symbolizer.sh runtime_build/lib/clang/4.0.0/lib/linux/
5 # zlib can be downloaded from http://www.zlib.net.
7 # Script compiles self-contained object file with symbolization code and injects
8 # it into the given set of runtime libraries. Script updates only libraries
9 # which has unresolved __sanitizer_symbolize_* symbols and matches architecture.
10 # Object file is be compiled from LLVM sources with dependencies like libc++ and
11 # zlib. Then it internalizes symbols in the file, so that it can be linked
12 # into arbitrary programs, avoiding conflicts with the program own symbols and
13 # avoiding dependencies on any program symbols. The only acceptable dependencies
14 # are libc and __sanitizer::internal_* from sanitizer runtime.
16 # Symbols exported by the object file will be used by Sanitizer runtime
17 # libraries to symbolize code/data in-process.
19 # The script will modify the output directory which is given as the first
20 # argument to the script.
22 # FIXME: We should really be using a simpler approach to building this object
23 # file, and it should be available as a regular cmake rule. Conceptually, we
24 # want to be doing "ld -r" followed by "objcopy -G" to create a relocatable
25 # object file with only our entry points exposed. However, this does not work at
26 # present, see PR30750.
28 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
29 SRC_DIR=$(readlink -f $SCRIPT_DIR/..)
30 TARGE_DIR=$(readlink -f $1)
32 LLVM_SRC="${LLVM_SRC:-$SCRIPT_DIR/../../../../../..}"
33 LLVM_SRC=$(readlink -f $LLVM_SRC)
35 if [[ ! -d "${LLVM_SRC}/projects/libcxxabi" ||
36 ! -d "${LLVM_SRC}/projects/libcxx" ]]; then
37 echo "Missing or incomplete LLVM_SRC"
41 if [[ "$ZLIB_SRC" == "" ||
42 ! -x "${ZLIB_SRC}/configure" ||
43 ! -f "${ZLIB_SRC}/zlib.h" ]]; then
44 echo "Missing or incomplete ZLIB_SRC"
47 ZLIB_SRC=$(readlink -f $ZLIB_SRC)
51 CLANG="${CLANG:-`which clang`}"
52 CLANG_DIR=$(readlink -f $(dirname "$CLANG"))
54 BUILD_DIR=$(readlink -f ./symbolizer)
59 CXX=$CLANG_DIR/clang++
60 TBLGEN=$CLANG_DIR/llvm-tblgen
62 export AR=$CLANG_DIR/llvm-ar
63 export LINK=$CLANG_DIR/llvm-link
65 for F in $CC $CXX $TBLGEN $LINK $OPT $AR; do
66 if [[ ! -x "$F" ]]; then
72 ZLIB_BUILD=${BUILD_DIR}/zlib
73 LIBCXX_BUILD=${BUILD_DIR}/libcxx
74 LLVM_BUILD=${BUILD_DIR}/llvm
75 SYMBOLIZER_BUILD=${BUILD_DIR}/symbolizer
78 FLAGS="$FLAGS -fPIC -flto -Os -g0 -DNDEBUG"
81 mkdir -p ${ZLIB_BUILD}
84 CC=$CC CFLAGS="$FLAGS" RANLIB=/bin/true ./configure --static
87 # Build and install libcxxabi and libcxx.
88 if [[ ! -d ${LIBCXX_BUILD} ]]; then
89 mkdir -p ${LIBCXX_BUILD}
91 LIBCXX_FLAGS="${FLAGS} -Wno-macro-redefined -I${LLVM_SRC}/projects/libcxxabi/include"
93 -DCMAKE_BUILD_TYPE=Release \
94 -DCMAKE_C_COMPILER=$CC \
95 -DCMAKE_CXX_COMPILER=$CXX \
96 -DCMAKE_C_FLAGS_RELEASE="${LIBCXX_FLAGS}" \
97 -DCMAKE_CXX_FLAGS_RELEASE="${LIBCXX_FLAGS}" \
98 -DLIBCXXABI_ENABLE_ASSERTIONS=OFF \
99 -DLIBCXXABI_ENABLE_EXCEPTIONS=OFF \
100 -DLIBCXXABI_ENABLE_SHARED=OFF \
101 -DLIBCXX_ENABLE_ASSERTIONS=OFF \
102 -DLIBCXX_ENABLE_EXCEPTIONS=OFF \
103 -DLIBCXX_ENABLE_RTTI=OFF \
104 -DLIBCXX_ENABLE_SHARED=OFF \
110 FLAGS="${FLAGS} -fno-rtti -fno-exceptions"
111 LLVM_FLAGS="${FLAGS} -nostdinc++ -I${ZLIB_BUILD} -I${LIBCXX_BUILD}/include/c++/v1"
114 if [[ ! -d ${LLVM_BUILD} ]]; then
115 mkdir -p ${LLVM_BUILD}
118 -DCMAKE_BUILD_TYPE=Release \
119 -DCMAKE_C_COMPILER=$CC \
120 -DCMAKE_CXX_COMPILER=$CXX \
121 -DCMAKE_C_FLAGS_RELEASE="${LLVM_FLAGS}" \
122 -DCMAKE_CXX_FLAGS_RELEASE="${LLVM_FLAGS}" \
123 -DLLVM_TABLEGEN=$TBLGEN \
124 -DLLVM_ENABLE_ZLIB=ON \
125 -DLLVM_ENABLE_TERMINFO=OFF \
126 -DLLVM_ENABLE_THREADS=OFF \
130 ninja LLVMSymbolize LLVMObject LLVMBinaryFormat LLVMDebugInfoDWARF LLVMSupport LLVMDebugInfoPDB LLVMMC LLVMDemangle
133 rm -rf ${SYMBOLIZER_BUILD}
134 mkdir ${SYMBOLIZER_BUILD}
135 cd ${SYMBOLIZER_BUILD}
138 SYMBOLIZER_FLAGS="$LLVM_FLAGS -I${LLVM_SRC}/include -I${LLVM_BUILD}/include -std=c++11"
139 $CXX $SYMBOLIZER_FLAGS ${SRC_DIR}/sanitizer_symbolize.cc ${SRC_DIR}/sanitizer_wrappers.cc -c
140 $AR rc symbolizer.a sanitizer_symbolize.o sanitizer_wrappers.o
142 SYMBOLIZER_API_LIST=__sanitizer_symbolize_code,__sanitizer_symbolize_data,__sanitizer_symbolize_flush,__sanitizer_symbolize_demangle
144 # Merge all the object files together and copy the resulting library back.
145 $SCRIPT_DIR/ar_to_bc.sh $LIBCXX_BUILD/lib/libc++.a \
146 $LIBCXX_BUILD/lib/libc++abi.a \
147 $LLVM_BUILD/lib/libLLVMSymbolize.a \
148 $LLVM_BUILD/lib/libLLVMObject.a \
149 $LLVM_BUILD/lib/libLLVMBinaryFormat.a \
150 $LLVM_BUILD/lib/libLLVMDebugInfoDWARF.a \
151 $LLVM_BUILD/lib/libLLVMSupport.a \
152 $LLVM_BUILD/lib/libLLVMDebugInfoPDB.a \
153 $LLVM_BUILD/lib/libLLVMDemangle.a \
154 $LLVM_BUILD/lib/libLLVMMC.a \
160 $OPT -internalize -internalize-public-api-list=${SYMBOLIZER_API_LIST} all.bc -o opt.bc
161 $CC $FLAGS -fno-lto -c opt.bc -o symbolizer.o
163 echo "Checking undefined symbols..."
164 nm -f posix -g symbolizer.o | cut -f 1,2 -d \ | LC_COLLATE=C sort -u > undefined.new
165 (diff -u $SCRIPT_DIR/global_symbols.txt undefined.new | grep -E "^\+[^+]") && \
166 (echo "Failed: unexpected symbols"; exit 1)
169 objdump -f $1 | grep -m1 -Po "(?<=file format ).*$"
172 SYMBOLIZER_FORMAT=$(arch symbolizer.o)
173 echo "Injecting $SYMBOLIZER_FORMAT symbolizer..."
174 for A in $TARGE_DIR/libclang_rt.*san*.a; do
176 if [[ "$A_FORMAT" != "$SYMBOLIZER_FORMAT" ]] ; then
179 (nm -u $A 2>/dev/null | grep -E "__sanitizer_symbolize_code" >/dev/null) || continue
181 $AR rcs $A symbolizer.o