include/scsi/scsi_host.h

1 /* SPDX-License-Identifier: GPL-2.0 */
11 #include <linux/blk-mq.h>
31  * enum scsi_timeout_action - How to handle a command that timed out.
49 	 * Additional per-command data allocated for the driver.
77          * For compatibility, any other non-zero return is treated the
123 	 * When unknown ioctl is passed return -ENOIOCTLCMD.
136 	 * define one of these if you don't want to - there is a default
139 	 * own strategy routine, this is where it is specified.  Note - the
159 	 * Before the mid layer attempts to scan for a new device where none
168 	 * Return values: 0 on success, non-0 on failure
191 	 * depth on the device.  All other tasks are optional and depend
196 	 * 1.  Setting the device queue depth.  Proper setting of this is
202 	 *     device->sdtr will be true if the device supports SDTR messages.
207 	 * 6.  Return 0 on success, non-0 on error.  The device will be marked
209 	 *     non-0, your slave_destroy routine will never get called for this
211 	 *     up after yourself before returning non-0
219 	 * has ceased the mid layer calls this point so that the low level
229 	 * Before the mid layer attempts to scan for a new device attached
236 	 * Return values: 0 on success, non-0 on failure
276 	 * Fill in this function to allow the queue depth of this host
278 	 * the current queue depth setting (may be different from what
280 	 * returned if the requested depth is legal but the driver was
281 	 * unable to set it.  If the requested depth is illegal, the
282 	 * driver should set and return the closest legal queue depth.
290 	 * to the block layer.
297 	 * SCSI interface of blk_poll - poll for IO completions.
360 	 * Return values: 0 on success, -ve value on failure.
376 	 * This determines if we will use a non-interrupt driven
385 	 * the case, then it must be reserved.  Please set this_id to -1 if
393 	 * of scatter-gather.
420 	 * individual devices (e.g. 256 for SCSI-1).
435 	/* If use block layer to manage tags, this is tag allocation policy */
439 	 * Track QUEUE_FULL events and reduce queue depth on demand.
454 	 * True if the low-level driver performs its own reset-settle delays.
461 	/* True if the host uses host-wide tagspace */
516 		spin_lock_irqsave(shost->host_lock, irq_flags);		\
518 		spin_unlock_irqrestore(shost->host_lock, irq_flags);	\
623 	 * In scsi-mq mode, the number of hardware queues supported by the LLD.
625 	 * Note: it is assumed that each hardware queue has a queue depth of
626 	 * can_queue. In other words, the total queue depth per host
628 	 * the total queue depth is can_queue.
659 	/* True if the host uses host-wide tagspace */
729 	dev_printk(prefix, &(shost)->shost_gendev, fmt, ##a)
733 	return (void *)shost->hostdata;  in shost_priv()
741 		if (!dev->parent)  in dev_to_shost()
743 		dev = dev->parent;  in dev_to_shost()
750 	return shost->shost_state == SHOST_RECOVERY ||  in scsi_host_in_recovery()
751 		shost->shost_state == SHOST_CANCEL_RECOVERY ||  in scsi_host_in_recovery()
752 		shost->shost_state == SHOST_DEL_RECOVERY ||  in scsi_host_in_recovery()
753 		shost->tmf_in_progress;  in scsi_host_in_recovery()
788         return shost->shost_gendev.parent;  in scsi_get_device()
792  * scsi_host_scan_allowed - Is scanning of this host allowed
797 	return shost->shost_state == SHOST_RUNNING ||  in scsi_host_scan_allowed()
798 	       shost->shost_state == SHOST_RECOVERY;  in scsi_host_scan_allowed()
836 	shost->prot_capabilities = mask;  in scsi_host_set_prot()
841 	return shost->prot_capabilities;  in scsi_host_get_prot()
846 	return shost->prot_capabilities >= SHOST_DIX_TYPE0_PROTECTION;  in scsi_host_prot_dma()
859 	return shost->prot_capabilities & cap[target_type] ? target_type : 0;  in scsi_host_dif_capable()
873 	return shost->prot_capabilities & cap[target_type];  in scsi_host_dix_capable()
879  * All DIX-capable initiators must support the T10-mandated CRC
894 	shost->prot_guard_type = type;  in scsi_host_set_guard()
899 	return shost->prot_guard_type;  in scsi_host_get_guard()