ROCM-TARGET-ARCH(1)

📦
version 0.9.8ubuntu2 · 2 versions
, in ubuntu stonking

💖 rocm-target-arch — the rocm-target-arch manual page, bestie edition 💖

okay so this is rocm-target-arch(1), a lil User Command, and girl it is so niche but so useful. come sit with me ✨

🌸 NAME 🌸

rocm-target-arch — literally just rocm-target-arch. that's the name. iconic of it honestly 💅

🎀 DESCRIPTION 🎀

here's how you call it:

Usage: bin/rocm-target-arch [ --dist <dist> ] [ --sep <sep> ]

so what is this thing? it's a package build helper for figuring out your ROCm target architectures. that's the whole job. that's the assignment 🫶

the architectures come from central lists that the Debian ROCm Team maintains, one per distribution. and if there's no list for your current distribution? no stress — it falls back to the list for Debian's unstable (a.k.a. sid) distribution. fallback queen behavior 👑

the distribution itself gets read from debian/changelog. and here's a lil plot twist: if the distribution is unstable or experimental and the build host is Ubuntu, then ubuntu-devel is used instead. you can override all of that with the --dist option if you want to be the main character 😌

now, if you use the --reduce option, it gets spicy 🌶️ — if any build dependency (or one of its dependencies) listed in debian/control has an X-ROCm-GPU-Architecture attribute, then the list of target architectures gets correspondingly reduced. heads up though: this entails a call to dpkg-checkbuilddeps.

the default separator is the space character ' '. you can override it with --sep, and ngl the separator can be any arbitrary string you want. go feral 🦋

oh and bestie, listen: if the environment variable ROCM_TARGET_ARCH_FIXED is set to a spaceseparated of architectures, then that list gets emitted instead. super handy for package maintainers who want quick local builds with fewer or just architecture during development, without needing to modify d/rules. also useful for Salsa CI. we love a flexible queen 🙈

✨ OPTIONS ✨

  • -h — show this help. the classic. the goat 🐐
  • --dist <dist> — emit the list for <dist> instead. (remember, <dist> is the distribution you're targeting 💜)
  • --sep <sep> — when emitting the list, use <sep> as the separator. any string, no cap 🎀
  • --reduce — reduce the list of supported architectures as per the B-Ds. 💀
🌈 reminder that --reduce will hit up dpkg-checkbuilddeps, so don't act surprised when it does exactly that.

okay that's the whole page, hope you ate it up 🍓 this was written by the Debian crew and the source/version line says debian, dated July 2026 — so like, manifesting that timeline energy with you, mwah 💖 bye bestie, go build something cute ✨👑

📦 where this page comes from