networking/devlink/devlink-region.rst

4 Devlink Region
11 region can then be accessed via the devlink region interface.
13 Region snapshots are collected by the driver, and can be accessed via read
17 Snapshot identifiers are scoped to the devlink instance, not a region.
21 The major benefit to creating a region is to provide access to internal
29 requested snapshots must implement the ``.snapshot`` callback for the region
38 region should implement the ``.read`` callback in the ``devlink_region_ops``
48     $ devlink region help
49     $ devlink region show [ DEV/REGION ]
50     $ devlink region del DEV/REGION snapshot SNAPSHOT_ID
51     $ devlink region dump DEV/REGION [ snapshot SNAPSHOT_ID ]
52     $ devlink region read DEV/REGION [ snapshot SNAPSHOT_ID ] address ADDRESS length length
54     # Show all of the exposed regions with region sizes:
55     $ devlink region show
60     $ devlink region del pci/0000:00:05.0/cr-space snapshot 1
62     # Request an immediate snapshot, if supported by the region
63     $ devlink region new pci/0000:00:05.0/cr-space
67     $ devlink region dump pci/0000:00:05.0/fw-health snapshot 1
74     $ devlink region read pci/0000:00:05.0/fw-health snapshot 1 address 0 length 16
77     # Read from the region without a snapshot
78     $ devlink region read pci/0000:00:05.0/fw-health address 16 length 16