mirror of
https://git.proxmox.com/git/mirror_iproute2
synced 2025-10-04 19:29:30 +00:00
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:
parent
c4572a465b
commit
e861272015
82
man/man8/rdma-system.8
Normal file
82
man/man8/rdma-system.8
Normal 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>
|
@ -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
|
||||
|
Loading…
Reference in New Issue
Block a user