NAME

       devlink-region - devlink address region access

SYNOPSIS

       devlink [ OPTIONS ] region  { COMMAND | help }

       OPTIONS := { -V[ersion] | -n[no-nice-names] }

       devlink region show [ DEV/REGION ]

       devlink region new DEV/REGION [ snapshot SNAPSHOT_ID ]

       devlink region del DEV/REGION snapshot SNAPSHOT_ID

       devlink region dump DEV/REGION snapshot SNAPSHOT_ID

       devlink region read DEV/REGION [ snapshot SNAPSHOT_ID ] address ADDRESS length LENGTH

       devlink region help

DESCRIPTION

   devlink region show - Show all supported address regions names, snapshots and sizes
       DEV/REGION - specifies the devlink device and address-region to query.

   devlink region new - Create a snapshot specified by address-region name and snapshot ID
       DEV/REGION - specifies the devlink device and address-region to snapshot

       snapshot SNAPSHOT_ID - optionally specifies the snapshot ID to assign. If not specified,
       devlink will assign a unique ID to the snapshot.

   devlink region del - Delete a snapshot specified by address-region name and snapshot ID
       DEV/REGION - specifies the devlink device and address-region to delete the snapshot from

       snapshot SNAPSHOT_ID - specifies the snapshot ID to delete

   devlink region dump - Dump all the available data from a region or from snapshot of a region
       DEV/REGION - specifies the device and address-region to dump from.

       snapshot SNAPSHOT_ID - specifies the snapshot-id of the region to dump.

   devlink region read - Read from a specific region address for a given length
       DEV/REGION - specifies the device and address-region to read from.

       snapshot SNAPSHOT_ID - specifies the snapshot-id of the region to read.

       address ADDRESS - specifies the address to read from.

       length LENGTH - specifies the length of data to read.

EXAMPLES

       devlink region show
           List available address regions and snapshot.

       devlink region new pci/0000:00:05.0/cr-space
           Create a new snapshot from cr-space address region from device pci/0000:00:05.0.

       devlink region del pci/0000:00:05.0/cr-space snapshot 1
           Delete snapshot id 1 from cr-space address region from device pci/0000:00:05.0.

       devlink region dump pci/0000:00:05.0/cr-space snapshot 1
           Dump the snapshot taken from cr-space address region with ID 1

       devlink region read pci/0000:00:05.0/cr-space snapshot 1 address 0x10 length 16
           Read from address 0x10, 16 Bytes of snapshot ID 1 taken from cr-space address region

SEE ALSO

       devlink(8), devlink-dev(8), devlink-port(8), devlink-monitor(8),

AUTHOR

       Alex Vesker <valex@mellanox.com>