scsi_device.h 21 KB

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