Skip to main content

ironaccelerator_rocm/
lib.rs

1//! # `ironaccelerator-rocm`
2//!
3//! ROCm / HIP backend. Targets the ROCm 6.x API surface and the AMD
4//! datacenter accelerator stack:
5//!
6//! - **HIP** driver + runtime (analogous to CUDA driver/runtime)
7//! - **hipBLAS / hipBLASLt** — dense matmul, FP8 on CDNA3+
8//! - **MIOpen** — convolution + fused kernels (cuDNN analogue)
9//! - **rocFFT, rocRAND, rocSPARSE, rocSOLVER**
10//! - **RCCL** — collective comms (NCCL analogue)
11//! - **Composable Kernel** — tunable templates (CUTLASS analogue)
12//!
13//! ## Status
14//!
15//! Safe HIP driver wrappers (`drv`), HIPRTC kernel compilation with a
16//! race-free in-memory module cache (`kernel`), a size-class memory pool
17//! (`pool`), and a hipBLASLt matmul surface (`blas`). Device paths compile
18//! but are not yet validated on AMD hardware.
19
20#![warn(missing_docs)]
21#![allow(
22    clippy::missing_safety_doc,
23    clippy::too_many_arguments,
24    clippy::type_complexity
25)]
26
27pub mod backend;
28pub mod blas;
29pub mod drv;
30pub mod kernel;
31pub mod pool;
32
33pub use backend::{RocmBackend, ROCM_BACKEND};
34
35/// Registers the ROCm backend with `reg`.
36pub fn register(reg: &mut ironaccelerator_core::BackendRegistry) {
37    // Force the Lazy and hand the registry the inner `'static` reference.
38    let b: &'static backend::RocmBackend = &ROCM_BACKEND;
39    reg.register(b);
40}