LLVM-PROFGEN(1)

📦
version 16.0.6 · 3 versions
, in ubuntu noble

💖 LLVM-PROFGEN(1) 💖

okay bestie, so this is llvm-profgen from the LLVM fam — and before you ask, yes, this is the manual page, and yes, I'm gonna walk you through every single flag because I'm obsessed with you understanding it. no skimming, no vibes-only learning, we're doing this properly. 🫶

✨ NAME ✨

llvm-profgen — the LLVM SPGO profile generation tool. that's it, that's the name, it's giving "short and powerful". 💅

🌸 SYNOPSIS 🌸

llvm-profgen [commands] [options]

literally just commands and options, she's lowkey simple like that. ✨

🦋 DESCRIPTION 🦋

The llvm-profgen utility generates a profile data file from given perf script data files for sample-based profile guided optimization, aka SPGO. so it takes your perf script data, does its little magic, and hands you back a profile file. iconic behaviour, no cap. 👑

🎀 COMMANDS 🎀

bestie, listen — at least one of the following commands are required. not optional. not "if you feel like it". at least one, periodt. 💀

  • --perfscript=<string[,string,...]> — path of the perf-script trace, and it's the one created by the Linux perf tool with the script command. heads up though: the raw perf.data should be profiled with -b. don't forget the -b, I'm begging. 🙈
  • --binary=<string[,string,...]> — path of the input profiled binary files. yeah, the binaries you profiled, those ones. 🌈
  • --output=<string> — path of the output profile file. where your little profile baby gets born. 🍓

💜 OPTIONS 💜

llvm-profgen supports the following options — and yes, we're listing all of them, every single one, because every single one matters. 💅

  • --format=[text|binary|extbinary|compbinary|gcc] — specify the format of the generated profile. the supported <format> values are text, binary, extbinary, compbinary, and gcc — and if you wanna know more about what each format actually means, go check out llvm-profdata, because that's where the descriptions live. iykyk. 📖
  • --show-mmap-events — print mmap events. yes, it just prints them. sometimes you just wanna see the mmap events, and honestly? valid. 🔥
  • --show-disassembly — print disassembled code. assembly girlies rise up. 💀
  • --x86-asm-syntax=[att|intel] — specify whether to print assembly code in AT&T syntax (which is the default, btw, so if you say nothing you're getting AT&T) or Intel syntax. pick your fighter. ⚔️
real talk: att is the default. if you want intel you have to say you want intel. the assembly won't just guess for you, bestie. 🧚

🌟 AUTHOR 🌟

Maintained by the LLVM Team (https://llvm.org/). they're the main characters, we're just reading their docs. 👑

2003-2024, LLVM Project. all the rights, all the years, all the respect. 💖

and that's the whole page, bestie!! 🎉 every command, every option, every default, every path, nothing skipped, nothing merged, nothing invented. you ate that. 💅✨

one last lil sign-off: this page is version 15, dated 2024-04-14, from the LLVM Project — mwah, go profile something gorgeous. 🦋💜

📦 where this page comes from