Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

scsi: mpi3mr: Fix kernel-doc issues in mpi3mr_app.c

Fix all kernel-doc problems in mpi3mr_app.c:

mpi3mr_app.c:809: warning: Excess function parameter 'data' description in 'mpi3mr_set_trigger_data_in_hdb'
mpi3mr_app.c:836: warning: Excess function parameter 'data' description in 'mpi3mr_set_trigger_data_in_all_hdb'
mpi3mr_app.c:3395: warning: No description found for return value of 'sas_ncq_prio_supported_show'
mpi3mr_app.c:3413: warning: No description found for return value of 'sas_ncq_prio_enable_show'

Fixes: fc4444941140 ("scsi: mpi3mr: HDB allocation and posting for hardware and firmware buffers")
Fixes: d8d08d1638ce ("scsi: mpi3mr: Trigger support")
Fixes: 90e6f08915ec ("scsi: mpi3mr: Fix ATA NCQ priority support")
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Link: https://lore.kernel.org/r/20250620162158.776795-1-rdunlap@infradead.org
Cc: Sathya Prakash <sathya.prakash@broadcom.com>
Cc: Kashyap Desai <kashyap.desai@broadcom.com>
Cc: Sumit Saxena <sumit.saxena@broadcom.com>
Cc: Sreekanth Reddy <sreekanth.reddy@broadcom.com>
Cc: Ranjan Kumar <ranjan.kumar@broadcom.com>
Cc: mpi3mr-linuxdrv.pdl@broadcom.com
Cc: Damien Le Moal <dlemoal@kernel.org>
Cc: James E.J. Bottomley <James.Bottomley@HansenPartnership.com>
Cc: Martin K. Petersen <martin.petersen@oracle.com>
Reviewed-by: Damien Le Moal <dlemoal@kernel.org>
Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>

authored by

Randy Dunlap and committed by
Martin K. Petersen
ed575d4b c7ee6c8f

+6 -4
+6 -4
drivers/scsi/mpi3mr/mpi3mr_app.c
··· 795 795 * 796 796 * @hdb: HDB pointer 797 797 * @type: Trigger type 798 - * @data: Trigger data 799 - * @force: Trigger overwrite flag 800 798 * @trigger_data: Pointer to trigger data information 799 + * @force: Trigger overwrite flag 801 800 * 802 801 * Updates trigger type and trigger data based on parameter 803 802 * passed to this function ··· 821 822 * 822 823 * @mrioc: Adapter instance reference 823 824 * @type: Trigger type 824 - * @data: Trigger data 825 - * @force: Trigger overwrite flag 826 825 * @trigger_data: Pointer to trigger data information 826 + * @force: Trigger overwrite flag 827 827 * 828 828 * Updates trigger type and trigger data based on parameter 829 829 * passed to this function ··· 3386 3388 * @buf: the buffer returned 3387 3389 * 3388 3390 * A sysfs 'read-only' sdev attribute, only works with SATA devices 3391 + * 3392 + * Returns: the number of characters written to @buf 3389 3393 */ 3390 3394 static ssize_t 3391 3395 sas_ncq_prio_supported_show(struct device *dev, ··· 3406 3406 * @buf: the buffer returned 3407 3407 * 3408 3408 * A sysfs 'read/write' sdev attribute, only works with SATA devices 3409 + * 3410 + * Returns: the number of characters written to @buf 3409 3411 */ 3410 3412 static ssize_t 3411 3413 sas_ncq_prio_enable_show(struct device *dev,