---
name: "rdma-resource"
section: "8"
platform: "linux"
package: "iproute2"
version: "7.3.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/rdma-resource"
---

# rdma-resource(8)

rdma resource configuration

## NAME

rdma-resource - rdma resource configuration

## SYNOPSIS

**rdma** \[ *OPTIONS* \] *RESOURCE* { *COMMAND* \|  **help** }

*RESOURCE* := {  **cm\_id** \| **cq** \| **mr** \| **pd** \| **qp** \| **ctx** \| **srq** \|  **frmr\_pools** }

*OPTIONS* := {  **-j**\[*son*\] \| **-d**\[*etails*\] }

**rdma resource show** \[ *DEV/PORT\_INDEX* \]

**rdma resource set frmr\_pools** **dev** *DEV* **aging** *AGING\_PERIOD*

**rdma resource set frmr\_pools** **dev** *DEV* **pinned** *POOL\_KEY* *PINNED\_VALUE*

**rdma resource help**

## DESCRIPTION

### rdma resource show - display rdma resource tracking information

*DEV/PORT\_INDEX* - specifies the RDMA link to show. If this argument is omitted all links are listed.

### rdma resource set - configure resource related parameters

*DEV* - specifies the RDMA device to configure.

*AGING\_PERIOD* - specifies the aging period in seconds for unused FRMR handles. Handles unused for this period will be freed.

*POOL\_KEY* - specifies the pool key that identifies a specific FRMR pool. The key is a colon-separated list of hexadecimal fields in the format vendor\_key:num\_dma\_blocks:access\_flags:ats.

*PINNED\_VALUE* - specifies the pinned value for the FRMR pool. A non-zero value pins handles to the pool, preventing them from being freed by the aging mechanism.

## EXAMPLES

rdma resource show

Shows summary for all devices on the system.

rdma resource show mlx5\_2

Shows the state of the specified rdma device.

rdma res show qp link mlx5\_4

Get all QPs for the specific device.

rdma res show qp link mlx5\_4/1

Get QPs of specific port.

rdma res show qp link mlx5\_4/0

Provide illegal port number (0 is illegal).

rdma res show qp link mlx5\_4/-

Get QPs which have not assigned port yet.

rdma res show qp link mlx5\_4/- -d

Detailed view.

rdma res show qp link mlx5\_4/- -dd

Detailed view including driver-specific details.

rdma res show qp link mlx5\_4/1 lqpn 0-6

Limit to specific Local QPNs.

rdma res show qp link mlx5\_4/1 lqpn 6 -r

Driver specific details in raw format.

rdma resource show cm\_id dst-port 7174

Show CM\_IDs with destination ip port of 7174.

rdma resource show cm\_id src-addr 172.16.0.100

Show CM\_IDs bound to local ip address 172.16.0.100.

rdma resource show cq pid 30489

Show CQs belonging to pid 30489.

rdma resource show ctx ctxn 1

Show contexts that have index equal to 1.

rdma resource show srq lqpn 5-7

Show SRQs that the QPs with lqpn 5-7 are associated with.

rdma resource show frmr\_pools ats 1

Show FRMR pools that have ats attribute set.

rdma resource set frmr\_pools dev rocep8s0f0 aging 120

Set the aging period for FRMR pools on device rocep8s0f0 to 120 seconds.

rdma resource set frmr\_pools dev rocep8s0f0 pinned 0:1000:0:0 25000

Pin 25000 handles to the FRMR pool identified by key 0:1000:0:0 on device rocep8s0f0 to prevent them from being freed.

## SEE ALSO

[**rdma**(8)](/rdma/8.md), [**rdma-dev**(8)](/rdma-dev/8.md), [**rdma-link**(8)](/rdma-link/8.md), [**rdma-statistic**(8)](/rdma-statistic/8.md),\

## AUTHOR

Leon Romanovsky \<leonro@mellanox.com\>