scsi_device.h 19.9 KB
Newer Older
Linus Torvalds's avatar
Linus Torvalds committed
1 2 3 4 5
#ifndef _SCSI_SCSI_DEVICE_H
#define _SCSI_SCSI_DEVICE_H

#include <linux/list.h>
#include <linux/spinlock.h>
6
#include <linux/workqueue.h>
7
#include <linux/blkdev.h>
8
#include <scsi/scsi.h>
9
#include <linux/atomic.h>
Linus Torvalds's avatar
Linus Torvalds committed
10

11
struct device;
Linus Torvalds's avatar
Linus Torvalds committed
12 13
struct request_queue;
struct scsi_cmnd;
14
struct scsi_lun;
15
struct scsi_sense_hdr;
Linus Torvalds's avatar
Linus Torvalds committed
16

17 18 19 20 21 22 23 24 25
struct scsi_mode_data {
	__u32	length;
	__u16	block_descriptor_length;
	__u8	medium_type;
	__u8	device_specific;
	__u8	header_length;
	__u8	longlba:1;
};

Linus Torvalds's avatar
Linus Torvalds committed
26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44
/*
 * sdev state: If you alter this, you also need to alter scsi_sysfs.c
 * (for the ascii descriptions) and the state model enforcer:
 * scsi_lib:scsi_device_set_state().
 */
enum scsi_device_state {
	SDEV_CREATED = 1,	/* device created but not added to sysfs
				 * Only internal commands allowed (for inq) */
	SDEV_RUNNING,		/* device properly configured
				 * All commands allowed */
	SDEV_CANCEL,		/* beginning to delete device
				 * Only error handler commands allowed */
	SDEV_DEL,		/* device deleted 
				 * no commands allowed */
	SDEV_QUIESCE,		/* Device quiescent.  No block commands
				 * will be accepted, only specials (which
				 * originate in the mid-layer) */
	SDEV_OFFLINE,		/* Device offlined (by error handling or
				 * user request */
45
	SDEV_TRANSPORT_OFFLINE,	/* Offlined by transport class error handler */
46 47 48 49 50
	SDEV_BLOCK,		/* Device blocked by scsi lld.  No
				 * scsi commands from user or midlayer
				 * should be issued to the scsi
				 * lld. */
	SDEV_CREATED_BLOCK,	/* same as above but for created devices */
Linus Torvalds's avatar
Linus Torvalds committed
51 52
};

53 54 55 56 57 58
enum scsi_scan_mode {
	SCSI_SCAN_INITIAL = 0,
	SCSI_SCAN_RESCAN,
	SCSI_SCAN_MANUAL,
};

59 60
enum scsi_device_event {
	SDEV_EVT_MEDIA_CHANGE	= 1,	/* media has changed */
61 62 63 64 65
	SDEV_EVT_INQUIRY_CHANGE_REPORTED,		/* 3F 03  UA reported */
	SDEV_EVT_CAPACITY_CHANGE_REPORTED,		/* 2A 09  UA reported */
	SDEV_EVT_SOFT_THRESHOLD_REACHED_REPORTED,	/* 38 07  UA reported */
	SDEV_EVT_MODE_PARAMETER_CHANGE_REPORTED,	/* 2A 01  UA reported */
	SDEV_EVT_LUN_CHANGE_REPORTED,			/* 3F 0E  UA reported */
66
	SDEV_EVT_ALUA_STATE_CHANGE_REPORTED,		/* 2A 06  UA reported */
67 68

	SDEV_EVT_FIRST		= SDEV_EVT_MEDIA_CHANGE,
69
	SDEV_EVT_LAST		= SDEV_EVT_ALUA_STATE_CHANGE_REPORTED,
70 71 72 73 74 75 76 77 78 79 80 81 82

	SDEV_EVT_MAXBITS	= SDEV_EVT_LAST + 1
};

struct scsi_event {
	enum scsi_device_event	evt_type;
	struct list_head	node;

	/* put union of data structures, for non-simple event types,
	 * here
	 */
};

Linus Torvalds's avatar
Linus Torvalds committed
83 84 85 86 87 88 89 90
struct scsi_device {
	struct Scsi_Host *host;
	struct request_queue *request_queue;

	/* the next two are protected by the host->host_lock */
	struct list_head    siblings;   /* list of all devices on this host */
	struct list_head    same_target_siblings; /* just the devices sharing same target id */

91
	atomic_t device_busy;		/* commands actually active on LLDD */
92 93
	atomic_t device_blocked;	/* Device returned QUEUE_FULL. */

Linus Torvalds's avatar
Linus Torvalds committed
94 95 96 97
	spinlock_t list_lock;
	struct list_head cmd_list;	/* queue of in use SCSI Command structures */
	struct list_head starved_entry;
	unsigned short queue_depth;	/* How deep of a queue we want */
98
	unsigned short max_queue_depth;	/* max queue depth */
Linus Torvalds's avatar
Linus Torvalds committed
99 100
	unsigned short last_queue_full_depth; /* These two are used by */
	unsigned short last_queue_full_count; /* scsi_track_queue_full() */
101 102 103 104 105
	unsigned long last_queue_full_time;	/* last queue full time */
	unsigned long queue_ramp_up_period;	/* ramp up period in jiffies */
#define SCSI_DEFAULT_RAMP_UP_PERIOD	(120 * HZ)

	unsigned long last_queue_ramp_up;	/* last queue ramp up time */
Linus Torvalds's avatar
Linus Torvalds committed
106

Hannes Reinecke's avatar
Hannes Reinecke committed
107 108
	unsigned int id, channel;
	u64 lun;
Linus Torvalds's avatar
Linus Torvalds committed
109 110 111 112 113 114 115 116
	unsigned int manufacturer;	/* Manufacturer of device, for using 
					 * vendor-specific cmd's */
	unsigned sector_size;	/* size in bytes */

	void *hostdata;		/* available to low-level driver */
	char type;
	char scsi_level;
	char inq_periph_qual;	/* PQ from INQUIRY data */	
117
	struct mutex inquiry_mutex;
Linus Torvalds's avatar
Linus Torvalds committed
118 119
	unsigned char inquiry_len;	/* valid bytes in 'inquiry' */
	unsigned char * inquiry;	/* INQUIRY response data */
120 121 122
	const char * vendor;		/* [back_compat] point into 'inquiry' ... */
	const char * model;		/* ... after scan; point to static string */
	const char * rev;		/* ... "nullnullnullnull" before scan */
123 124 125

#define SCSI_VPD_PG_LEN                255
	int vpd_pg83_len;
126
	unsigned char __rcu *vpd_pg83;
127
	int vpd_pg80_len;
128
	unsigned char __rcu *vpd_pg80;
Linus Torvalds's avatar
Linus Torvalds committed
129 130 131 132 133 134 135
	unsigned char current_tag;	/* current tag */
	struct scsi_target      *sdev_target;   /* used only for single_lun */

	unsigned int	sdev_bflags; /* black/white flags as also found in
				 * scsi_devinfo.[hc]. For now used only to
				 * pass settings from slave_alloc to scsi
				 * core. */
136
	unsigned int eh_timeout; /* Error handling timeout */
Linus Torvalds's avatar
Linus Torvalds committed
137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156
	unsigned removable:1;
	unsigned changed:1;	/* Data invalid due to media change */
	unsigned busy:1;	/* Used to prevent races */
	unsigned lockable:1;	/* Able to prevent media removal */
	unsigned locked:1;      /* Media removal disabled */
	unsigned borken:1;	/* Tell the Seagate driver to be 
				 * painfully slow on this device */
	unsigned disconnect:1;	/* can disconnect */
	unsigned soft_reset:1;	/* Uses soft reset option */
	unsigned sdtr:1;	/* Device supports SDTR messages */
	unsigned wdtr:1;	/* Device supports WDTR messages */
	unsigned ppr:1;		/* Device supports PPR messages */
	unsigned tagged_supported:1;	/* Supports SCSI-II tagged queuing */
	unsigned simple_tags:1;	/* simple queue tag messages are enabled */
	unsigned was_reset:1;	/* There was a bus reset on the bus for 
				 * this device */
	unsigned expecting_cc_ua:1; /* Expecting a CHECK_CONDITION/UNIT_ATTN
				     * because we did a bus reset. */
	unsigned use_10_for_rw:1; /* first try 10-byte read / write */
	unsigned use_10_for_ms:1; /* first try 10-byte mode sense/select */
157
	unsigned no_report_opcodes:1;	/* no REPORT SUPPORTED OPERATION CODES */
158
	unsigned no_write_same:1;	/* no WRITE SAME command */
159
	unsigned use_16_for_rw:1; /* Use read/write(16) over read/write(10) */
Linus Torvalds's avatar
Linus Torvalds committed
160 161
	unsigned skip_ms_page_8:1;	/* do not use MODE SENSE page 0x08 */
	unsigned skip_ms_page_3f:1;	/* do not use MODE SENSE page 0x3f */
162
	unsigned skip_vpd_pages:1;	/* do not read VPD pages */
163
	unsigned try_vpd_pages:1;	/* attempt to read VPD pages */
Linus Torvalds's avatar
Linus Torvalds committed
164 165 166
	unsigned use_192_bytes_for_3f:1; /* ask for 192 bytes from page 0x3f */
	unsigned no_start_on_add:1;	/* do not issue start on add */
	unsigned allow_restart:1; /* issue START_UNIT in error handler */
167
	unsigned manage_start_stop:1;	/* Let HLD (sd) manage start/stop */
168
	unsigned start_stop_pwr_cond:1;	/* Set power cond. in START_STOP_UNIT */
Linus Torvalds's avatar
Linus Torvalds committed
169 170 171
	unsigned no_uld_attach:1; /* disable connecting to upper level drivers */
	unsigned select_no_atn:1;
	unsigned fix_capacity:1;	/* READ_CAPACITY is too high by 1 */
172
	unsigned guess_capacity:1;	/* READ_CAPACITY might be too high by 1 */
Linus Torvalds's avatar
Linus Torvalds committed
173
	unsigned retry_hwerror:1;	/* Retry HARDWARE_ERROR */
174 175
	unsigned last_sector_bug:1;	/* do not use multisector accesses on
					   SD_LAST_BUGGY_SECTORS */
176
	unsigned no_read_disc_info:1;	/* Avoid READ_DISC_INFO cmds */
177
	unsigned no_read_capacity_16:1; /* Avoid READ_CAPACITY_16 cmds */
178
	unsigned try_rc_10_first:1;	/* Try READ_CAPACACITY_10 first */
179
	unsigned is_visible:1;	/* is the device visible in sysfs */
180
	unsigned wce_default_on:1;	/* Cache is ON by default */
181
	unsigned no_dif:1;	/* T10 PI (DIF) should be disabled */
182
	unsigned broken_fua:1;		/* Don't set FUA bit */
183
	unsigned lun_in_cdb:1;		/* Store LUN bits in CDB[1] */
184
	unsigned synchronous_alua:1;	/* Synchronous ALUA commands */
Linus Torvalds's avatar
Linus Torvalds committed
185

186 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 191 192
	struct list_head event_list;	/* asserted events */
	struct work_struct event_work;

Linus Torvalds's avatar
Linus Torvalds committed
193 194 195 196 197 198 199
	unsigned int max_device_blocked; /* what device_blocked counts down from  */
#define SCSI_DEFAULT_DEVICE_BLOCKED	3

	atomic_t iorequest_cnt;
	atomic_t iodone_cnt;
	atomic_t ioerr_cnt;

200 201
	struct device		sdev_gendev,
				sdev_dev;
Linus Torvalds's avatar
Linus Torvalds committed
202

203
	struct execute_work	ew; /* used to get process context on put */
204
	struct work_struct	requeue_work;
205

206 207 208
	struct scsi_device_handler *handler;
	void			*handler_data;

209
	unsigned char		access_state;
Linus Torvalds's avatar
Linus Torvalds committed
210 211 212
	enum scsi_device_state sdev_state;
	unsigned long		sdev_data[0];
} __attribute__((aligned(sizeof(unsigned long))));
213

Linus Torvalds's avatar
Linus Torvalds committed
214 215 216
#define	to_scsi_device(d)	\
	container_of(d, struct scsi_device, sdev_gendev)
#define	class_to_sdev(d)	\
217
	container_of(d, struct scsi_device, sdev_dev)
Linus Torvalds's avatar
Linus Torvalds committed
218
#define transport_class_to_sdev(class_dev) \
219
	to_scsi_device(class_dev->parent)
Linus Torvalds's avatar
Linus Torvalds committed
220

221 222 223
#define sdev_dbg(sdev, fmt, a...) \
	dev_dbg(&(sdev)->sdev_gendev, fmt, ##a)

224 225 226 227
/*
 * like scmd_printk, but the device name is passed in
 * as a string pointer
 */
228
__printf(4, 5) void
229 230
sdev_prefix_printk(const char *, const struct scsi_device *, const char *,
		const char *, ...);
231 232 233 234

#define sdev_printk(l, sdev, fmt, a...)				\
	sdev_prefix_printk(l, sdev, NULL, fmt, ##a)

235
__printf(3, 4) void
236
scmd_printk(const char *, const struct scsi_cmnd *, const char *, ...);
237

238 239 240 241 242 243 244 245 246
#define scmd_dbg(scmd, fmt, a...)					   \
	do {								   \
		if ((scmd)->request->rq_disk)				   \
			sdev_dbg((scmd)->device, "[%s] " fmt,		   \
				 (scmd)->request->rq_disk->disk_name, ##a);\
		else							   \
			sdev_dbg((scmd)->device, fmt, ##a);		   \
	} while (0)

247
enum scsi_target_state {
248 249
	STARGET_CREATED = 1,
	STARGET_RUNNING,
250
	STARGET_REMOVE,
251 252 253
	STARGET_DEL,
};

Linus Torvalds's avatar
Linus Torvalds committed
254 255 256 257 258 259 260 261 262 263
/*
 * scsi_target: representation of a scsi target, for now, this is only
 * used for single_lun devices. If no one has active IO to the target,
 * starget_sdev_user is NULL, else it points to the active sdev.
 */
struct scsi_target {
	struct scsi_device	*starget_sdev_user;
	struct list_head	siblings;
	struct list_head	devices;
	struct device		dev;
264
	struct kref		reap_ref; /* last put renders target invisible */
Linus Torvalds's avatar
Linus Torvalds committed
265 266 267
	unsigned int		channel;
	unsigned int		id; /* target id ... replace
				     * scsi_device.id eventually */
268
	unsigned int		create:1; /* signal that it needs to be added */
269 270 271
	unsigned int		single_lun:1;	/* Indicates we should only
						 * allow I/O to one of the luns
						 * for the device at a time. */
272 273
	unsigned int		pdt_1f_for_no_lun:1;	/* PDT = 0x1f
						 * means no lun present. */
274 275
	unsigned int		no_report_luns:1;	/* Don't use
						 * REPORT LUNS for scanning. */
276 277 278
	unsigned int		expecting_lun_change:1;	/* A device has reported
						 * a 3F/0E UA, other devices on
						 * the same target will also. */
279 280
	/* commands actually active on LLD. */
	atomic_t		target_busy;
281 282
	atomic_t		target_blocked;

283 284 285 286 287 288 289
	/*
	 * LLDs should set this in the slave_alloc host template callout.
	 * If set to zero then there is not limit.
	 */
	unsigned int		can_queue;
	unsigned int		max_target_blocked;
#define SCSI_DEFAULT_TARGET_BLOCKED	3
290

291
	char			scsi_level;
292
	enum scsi_target_state	state;
293 294 295
	void 			*hostdata; /* available to low-level driver */
	unsigned long		starget_data[0]; /* for the transport */
	/* starget_data must be the last element!!!! */
Linus Torvalds's avatar
Linus Torvalds committed
296 297 298 299 300 301 302 303
} __attribute__((aligned(sizeof(unsigned long))));

#define to_scsi_target(d)	container_of(d, struct scsi_target, dev)
static inline struct scsi_target *scsi_target(struct scsi_device *sdev)
{
	return to_scsi_target(sdev->sdev_gendev.parent);
}
#define transport_class_to_starget(class_dev) \
304
	to_scsi_target(class_dev->parent)
Linus Torvalds's avatar
Linus Torvalds committed
305

306 307 308
#define starget_printk(prefix, starget, fmt, a...)	\
	dev_printk(prefix, &(starget)->dev, fmt, ##a)

Linus Torvalds's avatar
Linus Torvalds committed
309
extern struct scsi_device *__scsi_add_device(struct Scsi_Host *,
Hannes Reinecke's avatar
Hannes Reinecke committed
310
		uint, uint, u64, void *hostdata);
311
extern int scsi_add_device(struct Scsi_Host *host, uint channel,
Hannes Reinecke's avatar
Hannes Reinecke committed
312
			   uint target, u64 lun);
313
extern int scsi_register_device_handler(struct scsi_device_handler *scsi_dh);
Linus Torvalds's avatar
Linus Torvalds committed
314
extern void scsi_remove_device(struct scsi_device *);
315
extern int scsi_unregister_device_handler(struct scsi_device_handler *scsi_dh);
316
void scsi_attach_vpd(struct scsi_device *sdev);
Linus Torvalds's avatar
Linus Torvalds committed
317 318 319 320

extern int scsi_device_get(struct scsi_device *);
extern void scsi_device_put(struct scsi_device *);
extern struct scsi_device *scsi_device_lookup(struct Scsi_Host *,
Hannes Reinecke's avatar
Hannes Reinecke committed
321
					      uint, uint, u64);
Linus Torvalds's avatar
Linus Torvalds committed
322
extern struct scsi_device *__scsi_device_lookup(struct Scsi_Host *,
Hannes Reinecke's avatar
Hannes Reinecke committed
323
						uint, uint, u64);
Linus Torvalds's avatar
Linus Torvalds committed
324
extern struct scsi_device *scsi_device_lookup_by_target(struct scsi_target *,
Hannes Reinecke's avatar
Hannes Reinecke committed
325
							u64);
Linus Torvalds's avatar
Linus Torvalds committed
326
extern struct scsi_device *__scsi_device_lookup_by_target(struct scsi_target *,
Hannes Reinecke's avatar
Hannes Reinecke committed
327
							  u64);
Linus Torvalds's avatar
Linus Torvalds committed
328 329
extern void starget_for_each_device(struct scsi_target *, void *,
		     void (*fn)(struct scsi_device *, void *));
330 331 332
extern void __starget_for_each_device(struct scsi_target *, void *,
				      void (*fn)(struct scsi_device *,
						 void *));
Linus Torvalds's avatar
Linus Torvalds committed
333 334 335 336 337 338

/* only exposed to implement shost_for_each_device */
extern struct scsi_device *__scsi_iterate_devices(struct Scsi_Host *,
						  struct scsi_device *);

/**
339 340 341
 * shost_for_each_device - iterate over all devices of a host
 * @sdev: the &struct scsi_device to use as a cursor
 * @shost: the &struct scsi_host to iterate over
Linus Torvalds's avatar
Linus Torvalds committed
342
 *
343 344 345
 * Iterator that returns each device attached to @shost.  This loop
 * takes a reference on each device and releases it at the end.  If
 * you break out of the loop, you must call scsi_device_put(sdev).
Linus Torvalds's avatar
Linus Torvalds committed
346 347 348 349 350 351 352
 */
#define shost_for_each_device(sdev, shost) \
	for ((sdev) = __scsi_iterate_devices((shost), NULL); \
	     (sdev); \
	     (sdev) = __scsi_iterate_devices((shost), (sdev)))

/**
353 354 355
 * __shost_for_each_device - iterate over all devices of a host (UNLOCKED)
 * @sdev: the &struct scsi_device to use as a cursor
 * @shost: the &struct scsi_host to iterate over
Linus Torvalds's avatar
Linus Torvalds committed
356
 *
357 358 359
 * Iterator that returns each device attached to @shost.  It does _not_
 * take a reference on the scsi_device, so the whole loop must be
 * protected by shost->host_lock.
Linus Torvalds's avatar
Linus Torvalds committed
360
 *
361 362 363
 * Note: The only reason to use this is because you need to access the
 * device list in interrupt context.  Otherwise you really want to use
 * shost_for_each_device instead.
Linus Torvalds's avatar
Linus Torvalds committed
364 365 366 367
 */
#define __shost_for_each_device(sdev, shost) \
	list_for_each_entry((sdev), &((shost)->__devices), siblings)

368
extern int scsi_change_queue_depth(struct scsi_device *, int);
Linus Torvalds's avatar
Linus Torvalds committed
369 370 371 372 373 374
extern int scsi_track_queue_full(struct scsi_device *, int);

extern int scsi_set_medium_removal(struct scsi_device *, char);

extern int scsi_mode_sense(struct scsi_device *sdev, int dbd, int modepage,
			   unsigned char *buffer, int len, int timeout,
375
			   int retries, struct scsi_mode_data *data,
376
			   struct scsi_sense_hdr *);
377 378 379 380 381
extern int scsi_mode_select(struct scsi_device *sdev, int pf, int sp,
			    int modepage, unsigned char *buffer, int len,
			    int timeout, int retries,
			    struct scsi_mode_data *data,
			    struct scsi_sense_hdr *);
Linus Torvalds's avatar
Linus Torvalds committed
382
extern int scsi_test_unit_ready(struct scsi_device *sdev, int timeout,
383
				int retries, struct scsi_sense_hdr *sshdr);
384 385
extern int scsi_get_vpd_page(struct scsi_device *, u8 page, unsigned char *buf,
			     int buf_len);
386 387
extern int scsi_report_opcode(struct scsi_device *sdev, unsigned char *buffer,
			      unsigned int len, unsigned char opcode);
Linus Torvalds's avatar
Linus Torvalds committed
388 389
extern int scsi_device_set_state(struct scsi_device *sdev,
				 enum scsi_device_state state);
390 391 392 393 394
extern struct scsi_event *sdev_evt_alloc(enum scsi_device_event evt_type,
					  gfp_t gfpflags);
extern void sdev_evt_send(struct scsi_device *sdev, struct scsi_event *evt);
extern void sdev_evt_send_simple(struct scsi_device *sdev,
			  enum scsi_device_event evt_type, gfp_t gfpflags);
Linus Torvalds's avatar
Linus Torvalds committed
395 396 397 398 399
extern int scsi_device_quiesce(struct scsi_device *sdev);
extern void scsi_device_resume(struct scsi_device *sdev);
extern void scsi_target_quiesce(struct scsi_target *);
extern void scsi_target_resume(struct scsi_target *);
extern void scsi_scan_target(struct device *parent, unsigned int channel,
400 401
			     unsigned int id, u64 lun,
			     enum scsi_scan_mode rescan);
Linus Torvalds's avatar
Linus Torvalds committed
402 403
extern void scsi_target_reap(struct scsi_target *);
extern void scsi_target_block(struct device *);
404
extern void scsi_target_unblock(struct device *, enum scsi_device_state);
Linus Torvalds's avatar
Linus Torvalds committed
405 406 407 408
extern void scsi_remove_target(struct device *);
extern const char *scsi_device_state_name(enum scsi_device_state);
extern int scsi_is_sdev_device(const struct device *);
extern int scsi_is_target_device(const struct device *);
409
extern void scsi_sanitize_inquiry_string(unsigned char *s, int len);
410 411 412
extern int scsi_execute(struct scsi_device *sdev, const unsigned char *cmd,
			int data_direction, void *buffer, unsigned bufflen,
			unsigned char *sense, int timeout, int retries,
413
			u64 flags, int *resid);
414 415 416
extern int scsi_execute_req_flags(struct scsi_device *sdev,
	const unsigned char *cmd, int data_direction, void *buffer,
	unsigned bufflen, struct scsi_sense_hdr *sshdr, int timeout,
417
	int retries, int *resid, u64 flags);
418 419 420 421 422 423 424 425
static inline int scsi_execute_req(struct scsi_device *sdev,
	const unsigned char *cmd, int data_direction, void *buffer,
	unsigned bufflen, struct scsi_sense_hdr *sshdr, int timeout,
	int retries, int *resid)
{
	return scsi_execute_req_flags(sdev, cmd, data_direction, buffer,
		bufflen, sshdr, timeout, retries, resid, 0);
}
426 427
extern void sdev_disable_disk_events(struct scsi_device *sdev);
extern void sdev_enable_disk_events(struct scsi_device *sdev);
428
extern int scsi_vpd_lun_id(struct scsi_device *, char *, size_t);
429
extern int scsi_vpd_tpg_id(struct scsi_device *, int *);
430

431
#ifdef CONFIG_PM
432 433 434 435 436
extern int scsi_autopm_get_device(struct scsi_device *);
extern void scsi_autopm_put_device(struct scsi_device *);
#else
static inline int scsi_autopm_get_device(struct scsi_device *d) { return 0; }
static inline void scsi_autopm_put_device(struct scsi_device *d) {}
437
#endif /* CONFIG_PM */
438

439
static inline int __must_check scsi_device_reprobe(struct scsi_device *sdev)
440
{
441
	return device_reprobe(&sdev->sdev_gendev);
442 443
}

444 445 446 447 448 449 450 451 452 453 454 455 456
static inline unsigned int sdev_channel(struct scsi_device *sdev)
{
	return sdev->channel;
}

static inline unsigned int sdev_id(struct scsi_device *sdev)
{
	return sdev->id;
}

#define scmd_id(scmd) sdev_id((scmd)->device)
#define scmd_channel(scmd) sdev_channel((scmd)->device)

457 458 459
/*
 * checks for positions of the SCSI state machine
 */
Linus Torvalds's avatar
Linus Torvalds committed
460 461
static inline int scsi_device_online(struct scsi_device *sdev)
{
462
	return (sdev->sdev_state != SDEV_OFFLINE &&
463
		sdev->sdev_state != SDEV_TRANSPORT_OFFLINE &&
464
		sdev->sdev_state != SDEV_DEL);
Linus Torvalds's avatar
Linus Torvalds committed
465
}
466 467
static inline int scsi_device_blocked(struct scsi_device *sdev)
{
468 469
	return sdev->sdev_state == SDEV_BLOCK ||
		sdev->sdev_state == SDEV_CREATED_BLOCK;
470 471 472
}
static inline int scsi_device_created(struct scsi_device *sdev)
{
473 474
	return sdev->sdev_state == SDEV_CREATED ||
		sdev->sdev_state == SDEV_CREATED_BLOCK;
475
}
Linus Torvalds's avatar
Linus Torvalds committed
476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507

/* accessor functions for the SCSI parameters */
static inline int scsi_device_sync(struct scsi_device *sdev)
{
	return sdev->sdtr;
}
static inline int scsi_device_wide(struct scsi_device *sdev)
{
	return sdev->wdtr;
}
static inline int scsi_device_dt(struct scsi_device *sdev)
{
	return sdev->ppr;
}
static inline int scsi_device_dt_only(struct scsi_device *sdev)
{
	if (sdev->inquiry_len < 57)
		return 0;
	return (sdev->inquiry[56] & 0x0c) == 0x04;
}
static inline int scsi_device_ius(struct scsi_device *sdev)
{
	if (sdev->inquiry_len < 57)
		return 0;
	return sdev->inquiry[56] & 0x01;
}
static inline int scsi_device_qas(struct scsi_device *sdev)
{
	if (sdev->inquiry_len < 57)
		return 0;
	return sdev->inquiry[56] & 0x02;
}
508 509
static inline int scsi_device_enclosure(struct scsi_device *sdev)
{
510
	return sdev->inquiry ? (sdev->inquiry[6] & (1<<6)) : 1;
511
}
512

513 514
static inline int scsi_device_protection(struct scsi_device *sdev)
{
515 516 517
	if (sdev->no_dif)
		return 0;

518
	return sdev->scsi_level > SCSI_2 && sdev->inquiry[5] & (1<<0);
519 520
}

521 522 523 524 525
static inline int scsi_device_tpgs(struct scsi_device *sdev)
{
	return sdev->inquiry ? (sdev->inquiry[5] >> 4) & 0x3 : 0;
}

526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543
/**
 * scsi_device_supports_vpd - test if a device supports VPD pages
 * @sdev: the &struct scsi_device to test
 *
 * If the 'try_vpd_pages' flag is set it takes precedence.
 * Otherwise we will assume VPD pages are supported if the
 * SCSI level is at least SPC-3 and 'skip_vpd_pages' is not set.
 */
static inline int scsi_device_supports_vpd(struct scsi_device *sdev)
{
	/* Attempt VPD inquiry if the device blacklist explicitly calls
	 * for it.
	 */
	if (sdev->try_vpd_pages)
		return 1;
	/*
	 * Although VPD inquiries can go to SCSI-2 type devices,
	 * some USB ones crash on receiving them, and the pages
544
	 * we currently ask for are mandatory for SPC-2 and beyond
545
	 */
546
	if (sdev->scsi_level >= SCSI_SPC_2 && !sdev->skip_vpd_pages)
547 548 549 550
		return 1;
	return 0;
}

551 552 553 554
#define MODULE_ALIAS_SCSI_DEVICE(type) \
	MODULE_ALIAS("scsi:t-" __stringify(type) "*")
#define SCSI_DEVICE_MODALIAS_FMT "scsi:t-0x%02x"

Linus Torvalds's avatar
Linus Torvalds committed
555
#endif /* _SCSI_SCSI_DEVICE_H */