Content-type: text/html; charset=UTF-8 Man page of RDMA-SYSTEM

RDMA-SYSTEM

Section: Linux (8)
Updated: 06 Jul 2017
Index Return to Main Contents
 

NAME

rdma-system - RDMA subsystem configuration  

SYNOPSIS


rdma [ OPTIONS ] sys { COMMAND | help }


OPTIONS := { -V[ersion] | -d[etails] }


rdma system show


rdma system set netns NEWMODE


rdma system set privileged-qkey NEWSTATE


rdma system help

 

DESCRIPTION

 

rdma system set - set RDMA subsystem network namespace mode or

privileged qkey mode

 

rdma system show - display RDMA subsystem network namespace mode,

privileged qkey state and whether RDMA monitoring is supported.

NEWMODE - specifies the RDMA subsystem mode. Either exclusive or shared. When user wants to assign dedicated RDMA device to a particular network namespace, exclusive mode should be set before creating any network namespace. If there are active network namespaces and if one or more RDMA devices exist, changing mode from shared to exclusive returns error code EBUSY.

When RDMA subsystem is in shared mode, RDMA device is accessible in all network namespace. When RDMA device isolation among multiple network namespaces is not needed, shared mode can be used.

It is preferred to not change the subsystem mode when there is active RDMA traffic running, even though it is supported.

NEWSTATE - Specifies the new state of the privileged-qkey parameter, either on or off. This parameter determines whether a non-privileged user is allowed to specify a controlled QKEY or not.

 

EXAMPLES

rdma system show

Shows the state of RDMA subsystem network namespace mode on the system, the state of privileged qkey parameter and whether RDMA monitor is supported.

rdma system set netns exclusive

Sets the RDMA subsystem in network namespace exclusive mode. In this mode RDMA devices are visible only in single network namespace.

rdma system set netns shared

Sets the RDMA subsystem in network namespace shared mode. In this mode RDMA devices are shared among network namespaces.

rdma system set privileged-qkey on

Sets the privileged-qkey parameter to on. In this state non-privileged user is allowed to specify a controlled QKEY.

rdma system set privileged-qkey off

Sets the privileged-qkey parameter to off. In this state non-privileged user is *not* allowed to specify a controlled QKEY.

 

SEE ALSO

rdma(8), rdma-link(8), rdma-resource(8), rdma-monitor(8), network_namespaces(7), namespaces(7),

 

AUTHOR

Parav Pandit <parav@mellanox.com>

 

Index

NAME
SYNOPSIS
DESCRIPTION
rdma system set - set RDMA subsystem network namespace mode or
rdma system show - display RDMA subsystem network namespace mode,
EXAMPLES
SEE ALSO
AUTHOR
This document was created by man2html, using the manual pages.
Time: 11:48:53 GMT, September 14, 2026