mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-27 19:29:37 +00:00
scsi: ibmvscsi: Fix a bunch of misdocumentation
Fixes the following W=1 kernel build warning(s): drivers/scsi/ibmvscsi/ibmvfc.c:331: warning: Function parameter or member 'vhost' not described in 'ibmvfc_get_err_result' drivers/scsi/ibmvscsi/ibmvfc.c:653: warning: Excess function parameter 'job_step' description in 'ibmvfc_del_tgt' drivers/scsi/ibmvscsi/ibmvfc.c:773: warning: Function parameter or member 'queue' not described in 'ibmvfc_init_event_pool' drivers/scsi/ibmvscsi/ibmvfc.c:773: warning: Function parameter or member 'size' not described in 'ibmvfc_init_event_pool' drivers/scsi/ibmvscsi/ibmvfc.c:823: warning: Function parameter or member 'queue' not described in 'ibmvfc_free_event_pool' drivers/scsi/ibmvscsi/ibmvfc.c:1413: warning: Function parameter or member 'vhost' not described in 'ibmvfc_gather_partition_info' drivers/scsi/ibmvscsi/ibmvfc.c:1483: warning: Function parameter or member 'queue' not described in 'ibmvfc_get_event' drivers/scsi/ibmvscsi/ibmvfc.c:1483: warning: Excess function parameter 'vhost' description in 'ibmvfc_get_event' drivers/scsi/ibmvscsi/ibmvfc.c:1630: warning: Function parameter or member 't' not described in 'ibmvfc_timeout' drivers/scsi/ibmvscsi/ibmvfc.c:1630: warning: Excess function parameter 'evt' description in 'ibmvfc_timeout' drivers/scsi/ibmvscsi/ibmvfc.c:1893: warning: Function parameter or member 'shost' not described in 'ibmvfc_queuecommand' drivers/scsi/ibmvscsi/ibmvfc.c:1893: warning: Excess function parameter 'done' description in 'ibmvfc_queuecommand' drivers/scsi/ibmvscsi/ibmvfc.c:2324: warning: Function parameter or member 'rport' not described in 'ibmvfc_match_rport' drivers/scsi/ibmvscsi/ibmvfc.c:2324: warning: Excess function parameter 'device' description in 'ibmvfc_match_rport' drivers/scsi/ibmvscsi/ibmvfc.c:3133: warning: Function parameter or member 'evt_doneq' not described in 'ibmvfc_handle_crq' drivers/scsi/ibmvscsi/ibmvfc.c:3317: warning: Excess function parameter 'reason' description in 'ibmvfc_change_queue_depth' drivers/scsi/ibmvscsi/ibmvfc.c:3390: warning: Function parameter or member 'attr' not described in 'ibmvfc_show_log_level' drivers/scsi/ibmvscsi/ibmvfc.c:3413: warning: Function parameter or member 'attr' not described in 'ibmvfc_store_log_level' drivers/scsi/ibmvscsi/ibmvfc.c:3413: warning: Function parameter or member 'count' not described in 'ibmvfc_store_log_level' drivers/scsi/ibmvscsi/ibmvfc.c:4121: warning: Function parameter or member 'done' not described in '__ibmvfc_tgt_get_implicit_logout_evt' drivers/scsi/ibmvscsi/ibmvfc.c:4438: warning: Function parameter or member 't' not described in 'ibmvfc_adisc_timeout' drivers/scsi/ibmvscsi/ibmvfc.c:4438: warning: Excess function parameter 'tgt' description in 'ibmvfc_adisc_timeout' drivers/scsi/ibmvscsi/ibmvfc.c:4641: warning: Function parameter or member 'target' not described in 'ibmvfc_alloc_target' drivers/scsi/ibmvscsi/ibmvfc.c:4641: warning: Excess function parameter 'scsi_id' description in 'ibmvfc_alloc_target' drivers/scsi/ibmvscsi/ibmvfc.c:5068: warning: Function parameter or member 'evt' not described in 'ibmvfc_npiv_logout_done' drivers/scsi/ibmvscsi/ibmvfc.c:5068: warning: Excess function parameter 'vhost' description in 'ibmvfc_npiv_logout_done' Link: https://lore.kernel.org/r/20210317091230.2912389-35-lee.jones@linaro.org Cc: Tyrel Datwyler <tyreld@linux.ibm.com> Cc: Michael Ellerman <mpe@ellerman.id.au> Cc: Benjamin Herrenschmidt <benh@kernel.crashing.org> Cc: Paul Mackerras <paulus@samba.org> Cc: "James E.J. Bottomley" <jejb@linux.ibm.com> Cc: "Martin K. Petersen" <martin.petersen@oracle.com> Cc: Brian King <brking@linux.vnet.ibm.com> Cc: linux-scsi@vger.kernel.org Cc: linuxppc-dev@lists.ozlabs.org Signed-off-by: Lee Jones <lee.jones@linaro.org> Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>
This commit is contained in:
parent
841d7df0d4
commit
dd9c772971
1 changed files with 18 additions and 11 deletions
|
@ -322,6 +322,7 @@ static const char *ibmvfc_get_cmd_error(u16 status, u16 error)
|
|||
|
||||
/**
|
||||
* ibmvfc_get_err_result - Find the scsi status to return for the fcp response
|
||||
* @vhost: ibmvfc host struct
|
||||
* @vfc_cmd: ibmvfc command struct
|
||||
*
|
||||
* Return value:
|
||||
|
@ -646,8 +647,6 @@ static void ibmvfc_reinit_host(struct ibmvfc_host *vhost)
|
|||
/**
|
||||
* ibmvfc_del_tgt - Schedule cleanup and removal of the target
|
||||
* @tgt: ibmvfc target struct
|
||||
* @job_step: job step to perform
|
||||
*
|
||||
**/
|
||||
static void ibmvfc_del_tgt(struct ibmvfc_target *tgt)
|
||||
{
|
||||
|
@ -764,6 +763,8 @@ static int ibmvfc_send_crq_init_complete(struct ibmvfc_host *vhost)
|
|||
/**
|
||||
* ibmvfc_init_event_pool - Allocates and initializes the event pool for a host
|
||||
* @vhost: ibmvfc host who owns the event pool
|
||||
* @queue: ibmvfc queue struct
|
||||
* @size: pool size
|
||||
*
|
||||
* Returns zero on success.
|
||||
**/
|
||||
|
@ -816,6 +817,7 @@ static int ibmvfc_init_event_pool(struct ibmvfc_host *vhost,
|
|||
/**
|
||||
* ibmvfc_free_event_pool - Frees memory of the event pool of a host
|
||||
* @vhost: ibmvfc host who owns the event pool
|
||||
* @queue: ibmvfc queue struct
|
||||
*
|
||||
**/
|
||||
static void ibmvfc_free_event_pool(struct ibmvfc_host *vhost,
|
||||
|
@ -1405,6 +1407,7 @@ static int ibmvfc_issue_fc_host_lip(struct Scsi_Host *shost)
|
|||
|
||||
/**
|
||||
* ibmvfc_gather_partition_info - Gather info about the LPAR
|
||||
* @vhost: ibmvfc host struct
|
||||
*
|
||||
* Return value:
|
||||
* none
|
||||
|
@ -1475,7 +1478,7 @@ static void ibmvfc_set_login_info(struct ibmvfc_host *vhost)
|
|||
|
||||
/**
|
||||
* ibmvfc_get_event - Gets the next free event in pool
|
||||
* @vhost: ibmvfc host struct
|
||||
* @queue: ibmvfc queue struct
|
||||
*
|
||||
* Returns a free event from the pool.
|
||||
**/
|
||||
|
@ -1622,7 +1625,7 @@ static int ibmvfc_map_sg_data(struct scsi_cmnd *scmd,
|
|||
|
||||
/**
|
||||
* ibmvfc_timeout - Internal command timeout handler
|
||||
* @evt: struct ibmvfc_event that timed out
|
||||
* @t: struct ibmvfc_event that timed out
|
||||
*
|
||||
* Called when an internally generated command times out
|
||||
**/
|
||||
|
@ -1883,8 +1886,8 @@ static struct ibmvfc_cmd *ibmvfc_init_vfc_cmd(struct ibmvfc_event *evt, struct s
|
|||
|
||||
/**
|
||||
* ibmvfc_queuecommand - The queuecommand function of the scsi template
|
||||
* @shost: scsi host struct
|
||||
* @cmnd: struct scsi_cmnd to be executed
|
||||
* @done: Callback function to be called when cmnd is completed
|
||||
*
|
||||
* Returns:
|
||||
* 0 on success / other on failure
|
||||
|
@ -2315,7 +2318,7 @@ static int ibmvfc_reset_device(struct scsi_device *sdev, int type, char *desc)
|
|||
/**
|
||||
* ibmvfc_match_rport - Match function for specified remote port
|
||||
* @evt: ibmvfc event struct
|
||||
* @device: device to match (rport)
|
||||
* @rport: device to match
|
||||
*
|
||||
* Returns:
|
||||
* 1 if event matches rport / 0 if event does not match rport
|
||||
|
@ -3126,8 +3129,9 @@ static void ibmvfc_handle_async(struct ibmvfc_async_crq *crq,
|
|||
* ibmvfc_handle_crq - Handles and frees received events in the CRQ
|
||||
* @crq: Command/Response queue
|
||||
* @vhost: ibmvfc host struct
|
||||
* @evt_doneq: Event done queue
|
||||
*
|
||||
**/
|
||||
**/
|
||||
static void ibmvfc_handle_crq(struct ibmvfc_crq *crq, struct ibmvfc_host *vhost,
|
||||
struct list_head *evt_doneq)
|
||||
{
|
||||
|
@ -3308,7 +3312,6 @@ static int ibmvfc_slave_configure(struct scsi_device *sdev)
|
|||
* ibmvfc_change_queue_depth - Change the device's queue depth
|
||||
* @sdev: scsi device struct
|
||||
* @qdepth: depth to set
|
||||
* @reason: calling context
|
||||
*
|
||||
* Return value:
|
||||
* actual depth set
|
||||
|
@ -3380,6 +3383,7 @@ static ssize_t ibmvfc_show_host_capabilities(struct device *dev,
|
|||
/**
|
||||
* ibmvfc_show_log_level - Show the adapter's error logging level
|
||||
* @dev: class device struct
|
||||
* @attr: unused
|
||||
* @buf: buffer
|
||||
*
|
||||
* Return value:
|
||||
|
@ -3402,7 +3406,9 @@ static ssize_t ibmvfc_show_log_level(struct device *dev,
|
|||
/**
|
||||
* ibmvfc_store_log_level - Change the adapter's error logging level
|
||||
* @dev: class device struct
|
||||
* @attr: unused
|
||||
* @buf: buffer
|
||||
* @count: buffer size
|
||||
*
|
||||
* Return value:
|
||||
* number of bytes printed to buffer
|
||||
|
@ -4112,6 +4118,7 @@ static void ibmvfc_tgt_implicit_logout_done(struct ibmvfc_event *evt)
|
|||
/**
|
||||
* __ibmvfc_tgt_get_implicit_logout_evt - Allocate and init an event for implicit logout
|
||||
* @tgt: ibmvfc target struct
|
||||
* @done: Routine to call when the event is responded to
|
||||
*
|
||||
* Returns:
|
||||
* Allocated and initialized ibmvfc_event struct
|
||||
|
@ -4428,7 +4435,7 @@ static void ibmvfc_tgt_adisc_cancel_done(struct ibmvfc_event *evt)
|
|||
|
||||
/**
|
||||
* ibmvfc_adisc_timeout - Handle an ADISC timeout
|
||||
* @tgt: ibmvfc target struct
|
||||
* @t: ibmvfc target struct
|
||||
*
|
||||
* If an ADISC times out, send a cancel. If the cancel times
|
||||
* out, reset the CRQ. When the ADISC comes back as cancelled,
|
||||
|
@ -4631,7 +4638,7 @@ static void ibmvfc_tgt_query_target(struct ibmvfc_target *tgt)
|
|||
/**
|
||||
* ibmvfc_alloc_target - Allocate and initialize an ibmvfc target
|
||||
* @vhost: ibmvfc host struct
|
||||
* @scsi_id: SCSI ID to allocate target for
|
||||
* @target: Holds SCSI ID to allocate target forand the WWPN
|
||||
*
|
||||
* Returns:
|
||||
* 0 on success / other on failure
|
||||
|
@ -5061,7 +5068,7 @@ static void ibmvfc_npiv_login(struct ibmvfc_host *vhost)
|
|||
|
||||
/**
|
||||
* ibmvfc_npiv_logout_done - Completion handler for NPIV Logout
|
||||
* @vhost: ibmvfc host struct
|
||||
* @evt: ibmvfc event struct
|
||||
*
|
||||
**/
|
||||
static void ibmvfc_npiv_logout_done(struct ibmvfc_event *evt)
|
||||
|
|
Loading…
Reference in a new issue