microsoft
/
WSL2-Linux-Kernel
зеркало из https://github.com/microsoft/WSL2-Linux-Kernel.git
1
0
Форкнуть 0
Код Задачи Пакеты Проекты Релизы Вики Активность

scsi: message: fusion: Documentation cleanup 

Fix kernel-doc warnings, spellos, and typos.

../drivers/message/fusion/mptsas.c:432: warning: Function parameter or member 'sas_address' not described in 'mptsas_find_portinfo_by_sas_address'
../drivers/message/fusion/mptsas.c:432: warning: Excess function parameter 'handle' description in 'mptsas_find_portinfo_by_sas_address'
../drivers/message/fusion/mptsas.c:581: warning: Function parameter or member 'slot' not described in 'mptsas_add_device_component'
../drivers/message/fusion/mptsas.c:581: warning: Function parameter or member 'enclosure_logical_id' not described in 'mptsas_add_device_component'
../drivers/message/fusion/mptsas.c:678: warning: Function parameter or member 'starget' not described in 'mptsas_add_device_component_starget_ir'
../drivers/message/fusion/mptsas.c:678: warning: Excess function parameter 'channel' description in 'mptsas_add_device_component_starget_ir'
../drivers/message/fusion/mptsas.c:678: warning: Excess function parameter 'id' description in 'mptsas_add_device_component_starget_ir'
../drivers/message/fusion/mptsas.c:990: warning: Function parameter or member 'ioc' not described in 'mptsas_find_vtarget'
../drivers/message/fusion/mptsas.c:990: warning: Function parameter or member 'channel' not described in 'mptsas_find_vtarget'
../drivers/message/fusion/mptsas.c:990: warning: Function parameter or member 'id' not described in 'mptsas_find_vtarget'
../drivers/message/fusion/mptsas.c:990: warning: expecting prototype for csmisas_find_vtarget(). Prototype was for mptsas_find_vtarget() instead
../drivers/message/fusion/mptsas.c:1064: warning: Function parameter or member 'ioc' not described in 'mptsas_target_reset'
../drivers/message/fusion/mptsas.c:1064: warning: Function parameter or member 'channel' not described in 'mptsas_target_reset'
../drivers/message/fusion/mptsas.c:1064: warning: Function parameter or member 'id' not described in 'mptsas_target_reset'
../drivers/message/fusion/mptsas.c:1135: warning: Function parameter or member 'ioc' not described in 'mptsas_target_reset_queue'
../drivers/message/fusion/mptsas.c:1135: warning: Function parameter or member 'sas_event_data' not described in 'mptsas_target_reset_queue'
../drivers/message/fusion/mptsas.c:1217: warning: Function parameter or member 'mf' not described in 'mptsas_taskmgmt_complete'
../drivers/message/fusion/mptsas.c:1217: warning: Function parameter or member 'mr' not described in 'mptsas_taskmgmt_complete'
../drivers/message/fusion/mptsas.c:1311: warning: Function parameter or member 'ioc' not described in 'mptsas_ioc_reset'
../drivers/message/fusion/mptsas.c:1311: warning: Function parameter or member 'reset_phase' not described in 'mptsas_ioc_reset'
../drivers/message/fusion/mptsas.c:1311: warning: expecting prototype for mptscsih_ioc_reset(). Prototype was for mptsas_ioc_reset() instead
../drivers/message/fusion/mptsas.c:1951: warning: expecting prototype for mptsas_mptsas_eh_timed_out(). Prototype was for mptsas_eh_timed_out() instead
../drivers/message/fusion/mptsas.c:3623: warning: Function parameter or member 'fw_event' not described in 'mptsas_send_expander_event'
../drivers/message/fusion/mptsas.c:3623: warning: Excess function parameter 'ioc' description in 'mptsas_send_expander_event'
../drivers/message/fusion/mptsas.c:3623: warning: Excess function parameter 'expander_data' description in 'mptsas_send_expander_event'
../drivers/message/fusion/mptsas.c:4010: warning: Excess function parameter 'sas_address' description in 'mptsas_scan_sas_topology'
../drivers/message/fusion/mptsas.c:4783: warning: Function parameter or member 'issue_reset' not described in 'mptsas_issue_tm'
../drivers/message/fusion/mptsas.c:4856: warning: Function parameter or member 'fw_event' not described in 'mptsas_broadcast_primitive_work'
../drivers/message/fusion/mptsas.c:4856: warning: Excess function parameter 'work' description in 'mptsas_broadcast_primitive_work'

mptsas.c:984: warning: missing initial short description on line:
 * csmisas_find_vtarget
mptsas.c:993: warning: expecting prototype for csmisas_find_vtarget(). Prototype
 was for mptsas_find_vtarget() instead
mptsas.c:1053: warning: missing initial short description on line:
 * mptsas_target_reset
mptsas.c:1057: warning: contents before sections
mptsas.c:1125: warning: missing initial short description on line:
 * mptsas_target_reset_queue
mptsas.c:1131: warning: contents before sections
mptsas.c:1308: warning: missing initial short description on line:
 * mptsas_ioc_reset

Link: https://lore.kernel.org/r/20210418203259.835-1-rdunlap@infradead.org
Cc: Sathya Prakash <sathya.prakash@broadcom.com>
Cc: Sreekanth Reddy <sreekanth.reddy@broadcom.com>
Cc: Suganath Prabu Subramani <suganath-prabu.subramani@broadcom.com>
Cc: MPT-FusionLinux.pdl@broadcom.com
Cc: linux-scsi@vger.kernel.org
Cc: "James E.J. Bottomley" <jejb@linux.ibm.com>
Cc: "Martin K. Petersen" <martin.petersen@oracle.com>
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>
This commit is contained in:
Randy Dunlap 2021-04-18 13:32:59 -07:00 коммит произвёл Martin K. Petersen
Родитель 2910a4a9e9
Коммит cdcda4651d
1 изменённых файлов: 63 добавлений и 56 удалений
Показать статистику Скачать Patch файл Скачать Diff файл Показать все файлы Свернуть все файлы

117
drivers/message/fusion/mptsas.c
Просмотреть файл

@ -86,7 +86,7 @@ MODULE_PARM_DESC(mpt_pt_clear,
" Clear persistency table: enable=1 " " Clear persistency table: enable=1 "
"(default=MPTSCSIH_PT_CLEAR=0)"); "(default=MPTSCSIH_PT_CLEAR=0)");
/* scsi-mid layer global parmeter is max_report_luns, which is 511 */ /* scsi-mid layer global parameter is max_report_luns, which is 511 */
#define MPTSAS_MAX_LUN (16895) #define MPTSAS_MAX_LUN (16895)
static int max_lun = MPTSAS_MAX_LUN; static int max_lun = MPTSAS_MAX_LUN;
module_param(max_lun, int, 0); module_param(max_lun, int, 0);
@ -420,12 +420,14 @@ mptsas_find_portinfo_by_handle(MPT_ADAPTER *ioc, u16 handle)
} }
/** /**
* mptsas_find_portinfo_by_sas_address - * mptsas_find_portinfo_by_sas_address - find and return portinfo for
* this sas_address
* @ioc: Pointer to MPT_ADAPTER structure * @ioc: Pointer to MPT_ADAPTER structure
* @handle: * @sas_address: expander sas address
* *
* This function should be called with the sas_topology_mutex already held * This function should be called with the sas_topology_mutex already held.
* *
* Return: %NULL if not found.
**/ **/
static struct mptsas_portinfo * static struct mptsas_portinfo *
mptsas_find_portinfo_by_sas_address(MPT_ADAPTER *ioc, u64 sas_address) mptsas_find_portinfo_by_sas_address(MPT_ADAPTER *ioc, u64 sas_address)
@ -567,12 +569,14 @@ starget)
} }
/** /**
* mptsas_add_device_component - * mptsas_add_device_component - adds a new device component to our lists
* @ioc: Pointer to MPT_ADAPTER structure * @ioc: Pointer to MPT_ADAPTER structure
* @channel: fw mapped id's * @channel: channel number
* @id: * @id: Logical Target ID for reset (if appropriate)
* @sas_address: * @sas_address: expander sas address
* @device_info: * @device_info: specific bits (flags) for devices
* @slot: enclosure slot ID
* @enclosure_logical_id: enclosure WWN
* *
**/ **/
static void static void
@ -634,10 +638,10 @@ mptsas_add_device_component(MPT_ADAPTER *ioc, u8 channel, u8 id,
} }
/** /**
* mptsas_add_device_component_by_fw - * mptsas_add_device_component_by_fw - adds a new device component by FW ID
* @ioc: Pointer to MPT_ADAPTER structure * @ioc: Pointer to MPT_ADAPTER structure
* @channel: fw mapped id's * @channel: channel number
* @id: * @id: Logical Target ID
* *
**/ **/
static void static void
@ -668,8 +672,7 @@ mptsas_add_device_component_by_fw(MPT_ADAPTER *ioc, u8 channel, u8 id)
/** /**
* mptsas_add_device_component_starget_ir - Handle Integrated RAID, adding each individual device to list * mptsas_add_device_component_starget_ir - Handle Integrated RAID, adding each individual device to list
* @ioc: Pointer to MPT_ADAPTER structure * @ioc: Pointer to MPT_ADAPTER structure
* @channel: fw mapped id's * @starget: SCSI target for this SCSI device
* @id:
* *
**/ **/
static void static void
@ -771,9 +774,9 @@ mptsas_add_device_component_starget_ir(MPT_ADAPTER *ioc,
} }
/** /**
* mptsas_add_device_component_starget - * mptsas_add_device_component_starget - adds a SCSI target device component
* @ioc: Pointer to MPT_ADAPTER structure * @ioc: Pointer to MPT_ADAPTER structure
* @starget: * @starget: SCSI target for this SCSI device
* *
**/ **/
static void static void
@ -806,7 +809,7 @@ mptsas_add_device_component_starget(MPT_ADAPTER *ioc,
* mptsas_del_device_component_by_os - Once a device has been removed, we mark the entry in the list as being cached * mptsas_del_device_component_by_os - Once a device has been removed, we mark the entry in the list as being cached
* @ioc: Pointer to MPT_ADAPTER structure * @ioc: Pointer to MPT_ADAPTER structure
* @channel: os mapped id's * @channel: os mapped id's
* @id: * @id: Logical Target ID
* *
**/ **/
static void static void
@ -978,11 +981,12 @@ mptsas_setup_wide_ports(MPT_ADAPTER *ioc, struct mptsas_portinfo *port_info)
} }
/** /**
* csmisas_find_vtarget * mptsas_find_vtarget - find a virtual target device (FC LUN device or
* SCSI target device)
* *
* @ioc * @ioc: Pointer to MPT_ADAPTER structure
* @volume_id * @channel: channel number
* @volume_bus * @id: Logical Target ID
* *
**/ **/
static VirtTarget * static VirtTarget *
@ -1047,15 +1051,14 @@ mptsas_queue_rescan(MPT_ADAPTER *ioc)
/** /**
* mptsas_target_reset * mptsas_target_reset - Issues TARGET_RESET to end device using
* handshaking method
* *
* Issues TARGET_RESET to end device using handshaking method * @ioc: Pointer to MPT_ADAPTER structure
* @channel: channel number
* @id: Logical Target ID for reset
* *
* @ioc * Return: (1) success
* @channel
* @id
*
* Returns (1) success
* (0) failure * (0) failure
* *
**/ **/
@ -1119,15 +1122,15 @@ mptsas_block_io_starget(struct scsi_target *starget)
} }
/** /**
* mptsas_target_reset_queue * mptsas_target_reset_queue - queue a target reset
* *
* Receive request for TARGET_RESET after receiving an firmware * @ioc: Pointer to MPT_ADAPTER structure
* @sas_event_data: SAS Device Status Change Event data
*
* Receive request for TARGET_RESET after receiving a firmware
* event NOT_RESPONDING_EVENT, then put command in link list * event NOT_RESPONDING_EVENT, then put command in link list
* and queue if task_queue already in use. * and queue if task_queue already in use.
* *
* @ioc
* @sas_event_data
*
**/ **/
static void static void
mptsas_target_reset_queue(MPT_ADAPTER *ioc, mptsas_target_reset_queue(MPT_ADAPTER *ioc,
@ -1207,9 +1210,11 @@ mptsas_schedule_target_reset(void *iocp)
/** /**
* mptsas_taskmgmt_complete - complete SAS task management function * mptsas_taskmgmt_complete - complete SAS task management function
* @ioc: Pointer to MPT_ADAPTER structure * @ioc: Pointer to MPT_ADAPTER structure
* @mf: MPT message frame
* @mr: SCSI Task Management Reply structure ptr (may be %NULL)
* *
* Completion for TARGET_RESET after NOT_RESPONDING_EVENT, enable work * Completion for TARGET_RESET after NOT_RESPONDING_EVENT, enable work
* queue to finish off removing device from upper layers. then send next * queue to finish off removing device from upper layers, then send next
* TARGET_RESET in the queue. * TARGET_RESET in the queue.
**/ **/
static int static int
@ -1300,10 +1305,10 @@ mptsas_taskmgmt_complete(MPT_ADAPTER *ioc, MPT_FRAME_HDR *mf, MPT_FRAME_HDR *mr)
} }
/** /**
* mptscsih_ioc_reset * mptsas_ioc_reset - issue an IOC reset for this reset phase
* *
* @ioc * @ioc: Pointer to MPT_ADAPTER structure
* @reset_phase * @reset_phase: id of phase of reset
* *
**/ **/
static int static int
@ -1350,7 +1355,7 @@ mptsas_ioc_reset(MPT_ADAPTER *ioc, int reset_phase)
/** /**
* enum device_state - * enum device_state - TUR device state
* @DEVICE_RETRY: need to retry the TUR * @DEVICE_RETRY: need to retry the TUR
* @DEVICE_ERROR: TUR return error, don't add device * @DEVICE_ERROR: TUR return error, don't add device
* @DEVICE_READY: device can be added * @DEVICE_READY: device can be added
@ -1941,7 +1946,7 @@ mptsas_qcmd(struct Scsi_Host *shost, struct scsi_cmnd *SCpnt)
} }
/** /**
* mptsas_mptsas_eh_timed_out - resets the scsi_cmnd timeout * mptsas_eh_timed_out - resets the scsi_cmnd timeout
* if the device under question is currently in the * if the device under question is currently in the
* device removal delay. * device removal delay.
* @sc: scsi command that the midlayer is about to time out * @sc: scsi command that the midlayer is about to time out
@ -2839,14 +2844,15 @@ struct rep_manu_reply{
}; };
/** /**
* mptsas_exp_repmanufacture_info - * mptsas_exp_repmanufacture_info - sets expander manufacturer info
* @ioc: per adapter object * @ioc: per adapter object
* @sas_address: expander sas address * @sas_address: expander sas address
* @edev: the sas_expander_device object * @edev: the sas_expander_device object
* *
* Fills in the sas_expander_device object when SMP port is created. * For an edge expander or a fanout expander:
* fills in the sas_expander_device object when SMP port is created.
* *
* Returns 0 for success, non-zero for failure. * Return: 0 for success, non-zero for failure.
*/ */
static int static int
mptsas_exp_repmanufacture_info(MPT_ADAPTER *ioc, mptsas_exp_repmanufacture_info(MPT_ADAPTER *ioc,
@ -3611,8 +3617,7 @@ static void mptsas_expander_delete(MPT_ADAPTER *ioc,
/** /**
* mptsas_send_expander_event - expanders events * mptsas_send_expander_event - expanders events
* @ioc: Pointer to MPT_ADAPTER structure * @fw_event: event data
* @expander_data: event data
* *
* *
* This function handles adding, removing, and refreshing * This function handles adding, removing, and refreshing
@ -3657,9 +3662,9 @@ mptsas_send_expander_event(struct fw_event_work *fw_event)
/** /**
* mptsas_expander_add - * mptsas_expander_add - adds a newly discovered expander
* @ioc: Pointer to MPT_ADAPTER structure * @ioc: Pointer to MPT_ADAPTER structure
* @handle: * @handle: device handle
* *
*/ */
static struct mptsas_portinfo * static struct mptsas_portinfo *
@ -4000,9 +4005,9 @@ mptsas_probe_devices(MPT_ADAPTER *ioc)
} }
/** /**
* mptsas_scan_sas_topology - * mptsas_scan_sas_topology - scans new SAS topology
* (part of probe or rescan)
* @ioc: Pointer to MPT_ADAPTER structure * @ioc: Pointer to MPT_ADAPTER structure
* @sas_address:
* *
**/ **/
static void static void
@ -4150,11 +4155,12 @@ mptsas_find_phyinfo_by_sas_address(MPT_ADAPTER *ioc, u64 sas_address)
} }
/** /**
* mptsas_find_phyinfo_by_phys_disk_num - * mptsas_find_phyinfo_by_phys_disk_num - find phyinfo for the
* specified @phys_disk_num
* @ioc: Pointer to MPT_ADAPTER structure * @ioc: Pointer to MPT_ADAPTER structure
* @phys_disk_num: * @phys_disk_num: (hot plug) physical disk number (for RAID support)
* @channel: * @channel: channel number
* @id: * @id: Logical Target ID
* *
**/ **/
static struct mptsas_phyinfo * static struct mptsas_phyinfo *
@ -4773,8 +4779,9 @@ mptsas_send_raid_event(struct fw_event_work *fw_event)
* @lun: Logical unit for reset (if appropriate) * @lun: Logical unit for reset (if appropriate)
* @task_context: Context for the task to be aborted * @task_context: Context for the task to be aborted
* @timeout: timeout for task management control * @timeout: timeout for task management control
* @issue_reset: set to 1 on return if reset is needed, else 0
* *
* return 0 on success and -1 on failure: * Return: 0 on success or -1 on failure.
* *
*/ */
static int static int
@ -4847,9 +4854,9 @@ mptsas_issue_tm(MPT_ADAPTER *ioc, u8 type, u8 channel, u8 id, u64 lun,
/** /**
* mptsas_broadcast_primitive_work - Handle broadcast primitives * mptsas_broadcast_primitive_work - Handle broadcast primitives
* @work: work queue payload containing info describing the event * @fw_event: work queue payload containing info describing the event
* *
* this will be handled in workqueue context. * This will be handled in workqueue context.
*/ */
static void static void
mptsas_broadcast_primitive_work(struct fw_event_work *fw_event) mptsas_broadcast_primitive_work(struct fw_event_work *fw_event)