ROC-OBJ-EXTRACT(1)

💖 ROC-OBJ-EXTRACT(1) 💖

okay bestie, welcome to roc-obj-extract(1) from the User Commands section — yes she's a manual page, yes she's iconic, and yes she's about to change your whole extraction game. sit down, grab a strawberry 🍓, let's go.

---

✨ NAME ✨

roc-obj-extract — the ROCm code object extraction tool. that's it, that's her whole job, and she does it flawlessly 💅

---

🌈 SYNOPSIS 🌈

roc-obj-extract [-o|v|h] URI...

that's the whole vibe check. flags up front, then a whole lineup of URI...s, because she's not gonna stop at just one 🫶

---

🦋 DESCRIPTION 🦋

so here's the tea, fr fr: roc-obj-extract goes and finds code objects that are embedded within binaries — like little treasures hiding inside a bigger file — copies them out, and saves them to disk. that's the main character move. she's not editing anything, she's not judging the binary, she's just extracting and saving. no cap. 👑

---

🎀 OPTIONS 🎀

• -o <path> — where the output goes, bestie. tell her the path and she'll drop the code object right there. BUT — if you pass -, she prints the code object straight to STDOUT instead. yes, the literal dash. she knows what it means. 💖
• -v — verbose mode, aka she tells you what she's doing while she's doing it, printed to STDOUT. not me loving a tool that narrates 🗣️✨
• -h — show the help message. when in doubt, -h it out 🙈

---

⭐ NOTES ⭐

listen up, because this one's a classic gotcha 😭 — when you're specifying a URI in a shell command, you need to escape the & character in the range_specifier. the shell will absolutely snatch your & if you don't. protect her. escape her. periodt. 🛡️

also: if size= is not specified, the default is the remainder of the file from the given offset. so she just keeps going to the end of the file from wherever you told her to start. generous queen 🌸

---

💜 SEE ALSO 💜

• roc-obj(1)
• roc-obj-ls(1)

---

💀 tiny reminder: escape that & or the shell will eat it and you'll be confused in the group chat. iykyk.

---

okay that's the whole page! this was roc-obj-extract 5.7.31921, from April 2025 — thanks for coming to my TED talk, go extract something iconic 💖✨🎀🦋