From 48faeeac5f7c66520141a2663aa22aeac2716e8d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vin=C3=ADcius=20Ferr=C3=A3o?=
 <2031761+viniciusferrao@users.noreply.github.com>
Date: Wed, 26 Aug 2026 18:51:36 -0300
Subject: [PATCH] docs(genimage): show the Mellanox drivers that genimage adds

---
 .../common/deployment/install_new_kernel.rst              | 8 ++++++--
 1 file changed, 6 insertions(+), 2 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 c45845212..c469cdc72 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
@@ -77,13 +77,17 @@ Generally, the genimage command has a default driver list which will be added to
 
 The default driver list: ::
 
-         rh-x86:   tg3 bnx2 bnx2x e1000 e1000e igb mlx_en virtio_net be2net
+         rh-x86:   tg3 bnx2 bnx2x e1000 e1000e igb mlx_en mlx5_core virtio_net be2net
          rh-ppc:   e1000 e1000e igb ibmveth ehea
          rh-ppcle: ext3 ext4
-         sles-x86: tg3 bnx2 bnx2x e1000 e1000e igb mlx_en be2net
+         sles-x86: tg3 bnx2 bnx2x e1000 e1000e virtio_net virtio_balloon igb mlx4_en mlx5_core be2net
          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.
+
 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.
 
 Use the driver rpm package to add new drivers from rpm packages to the diskless initrd. Refer to the :doc:`/guides/admin-guides/manage_clusters/ppc64le/diskless/customize_image/network/cfg_network_adapter` for details.