LLVM-EXTRACT(1)

✨ LLVM-EXTRACT ✨

okay bestie, so this is llvm-extract, part of the LLVM fam, and honestly? it's giving surgical 💅 she takes one (1) function and yoinks it out of a whole LLVM bitcode file. iconic behavior.

---

🎀 SYNOPSIS 🎀

llvm-extract [options] --func function-name [filename]

---

🌸 DESCRIPTION 🌸

So here's the vibe: llvm-extract takes the name of a function and extracts it from the LLVM bitcode file you point at. That's it, that's the whole thing. 🫶

It's mainly a debugging tool — like, its whole purpose in life is helping you shrink down big test cases from larger programs that are out here triggering a bug. little sis ate that.

And not only does it pull out the bitcode of the function you asked for — it also removes unreachable global variables, prototypes, and unused types. she's tidy fr fr ✨

Input tea: llvm-extract reads its input from standard input if filename is omitted, OR if filename is -.

Output is always written to standard output, unless you pass the -o option (peep below 👇).

---

💖 OPTIONS 💖

• --alias alias-name — extract the alias named function-name from the LLVM bitcode. yes the manpage really says "function-name" for an alias, no I'm not fixing it, we report the tea as it is 🍓. You can pass this multiple times to extract multiple aliases at once.
• --ralias alias-regular-expr — extract the alias matching alias-regular-expr from the LLVM bitcode. Every alias matching the regular expression gets extracted. May be specified multiple times.
• --bb basic-block-specifier — extract basic block(s) specified in basic-block-specifier. May be specified multiple times. Each <function:bb[;bb]> specifier pair will create a function. If multiple basic blocks are specified in one pair, the first block in the sequence should dominate the rest. lowkey powerful 👑
• --delete — delete specified Globals from Module. that's it. no thoughts, just deletion 💀
• -f — enable binary output on terminals. Normally, llvm-extract will refuse to write raw bitcode output if the output stream is a terminal. With this option, she'll write raw bitcode regardless of the output device. (chaos mode unlocked, bestie)
• --func function-name — extract the function named function-name from the LLVM bitcode. May be specified multiple times to extract multiple functions at once. this is the main character option tbh ⭐
• --rfunc function-regular-expr — extract the function(s) matching function-regular-expr from the LLVM bitcode. All functions matching the regular expression will be extracted. May be specified multiple times.
• --glob global-name — extract the global variable named global-name from the LLVM bitcode. May be specified multiple times to extract multiple global variables at once.
• --rglob glob-regular-expr — extract the global variable(s) matching global-regular-expr from the LLVM bitcode. All global variables matching the regular expression will be extracted. May be specified multiple times.
• --keep-const-init — preserve the values of constant globals. protecting the constants, we love to see it 🛡️
• --recursive — recursively extract all called functions. she goes deep. no cap.
• -help — print a summary of command line options. when in doubt, ask for help bestie 🙈
• -o filename — specify the output filename. If filename is "-" (which is the default), then llvm-extract sends its output to standard output.
• -S — write output in LLVM intermediate language (instead of bitcode). human-readable era 🌈

---

🦋 EXIT STATUS 🦋

If llvm-extract succeeds, she exits with 0. ✨

Otherwise, if an error occurs, she exits with a non-zero value. 😭 (as she should)

---

🌟 SEE ALSO 🌟

• bugpoint(1)

---

💜 AUTHOR 💜

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

---

👑 COPYRIGHT 👑

2003-2024, LLVM Project

---

and that's the whole page bestie!! 🎀🦋💖 this lil angel comes to you from the LLVM manual, dated 2024-07-18 — mwah, go extract something iconic 💅✨