القائمة
Read before debugging guest-side ROCm behavior such as HSA signals, HIP waits, KFD ioctls, driver parameters, PASID/VMID routing, or known cosim runtime quirks.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use as the main entry for cosim debugging: gem5 crashes, assertions, hangs, timeouts, address translation faults, non-PASS test results, guest-side waits, and QEMU exits that may be secondary to gem5. Collect logs, preserve live state when needed, route to gem5 model references, and decide the first failing component.
Use when building gem5 or QEMU, checking build provenance, or preserving gem5 incremental builds across worktrees. Delegates to scripts/cosim_build.sh; never hand-roll Docker, scons, or QEMU make commands.
Use when delegating independent code review, design review, or focused bug investigation to an AI reviewer. Provides delegation templates and records reviewer evidence; higher-level review flow remains in cosim-gpu-review or cosim-gpu-rlcr-loop.
Use when the guest disk image needs modification without a full rebuild. Mount with guestmount, add files, systemd services, kernel module config.
Use as the first step for non-trivial cosim testing, debugging, review, or iterative implementation tasks. Do not use for ordinary repository maintenance such as commit splitting, submodule pointer updates, author config, or documentation-only cleanup.
Use when you need to send commands to a running cosim guest. Console pipe interaction, 9p share mount, GPU status check, manual driver load.
| name | cosim-gpu-rocm-stack |
| description | Read before debugging guest-side ROCm behavior such as HSA signals, HIP waits, KFD ioctls, driver parameters, PASID/VMID routing, or known cosim runtime quirks. |
Use this as the guest-side ROCm routing guide. It explains when a symptom
belongs to test policy, guest inspection, debug evidence, or model-side review.
Detailed runtime semantics live in references/rocm-runtime-reference.md; read
that file when debugging HSA signals, HIP API waits, KFD ioctls, PASID, VMID, or
driver parameters.
HIP API
-> ROCclr
-> ROCr / HSA runtime
-> amdgpu KFD
-> amdgpu DRM
-> gem5 GPU model through QEMU
| Question | First route |
|---|---|
Environment defaults or HSA_ENABLE_INTERRUPT | cosim-gpu-test, then scripts/cosim_guest_env.sh |
| Guest device visibility, driver load, debugfs | cosim-gpu-guest |
| Non-PASS row, hang, crash, or timeout | cosim-gpu-debug |
| Disk image package or service changes | cosim-gpu-disk-image-edit |
| HSA signal, HIP wait, KFD ioctl, PASID or VMID meaning | references/rocm-runtime-reference.md |
Use cosim-gpu-guest and cosim-gpu-debug to collect:
When runtime symbols or debug builds are needed, use repository scripts and
cosim-gpu-disk-image-edit; do not embed package-install procedures in this
skill.