From f1aeb0948edb25c5b7e39595833e1f10887c121a Mon Sep 17 00:00:00 2001 From: KelleyCook Date: Thu, 30 Mar 2023 09:16:13 -0400 Subject: [PATCH 1/3] Document the magic rate and mtu values Add in a RFC-esque tables for the magic values which aren't in any of the user docs I found. Especially needed for MTU which you need to change to mtu=5 to allow your subnet to run at 4K. All values taken from https://github.com/linux-rdma/opensm/blob/master/include/iba/ib_types.h --- doc/partition-config.txt | 40 ++++++++++++++++++++++++++++++++++++---- 1 file changed, 36 insertions(+), 4 deletions(-) diff --git a/doc/partition-config.txt b/doc/partition-config.txt index 8f3a3685..52bd063f 100644 --- a/doc/partition-config.txt +++ b/doc/partition-config.txt @@ -91,10 +91,42 @@ General file format: bits. mgroup_flag: - rate= - specifies rate for this MC group - (default is 3 (10GBps)) - mtu= - specifies MTU for this MC group - (default is 4 (2048)) + rate= - specifies rate selector for this MC group + | Selector | Gb/s | | + |----------|--------|---------| + | 2 | 2.5 | | + | 3 | 10 | default | + | 4 | 30 | | + | 5 | 5 | | + | 6 | 20 | | + | 7 | 40 | | + | 8 | 60 | | + | 9 | 80 | | + | 10 | 120 | | + | 11 | 14 | | + | 12 | 56 | | + | 13 | 112 | | + | 14 | 168 | | + | 15 | 25 | | + | 16 | 100 | | + | 17 | 200 | | + | 18 | 300 | | + | 19 | 28 | | + | 20 | 50 | | + | 21 | 400 | | + | 22 | 600 | | + | 23 | 800 | | + | 24 | 1200 | | + + mtu= - specifies MTU selector for this MC group + | Selector | MTU | | + |----------|--------|---------| + | 1 | 256 | | + | 2 | 512 | | + | 3 | 1024 | | + | 4 | 2048 | default | + | 5 | 4096 | | + sl= - specifies SL for this MC group (default is 0) scope= - specifies scope for this MC group From 992bbb03f8c4f561ad768efe95fc7a9b0bd86f87 Mon Sep 17 00:00:00 2001 From: KelleyCook Date: Thu, 30 Mar 2023 09:21:29 -0400 Subject: [PATCH 2/3] bump up mtu example Change the mtu example to 4096 as mtu=4 is the default wouldn't be required. --- doc/partition-config.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/partition-config.txt b/doc/partition-config.txt index 52bd063f..a219abb4 100644 --- a/doc/partition-config.txt +++ b/doc/partition-config.txt @@ -150,7 +150,7 @@ General file format: Note that values for rate, mtu, and scope, for both partitions and multicast groups, should be specified as defined in the IBTA specification (for example, -mtu=4 for 2048). +mtu=5 for 4096). There are several useful keywords for PortGUID definition: From 30dbdba6166c8c0f1c3508cdb8ceae0e4b1febe2 Mon Sep 17 00:00:00 2001 From: KelleyCook Date: Thu, 30 Mar 2023 09:32:56 -0400 Subject: [PATCH 3/3] Use searchable english Convert to a sentence. Moreover allows for searching for 4096 or 4K --- doc/partition-config.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/partition-config.txt b/doc/partition-config.txt index a219abb4..a8092256 100644 --- a/doc/partition-config.txt +++ b/doc/partition-config.txt @@ -149,8 +149,8 @@ General file format: NOTE: All mgroup_flag flags MUST be separated by comma (,). Note that values for rate, mtu, and scope, for both partitions and multicast -groups, should be specified as defined in the IBTA specification (for example, -mtu=5 for 4096). +groups, should be specified as defined in the IBTA specification. +For example, "mtu=5" to allow 4K MTU sizes of 4096. There are several useful keywords for PortGUID definition: