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