UAIX.LmRuntime / Package guide

UAIX.LmRuntime.Backends.Rocm

ROCm backend registration, declared compatibility metadata, runtime identifiers, and fail-closed local probe diagnostics.

Required For ROCm backend registration and fail-closed ROCm diagnostics

UAIX.LmRuntime.Backends.Rocm

ROCm backend registration, declared compatibility metadata, runtime identifiers, and fail-closed local probe diagnostics.

Open on NuGet Package family

Overview

Backends.Rocm registers the UAIX ROCm backend family with Acceleration. It declares the intended ROCm capability surface and package runtime identifiers (linux-x64), then probes unavailable until a host-supplied native adapter proves assets, runtime libraries, drivers, and a device. The managed package performs no hidden native inference.

Who should use it Hosts building an explicit ROCm compatibility lane, diagnostics UI, deployment validation, or future native adapter integration for AMD GPU Linux hosts.

Install

.NET CLI

dotnet add package UAIX.LmRuntime.Backends.Rocm

Project file

<PackageReference Include="UAIX.LmRuntime.Backends.Rocm" />

Version policy: The documentation deliberately omits UAIX.LmRuntime package version numbers. Resolve and pin versions through your normal dependency-management and lock-file process.

Review the current package metadata, frameworks, dependencies, and downloads on NuGet ↗

Direct package dependencies

UAIX.LmRuntime.AccelerationNuGet ↗

Package role and boundaries

Required For ROCm backend registration and fail-closed ROCm diagnostics

You need the stable ROCm backend ID and registry extension.
You need package-visible ROCm runtime-identifier and capability declarations.
You need fail-closed probe diagnostics before ROCm execution is proven.

Boundary

Installing or registering this package does not prove ROCm execution.
The supplied managed backend does not load native inference libraries or enumerate a real device.
Do not report GPU availability unless a host adapter returns an available probe with concrete device evidence.

Registration is not execution

AddUaixRocmBackend adds metadata and probe behavior to the registry; it does not start a ROCm engine.

Compatibility fails closed

The default diagnostic probe returns unavailable and states which native evidence has not been supplied.

Runtime identifiers are declared

The package declares linux-x64; the current process and deployment still require independent validation.

Key types

These are the main entry points for this package. The generated reference below includes every documented type and member represented by public package XML documentation.

RocmRuntimeBackend RuntimeBackendRegistryExtensions

Coding examples

Examples use public package signatures documented on LMRuntime.com. Model paths, hashes, byte counts, prompts, and host-specific identifiers remain application inputs.

Register the ROCm backend

Add the package-visible ROCm backend to an explicit Acceleration registry.

RegisterROCmExample.cs

using UAIX.LmRuntime.Acceleration;
using UAIX.LmRuntime.Backends.Rocm;

var registry = new RuntimeBackendRegistry();
registry.AddUaixRocmBackend();

IRuntimeBackend backend = registry.FindById(RocmRuntimeBackend.BackendId)
    ?? throw new InvalidOperationException("ROCm backend registration failed.");

Console.WriteLine($"{backend.Id} / {backend.Kind}");

Boundary: Registration exposes ROCm diagnostics. It does not prove a native runtime or device.

Probe the ROCm package boundary

Inspect declared capabilities and the independent availability result.

ProbeROCmExample.cs

using UAIX.LmRuntime.Acceleration;
using UAIX.LmRuntime.Backends.Rocm;

var backend = new RocmRuntimeBackend();
RuntimeBackendProbeResult probe = await backend.ProbeAsync(
    new RuntimeBackendOptions
    {
        RequestedRuntimeIdentifier =
            System.Runtime.InteropServices.RuntimeInformation.RuntimeIdentifier,
        RequireNativeAssets = true
    });

Console.WriteLine($"Declared API: {probe.Capabilities.BackendApiName}");
Console.WriteLine($"Native state: {probe.Capabilities.NativeAssetState}");
Console.WriteLine($"Available: {probe.IsAvailable}");
foreach (string diagnostic in probe.Diagnostics)
{
    Console.WriteLine(diagnostic);
}

Boundary: The default probe is expected to remain unavailable until a production adapter proves ROCm assets, runtime libraries, and a device.

Require the ROCm backend by ID

Reject CPU substitution when the workload contract specifically requires ROCm.

RequireROCmExample.cs

using UAIX.LmRuntime.Acceleration;
using UAIX.LmRuntime.Backends.Rocm;

var registry = new RuntimeBackendRegistry();
registry.AddUaixRocmBackend();

var selector = new RuntimeBackendSelector(registry);
RuntimeSelectionResult result = await selector.SelectAsync(
    new RuntimeBackendOptions
    {
        Policy = RuntimeSelectionPolicy.RequireBackendId,
        PreferredBackendId = RocmRuntimeBackend.BackendId,
        AllowCpuFallback = false,
        RequireNativeAssets = true
    });

if (!result.Succeeded)
{
    Console.Error.WriteLine(result.FailureReason);
}

Boundary: RequireBackendId fails instead of relabeling another backend as ROCm.

List the ROCm package runtime identifiers

Use declared identifiers as deployment metadata, not as proof that the current machine is ready.

ROCmRuntimeIdentifiersExample.cs

using UAIX.LmRuntime.Backends.Rocm;

var backend = new RocmRuntimeBackend();
foreach (string runtimeIdentifier in backend.Capabilities.RuntimeIdentifiers)
{
    Console.WriteLine(runtimeIdentifier);
}

Boundary: The declared identifiers are linux-x64. Probe evidence remains required for a usable ROCm execution path.

Open this package on NuGet Compare the full package family →

Generated API reference

Expand a type to review its documented fields, properties, constructors, methods, parameter descriptions, and return descriptions. Browser Find also works across the closed detail elements.

RocmRuntimeBackendUAIX.LmRuntime.Backends.Rocm 2 members

Reports ROCm backend compatibility and diagnostics to the acceleration registry.

ROCm support is declared for AMD GPU systems. This package does not contain hidden ROCm inference binaries and reports unavailable until runtime and device evidence exists.

Field BackendId

The stable backend identifier used by selection policies.

Method RocmRuntimeBackend

Initializes a new instance of the UAIX.LmRuntime.Backends.Rocm.RocmRuntimeBackend class.

RuntimeBackendRegistryExtensionsUAIX.LmRuntime.Backends.Rocm 1 member

Provides registration helpers for the ROCm backend.

Registration only exposes diagnostics and selection metadata. It does not authorize hidden native execution.

Method AddUaixRocmBackend(UAIX.LmRuntime.Acceleration.IRuntimeBackendRegistry)

Adds the UAIX ROCm backend to a registry.

registry: The registry to update.

Returns: The same registry instance for fluent configuration.

Frequently asked questions

Does this package execute through ROCm today?

The managed registration package reports unavailable until a host-supplied native adapter proves ROCm assets, runtime libraries, drivers, and a device.

Why does SupportsGpuExecution read true when IsAvailable is false?

Capabilities describe the backend family. IsAvailable describes the current proven host state.

Does registration contact the network?

No. Registration and the supplied diagnostic probe perform no downloads, provider calls, subprocess execution, or remote inference.