Gh0st
/
linux
mirror of https://github.com/torvalds/linux.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

scsi: transport: sas: spi: Fix kernel-doc for exported functions 

Fix kernel-doc for sas_port_alloc(), sas_port_alloc_num(), and
spi_dv_device().  This allows them to be part of the SCSI driver-api
docbook.

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Link: https://lore.kernel.org/r/20241212205217.597844-6-rdunlap@infradead.org
CC: James E.J. Bottomley <James.Bottomley@HansenPartnership.com>
CC: Martin K. Petersen <martin.petersen@oracle.com>
Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>
This commit is contained in:
Randy Dunlap 2024-12-12 12:52:17 -08:00 committed by Martin K. Petersen
parent d2f4084c52
commit d4842e5787
2 changed files with 8 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
drivers/scsi/scsi_transport_sas.c
View File

@ -888,7 +888,8 @@ static void sas_port_delete_link(struct sas_port *port,
sysfs_remove_link(&phy->dev.kobj, "port"); sysfs_remove_link(&phy->dev.kobj, "port");
} }
/** sas_port_alloc - allocate and initialize a SAS port structure /**
* sas_port_alloc - allocate and initialize a SAS port structure
* *
* @parent: parent device * @parent: parent device
* @port_id: port number * @port_id: port number
@ -897,7 +898,7 @@ static void sas_port_delete_link(struct sas_port *port,
* below the device specified by @parent which must be either a Scsi_Host * below the device specified by @parent which must be either a Scsi_Host
* or a sas_expander_device. * or a sas_expander_device.
* *
* Returns %NULL on error * Returns: %NULL on error
*/ */
struct sas_port *sas_port_alloc(struct device *parent, int port_id) struct sas_port *sas_port_alloc(struct device *parent, int port_id)
{ {
@ -932,7 +933,8 @@ struct sas_port *sas_port_alloc(struct device *parent, int port_id)
} }
EXPORT_SYMBOL(sas_port_alloc); EXPORT_SYMBOL(sas_port_alloc);
/** sas_port_alloc_num - allocate and initialize a SAS port structure /**
* sas_port_alloc_num - allocate and initialize a SAS port structure
* *
* @parent: parent device * @parent: parent device
* *
@ -942,7 +944,7 @@ EXPORT_SYMBOL(sas_port_alloc);
* the device tree below the device specified by @parent which must be * the device tree below the device specified by @parent which must be
* either a Scsi_Host or a sas_expander_device. * either a Scsi_Host or a sas_expander_device.
* *
* Returns %NULL on error * Returns: %NULL on error
*/ */
struct sas_port *sas_port_alloc_num(struct device *parent) struct sas_port *sas_port_alloc_num(struct device *parent)
{ {

3
drivers/scsi/scsi_transport_spi.c
View File

@ -985,7 +985,8 @@ spi_dv_device_internal(struct scsi_device *sdev, u8 *buffer)
} }
/** spi_dv_device - Do Domain Validation on the device /**
* spi_dv_device - Do Domain Validation on the device
* @sdev: scsi device to validate * @sdev: scsi device to validate
* *
* Performs the domain validation on the given device in the * Performs the domain validation on the given device in the