RDMA-RESOURCE(8) Linux RDMA-RESOURCE(8)

# [NAME](#NAME)

rdma-resource - rdma resource configuration

# [SYNOPSIS](#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](#DESCRIPTION)

## [rdma resource show - display rdma resource tracking information](#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](#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](#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](#SEE_ALSO)

[**rdma**(8)](/man/os/iproute2/rdma.8), [**rdma-dev**(8)](/man/os/iproute2/rdma-dev.8), [**rdma-link**(8)](/man/os/iproute2/rdma-link.8), [**rdma-statistic**(8)](/man/os/iproute2/rdma-statistic.8),

# [AUTHOR](#AUTHOR)

Leon Romanovsky <leonro@mellanox.com>

26 Dec 2017 iproute2

---

Document: rdma-resource(8) from iproute2 7.3.0-r0 (Chainguard OS)
Source: https://kernel.googlesource.com/pub/scm/network/iproute2/iproute2