scsi: Add LeapRAID driver support

This series adds the LeapRAID driver and its documentation.

This version addresses issues reported by Sashiko and the kernel test robot, as well as issues identified through internal testing. Because [PATCH v4 1/2] exceeded the line-count limit of the public Sashiko service, it was not analyzed. We therefore deployed Sashiko locally with an increased line-count limit to complete the analysis and have fixed all identified issues.

Changes in v5:

[PATCH v5 1/2] scsi: leapraid: Add new SCSI driver
- Fix /dev/leapraid_ctl adapter lifetime races during concurrent probe and removal.
- Fix firmware log mmap teardown by tracking active VMAs.
- Fix passthrough data_sge_offset validation to prevent overwrites.
- Validate asynchronous firmware event lengths to prevent out-of-bounds accesses.
- Fix SMP passthrough payload validation to prevent size_t underflow.
- Fix teardown races among event queuing, host removal, and IRQ handling.
- Fix MSI-X CPU mapping for sparse CPU IDs by using nr_cpu_ids.
- Make host-memory cleanup idempotent to prevent double cleanup.
- Initialize the internal SCSI command mutex earlier to ensure safe error-path cleanup.
- Fix Clang -Wunaligned-access warnings for packed SGE structures and related cases.
- Add the missing unwind path in leapraid_request_host_memory() and fix related error-path issues.
- Prevent nested hard resets during asynchronous recovery to avoid deadlocks.
- Remove periodic timestamp synchronization.

[PATCH v5 2/2] scsi: leapraid: Add documentation
- Document the actual enable_mp module parameter instead of enable_mpio.
- Drop SMART polling, which remains available only in the vendor driver.
- Remove the custom sas_address sysfs attribute, as it is provided by the SAS transport class.
- Drop the user-selectable interrupt_mode and msix_disable parameters.
- Rename the NCQ parameter to ncq_cmd_prio_enable for clarity.

Review tags collected
=====================

  1/2  Reviewed-by: Damien Le Moal [email protected]  (given on v2)
       Reviewed-by: Hannes Reinecke [email protected]    (given on v5)      
  2/2  Reviewed-by: Damien Le Moal [email protected]  (given on v2)
       Reviewed-by: Hannes Reinecke [email protected]    (given on v5)

Dongdong Hao (2):
scsi: leapraid: Add new SCSI driver
scsi: leapraid: Add driver documentation

 Documentation/scsi/index.rst               |    1 +
 Documentation/scsi/leapraid.rst            |  110 +
 MAINTAINERS                                |    7 +
 drivers/scsi/Kconfig                       |    1 +
 drivers/scsi/Makefile                      |    1 +
 drivers/scsi/leapraid/Kconfig              |   14 +
 drivers/scsi/leapraid/Makefile             |   10 +
 drivers/scsi/leapraid/leapraid.h           | 2048 +++++
 drivers/scsi/leapraid/leapraid_app.c       |  803 ++
 drivers/scsi/leapraid/leapraid_func.c      | 8626 ++++++++++++++++++++
 drivers/scsi/leapraid/leapraid_func.h      | 1486 ++++
 drivers/scsi/leapraid/leapraid_os.c        | 2468 ++++++
 drivers/scsi/leapraid/leapraid_transport.c | 1403 ++++
 13 files changed, 16978 insertions(+)
 create mode 100644 Documentation/scsi/leapraid.rst
 create mode 100644 drivers/scsi/leapraid/Kconfig
 create mode 100644 drivers/scsi/leapraid/Makefile
 create mode 100644 drivers/scsi/leapraid/leapraid.h
 create mode 100644 drivers/scsi/leapraid/leapraid_app.c
 create mode 100644 drivers/scsi/leapraid/leapraid_func.c
 create mode 100644 drivers/scsi/leapraid/leapraid_func.h
 create mode 100644 drivers/scsi/leapraid/leapraid_os.c
 create mode 100644 drivers/scsi/leapraid/leapraid_transport.c

2.25.1

The LeapRAID driver provides support for LeapRAID PCIe RAID controllers, enabling communication between the host operating system, firmware, and hardware for efficient storage management.

The driver is organized into several logical modules, each with a clear responsibility:

leapraid_os.c: Integrates with the Linux SCSI subsystem, handling host template callbacks, PCIe device probing, and initialization.

leapraid_func.c: Contains low-level routines for firmware/hardware interaction, interrupt handling, and reset logic.

leapraid_app.c: Provides the ioctl interface for user-space tools.

leapraid_transport.c: Manages interactions with the SCSI transport layer for SAS PHYs and ports.

leapraid_func.h: Contains internal definitions shared among driver modules.

leapraid.h: Contains low-level hardware definitions for driver/firmware interaction.

The leapraid_probe() function orchestrates the setup: it allocates the adapter structure and SCSI host, configures hardware interfaces, and registers it with the SCSI mid-layer. Following registration, scsi_scan_host() is invoked to initiate device discovery, with firmware reporting devices via interrupt-driven events.

This initial commit provides the necessary infrastructure for subsequent development of full I/O path handling, error recovery, and advanced management features.

---
 MAINTAINERS                                |    7 +
 drivers/scsi/Kconfig                       |    1 +
 drivers/scsi/Makefile                      |    1 +
 drivers/scsi/leapraid/Kconfig              |   14 +
 drivers/scsi/leapraid/Makefile             |   10 +
 drivers/scsi/leapraid/leapraid.h           | 2048 +++++
 drivers/scsi/leapraid/leapraid_app.c       |  803 ++
 drivers/scsi/leapraid/leapraid_func.c      | 8626 ++++++++++++++++++++
 drivers/scsi/leapraid/leapraid_func.h      | 1486 ++++
 drivers/scsi/leapraid/leapraid_os.c        | 2468 ++++++
 drivers/scsi/leapraid/leapraid_transport.c | 1403 ++++
 11 files changed, 16867 insertions(+)
 create mode 100644 drivers/scsi/leapraid/Kconfig
 create mode 100644 drivers/scsi/leapraid/Makefile
 create mode 100644 drivers/scsi/leapraid/leapraid.h
 create mode 100644 drivers/scsi/leapraid/leapraid_app.c
 create mode 100644 drivers/scsi/leapraid/leapraid_func.c
 create mode 100644 drivers/scsi/leapraid/leapraid_func.h
 create mode 100644 drivers/scsi/leapraid/leapraid_os.c
 create mode 100644 drivers/scsi/leapraid/leapraid_transport.c

index c68d108e4646..a8a58f059c49 100644
@@ -14650,6 +14650,13 @@ S:	Maintained
 T:	git git://git.kernel.org/pub/scm/linux/kernel/git/kees/linux.git for-next/hardening
 F:	scripts/leaking_addresses.pl
 
+LEAPIO SCSI RAID DRIVER
+M:	Dongdong Hao <[email protected]>
+L:	[email protected]
+S:	Supported
+F:	Documentation/scsi/leapraid.rst
+F:	drivers/scsi/leapraid/
+
 LED SUBSYSTEM
 M:	Lee Jones <[email protected]>
 M:	Pavel Machek <[email protected]>

index c3042393af23..4a2af0f702e1 100644
@@ -499,6 +499,7 @@ source "drivers/scsi/esas2r/Kconfig"
 source "drivers/scsi/megaraid/Kconfig.megaraid"
 source "drivers/scsi/mpt3sas/Kconfig"
 source "drivers/scsi/mpi3mr/Kconfig"
+source "drivers/scsi/leapraid/Kconfig"
 source "drivers/scsi/smartpqi/Kconfig"
 
 config SCSI_HPTIOP

index 842c254bb226..098f35219e7d 100644
@@ -91,6 +91,7 @@ obj-$(CONFIG_SCSI_BFA_FC)	+= bfa/
 obj-$(CONFIG_SCSI_CHELSIO_FCOE)	+= csiostor/
 obj-$(CONFIG_SCSI_DMX3191D)	+= dmx3191d.o
 obj-$(CONFIG_SCSI_HPSA)		+= hpsa.o
+obj-$(CONFIG_SCSI_LEAPRAID) += leapraid/
 obj-$(CONFIG_SCSI_SMARTPQI)	+= smartpqi/
 obj-$(CONFIG_SCSI_SYM53C8XX_2)	+= sym53c8xx_2/
 obj-$(CONFIG_SCSI_ZALON)	+= zalon7xx.o

new file mode 100644
index 000000000000..f4ece78f80d3
@@ -0,0 +1,14 @@
+# SPDX-License-Identifier: GPL-2.0-or-later
+
+config SCSI_LEAPRAID
+	tristate "LeapIO RAID Adapter"
+	depends on PCI && SCSI
+	select SCSI_SAS_ATTRS
+	help
+	  This driver supports LeapIO PCIe-based storage
+	  and RAID controllers.
+
+	  <http://www.leap-io.com>
+
+	  To compile this driver as a module, choose M here: the
+	  resulting kernel module will be named leapraid.

new file mode 100644
index 000000000000..bdafc036cd00
@@ -0,0 +1,10 @@
+# SPDX-License-Identifier: GPL-2.0
+#
+# Makefile for the LEAPRAID drivers.
+#
+
+obj-$(CONFIG_SCSI_LEAPRAID) += leapraid.o
+leapraid-objs += leapraid_func.o \
+		leapraid_os.o \
+		leapraid_transport.o \
+		leapraid_app.o

2.25.1

Part of the diff is not shown here. View the raw message.

This patch adds the necessary documentation for the LeapRAID SCSI driver to the kernel's documentation tree.

---
 Documentation/scsi/index.rst    |   1 +
 Documentation/scsi/leapraid.rst | 110 ++++++++++++++++++++++++++++++++
 2 files changed, 111 insertions(+)
 create mode 100644 Documentation/scsi/leapraid.rst

index f15a0f348ae4..52970f0159ca 100644
@@ -56,6 +56,7 @@ SCSI host adapter drivers
    g_NCR5380
    hpsa
    hptiop
+   leapraid
    libsas
    lpfc
    megaraid

2.25.1

Dongdong,

Applied to 7.3/scsi-staging, thanks!

Martin K. Petersen

Hi Martin,

Thank you for applying the series!

I would also like to thank Damien and Hannes for their careful reviews and valuable feedback.

Sashiko subsequently reported two minor issues in the documentation and sysfs interface. We will address them in follow-up patches once the tree has settled.

Best regards,
Dongdong