LLVM-CONFIG(1)

💖 LLVM-CONFIG(1) 💖

okay bestie, welcome to the llvm-config page — that's the LLVM manual, section 1, and she's here to spill all the compiler tea ☕✨

---

✨ NAME ✨

llvm-config — prints out all your LLVM compilation options, no cap 🫶

---

🌸 SYNOPSIS 🌸

llvm-config option [components...]

---

🦋 DESCRIPTION 🦋

So like, llvm-config is literally the bestie that makes building apps on top of LLVM so much easier 💅. She will print you the compiler flags, the linker flags, and the object libraries you need to link against LLVM. That's it. That's the whole job. And she ate. 🔥

---

🎀 EXAMPLES 🎀

Say you wanna link against the JIT — here's the vibe:

g++ `llvm-config --cxxflags` -o HowToUseJIT.o -c HowToUseJIT.cpp
g++ `llvm-config --ldflags` -o HowToUseJIT HowToUseJIT.o \
    `llvm-config --libs engine bcreader scalaropts`

look at her go, backtick substitution queen 👑

---

💅 OPTIONS 💅

• --assertion-mode — tells you the assertion mode LLVM was built with, either ON or OFF 🫡
• --bindir — prints where the LLVM binaries live on your system 🏠
• --build-mode — what build mode was LLVM built with? like Debug or Release and such 🌈
• --build-system — prints the build system that built LLVM, e.g. cmake or gn 🛠️
• --cflags — the C compiler flags you need to use LLVM's headers 💖
• --cmakedir — where the LLVM CMake modules got installed 📁
• --components — prints every single valid component name, the whole roster 👑
• --cppflags — the C preprocessor flags you need for LLVM's headers 🧚
• --cxxflags — the C++ compiler flags you need for LLVM's headers ✨
• --has-rtti — was LLVM built with rtti or not? answers YES or NO, no in-between 💀
• --help — a lil summary of all the llvm-config arguments, your cheat sheet 🍓
• --host-target — the target triple that configured LLVM 🎯
• --ignore-libllvm — skip libLLVM and link the component libraries instead 🙈
• --includedir — where the LLVM headers got installed 📂
• --ldflags — the flags you need to link against LLVM libraries 🔗
• --libdir — where the LLVM libraries got installed 🗂️
• --libfiles — basically --libs but it prints the full path to every library file. super useful for makefile dependencies, so a tool gets relinked whenever any library it uses changes 👀
• --libnames — also like --libs but it prints just the bare filenames, no -l and no pathnames. perfect when you're linking against a copy of LLVM that isn't installed yet 🐣
• --libs — every library you need to link against the components you asked for, dependencies included 🎁
• --link-shared — link those components as shared libraries 🌊
• --link-static — link the component libraries statically 🧱
• --obj-root — the object root used to build LLVM 🏗️
• --prefix — the installation prefix for LLVM 📍
• --shared-mode — prints how the components you gave her can be linked together as a group (shared or static) 🤝
• --system-libs — all the system libraries needed to link against your components, dependencies included 🖥️
• --targets-built — the component names of every target this copy of LLVM supports 🌍
• --version — the LLVM version number, obviously 💜

---

🌈 COMPONENTS 🌈

Wanna see every available component? just run llvm-config --components and she'll list them all for you 🫶

Most of the time components map directly onto LLVM libraries. But there are some "virtual" components that are lowkey iconic:

• all — includes every LLVM library. this is the default if you don't name any components at all 💫
• backend — includes either a native backend or the C backend 🧠
• engine — includes either a native JIT or the bitcode interpreter ⚙️

---

🚦 EXIT STATUS 🚦

If llvm-config succeeds, she exits with 0 — slay 💖

Otherwise, if an error happens, she exits with a non-zero value 😭

---

👑 AUTHOR 👑

Maintained by the LLVM Team (https://llvm.org/). icons only.

---

📜 COPYRIGHT 📜

2003-2025, LLVM Project

---

and that's the whole page bestie!! this one's llvm-config from the LLVM manual, page 20, dated 2025-09-03 — mwah, go build something gorgeous 💅✨🦋