^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) /* SPDX-License-Identifier: GPL-2.0 */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) #ifndef _SCSI_SCSI_DEVICE_H
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) #define _SCSI_SCSI_DEVICE_H
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) #include <linux/list.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) #include <linux/spinlock.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) #include <linux/workqueue.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) #include <linux/blkdev.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) #include <scsi/scsi.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) #include <linux/atomic.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) #include <linux/android_kabi.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) struct device;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) struct request_queue;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) struct scsi_cmnd;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) struct scsi_lun;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) struct scsi_sense_hdr;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) typedef __u64 __bitwise blist_flags_t;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) #define SCSI_SENSE_BUFFERSIZE 96
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) struct scsi_mode_data {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) __u32 length;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) __u16 block_descriptor_length;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) __u8 medium_type;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) __u8 device_specific;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) __u8 header_length;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) __u8 longlba:1;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) * sdev state: If you alter this, you also need to alter scsi_sysfs.c
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) * (for the ascii descriptions) and the state model enforcer:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) * scsi_lib:scsi_device_set_state().
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) enum scsi_device_state {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) SDEV_CREATED = 1, /* device created but not added to sysfs
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) * Only internal commands allowed (for inq) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) SDEV_RUNNING, /* device properly configured
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) * All commands allowed */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) SDEV_CANCEL, /* beginning to delete device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) * Only error handler commands allowed */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) SDEV_DEL, /* device deleted
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) * no commands allowed */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) SDEV_QUIESCE, /* Device quiescent. No block commands
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) * will be accepted, only specials (which
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) * originate in the mid-layer) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) SDEV_OFFLINE, /* Device offlined (by error handling or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) * user request */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) SDEV_TRANSPORT_OFFLINE, /* Offlined by transport class error handler */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) SDEV_BLOCK, /* Device blocked by scsi lld. No
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) * scsi commands from user or midlayer
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) * should be issued to the scsi
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) * lld. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) SDEV_CREATED_BLOCK, /* same as above but for created devices */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) enum scsi_scan_mode {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) SCSI_SCAN_INITIAL = 0,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) SCSI_SCAN_RESCAN,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) SCSI_SCAN_MANUAL,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) enum scsi_device_event {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) SDEV_EVT_MEDIA_CHANGE = 1, /* media has changed */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) SDEV_EVT_INQUIRY_CHANGE_REPORTED, /* 3F 03 UA reported */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) SDEV_EVT_CAPACITY_CHANGE_REPORTED, /* 2A 09 UA reported */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) SDEV_EVT_SOFT_THRESHOLD_REACHED_REPORTED, /* 38 07 UA reported */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) SDEV_EVT_MODE_PARAMETER_CHANGE_REPORTED, /* 2A 01 UA reported */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) SDEV_EVT_LUN_CHANGE_REPORTED, /* 3F 0E UA reported */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) SDEV_EVT_ALUA_STATE_CHANGE_REPORTED, /* 2A 06 UA reported */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) SDEV_EVT_POWER_ON_RESET_OCCURRED, /* 29 00 UA reported */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) SDEV_EVT_FIRST = SDEV_EVT_MEDIA_CHANGE,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) SDEV_EVT_LAST = SDEV_EVT_POWER_ON_RESET_OCCURRED,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) SDEV_EVT_MAXBITS = SDEV_EVT_LAST + 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) struct scsi_event {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) enum scsi_device_event evt_type;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) struct list_head node;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) /* put union of data structures, for non-simple event types,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) * here
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) /**
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) * struct scsi_vpd - SCSI Vital Product Data
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) * @rcu: For kfree_rcu().
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) * @len: Length in bytes of @data.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) * @data: VPD data as defined in various T10 SCSI standard documents.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) struct scsi_vpd {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) struct rcu_head rcu;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) int len;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) unsigned char data[];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) struct scsi_device {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) struct Scsi_Host *host;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) struct request_queue *request_queue;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) /* the next two are protected by the host->host_lock */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) struct list_head siblings; /* list of all devices on this host */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) struct list_head same_target_siblings; /* just the devices sharing same target id */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) atomic_t device_busy; /* commands actually active on LLDD */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) atomic_t device_blocked; /* Device returned QUEUE_FULL. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) atomic_t restarts;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) spinlock_t list_lock;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) struct list_head starved_entry;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) unsigned short queue_depth; /* How deep of a queue we want */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) unsigned short max_queue_depth; /* max queue depth */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) unsigned short last_queue_full_depth; /* These two are used by */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) unsigned short last_queue_full_count; /* scsi_track_queue_full() */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) unsigned long last_queue_full_time; /* last queue full time */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) unsigned long queue_ramp_up_period; /* ramp up period in jiffies */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) #define SCSI_DEFAULT_RAMP_UP_PERIOD (120 * HZ)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) unsigned long last_queue_ramp_up; /* last queue ramp up time */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) unsigned int id, channel;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) u64 lun;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) unsigned int manufacturer; /* Manufacturer of device, for using
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) * vendor-specific cmd's */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) unsigned sector_size; /* size in bytes */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) void *hostdata; /* available to low-level driver */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) unsigned char type;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) char scsi_level;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) char inq_periph_qual; /* PQ from INQUIRY data */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) struct mutex inquiry_mutex;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) unsigned char inquiry_len; /* valid bytes in 'inquiry' */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) unsigned char * inquiry; /* INQUIRY response data */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) const char * vendor; /* [back_compat] point into 'inquiry' ... */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) const char * model; /* ... after scan; point to static string */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) const char * rev; /* ... "nullnullnullnull" before scan */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) #define SCSI_VPD_PG_LEN 255
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144) struct scsi_vpd __rcu *vpd_pg0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) struct scsi_vpd __rcu *vpd_pg83;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) struct scsi_vpd __rcu *vpd_pg80;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) struct scsi_vpd __rcu *vpd_pg89;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) unsigned char current_tag; /* current tag */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) struct scsi_target *sdev_target; /* used only for single_lun */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151) blist_flags_t sdev_bflags; /* black/white flags as also found in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152) * scsi_devinfo.[hc]. For now used only to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 153) * pass settings from slave_alloc to scsi
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 154) * core. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 155) unsigned int eh_timeout; /* Error handling timeout */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 156) unsigned removable:1;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 157) unsigned changed:1; /* Data invalid due to media change */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 158) unsigned busy:1; /* Used to prevent races */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 159) unsigned lockable:1; /* Able to prevent media removal */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 160) unsigned locked:1; /* Media removal disabled */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 161) unsigned borken:1; /* Tell the Seagate driver to be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 162) * painfully slow on this device */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 163) unsigned disconnect:1; /* can disconnect */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 164) unsigned soft_reset:1; /* Uses soft reset option */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 165) unsigned sdtr:1; /* Device supports SDTR messages */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 166) unsigned wdtr:1; /* Device supports WDTR messages */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 167) unsigned ppr:1; /* Device supports PPR messages */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 168) unsigned tagged_supported:1; /* Supports SCSI-II tagged queuing */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 169) unsigned simple_tags:1; /* simple queue tag messages are enabled */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 170) unsigned was_reset:1; /* There was a bus reset on the bus for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 171) * this device */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 172) unsigned expecting_cc_ua:1; /* Expecting a CHECK_CONDITION/UNIT_ATTN
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 173) * because we did a bus reset. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 174) unsigned use_10_for_rw:1; /* first try 10-byte read / write */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 175) unsigned use_10_for_ms:1; /* first try 10-byte mode sense/select */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 176) unsigned set_dbd_for_ms:1; /* Set "DBD" field in mode sense */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 177) unsigned no_report_opcodes:1; /* no REPORT SUPPORTED OPERATION CODES */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 178) unsigned no_write_same:1; /* no WRITE SAME command */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 179) unsigned use_16_for_rw:1; /* Use read/write(16) over read/write(10) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 180) unsigned skip_ms_page_8:1; /* do not use MODE SENSE page 0x08 */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 181) unsigned skip_ms_page_3f:1; /* do not use MODE SENSE page 0x3f */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 182) unsigned skip_vpd_pages:1; /* do not read VPD pages */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 183) unsigned try_vpd_pages:1; /* attempt to read VPD pages */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 184) unsigned use_192_bytes_for_3f:1; /* ask for 192 bytes from page 0x3f */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 185) unsigned no_start_on_add:1; /* do not issue start on add */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 186) unsigned allow_restart:1; /* issue START_UNIT in error handler */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 187) unsigned manage_start_stop:1; /* Let HLD (sd) manage start/stop */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 188) unsigned start_stop_pwr_cond:1; /* Set power cond. in START_STOP_UNIT */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 189) unsigned no_uld_attach:1; /* disable connecting to upper level drivers */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 190) unsigned select_no_atn:1;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 191) unsigned fix_capacity:1; /* READ_CAPACITY is too high by 1 */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 192) unsigned guess_capacity:1; /* READ_CAPACITY might be too high by 1 */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 193) unsigned retry_hwerror:1; /* Retry HARDWARE_ERROR */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 194) unsigned last_sector_bug:1; /* do not use multisector accesses on
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 195) SD_LAST_BUGGY_SECTORS */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 196) unsigned no_read_disc_info:1; /* Avoid READ_DISC_INFO cmds */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 197) unsigned no_read_capacity_16:1; /* Avoid READ_CAPACITY_16 cmds */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 198) unsigned try_rc_10_first:1; /* Try READ_CAPACACITY_10 first */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 199) unsigned security_supported:1; /* Supports Security Protocols */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 200) unsigned is_visible:1; /* is the device visible in sysfs */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 201) unsigned wce_default_on:1; /* Cache is ON by default */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 202) unsigned no_dif:1; /* T10 PI (DIF) should be disabled */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 203) unsigned broken_fua:1; /* Don't set FUA bit */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 204) unsigned lun_in_cdb:1; /* Store LUN bits in CDB[1] */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 205) unsigned unmap_limit_for_ws:1; /* Use the UNMAP limit for WRITE SAME */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 206) unsigned rpm_autosuspend:1; /* Enable runtime autosuspend at device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 207) * creation time */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 208)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 209) bool offline_already; /* Device offline message logged */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 210)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 211) atomic_t disk_events_disable_depth; /* disable depth for disk events */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 212)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 213) DECLARE_BITMAP(supported_events, SDEV_EVT_MAXBITS); /* supported events */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 214) DECLARE_BITMAP(pending_events, SDEV_EVT_MAXBITS); /* pending events */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 215) struct list_head event_list; /* asserted events */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 216) struct work_struct event_work;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 217)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 218) unsigned int max_device_blocked; /* what device_blocked counts down from */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 219) #define SCSI_DEFAULT_DEVICE_BLOCKED 3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 220)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 221) atomic_t iorequest_cnt;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 222) atomic_t iodone_cnt;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 223) atomic_t ioerr_cnt;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 224)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 225) struct device sdev_gendev,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 226) sdev_dev;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 227)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 228) struct execute_work ew; /* used to get process context on put */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 229) struct work_struct requeue_work;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 230)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 231) struct scsi_device_handler *handler;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 232) void *handler_data;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 233)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 234) size_t dma_drain_len;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 235) void *dma_drain_buf;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 236)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 237) unsigned char access_state;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 238) struct mutex state_mutex;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 239) enum scsi_device_state sdev_state;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 240) struct task_struct *quiesced_by;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 241)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 242) ANDROID_KABI_RESERVE(1);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 243) ANDROID_KABI_RESERVE(2);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 244) ANDROID_KABI_RESERVE(3);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 245) ANDROID_KABI_RESERVE(4);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 246)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 247) unsigned long sdev_data[];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 248) } __attribute__((aligned(sizeof(unsigned long))));
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 249)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 250) #define to_scsi_device(d) \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 251) container_of(d, struct scsi_device, sdev_gendev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 252) #define class_to_sdev(d) \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 253) container_of(d, struct scsi_device, sdev_dev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 254) #define transport_class_to_sdev(class_dev) \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 255) to_scsi_device(class_dev->parent)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 256)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 257) #define sdev_dbg(sdev, fmt, a...) \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 258) dev_dbg(&(sdev)->sdev_gendev, fmt, ##a)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 259)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 260) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 261) * like scmd_printk, but the device name is passed in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 262) * as a string pointer
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 263) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 264) __printf(4, 5) void
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 265) sdev_prefix_printk(const char *, const struct scsi_device *, const char *,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 266) const char *, ...);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 267)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 268) #define sdev_printk(l, sdev, fmt, a...) \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 269) sdev_prefix_printk(l, sdev, NULL, fmt, ##a)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 270)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 271) __printf(3, 4) void
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 272) scmd_printk(const char *, const struct scsi_cmnd *, const char *, ...);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 273)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 274) #define scmd_dbg(scmd, fmt, a...) \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 275) do { \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 276) if ((scmd)->request->rq_disk) \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 277) sdev_dbg((scmd)->device, "[%s] " fmt, \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 278) (scmd)->request->rq_disk->disk_name, ##a);\
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 279) else \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 280) sdev_dbg((scmd)->device, fmt, ##a); \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 281) } while (0)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 282)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 283) enum scsi_target_state {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 284) STARGET_CREATED = 1,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 285) STARGET_RUNNING,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 286) STARGET_REMOVE,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 287) STARGET_CREATED_REMOVE,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 288) STARGET_DEL,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 289) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 290)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 291) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 292) * scsi_target: representation of a scsi target, for now, this is only
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 293) * used for single_lun devices. If no one has active IO to the target,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 294) * starget_sdev_user is NULL, else it points to the active sdev.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 295) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 296) struct scsi_target {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 297) struct scsi_device *starget_sdev_user;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 298) struct list_head siblings;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 299) struct list_head devices;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 300) struct device dev;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 301) struct kref reap_ref; /* last put renders target invisible */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 302) unsigned int channel;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 303) unsigned int id; /* target id ... replace
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 304) * scsi_device.id eventually */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 305) unsigned int create:1; /* signal that it needs to be added */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 306) unsigned int single_lun:1; /* Indicates we should only
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 307) * allow I/O to one of the luns
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 308) * for the device at a time. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 309) unsigned int pdt_1f_for_no_lun:1; /* PDT = 0x1f
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 310) * means no lun present. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 311) unsigned int no_report_luns:1; /* Don't use
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 312) * REPORT LUNS for scanning. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 313) unsigned int expecting_lun_change:1; /* A device has reported
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 314) * a 3F/0E UA, other devices on
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 315) * the same target will also. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 316) /* commands actually active on LLD. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 317) atomic_t target_busy;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 318) atomic_t target_blocked;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 319)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 320) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 321) * LLDs should set this in the slave_alloc host template callout.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 322) * If set to zero then there is not limit.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 323) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 324) unsigned int can_queue;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 325) unsigned int max_target_blocked;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 326) #define SCSI_DEFAULT_TARGET_BLOCKED 3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 327)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 328) char scsi_level;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 329) enum scsi_target_state state;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 330) void *hostdata; /* available to low-level driver */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 331) unsigned long starget_data[]; /* for the transport */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 332) /* starget_data must be the last element!!!! */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 333) } __attribute__((aligned(sizeof(unsigned long))));
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 334)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 335) #define to_scsi_target(d) container_of(d, struct scsi_target, dev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 336) static inline struct scsi_target *scsi_target(struct scsi_device *sdev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 337) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 338) return to_scsi_target(sdev->sdev_gendev.parent);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 339) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 340) #define transport_class_to_starget(class_dev) \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 341) to_scsi_target(class_dev->parent)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 342)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 343) #define starget_printk(prefix, starget, fmt, a...) \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 344) dev_printk(prefix, &(starget)->dev, fmt, ##a)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 345)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 346) extern struct scsi_device *__scsi_add_device(struct Scsi_Host *,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 347) uint, uint, u64, void *hostdata);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 348) extern int scsi_add_device(struct Scsi_Host *host, uint channel,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 349) uint target, u64 lun);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 350) extern int scsi_register_device_handler(struct scsi_device_handler *scsi_dh);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 351) extern void scsi_remove_device(struct scsi_device *);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 352) extern int scsi_unregister_device_handler(struct scsi_device_handler *scsi_dh);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 353) void scsi_attach_vpd(struct scsi_device *sdev);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 354)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 355) extern struct scsi_device *scsi_device_from_queue(struct request_queue *q);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 356) extern int __must_check scsi_device_get(struct scsi_device *);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 357) extern void scsi_device_put(struct scsi_device *);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 358) extern struct scsi_device *scsi_device_lookup(struct Scsi_Host *,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 359) uint, uint, u64);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 360) extern struct scsi_device *__scsi_device_lookup(struct Scsi_Host *,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 361) uint, uint, u64);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 362) extern struct scsi_device *scsi_device_lookup_by_target(struct scsi_target *,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 363) u64);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 364) extern struct scsi_device *__scsi_device_lookup_by_target(struct scsi_target *,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 365) u64);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 366) extern void starget_for_each_device(struct scsi_target *, void *,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 367) void (*fn)(struct scsi_device *, void *));
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 368) extern void __starget_for_each_device(struct scsi_target *, void *,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 369) void (*fn)(struct scsi_device *,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 370) void *));
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 371)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 372) /* only exposed to implement shost_for_each_device */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 373) extern struct scsi_device *__scsi_iterate_devices(struct Scsi_Host *,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 374) struct scsi_device *);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 375)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 376) /**
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 377) * shost_for_each_device - iterate over all devices of a host
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 378) * @sdev: the &struct scsi_device to use as a cursor
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 379) * @shost: the &struct scsi_host to iterate over
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 380) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 381) * Iterator that returns each device attached to @shost. This loop
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 382) * takes a reference on each device and releases it at the end. If
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 383) * you break out of the loop, you must call scsi_device_put(sdev).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 384) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 385) #define shost_for_each_device(sdev, shost) \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 386) for ((sdev) = __scsi_iterate_devices((shost), NULL); \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 387) (sdev); \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 388) (sdev) = __scsi_iterate_devices((shost), (sdev)))
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 389)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 390) /**
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 391) * __shost_for_each_device - iterate over all devices of a host (UNLOCKED)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 392) * @sdev: the &struct scsi_device to use as a cursor
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 393) * @shost: the &struct scsi_host to iterate over
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 394) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 395) * Iterator that returns each device attached to @shost. It does _not_
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 396) * take a reference on the scsi_device, so the whole loop must be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 397) * protected by shost->host_lock.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 398) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 399) * Note: The only reason to use this is because you need to access the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 400) * device list in interrupt context. Otherwise you really want to use
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 401) * shost_for_each_device instead.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 402) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 403) #define __shost_for_each_device(sdev, shost) \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 404) list_for_each_entry((sdev), &((shost)->__devices), siblings)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 405)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 406) extern int scsi_change_queue_depth(struct scsi_device *, int);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 407) extern int scsi_track_queue_full(struct scsi_device *, int);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 408)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 409) extern int scsi_set_medium_removal(struct scsi_device *, char);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 410)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 411) extern int scsi_mode_sense(struct scsi_device *sdev, int dbd, int modepage,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 412) unsigned char *buffer, int len, int timeout,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 413) int retries, struct scsi_mode_data *data,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 414) struct scsi_sense_hdr *);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 415) extern int scsi_mode_select(struct scsi_device *sdev, int pf, int sp,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 416) int modepage, unsigned char *buffer, int len,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 417) int timeout, int retries,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 418) struct scsi_mode_data *data,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 419) struct scsi_sense_hdr *);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 420) extern int scsi_test_unit_ready(struct scsi_device *sdev, int timeout,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 421) int retries, struct scsi_sense_hdr *sshdr);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 422) extern int scsi_get_vpd_page(struct scsi_device *, u8 page, unsigned char *buf,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 423) int buf_len);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 424) extern int scsi_report_opcode(struct scsi_device *sdev, unsigned char *buffer,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 425) unsigned int len, unsigned char opcode);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 426) extern int scsi_device_set_state(struct scsi_device *sdev,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 427) enum scsi_device_state state);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 428) extern struct scsi_event *sdev_evt_alloc(enum scsi_device_event evt_type,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 429) gfp_t gfpflags);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 430) extern void sdev_evt_send(struct scsi_device *sdev, struct scsi_event *evt);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 431) extern void sdev_evt_send_simple(struct scsi_device *sdev,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 432) enum scsi_device_event evt_type, gfp_t gfpflags);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 433) extern int scsi_device_quiesce(struct scsi_device *sdev);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 434) extern void scsi_device_resume(struct scsi_device *sdev);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 435) extern void scsi_target_quiesce(struct scsi_target *);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 436) extern void scsi_target_resume(struct scsi_target *);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 437) extern void scsi_scan_target(struct device *parent, unsigned int channel,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 438) unsigned int id, u64 lun,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 439) enum scsi_scan_mode rescan);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 440) extern void scsi_target_reap(struct scsi_target *);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 441) extern void scsi_target_block(struct device *);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 442) extern void scsi_target_unblock(struct device *, enum scsi_device_state);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 443) extern void scsi_remove_target(struct device *);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 444) extern const char *scsi_device_state_name(enum scsi_device_state);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 445) extern int scsi_is_sdev_device(const struct device *);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 446) extern int scsi_is_target_device(const struct device *);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 447) extern void scsi_sanitize_inquiry_string(unsigned char *s, int len);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 448) extern int __scsi_execute(struct scsi_device *sdev, const unsigned char *cmd,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 449) int data_direction, void *buffer, unsigned bufflen,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 450) unsigned char *sense, struct scsi_sense_hdr *sshdr,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 451) int timeout, int retries, u64 flags,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 452) req_flags_t rq_flags, int *resid);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 453) /* Make sure any sense buffer is the correct size. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 454) #define scsi_execute(sdev, cmd, data_direction, buffer, bufflen, sense, \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 455) sshdr, timeout, retries, flags, rq_flags, resid) \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 456) ({ \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 457) BUILD_BUG_ON((sense) != NULL && \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 458) sizeof(sense) != SCSI_SENSE_BUFFERSIZE); \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 459) __scsi_execute(sdev, cmd, data_direction, buffer, bufflen, \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 460) sense, sshdr, timeout, retries, flags, rq_flags, \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 461) resid); \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 462) })
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 463) static inline int scsi_execute_req(struct scsi_device *sdev,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 464) const unsigned char *cmd, int data_direction, void *buffer,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 465) unsigned bufflen, struct scsi_sense_hdr *sshdr, int timeout,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 466) int retries, int *resid)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 467) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 468) return scsi_execute(sdev, cmd, data_direction, buffer,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 469) bufflen, NULL, sshdr, timeout, retries, 0, 0, resid);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 470) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 471) extern void sdev_disable_disk_events(struct scsi_device *sdev);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 472) extern void sdev_enable_disk_events(struct scsi_device *sdev);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 473) extern int scsi_vpd_lun_id(struct scsi_device *, char *, size_t);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 474) extern int scsi_vpd_tpg_id(struct scsi_device *, int *);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 475)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 476) #ifdef CONFIG_PM
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 477) extern int scsi_autopm_get_device(struct scsi_device *);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 478) extern void scsi_autopm_put_device(struct scsi_device *);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 479) #else
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 480) static inline int scsi_autopm_get_device(struct scsi_device *d) { return 0; }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 481) static inline void scsi_autopm_put_device(struct scsi_device *d) {}
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 482) #endif /* CONFIG_PM */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 483)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 484) static inline int __must_check scsi_device_reprobe(struct scsi_device *sdev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 485) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 486) return device_reprobe(&sdev->sdev_gendev);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 487) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 488)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 489) static inline unsigned int sdev_channel(struct scsi_device *sdev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 490) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 491) return sdev->channel;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 492) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 493)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 494) static inline unsigned int sdev_id(struct scsi_device *sdev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 495) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 496) return sdev->id;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 497) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 498)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 499) #define scmd_id(scmd) sdev_id((scmd)->device)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 500) #define scmd_channel(scmd) sdev_channel((scmd)->device)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 501)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 502) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 503) * checks for positions of the SCSI state machine
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 504) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 505) static inline int scsi_device_online(struct scsi_device *sdev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 506) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 507) return (sdev->sdev_state != SDEV_OFFLINE &&
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 508) sdev->sdev_state != SDEV_TRANSPORT_OFFLINE &&
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 509) sdev->sdev_state != SDEV_DEL);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 510) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 511) static inline int scsi_device_blocked(struct scsi_device *sdev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 512) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 513) return sdev->sdev_state == SDEV_BLOCK ||
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 514) sdev->sdev_state == SDEV_CREATED_BLOCK;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 515) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 516) static inline int scsi_device_created(struct scsi_device *sdev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 517) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 518) return sdev->sdev_state == SDEV_CREATED ||
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 519) sdev->sdev_state == SDEV_CREATED_BLOCK;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 520) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 521)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 522) int scsi_internal_device_block_nowait(struct scsi_device *sdev);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 523) int scsi_internal_device_unblock_nowait(struct scsi_device *sdev,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 524) enum scsi_device_state new_state);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 525)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 526) /* accessor functions for the SCSI parameters */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 527) static inline int scsi_device_sync(struct scsi_device *sdev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 528) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 529) return sdev->sdtr;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 530) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 531) static inline int scsi_device_wide(struct scsi_device *sdev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 532) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 533) return sdev->wdtr;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 534) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 535) static inline int scsi_device_dt(struct scsi_device *sdev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 536) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 537) return sdev->ppr;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 538) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 539) static inline int scsi_device_dt_only(struct scsi_device *sdev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 540) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 541) if (sdev->inquiry_len < 57)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 542) return 0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 543) return (sdev->inquiry[56] & 0x0c) == 0x04;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 544) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 545) static inline int scsi_device_ius(struct scsi_device *sdev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 546) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 547) if (sdev->inquiry_len < 57)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 548) return 0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 549) return sdev->inquiry[56] & 0x01;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 550) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 551) static inline int scsi_device_qas(struct scsi_device *sdev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 552) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 553) if (sdev->inquiry_len < 57)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 554) return 0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 555) return sdev->inquiry[56] & 0x02;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 556) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 557) static inline int scsi_device_enclosure(struct scsi_device *sdev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 558) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 559) return sdev->inquiry ? (sdev->inquiry[6] & (1<<6)) : 1;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 560) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 561)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 562) static inline int scsi_device_protection(struct scsi_device *sdev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 563) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 564) if (sdev->no_dif)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 565) return 0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 566)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 567) return sdev->scsi_level > SCSI_2 && sdev->inquiry[5] & (1<<0);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 568) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 569)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 570) static inline int scsi_device_tpgs(struct scsi_device *sdev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 571) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 572) return sdev->inquiry ? (sdev->inquiry[5] >> 4) & 0x3 : 0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 573) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 574)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 575) /**
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 576) * scsi_device_supports_vpd - test if a device supports VPD pages
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 577) * @sdev: the &struct scsi_device to test
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 578) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 579) * If the 'try_vpd_pages' flag is set it takes precedence.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 580) * Otherwise we will assume VPD pages are supported if the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 581) * SCSI level is at least SPC-3 and 'skip_vpd_pages' is not set.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 582) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 583) static inline int scsi_device_supports_vpd(struct scsi_device *sdev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 584) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 585) /* Attempt VPD inquiry if the device blacklist explicitly calls
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 586) * for it.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 587) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 588) if (sdev->try_vpd_pages)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 589) return 1;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 590) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 591) * Although VPD inquiries can go to SCSI-2 type devices,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 592) * some USB ones crash on receiving them, and the pages
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 593) * we currently ask for are mandatory for SPC-2 and beyond
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 594) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 595) if (sdev->scsi_level >= SCSI_SPC_2 && !sdev->skip_vpd_pages)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 596) return 1;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 597) return 0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 598) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 599)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 600) #define MODULE_ALIAS_SCSI_DEVICE(type) \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 601) MODULE_ALIAS("scsi:t-" __stringify(type) "*")
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 602) #define SCSI_DEVICE_MODALIAS_FMT "scsi:t-0x%02x"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 603)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 604) #endif /* _SCSI_SCSI_DEVICE_H */
Orange Pi5 kernel
Deprecated Linux kernel 5.10.110 for OrangePi 5/5B/5+ boards
3 Commits
0 Branches
0 Tags