Awesome
linearize
This Plugin performs Control Flow Linearization
Building
For building the obfuscator you habe two options:
- build into llvm
- standalone pass plugin
This obfuscation has only been tested on linux. both ways of building the obfuscation may work on Mac as well. On Windows only building the pass into llvm has a chance to succeed as to my knowledge pass plugins are not supported on windows in general.
build into llvm
First checkout version 16.0.6 of llvm-project. Then apply linearize_in_tree.patch in llvm-project, run cmake, and lastly build using ninja.
git clone --depth 1 --branch llvmorg-16.0.6 https://github.com/llvm/llvm-project
cd llvm-project
patch -p1 < ../linearize_in_tree.patch
cd -
mkdir build
cd build
cmake -DLLVM_ENABLE_PROJECTS=clang -DLLVM_ENABLE_ASSERTIONS=ON -G Ninja ../llvm-project/llvm
ninja
ninja install
build as pass plugin
Make sure you have llvm version 16.0.6 installed (minor version missmatches often times don't matter). If multiple llvm version are installed find the path to the cmake directory of llvm 16.0.6. Replace the path of the LLVM_DIR option with the pass to your installation
mkdir build
cd build
cmake -DLLVM_DIR=/usr/lib/cmake/llvm/ -G Ninja ..
ninja
ninja install
Usage
Usage depends on the build type
build into llvm
Just invoke clang with the -flinearize-cfg
option on O1
or higher.
In opt
the pass is named --linearize
.
Path application should be immediatly visible as the pass is very noise currently
pass plugin
Just invoke clang with the -fpass-plugin=Linearize.so
option on O1
or higher.
If plugin is not found you may need to use the full path to the plugin or make sure
the directory containing the plugin is part of the library search path LD_LIBRARY_PATH