RDMA-RESOURCE(8)

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-dev(8), rdma-link(8), rdma-statistic(8),

AUTHOR
Leon Romanovsky <leonro@mellanox.com>