DEVLINK-REGION(8)

💖 DEVLINK-REGION(8) 💖

✨ NAME ✨

okay bestie, this is devlink-region 🦋, the devlink address region access tool. it lets you poke at device address regions, snapshot them, and read or dump the data 🔥

🎀 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 🌸

the whole vibe here is that each subcommand does its own thing, so let's go one by one 💅

🦋 devlink region show

this one is giving list everything. it shows all the supported address regions, their names, snapshots, and sizes ✨

• DEV/REGION — tells devlink which device and address region you want to look at 🧚

🍓 devlink region new

this one makes a snapshot of an address region, identified by its name and snapshot ID 📸

• DEV/REGION — the device and address region you want to snapshot 🌈
• snapshot SNAPSHOT_ID — totally optional! if you pass an ID, that's the one that gets assigned. if you don't, devlink picks a unique ID for you 🫶

💜 devlink region del

bye bye snapshot 👋 this deletes a snapshot, picked out by address region name and snapshot ID 💀

• DEV/REGION — the device and address region you're deleting the snapshot from 🙈
• snapshot SNAPSHOT_ID — the snapshot ID you want gone 🔥

🧚 devlink region dump

main character moment: this dumps all the available data from a region, or from a snapshot of a region 👑

• DEV/REGION — the device and address region you're dumping from 🌸
• snapshot SNAPSHOT_ID — the snapshot ID of the region you want to dump 💖

🌈 devlink region read

this one reads from a specific address in a region, for a given length. very precise, very iconic ✨

• DEV/REGION — the device and address region you're reading from 🦋
• snapshot SNAPSHOT_ID — the snapshot ID of the region you want to read 🎀
• address ADDRESS — the address you want to start reading from 🫶
• length LENGTH — how much data you want to read 💅

⭐ OPTIONS ⭐

• -V[ersion] — shows the version of the tool 🎀
• -n[no-nice-names] — turns off the pretty names 🙈

🌟 EXAMPLES 🌟

okay so here's how it looks in action, no cap 💅

devlink region show

list the available address regions and snapshots 🦋

devlink region new pci/0000:00:05.0/cr-space

make a brand new snapshot of the cr-space address region on device pci/0000:00:05.0 📸

devlink region del pci/0000:00:05.0/cr-space snapshot 1

delete snapshot ID 1 from the cr-space address region on device pci/0000:00:05.0 👋

devlink region dump pci/0000:00:05.0/cr-space snapshot 1

dump the snapshot with ID 1 that was taken from the cr-space address region 🧚

devlink region read pci/0000:00:05.0/cr-space snapshot 1 address 0x10
length 16

read from address 0x10, grabbing 16 bytes from snapshot ID 1 taken from the cr-space address region 💖

🫶 SEE ALSO 🫶

you'll want to check these out too, bestie 🌈

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

👑 AUTHOR 👑

written by Alex Vesker <valex@mellanox.com> 💜

---

bestie, that's the whole page! 🎀 this came from iproute2, dated 10 Jan 2018, and it's still giving 💅✨