LLVM-PROFGEN(1)

🌸 NAME 🌸

okay bestie, welcome to the LLVM-PROFGEN(1) page from the LLVM manual — this one is literally about llvm-profgen, the LLVM SPGO profile generation tool. No cap, that's the name vibe. 💅

✨ SYNOPSIS ✨

llvm-profgen [commands] [options]

🦋 DESCRIPTION 🦋

So llvm-profgen is the utility that generates a profile data file from the perf script data files you give it, all for sample-based profile guided optimization(SPGO). That's the main character job, periodt. 💖

🎀 COMMANDS 🎀

At least one of the following commands are required:

• --perfscript=<string[,string,...]> — path of the perf-script trace created by the Linux perf tool with the script command (the raw perf.data should be profiled with -b). 🍓
• --etm=<string> — path of the ETM trace file created by ARM CoreSight trace tools. This one requires the OpenCSD library version 1.5.4 or higher to be enabled during the build. 🦋
• --perfdata=<perfdata>, --pd — path of raw perf data created by the Linux perf tool (it should be profiled with -b). ✨
• --unsymbolized-profile=<unsymbolized profile>, --up — path of the unsymbolized profile created by llvm-profgen with --skip-symbolization. 💜
• --llvm-sample-profile=<llvm sample profile> — path of the LLVM sample profile. 🌸

⚠️ NOTE: Only one of --perfscript, --perfdata, --unsymbolized-profile, --llvm-sample-profile, or --etm may be specified at a time. 🫶

• --binary=<string[,string,...]> — path of the input profiled binary files. 🔥
• --output=<string> — path of the output profile file. 🎀

💖 OPTIONS 💖

llvm-profgen supports the following options, bestie — yes, we're listing every single one:

• --format=[text|binary|extbinary|compbinary|gcc] — specify the format of the generated profile. Supported <format> are text, binary, extbinary, compbinary, gcc; see llvm-profdata for more descriptions of the format. 👑
• --show-mmap-events — print mmap events. 🌈
• --show-disassembly — print disassembled code. 🧚
• --x86-asm-syntax=[att|intel] — specify whether to print assembly code in AT&T syntax (the default) or Intel syntax. 💅
• --debug-binary=<debug-binary> — path of the debug info binary. llvm-profgen will load the DWARF info from it instead of the executable binary. 🦋
• --target-triple=<triple> — override the target triple for the binary. This is useful for ETM trace decoding to specify the correct Arm M-profile target. ⭐
• --pid — Process Id for the profiled executable binary. 🔍
• --output=<output> — path of the output profile file. (Yep, --output shows up here too with <output>.) 🎀
• --data-access-perftrace=<data-access-perftrace> — file path of a Linux perf raw trace (generated by perf report -D) consisting of memory access events. 💀

👑 AUTHOR 👑

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

🌈 COPYRIGHT 🌈

2003-2026, LLVM Project

Cute sign-off: this page is from the LLVM manual, LLVM-PROFGEN(1), page 23, dated 2026-10-06. Bye bestie, mwah 💖