{
    "mode": "man",
    "parameter": "rdma-statistic",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/rdma-statistic/8/json",
    "generated": "2026-06-16T22:42:38Z",
    "synopsis": "rdma [ OPTIONS ] statistic { COMMAND | help }\nrdma statistic { OBJECT } show\nrdma statistic [ OBJECT ] show link [ DEV/PORTINDX ] [ FILTERNAME FILTERVALUE ]\nrdma statistic OBJECT mode\nrdma statistic OBJECT set COUNTERSCOPE [ DEV/PORTINDEX ] auto { CRITERIA | off }\nrdma statistic OBJECT bind COUNTERSCOPE [ DEV/PORTINDEX ] [ OBJECT-ID ] [ COUNTER-ID ]\nrdma statistic OBJECT unbind COUNTERSCOPE [ DEV/PORTINDEX ] [ COUNTER-ID ] [ OBJECT-ID ]\nCOUNTERSCOPE := { link | dev }\nOBJECT := { qp | mr }\nCRITERIA := { type | pid }\nFILTERNAME := { cntn | lqpn | pid | qp-type }",
    "sections": {
        "NAME": {
            "content": "rdma-statistic - RDMA statistic counter configuration\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "rdma [ OPTIONS ] statistic { COMMAND | help }\n\n\nrdma statistic { OBJECT } show\n\nrdma statistic [ OBJECT ] show link [ DEV/PORTINDX ] [ FILTERNAME FILTERVALUE ]\n\nrdma statistic OBJECT mode\n\nrdma statistic OBJECT set COUNTERSCOPE [ DEV/PORTINDEX ] auto { CRITERIA | off }\n\nrdma statistic OBJECT bind COUNTERSCOPE [ DEV/PORTINDEX ] [ OBJECT-ID ] [ COUNTER-ID ]\n\nrdma statistic OBJECT unbind COUNTERSCOPE [ DEV/PORTINDEX ] [ COUNTER-ID ] [ OBJECT-ID ]\n\nCOUNTERSCOPE := { link | dev }\n\nOBJECT := { qp | mr }\n\nCRITERIA := { type | pid }\n\nFILTERNAME := { cntn | lqpn | pid | qp-type }\n\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "",
            "subsections": [
                {
                    "name": "rdma statistic [object] show - Queries the specified RDMA device for RDMA and driver-specific",
                    "content": ""
                },
                {
                    "name": "statistics. Show the default hw counters if object is not specified",
                    "content": "DEV - specifies counters on this RDMA device to show.\n\nPORTINDEX - specifies counters on this RDMA port to show.\n\nFILTERNAME - specifies a filter to show only the results matching it.\n\n"
                },
                {
                    "name": "rdma statistic <object> set - configure counter statistic auto-mode for a specific device/port",
                    "content": "In auto mode all objects belong to one category are bind automatically to a single counter\nset. The \"off\" is global for all auto modes together. Not applicable for MR's.\n\n"
                },
                {
                    "name": "rdma statistic <object> bind - manually bind an object (e.g., a qp) with a counter",
                    "content": "When bound the statistics of this object are available in this counter. Not applicable for\nMR's.\n\n\nrdma statistic <object> unbind - manually unbind an object (e.g., a qp) from the counter previ‐‐"
                },
                {
                    "name": "ously bound",
                    "content": "When unbound the statistics of this object are no longer available in this counter; And if\nobject id is not specified then all objects on this counter will be unbound. Not applicable\nfor MR's.\n\nCOUNTER-ID - specifies the id of the counter to be bound.  If this argument is omitted then a\nnew counter will be allocated.\n\n"
                }
            ]
        },
        "EXAMPLES": {
            "content": "rdma statistic show\nShows the state of the default counter of all RDMA devices on the system.\n\nrdma statistic show link mlx52/1\nShows the state of the default counter of specified RDMA port\n\nrdma statistic qp show\nShows the state of all qp counters of all RDMA devices on the system.\n\nrdma statistic qp show link mlx52/1\nShows the state of all qp counters of specified RDMA port.\n\nrdma statistic qp show link mlx52 pid 30489\nShows the state of all qp counters of specified RDMA port and belonging to pid 30489\n\nrdma statistic qp show link mlx52 qp-type UD\nShows the state of all qp counters of specified RDMA port and with QP type UD\n\nrdma statistic qp mode\nList current counter mode on all devices\n\nrdma statistic qp mode link mlx52/1\nList current counter mode of device mlx52 port 1\n\nrdma statistic qp set link mlx52/1 auto type on\nOn device mlx52 port 1, for each new user QP bind it with a counter automatically. Per\ncounter for QPs with same qp type.\n\nrdma statistic qp set link mlx52/1 auto pid on\nOn device mlx52 port 1, for each new user QP bind it with a counter automatically. Per\ncounter for QPs with same pid.\n\nrdma statistic qp set link mlx52/1 auto pid,type on\nOn device mlx52 port 1, for each new user QP bind it with a counter automatically. Per\ncounter for QPs with same pid and same type.\n\nrdma statistic qp set link mlx52/1 auto off\nTurn-off auto mode on device mlx52 port 1. The allocated counters can be manually ac‐\ncessed.\n\nrdma statistic qp bind link mlx52/1 lqpn 178\nOn device mlx52 port 1, allocate a counter and bind the specified qp on it\n\nrdma statistic qp unbind link mlx52/1 cntn 4 lqpn 178\nOn device mlx52 port 1, bind the specified qp on the specified counter\n\nrdma statistic qp unbind link mlx52/1 cntn 4\nOn device mlx52 port 1, unbind all QPs on the specified counter. After that this counter\nwill be released automatically by the kernel.\n\nrdma statistic show mr\nList all currently allocated MR's and their counters.\n\nrdma statistic show mr mrn 6\nDump a specific MR statistics with mrn 6. Dumps nothing if does not exists.\n\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "rdma(8), rdma-dev(8), rdma-link(8), rdma-resource(8),\n\n",
            "subsections": []
        },
        "AUTHORS": {
            "content": "Mark Zhang <markz@mellanox.com>\nErez Alfasi <ereza@mellanox.com>\n\n\n\niproute2                                    27 June 2019                           RDMA-STATISTIC(8)",
            "subsections": []
        }
    },
    "summary": "rdma-statistic - RDMA statistic counter configuration",
    "flags": [],
    "examples": [
        "rdma statistic show",
        "Shows the state of the default counter of all RDMA devices on the system.",
        "rdma statistic show link mlx52/1",
        "Shows the state of the default counter of specified RDMA port",
        "rdma statistic qp show",
        "Shows the state of all qp counters of all RDMA devices on the system.",
        "rdma statistic qp show link mlx52/1",
        "Shows the state of all qp counters of specified RDMA port.",
        "rdma statistic qp show link mlx52 pid 30489",
        "Shows the state of all qp counters of specified RDMA port and belonging to pid 30489",
        "rdma statistic qp show link mlx52 qp-type UD",
        "Shows the state of all qp counters of specified RDMA port and with QP type UD",
        "rdma statistic qp mode",
        "List current counter mode on all devices",
        "rdma statistic qp mode link mlx52/1",
        "List current counter mode of device mlx52 port 1",
        "rdma statistic qp set link mlx52/1 auto type on",
        "On device mlx52 port 1, for each new user QP bind it with a counter automatically. Per",
        "counter for QPs with same qp type.",
        "rdma statistic qp set link mlx52/1 auto pid on",
        "On device mlx52 port 1, for each new user QP bind it with a counter automatically. Per",
        "counter for QPs with same pid.",
        "rdma statistic qp set link mlx52/1 auto pid,type on",
        "On device mlx52 port 1, for each new user QP bind it with a counter automatically. Per",
        "counter for QPs with same pid and same type.",
        "rdma statistic qp set link mlx52/1 auto off",
        "Turn-off auto mode on device mlx52 port 1. The allocated counters can be manually ac‐",
        "cessed.",
        "rdma statistic qp bind link mlx52/1 lqpn 178",
        "On device mlx52 port 1, allocate a counter and bind the specified qp on it",
        "rdma statistic qp unbind link mlx52/1 cntn 4 lqpn 178",
        "On device mlx52 port 1, bind the specified qp on the specified counter",
        "rdma statistic qp unbind link mlx52/1 cntn 4",
        "On device mlx52 port 1, unbind all QPs on the specified counter. After that this counter",
        "will be released automatically by the kernel.",
        "rdma statistic show mr",
        "List all currently allocated MR's and their counters.",
        "rdma statistic show mr mrn 6",
        "Dump a specific MR statistics with mrn 6. Dumps nothing if does not exists."
    ],
    "see_also": [
        {
            "name": "rdma",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/rdma/8/json"
        },
        {
            "name": "rdma-dev",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/rdma-dev/8/json"
        },
        {
            "name": "rdma-link",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/rdma-link/8/json"
        },
        {
            "name": "rdma-resource",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/rdma-resource/8/json"
        }
    ]
}