rdma: Add man pages for rdma system commands

Reviewed-by: Leon Romanovsky <leonro@mellanox.com>
Signed-off-by: Parav Pandit <parav@mellanox.com>
Signed-off-by: David Ahern <dsahern@gmail.com>
This commit is contained in:
Parav Pandit 2019-05-30 22:11:15 -05:00 committed by David Ahern
parent c4572a465b
commit e861272015
2 changed files with 88 additions and 1 deletions

82
man/man8/rdma-system.8 Normal file
View File

@ -0,0 +1,82 @@
.TH RDMA\-SYSTEM 8 "06 Jul 2017" "iproute2" "Linux"
.SH NAME
rdma-system \- RDMA subsystem configuration
.SH SYNOPSIS
.sp
.ad l
.in +8
.ti -8
.B rdma
.RI "[ " OPTIONS " ]"
.B sys
.RI " { " COMMAND " | "
.BR help " }"
.sp
.ti -8
.IR OPTIONS " := { "
\fB\-V\fR[\fIersion\fR] |
\fB\-d\fR[\fIetails\fR] }
.ti -8
.B rdma system show
.ti -8
.B rdma system set
.BR netns
.BR NEWMODE
.ti -8
.B rdma system help
.SH "DESCRIPTION"
.SS rdma system set - set RDMA subsystem network namespace mode
.SS rdma system show - display RDMA subsystem network namespace mode
.PP
.I "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.
.SH "EXAMPLES"
.PP
rdma system show
.RS 4
Shows the state of RDMA subsystem network namespace mode on the system.
.RE
.PP
rdma system set netns exclusive
.RS 4
Sets the RDMA subsystem in network namespace exclusive mode. In this mode RDMA devices
are visible only in single network namespace.
.RE
.PP
rdma system set netns shared
.RS 4
Sets the RDMA subsystem in network namespace shared mode. In this mode RDMA devices
are shared among network namespaces.
.RE
.PP
.SH SEE ALSO
.BR rdma (8),
.BR rdma-link (8),
.BR rdma-resource (8),
.BR network_namespaces (7),
.BR namespaces (7),
.br
.SH AUTHOR
Parav Pandit <parav@mellanox.com>

View File

@ -19,7 +19,7 @@ rdma \- RDMA tool
.ti -8
.IR OBJECT " := { "
.BR dev " | " link " }"
.BR dev " | " link " | " system " }"
.sp
.ti -8
@ -70,6 +70,10 @@ Generate JSON output.
.B link
- RDMA port related.
.TP
.B sys
- RDMA subsystem related.
.PP
The names of all objects may be written in full or
abbreviated form, for example
@ -107,6 +111,7 @@ Exit status is 0 if command was successful or a positive integer upon failure.
.BR rdma-dev (8),
.BR rdma-link (8),
.BR rdma-resource (8),
.BR rdma-system (8),
.br
.SH REPORTING BUGS