From 01766a6c666d37f4f1c1d0c9b96010b414cd3378 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vin=C3=ADcius=20Ferr=C3=A3o?=
 <2031761+viniciusferrao@users.noreply.github.com>
Date: Fri, 28 Aug 2026 13:57:50 -0300
Subject: [PATCH] docs(genimage): document InfiniBand driver defaults

---
 .../common/deployment/install_new_kernel.rst           | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/docs/source/guides/admin-guides/manage_clusters/common/deployment/install_new_kernel.rst b/docs/source/guides/admin-guides/manage_clusters/common/deployment/install_new_kernel.rst
index c469cdc72..7cff3d248 100644
--- a/docs/source/guides/admin-guides/manage_clusters/common/deployment/install_new_kernel.rst
+++ b/docs/source/guides/admin-guides/manage_clusters/common/deployment/install_new_kernel.rst
@@ -84,9 +84,13 @@ The default driver list: ::
          sels-ppc: tg3 e1000 e1000e igb ibmveth ehea be2net
          sles-ppcle: scsi_mod libata scsi_tgt jbd2 mbcache crc16 virtio virtio_ring libahci crc-t10dif scsi_transport_srp af_packet ext3 ext4 virtio_pci virtio_blk scsi_dh ahci megaraid_sas sd_mod ibmvscsi
 
-The Mellanox entries are conditional. ``genimage`` retains a real ``mlx_en``
-module from the target kernel, otherwise uses ``mlx4_en`` when available, and
-adds ``mlx5_core`` when available. Missing optional Mellanox modules are omitted.
+The automatically added Mellanox entries are conditional. ``genimage`` retains
+a real ``mlx_en`` module from the target kernel, otherwise uses ``mlx4_en`` when
+available, and adds ``mlx5_core`` when available. Available ``mlx4_ib`` and
+``mlx5_ib`` modules are also added. If either InfiniBand driver and ``ib_ipoib``
+are available, ``ib_ipoib`` is added for IP over InfiniBand. Missing optional
+Mellanox modules are omitted. Explicit ``netdrivers`` entries do not enable
+other optional Mellanox defaults.
 
 Note: With this approach, xCAT will search for the drivers in the rootimage. You need to make sure the drivers have been included in the rootimage before generating the initrd. You can install the drivers manually in an existing rootimage (using chroot) and run genimage again, or you can use a postinstall script to install drivers to the rootimage during your initial genimage run.