LLVM-PROFGEN(1)

📦
version 13.0.1 · 5 versions
, in ubuntu jammy

💅 LLVM-PROFGEN(1) — the girlies' guide to llvm-profgen

okay so bestie, welcome to llvm-profgen, the LLVM SPGO profile generation tool ✨ (that's a page from the LLVM manual, if u were wondering — yes the whole suite, hi 👋). Buckle up, it's actually so much simpler than it sounds, i promise 🫶

🌸 SYNOPSIS 🌸

llvm-profgen [commands] [options]

💖 DESCRIPTION 💖

okay so the way that llvm-profgen is literally the profile-making bestie: it takes ur perf script data files and turns them into a profile data file, which u then use for sample-based profile guided optimization (SPGO) 💅 no cap, it's giving "I collect the receipts so ur compiler can glow up."

🎀 COMMANDS 🎀

heads up bestie: u need at least one of these. at least one. don't be shy, pick one (or a few, we're not the cops) ⭐

  • --perfscript=<string[,string,...]> — the path (or paths, comma-separated, go off 👑) of the perf-script trace. and bestie, this has to be created by the Linux perf tool using the script command — and the raw perf.data should be profiled with -b. that part matters, don't skip it 🙈
  • --binary=<string[,string,...]> — the path(s) of the input profiled binary files. again, comma-separated strings if u have a whole squad of them 💜
  • --output=<string> — the path where ur output profile file goes. this is the main character. this is the whole point 🎯

✨ OPTIONS ✨

llvm-profgen supports these options, and yes we're listing all of them, every single one, i don't play favorites 🫶

  • --format=[text|binary|extbinary|compbinary|gcc] — specifies the format of the generated profile. the supported format values are text, binary, extbinary, compbinary, and gcc. and if u want the whole lore on what each format actually means, go check out llvm-profdata — that's where the descriptions live, i'm just the messenger 🦋
  • --show-mmap-events — prints mmap events. that's it. that's the vibe. 🔍
  • --show-disassembly — prints disassembled code. read it and weep (affectionately) 💀
  • --x86-asm-syntax=[att|intel] — specifies whether to print assembly code in AT&T syntax (the default, bb, it's the icon) or Intel syntax. choose ur fighter 🥊

👑 AUTHOR 👑

maintained by the LLVM Team (https://llvm.org/) — absolute legends, no notes 💖

2003-2023, LLVM Project — yeah, twenty whole years of this, slay 🎀

okay bestie that's the whole page, u ate that 💅 fr fr go generate some profiles. this was LLVM manual page LLVM-PROFGEN(1), dated 2023-07-14, and it's the 13 release 🦋⭐

📦 where this page comes from