Update man pages

xcat2 · Aug 28, 2024 · 0570cda · 0570cda
1 parent d2378d8
commit 0570cda
Show file tree

Hide file tree

Showing 3 changed files with 75 additions and 99 deletions.
diff --git a/docs/source/guides/admin-guides/references/man5/ipmi.5.rst b/docs/source/guides/admin-guides/references/man5/ipmi.5.rst
@@ -55,41 +55,33 @@ ipmi Attributes:
 
  .. code-block:: perl
  
-             The following special cases exist for IBM System x servers:
-  
-             For x3755 M3 systems, 0 means use the dedicated port, 1 means
-             shared, blank is to not assign.
-  
-         For certain systems which have a mezzaine or ML2 adapter, there is a second
-         value to include:
-  
-  
-             For x3750 M4 (Model 8722):
-  
-  
-             0 2   1st 1Gbps interface for LOM
-  
-             0 0   1st 10Gbps interface for LOM
-  
-             0 3   2nd 1Gbps interface for LOM
-  
-             0 1   2nd 10Gbps interface for LOM
-  
-  
-             For  x3750 M4 (Model 8752), x3850/3950 X6, dx360 M4, x3550 M4, and x3650 M4:
-  
-  
-             0     Shared (1st onboard interface)
-  
-             1     Dedicated
-  
-             2 0   First interface on ML2 or mezzanine adapter
-  
-             2 1   Second interface on ML2 or mezzanine adapter
-  
-             2 2   Third interface on ML2 or mezzanine adapter
-  
-             2 3   Fourth interface on ML2 or mezzanine adapter
+                  The following special cases exist for IBM System x servers:
+  
+                    - For x3755 M3 systems, 0 means use the dedicated port, 1 means shared, blank is to not assign.
+  
+                    - For certain systems which have a mezzaine or ML2 adapter, there is a second value to include:
+                        For x3750 M4 (Model 8722):
+                          0 2   1st 1Gbps interface for LOM
+                          0 0   1st 10Gbps interface for LOM
+                          0 3   2nd 1Gbps interface for LOM
+                          0 1   2nd 10Gbps interface for LOM
+                        For  x3750 M4 (Model 8752), x3850/3950 X6, dx360 M4, x3550 M4, and x3650 M4:
+                          0     Shared (1st onboard interface)
+                          1     Dedicated
+                          2 0   First interface on ML2 or mezzanine adapter
+                          2 1   Second interface on ML2 or mezzanine adapter
+                          2 2   Third interface on ML2 or mezzanine adapter
+                          2 3   Fourth interface on ML2 or mezzanine adapter
+  
+                  For Dell systems, a second and third values can also be used:
+                          1st value:  0 = shared / 1 = dedicated
+                          2nd value   shared LOM (1-4)   (0 or no value means first available LOM)
+                          3rd value:  failover LOM (1-4) (0 means no failover, no value means all LOMs)
+                              0      Shared with first available interface, failover all LOMs (catch all mode)
+                              0 1    Shared with LOM1, failover all LOMs
+                              0 1 2  Shared with LOM1, failover LOM2
+                              0 2 0  Shared with LOM2, no failover
+                              1      Dedicated
  
  
 

diff --git a/docs/source/guides/admin-guides/references/man7/group.7.rst b/docs/source/guides/admin-guides/references/man7/group.7.rst
@@ -96,41 +96,33 @@ group Attributes:
 
  .. code-block:: perl
  
-             The following special cases exist for IBM System x servers:
+                  The following special cases exist for IBM System x servers:
   
-             For x3755 M3 systems, 0 means use the dedicated port, 1 means
-             shared, blank is to not assign.
+                    - For x3755 M3 systems, 0 means use the dedicated port, 1 means shared, blank is to not assign.
   
-         For certain systems which have a mezzaine or ML2 adapter, there is a second
-         value to include:
+                    - For certain systems which have a mezzaine or ML2 adapter, there is a second value to include:
+                        For x3750 M4 (Model 8722):
+                          0 2   1st 1Gbps interface for LOM
+                          0 0   1st 10Gbps interface for LOM
+                          0 3   2nd 1Gbps interface for LOM
+                          0 1   2nd 10Gbps interface for LOM
+                        For  x3750 M4 (Model 8752), x3850/3950 X6, dx360 M4, x3550 M4, and x3650 M4:
+                          0     Shared (1st onboard interface)
+                          1     Dedicated
+                          2 0   First interface on ML2 or mezzanine adapter
+                          2 1   Second interface on ML2 or mezzanine adapter
+                          2 2   Third interface on ML2 or mezzanine adapter
+                          2 3   Fourth interface on ML2 or mezzanine adapter
   
-  
-             For x3750 M4 (Model 8722):
-  
-  
-             0 2   1st 1Gbps interface for LOM
-  
-             0 0   1st 10Gbps interface for LOM
-  
-             0 3   2nd 1Gbps interface for LOM
-  
-             0 1   2nd 10Gbps interface for LOM
-  
-  
-             For  x3750 M4 (Model 8752), x3850/3950 X6, dx360 M4, x3550 M4, and x3650 M4:
-  
-  
-             0     Shared (1st onboard interface)
-  
-             1     Dedicated
-  
-             2 0   First interface on ML2 or mezzanine adapter
-  
-             2 1   Second interface on ML2 or mezzanine adapter
-  
-             2 2   Third interface on ML2 or mezzanine adapter
-  
-             2 3   Fourth interface on ML2 or mezzanine adapter
+                  For Dell systems, a second and third values can also be used:
+                          1st value:  0 = shared / 1 = dedicated
+                          2nd value   shared LOM (1-4)   (0 or no value means first available LOM)
+                          3rd value:  failover LOM (1-4) (0 means no failover, no value means all LOMs)
+                              0      Shared with first available interface, failover all LOMs (catch all mode)
+                              0 1    Shared with LOM1, failover all LOMs
+                              0 1 2  Shared with LOM1, failover LOM2
+                              0 2 0  Shared with LOM2, no failover
+                              1      Dedicated
  
  
 

diff --git a/docs/source/guides/admin-guides/references/man7/node.7.rst b/docs/source/guides/admin-guides/references/man7/node.7.rst
@@ -108,41 +108,33 @@ node Attributes:
 
  .. code-block:: perl
  
-             The following special cases exist for IBM System x servers:
+                  The following special cases exist for IBM System x servers:
   
-             For x3755 M3 systems, 0 means use the dedicated port, 1 means
-             shared, blank is to not assign.
+                    - For x3755 M3 systems, 0 means use the dedicated port, 1 means shared, blank is to not assign.
   
-         For certain systems which have a mezzaine or ML2 adapter, there is a second
-         value to include:
+                    - For certain systems which have a mezzaine or ML2 adapter, there is a second value to include:
+                        For x3750 M4 (Model 8722):
+                          0 2   1st 1Gbps interface for LOM
+                          0 0   1st 10Gbps interface for LOM
+                          0 3   2nd 1Gbps interface for LOM
+                          0 1   2nd 10Gbps interface for LOM
+                        For  x3750 M4 (Model 8752), x3850/3950 X6, dx360 M4, x3550 M4, and x3650 M4:
+                          0     Shared (1st onboard interface)
+                          1     Dedicated
+                          2 0   First interface on ML2 or mezzanine adapter
+                          2 1   Second interface on ML2 or mezzanine adapter
+                          2 2   Third interface on ML2 or mezzanine adapter
+                          2 3   Fourth interface on ML2 or mezzanine adapter
   
-  
-             For x3750 M4 (Model 8722):
-  
-  
-             0 2   1st 1Gbps interface for LOM
-  
-             0 0   1st 10Gbps interface for LOM
-  
-             0 3   2nd 1Gbps interface for LOM
-  
-             0 1   2nd 10Gbps interface for LOM
-  
-  
-             For  x3750 M4 (Model 8752), x3850/3950 X6, dx360 M4, x3550 M4, and x3650 M4:
-  
-  
-             0     Shared (1st onboard interface)
-  
-             1     Dedicated
-  
-             2 0   First interface on ML2 or mezzanine adapter
-  
-             2 1   Second interface on ML2 or mezzanine adapter
-  
-             2 2   Third interface on ML2 or mezzanine adapter
-  
-             2 3   Fourth interface on ML2 or mezzanine adapter
+                  For Dell systems, a second and third values can also be used:
+                          1st value:  0 = shared / 1 = dedicated
+                          2nd value   shared LOM (1-4)   (0 or no value means first available LOM)
+                          3rd value:  failover LOM (1-4) (0 means no failover, no value means all LOMs)
+                              0      Shared with first available interface, failover all LOMs (catch all mode)
+                              0 1    Shared with LOM1, failover all LOMs
+                              0 1 2  Shared with LOM1, failover LOM2
+                              0 2 0  Shared with LOM2, no failover
+                              1      Dedicated