RDMA-RESOURCE(8)                     Linux                    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>

iproute2                          26 Dec 2017                 RDMA-RESOURCE(8)