scsi: ibmvscsi: Fix a bunch of misdocumentation (dd9c7729) · Commits · jan.koester / Linux

drivers/scsi/ibmvscsi/ibmvfc.c

+18 −11

Original line number	Diff line number	Diff line
		@@ -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,6 +3129,7 @@ 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,
		@@ -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)