Family drm-ras netlink specification

Contents

• Family drm-ras netlink specification

  • Summary

  • Operations

    • list-nodes

    • get-error-counter

  • Definitions

    • node-type

  • Attribute sets

    • node-attrs

    • error-counter-attrs

Summary

DRM RAS (Reliability, Availability, Serviceability) over Generic Netlink. Provides a standardized mechanism for DRM drivers to register “nodes” representing hardware/software components capable of reporting error counters. Userspace tools can query the list of nodes or individual error counters via the Generic Netlink interface.

Operations

list-nodes

Retrieve the full list of currently registered DRM RAS nodes. Each node includes its dynamically assigned ID, name, and type. Important: User space must call this operation first to obtain the node IDs. These IDs are required for all subsequent operations on nodes, such as querying error counters.

attribute-set

node-attrs

flags

[admin-perm]

dump

reply

attributes

[node-id, device-name, node-name, node-type]

get-error-counter

Retrieve error counter for a given node. The response includes the id, the name, and even the current value of each counter.

attribute-set

error-counter-attrs

flags

[admin-perm]

do

request

attributes

[node-id, error-id]

reply

attributes

[error-id, error-name, error-value]

dump

request

attributes

[node-id]

reply

attributes

[error-id, error-name, error-value]

Definitions

node-type

type

enum

value-start

1

doc

Type of the node. Currently, only error-counter nodes are supported, which expose reliability counters for a hardware/software component.

entries

• error-counter

Attribute sets

node-attrs

node-id (u32)

doc

Unique identifier for the node. Assigned dynamically by the DRM RAS core upon registration.

device-name (string)

doc

Device name chosen by the driver at registration. Can be a PCI BDF, UUID, or module name if unique.

node-name (string)

doc

Node name chosen by the driver at registration. Can be an IP block name, or any name that identifies the RAS node inside the device.

node-type (u32)

doc

Type of this node, identifying its function.

enum

node-type

error-counter-attrs

node-id (u32)

doc

Node ID targeted by this error counter operation.

error-id (u32)

doc

Unique identifier for a specific error counter within an node.

error-name (string)

doc

Name of the error.

error-value (u32)

doc

Current value of the requested error counter.