vosen/ZLUDA · error

Neither hipblaslt.dll nor libhipblaslt.dll could be found. P

Error message

Neither hipblaslt.dll nor libhipblaslt.dll could be found. Please install HIP SDK: https://zluda.readthedocs.io/latest/hip_sdk.html

What it means

Panic in zluda_blaslt: the loader failed to find either hipblaslt.dll or libhipblaslt.dll, the HIP SDK libraries that back ZLUDA's cuBLASLt emulation. The build tried both possible names (Windows DLL and alternative naming) before giving up, so the root cause is simply that the HIP SDK is not installed or not on the DLL search path.

Source

Thrown at zluda_blaslt/src/impl.rs:106

// Same as in zluda_blas
pub(crate) fn get_status_name(status: cublasStatus_t) -> *const ::core::ffi::c_char {
    match status {
        cublasStatus_t::SUCCESS => c"CUBLAS_STATUS_SUCCESS".as_ptr(),
        cublasStatus_t::ERROR_NOT_INITIALIZED => c"CUBLAS_STATUS_NOT_INITIALIZED".as_ptr(),
        cublasStatus_t::ERROR_ALLOC_FAILED => c"CUBLAS_STATUS_ALLOC_FAILED".as_ptr(),
        cublasStatus_t::ERROR_INVALID_VALUE => c"CUBLAS_STATUS_INVALID_VALUE".as_ptr(),
        cublasStatus_t::ERROR_ARCH_MISMATCH => c"CUBLAS_STATUS_ARCH_MISMATCH".as_ptr(),
        cublasStatus_t::ERROR_MAPPING_ERROR => c"CUBLAS_STATUS_MAPPING_ERROR".as_ptr(),
        cublasStatus_t::ERROR_EXECUTION_FAILED => c"CUBLAS_STATUS_EXECUTION_FAILED".as_ptr(),
        cublasStatus_t::ERROR_INTERNAL_ERROR => c"CUBLAS_STATUS_INTERNAL_ERROR".as_ptr(),
        cublasStatus_t::ERROR_NOT_SUPPORTED => c"CUBLAS_STATUS_NOT_SUPPORTED".as_ptr(),
        cublasStatus_t::ERROR_LICENSE_ERROR => c"CUBLAS_STATUS_LICENSE_ERROR".as_ptr(),
        _ => c"CUBLAS_STATUS_UNKNOWN".as_ptr(),
    }
}

pub(crate) fn get_status_string(status: cublasStatus_t) -> *const ::core::ffi::c_char {
    if cfg!(windows) && status.is_err() && status.err() == hipblaslt().err().map(Into::into) {
        return c"Neither hipblaslt.dll nor libhipblaslt.dll could be found. Please install HIP SDK: https://zluda.readthedocs.io/latest/hip_sdk.html".as_ptr();
    }
    get_status_name(status)
}

pub(crate) fn get_version() -> usize {
    todo!()
}

pub(crate) fn get_cudart_version() -> usize {
    todo!()
}

pub(crate) fn disable_cpu_instructions_set_mask(_mask: ::core::ffi::c_uint) -> ::core::ffi::c_uint {
    todo!()
}

pub(crate) fn create(handle: &mut cublasLtHandle_t) -> cublasStatus_t {

View on GitHub (pinned to 9c8b43f242)

Solutions

1. Install the AMD HIP SDK (https://zluda.readthedocs.io/latest/hip_sdk.html)
2. Ensure hipblaslt.dll (or libhipblaslt.dll) is reachable via PATH or beside the executable
3. Update ZLUDA and the HIP SDK to matching versions if the DLL exists but fails to load

When it happens

Trigger: Thrown at zluda_blaslt/src/impl.rs:106 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of vosen/ZLUDA@9c8b43f242 (2026-09-06). Data as JSON: /api/errors/a85ded4aebad8a6e. Report an issue: GitHub.