https://github.com/google/llvm-propeller
PROPELLER: Profile Guided Optimizing Large Scale LLVM-based Relinker
https://github.com/google/llvm-propeller
Last synced: 1 day ago
JSON representation
PROPELLER: Profile Guided Optimizing Large Scale LLVM-based Relinker
- Host: GitHub
- URL: https://github.com/google/llvm-propeller
- Owner: google
- License: apache-2.0
- Created: 2019-09-09T17:16:49.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2026-07-23T19:46:56.000Z (1 day ago)
- Last Synced: 2026-07-23T21:09:30.942Z (1 day ago)
- Language: C++
- Homepage: https://github.com/google/llvm-propeller/blob/plo-dev/Propeller_RFC.pdf
- Size: 40.5 MB
- Stars: 533
- Watchers: 17
- Forks: 48
- Open Issues: 36
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
- dynamic-analysis - llvm-propeller
- AwesomeCppGameDev - llvm-propeller - based Relinker (C++)
README
# LLVM Propeller
Propeller is a profile-guided, relinking optimizer for warehouse-scale
applications. It is built on top of LLVM and provides a framework for computing
whole-program optimizations for applications built with LLVM.
_For artifact evaluation, see [ArtifactEvaluation/README.md](ArtifactEvaluation/README.md)_
## Quickstart
### Prerequisites and dependencies
| Operating System | Version |
| --- | --- |
| Ubuntu | 22.04 or newer |
While the Propeller build system automatically pulls in most of its dependencies,
you will need to install a few packages manually:
```
# Common dependencies
sudo apt install -y wget lsb-release software-properties-common gnupg
# Propeller builds with Clang 19.0.0 or newer.
wget https://apt.llvm.org/llvm.sh
chmod +x llvm.sh
sudo ./llvm.sh 19
export CC=clang-19
export CXX=clang++-19
# For the CMake build
sudo apt-get update && sudo apt-get install -y \
libelf-dev \
libssl-dev \
libzstd-dev
```
### Building Propeller from source
The Propeller repository provides both CMake and Bazel build configurations.
The CMake build requires CMake 3.24 or newer, and the Bazel build requires
Bazel 5.0 or newer.
#### CMake
```
cmake -G Ninja -B build
ninja -C build generate_propeller_profiles
# Build and run tests (optional)
ninja -C build
ninja -C build test
```
#### Bazel
```
bazel build //propeller:generate_propeller_profiles
# Build and run tests (optional)
bazel test //propeller/...:all
```
### Generating a Propeller profile
```
./generate_propeller_profiles \
--binary=/path/to/profiled/binary \
--profile=/path/to/input/profile.txt \
--cc_profile=/path/to/out/cc_profile.txt \
--ld_profile=/path/to/out/ld_profile.txt
```
Propeller generates compiler profiles (`cc_profile.txt`) and linker profiles
(`ld_profile.txt`). The compiler profile is used by LLVM to guide optimizations
and is described in [Propeller Profile Format](propeller_profile_format.md).