Linux Audio

Check our new training course

Yocto distribution development and maintenance

Need a Yocto distribution for your embedded project?
Loading...
v3.15
  1#ifndef _SCSI_DISK_H
  2#define _SCSI_DISK_H
  3
  4/*
  5 * More than enough for everybody ;)  The huge number of majors
  6 * is a leftover from 16bit dev_t days, we don't really need that
  7 * much numberspace.
  8 */
  9#define SD_MAJORS	16
 10
 11/*
 12 * Time out in seconds for disks and Magneto-opticals (which are slower).
 13 */
 14#define SD_TIMEOUT		(30 * HZ)
 15#define SD_MOD_TIMEOUT		(75 * HZ)
 16/*
 17 * Flush timeout is a multiplier over the standard device timeout which is
 18 * user modifiable via sysfs but initially set to SD_TIMEOUT
 19 */
 20#define SD_FLUSH_TIMEOUT_MULTIPLIER	2
 21#define SD_WRITE_SAME_TIMEOUT	(120 * HZ)
 22
 23/*
 24 * Number of allowed retries
 25 */
 26#define SD_MAX_RETRIES		5
 27#define SD_PASSTHROUGH_RETRIES	1
 28#define SD_MAX_MEDIUM_TIMEOUTS	2
 29
 30/*
 31 * Size of the initial data buffer for mode and read capacity data
 32 */
 33#define SD_BUF_SIZE		512
 34
 35/*
 36 * Number of sectors at the end of the device to avoid multi-sector
 37 * accesses to in the case of last_sector_bug
 38 */
 39#define SD_LAST_BUGGY_SECTORS	8
 40
 41enum {
 42	SD_EXT_CDB_SIZE = 32,	/* Extended CDB size */
 43	SD_MEMPOOL_SIZE = 2,	/* CDB pool size */
 44};
 45
 46enum {
 
 
 47	SD_MAX_WS10_BLOCKS = 0xffff,
 48	SD_MAX_WS16_BLOCKS = 0x7fffff,
 49};
 50
 51enum {
 52	SD_LBP_FULL = 0,	/* Full logical block provisioning */
 53	SD_LBP_UNMAP,		/* Use UNMAP command */
 54	SD_LBP_WS16,		/* Use WRITE SAME(16) with UNMAP bit */
 55	SD_LBP_WS10,		/* Use WRITE SAME(10) with UNMAP bit */
 56	SD_LBP_ZERO,		/* Use WRITE SAME(10) with zero payload */
 57	SD_LBP_DISABLE,		/* Discard disabled due to failed cmd */
 58};
 59
 60struct scsi_disk {
 61	struct scsi_driver *driver;	/* always &sd_template */
 62	struct scsi_device *device;
 63	struct device	dev;
 64	struct gendisk	*disk;
 
 
 
 
 
 
 
 
 
 65	atomic_t	openers;
 66	sector_t	capacity;	/* size in 512-byte sectors */
 
 
 67	u32		max_ws_blocks;
 68	u32		max_unmap_blocks;
 69	u32		unmap_granularity;
 70	u32		unmap_alignment;
 71	u32		index;
 72	unsigned int	physical_block_size;
 73	unsigned int	max_medium_access_timeouts;
 74	unsigned int	medium_access_timed_out;
 75	u8		media_present;
 76	u8		write_prot;
 77	u8		protection_type;/* Data Integrity Field */
 78	u8		provisioning_mode;
 79	unsigned	ATO : 1;	/* state of disk ATO bit */
 80	unsigned	cache_override : 1; /* temp override of WCE,RCD */
 81	unsigned	WCE : 1;	/* state of disk WCE bit */
 82	unsigned	RCD : 1;	/* state of disk RCD bit, unused */
 83	unsigned	DPOFUA : 1;	/* state of disk DPOFUA bit */
 84	unsigned	first_scan : 1;
 85	unsigned	lbpme : 1;
 86	unsigned	lbprz : 1;
 87	unsigned	lbpu : 1;
 88	unsigned	lbpws : 1;
 89	unsigned	lbpws10 : 1;
 90	unsigned	lbpvpd : 1;
 91	unsigned	ws10 : 1;
 92	unsigned	ws16 : 1;
 
 
 
 93};
 94#define to_scsi_disk(obj) container_of(obj,struct scsi_disk,dev)
 95
 96static inline struct scsi_disk *scsi_disk(struct gendisk *disk)
 97{
 98	return container_of(disk->private_data, struct scsi_disk, driver);
 99}
100
101#define sd_printk(prefix, sdsk, fmt, a...)				\
102        (sdsk)->disk ?							\
103	sdev_printk(prefix, (sdsk)->device, "[%s] " fmt,		\
104		    (sdsk)->disk->disk_name, ##a) :			\
105	sdev_printk(prefix, (sdsk)->device, fmt, ##a)
106
107#define sd_first_printk(prefix, sdsk, fmt, a...)			\
108	do {								\
109		if ((sdkp)->first_scan)					\
110			sd_printk(prefix, sdsk, fmt, ##a);		\
111	} while (0)
112
113static inline int scsi_medium_access_command(struct scsi_cmnd *scmd)
114{
115	switch (scmd->cmnd[0]) {
116	case READ_6:
117	case READ_10:
118	case READ_12:
119	case READ_16:
120	case SYNCHRONIZE_CACHE:
121	case VERIFY:
122	case VERIFY_12:
123	case VERIFY_16:
124	case WRITE_6:
125	case WRITE_10:
126	case WRITE_12:
127	case WRITE_16:
128	case WRITE_SAME:
129	case WRITE_SAME_16:
130	case UNMAP:
131		return 1;
132	case VARIABLE_LENGTH_CMD:
133		switch (scmd->cmnd[9]) {
134		case READ_32:
135		case VERIFY_32:
136		case WRITE_32:
137		case WRITE_SAME_32:
138			return 1;
139		}
140	}
141
142	return 0;
143}
144
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
145/*
146 * A DIF-capable target device can be formatted with different
147 * protection schemes.  Currently 0 through 3 are defined:
148 *
149 * Type 0 is regular (unprotected) I/O
150 *
151 * Type 1 defines the contents of the guard and reference tags
152 *
153 * Type 2 defines the contents of the guard and reference tags and
154 * uses 32-byte commands to seed the latter
155 *
156 * Type 3 defines the contents of the guard tag only
157 */
 
 
 
 
 
 
 
 
 
 
 
 
 
158
159enum sd_dif_target_protection_types {
160	SD_DIF_TYPE0_PROTECTION = 0x0,
161	SD_DIF_TYPE1_PROTECTION = 0x1,
162	SD_DIF_TYPE2_PROTECTION = 0x2,
163	SD_DIF_TYPE3_PROTECTION = 0x3,
164};
165
166/*
167 * Data Integrity Field tuple.
 
168 */
169struct sd_dif_tuple {
170       __be16 guard_tag;	/* Checksum */
171       __be16 app_tag;		/* Opaque storage */
172       __be32 ref_tag;		/* Target LBA or indirect LBA */
173};
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
174
175#ifdef CONFIG_BLK_DEV_INTEGRITY
176
177extern void sd_dif_config_host(struct scsi_disk *);
178extern void sd_dif_prepare(struct request *rq, sector_t, unsigned int);
179extern void sd_dif_complete(struct scsi_cmnd *, unsigned int);
180
181#else /* CONFIG_BLK_DEV_INTEGRITY */
182
183static inline void sd_dif_config_host(struct scsi_disk *disk)
184{
185}
186static inline int sd_dif_prepare(struct request *rq, sector_t s, unsigned int a)
187{
188	return 0;
189}
190static inline void sd_dif_complete(struct scsi_cmnd *cmd, unsigned int a)
191{
192}
193
194#endif /* CONFIG_BLK_DEV_INTEGRITY */
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
195
196#endif /* _SCSI_DISK_H */
v4.10.11
  1#ifndef _SCSI_DISK_H
  2#define _SCSI_DISK_H
  3
  4/*
  5 * More than enough for everybody ;)  The huge number of majors
  6 * is a leftover from 16bit dev_t days, we don't really need that
  7 * much numberspace.
  8 */
  9#define SD_MAJORS	16
 10
 11/*
 12 * Time out in seconds for disks and Magneto-opticals (which are slower).
 13 */
 14#define SD_TIMEOUT		(30 * HZ)
 15#define SD_MOD_TIMEOUT		(75 * HZ)
 16/*
 17 * Flush timeout is a multiplier over the standard device timeout which is
 18 * user modifiable via sysfs but initially set to SD_TIMEOUT
 19 */
 20#define SD_FLUSH_TIMEOUT_MULTIPLIER	2
 21#define SD_WRITE_SAME_TIMEOUT	(120 * HZ)
 22
 23/*
 24 * Number of allowed retries
 25 */
 26#define SD_MAX_RETRIES		5
 27#define SD_PASSTHROUGH_RETRIES	1
 28#define SD_MAX_MEDIUM_TIMEOUTS	2
 29
 30/*
 31 * Size of the initial data buffer for mode and read capacity data
 32 */
 33#define SD_BUF_SIZE		512
 34
 35/*
 36 * Number of sectors at the end of the device to avoid multi-sector
 37 * accesses to in the case of last_sector_bug
 38 */
 39#define SD_LAST_BUGGY_SECTORS	8
 40
 41enum {
 42	SD_EXT_CDB_SIZE = 32,	/* Extended CDB size */
 43	SD_MEMPOOL_SIZE = 2,	/* CDB pool size */
 44};
 45
 46enum {
 47	SD_DEF_XFER_BLOCKS = 0xffff,
 48	SD_MAX_XFER_BLOCKS = 0xffffffff,
 49	SD_MAX_WS10_BLOCKS = 0xffff,
 50	SD_MAX_WS16_BLOCKS = 0x7fffff,
 51};
 52
 53enum {
 54	SD_LBP_FULL = 0,	/* Full logical block provisioning */
 55	SD_LBP_UNMAP,		/* Use UNMAP command */
 56	SD_LBP_WS16,		/* Use WRITE SAME(16) with UNMAP bit */
 57	SD_LBP_WS10,		/* Use WRITE SAME(10) with UNMAP bit */
 58	SD_LBP_ZERO,		/* Use WRITE SAME(10) with zero payload */
 59	SD_LBP_DISABLE,		/* Discard disabled due to failed cmd */
 60};
 61
 62struct scsi_disk {
 63	struct scsi_driver *driver;	/* always &sd_template */
 64	struct scsi_device *device;
 65	struct device	dev;
 66	struct gendisk	*disk;
 67#ifdef CONFIG_BLK_DEV_ZONED
 68	unsigned int	nr_zones;
 69	unsigned int	zone_blocks;
 70	unsigned int	zone_shift;
 71	unsigned long	*zones_wlock;
 72	unsigned int	zones_optimal_open;
 73	unsigned int	zones_optimal_nonseq;
 74	unsigned int	zones_max_open;
 75#endif
 76	atomic_t	openers;
 77	sector_t	capacity;	/* size in logical blocks */
 78	u32		max_xfer_blocks;
 79	u32		opt_xfer_blocks;
 80	u32		max_ws_blocks;
 81	u32		max_unmap_blocks;
 82	u32		unmap_granularity;
 83	u32		unmap_alignment;
 84	u32		index;
 85	unsigned int	physical_block_size;
 86	unsigned int	max_medium_access_timeouts;
 87	unsigned int	medium_access_timed_out;
 88	u8		media_present;
 89	u8		write_prot;
 90	u8		protection_type;/* Data Integrity Field */
 91	u8		provisioning_mode;
 92	unsigned	ATO : 1;	/* state of disk ATO bit */
 93	unsigned	cache_override : 1; /* temp override of WCE,RCD */
 94	unsigned	WCE : 1;	/* state of disk WCE bit */
 95	unsigned	RCD : 1;	/* state of disk RCD bit, unused */
 96	unsigned	DPOFUA : 1;	/* state of disk DPOFUA bit */
 97	unsigned	first_scan : 1;
 98	unsigned	lbpme : 1;
 99	unsigned	lbprz : 1;
100	unsigned	lbpu : 1;
101	unsigned	lbpws : 1;
102	unsigned	lbpws10 : 1;
103	unsigned	lbpvpd : 1;
104	unsigned	ws10 : 1;
105	unsigned	ws16 : 1;
106	unsigned	rc_basis: 2;
107	unsigned	zoned: 2;
108	unsigned	urswrz : 1;
109};
110#define to_scsi_disk(obj) container_of(obj,struct scsi_disk,dev)
111
112static inline struct scsi_disk *scsi_disk(struct gendisk *disk)
113{
114	return container_of(disk->private_data, struct scsi_disk, driver);
115}
116
117#define sd_printk(prefix, sdsk, fmt, a...)				\
118        (sdsk)->disk ?							\
119	      sdev_prefix_printk(prefix, (sdsk)->device,		\
120				 (sdsk)->disk->disk_name, fmt, ##a) :	\
121	      sdev_printk(prefix, (sdsk)->device, fmt, ##a)
122
123#define sd_first_printk(prefix, sdsk, fmt, a...)			\
124	do {								\
125		if ((sdkp)->first_scan)					\
126			sd_printk(prefix, sdsk, fmt, ##a);		\
127	} while (0)
128
129static inline int scsi_medium_access_command(struct scsi_cmnd *scmd)
130{
131	switch (scmd->cmnd[0]) {
132	case READ_6:
133	case READ_10:
134	case READ_12:
135	case READ_16:
136	case SYNCHRONIZE_CACHE:
137	case VERIFY:
138	case VERIFY_12:
139	case VERIFY_16:
140	case WRITE_6:
141	case WRITE_10:
142	case WRITE_12:
143	case WRITE_16:
144	case WRITE_SAME:
145	case WRITE_SAME_16:
146	case UNMAP:
147		return 1;
148	case VARIABLE_LENGTH_CMD:
149		switch (scmd->cmnd[9]) {
150		case READ_32:
151		case VERIFY_32:
152		case WRITE_32:
153		case WRITE_SAME_32:
154			return 1;
155		}
156	}
157
158	return 0;
159}
160
161static inline sector_t logical_to_sectors(struct scsi_device *sdev, sector_t blocks)
162{
163	return blocks << (ilog2(sdev->sector_size) - 9);
164}
165
166static inline unsigned int logical_to_bytes(struct scsi_device *sdev, sector_t blocks)
167{
168	return blocks * sdev->sector_size;
169}
170
171static inline sector_t sectors_to_logical(struct scsi_device *sdev, sector_t sector)
172{
173	return sector >> (ilog2(sdev->sector_size) - 9);
174}
175
176/*
177 * Look up the DIX operation based on whether the command is read or
178 * write and whether dix and dif are enabled.
 
 
 
 
 
 
 
 
 
179 */
180static inline unsigned int sd_prot_op(bool write, bool dix, bool dif)
181{
182	/* Lookup table: bit 2 (write), bit 1 (dix), bit 0 (dif) */
183	const unsigned int ops[] = {	/* wrt dix dif */
184		SCSI_PROT_NORMAL,	/*  0	0   0  */
185		SCSI_PROT_READ_STRIP,	/*  0	0   1  */
186		SCSI_PROT_READ_INSERT,	/*  0	1   0  */
187		SCSI_PROT_READ_PASS,	/*  0	1   1  */
188		SCSI_PROT_NORMAL,	/*  1	0   0  */
189		SCSI_PROT_WRITE_INSERT, /*  1	0   1  */
190		SCSI_PROT_WRITE_STRIP,	/*  1	1   0  */
191		SCSI_PROT_WRITE_PASS,	/*  1	1   1  */
192	};
193
194	return ops[write << 2 | dix << 1 | dif];
195}
 
 
 
 
196
197/*
198 * Returns a mask of the protection flags that are valid for a given DIX
199 * operation.
200 */
201static inline unsigned int sd_prot_flag_mask(unsigned int prot_op)
202{
203	const unsigned int flag_mask[] = {
204		[SCSI_PROT_NORMAL]		= 0,
205
206		[SCSI_PROT_READ_STRIP]		= SCSI_PROT_TRANSFER_PI |
207						  SCSI_PROT_GUARD_CHECK |
208						  SCSI_PROT_REF_CHECK |
209						  SCSI_PROT_REF_INCREMENT,
210
211		[SCSI_PROT_READ_INSERT]		= SCSI_PROT_REF_INCREMENT |
212						  SCSI_PROT_IP_CHECKSUM,
213
214		[SCSI_PROT_READ_PASS]		= SCSI_PROT_TRANSFER_PI |
215						  SCSI_PROT_GUARD_CHECK |
216						  SCSI_PROT_REF_CHECK |
217						  SCSI_PROT_REF_INCREMENT |
218						  SCSI_PROT_IP_CHECKSUM,
219
220		[SCSI_PROT_WRITE_INSERT]	= SCSI_PROT_TRANSFER_PI |
221						  SCSI_PROT_REF_INCREMENT,
222
223		[SCSI_PROT_WRITE_STRIP]		= SCSI_PROT_GUARD_CHECK |
224						  SCSI_PROT_REF_CHECK |
225						  SCSI_PROT_REF_INCREMENT |
226						  SCSI_PROT_IP_CHECKSUM,
227
228		[SCSI_PROT_WRITE_PASS]		= SCSI_PROT_TRANSFER_PI |
229						  SCSI_PROT_GUARD_CHECK |
230						  SCSI_PROT_REF_CHECK |
231						  SCSI_PROT_REF_INCREMENT |
232						  SCSI_PROT_IP_CHECKSUM,
233	};
234
235	return flag_mask[prot_op];
236}
237
238#ifdef CONFIG_BLK_DEV_INTEGRITY
239
240extern void sd_dif_config_host(struct scsi_disk *);
241extern void sd_dif_prepare(struct scsi_cmnd *scmd);
242extern void sd_dif_complete(struct scsi_cmnd *, unsigned int);
243
244#else /* CONFIG_BLK_DEV_INTEGRITY */
245
246static inline void sd_dif_config_host(struct scsi_disk *disk)
247{
248}
249static inline int sd_dif_prepare(struct scsi_cmnd *scmd)
250{
251	return 0;
252}
253static inline void sd_dif_complete(struct scsi_cmnd *cmd, unsigned int a)
254{
255}
256
257#endif /* CONFIG_BLK_DEV_INTEGRITY */
258
259static inline int sd_is_zoned(struct scsi_disk *sdkp)
260{
261	return sdkp->zoned == 1 || sdkp->device->type == TYPE_ZBC;
262}
263
264#ifdef CONFIG_BLK_DEV_ZONED
265
266extern int sd_zbc_read_zones(struct scsi_disk *sdkp, unsigned char *buffer);
267extern void sd_zbc_remove(struct scsi_disk *sdkp);
268extern void sd_zbc_print_zones(struct scsi_disk *sdkp);
269extern int sd_zbc_setup_write_cmnd(struct scsi_cmnd *cmd);
270extern void sd_zbc_cancel_write_cmnd(struct scsi_cmnd *cmd);
271extern int sd_zbc_setup_report_cmnd(struct scsi_cmnd *cmd);
272extern int sd_zbc_setup_reset_cmnd(struct scsi_cmnd *cmd);
273extern void sd_zbc_complete(struct scsi_cmnd *cmd, unsigned int good_bytes,
274			    struct scsi_sense_hdr *sshdr);
275
276#else /* CONFIG_BLK_DEV_ZONED */
277
278static inline int sd_zbc_read_zones(struct scsi_disk *sdkp,
279				    unsigned char *buf)
280{
281	return 0;
282}
283
284static inline void sd_zbc_remove(struct scsi_disk *sdkp) {}
285
286static inline void sd_zbc_print_zones(struct scsi_disk *sdkp) {}
287
288static inline int sd_zbc_setup_write_cmnd(struct scsi_cmnd *cmd)
289{
290	/* Let the drive fail requests */
291	return BLKPREP_OK;
292}
293
294static inline void sd_zbc_cancel_write_cmnd(struct scsi_cmnd *cmd) {}
295
296static inline int sd_zbc_setup_report_cmnd(struct scsi_cmnd *cmd)
297{
298	return BLKPREP_INVALID;
299}
300
301static inline int sd_zbc_setup_reset_cmnd(struct scsi_cmnd *cmd)
302{
303	return BLKPREP_INVALID;
304}
305
306static inline void sd_zbc_complete(struct scsi_cmnd *cmd,
307				   unsigned int good_bytes,
308				   struct scsi_sense_hdr *sshdr) {}
309
310#endif /* CONFIG_BLK_DEV_ZONED */
311
312#endif /* _SCSI_DISK_H */