2 * SCSI Zoned Block commands
4 * Copyright (C) 2014-2015 SUSE Linux GmbH
5 * Written by: Hannes Reinecke <hare@suse.de>
6 * Modified by: Damien Le Moal <damien.lemoal@hgst.com>
7 * Modified by: Shaun Tancheff <shaun.tancheff@seagate.com>
9 * This program is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU General Public License version
11 * 2 as published by the Free Software Foundation.
13 * This program is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; see the file COPYING. If not, write to
20 * the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139,
25 #include <linux/blkdev.h>
27 #include <asm/unaligned.h>
29 #include <scsi/scsi.h>
30 #include <scsi/scsi_cmnd.h>
35 * sd_zbc_parse_report - Convert a zone descriptor to a struct blk_zone,
36 * @sdkp: The disk the report originated from
37 * @buf: Address of the report zone descriptor
38 * @zone: the destination zone structure
40 * All LBA sized values are converted to 512B sectors unit.
42 static void sd_zbc_parse_report(struct scsi_disk
*sdkp
, u8
*buf
,
43 struct blk_zone
*zone
)
45 struct scsi_device
*sdp
= sdkp
->device
;
47 memset(zone
, 0, sizeof(struct blk_zone
));
49 zone
->type
= buf
[0] & 0x0f;
50 zone
->cond
= (buf
[1] >> 4) & 0xf;
56 zone
->len
= logical_to_sectors(sdp
, get_unaligned_be64(&buf
[8]));
57 zone
->start
= logical_to_sectors(sdp
, get_unaligned_be64(&buf
[16]));
58 zone
->wp
= logical_to_sectors(sdp
, get_unaligned_be64(&buf
[24]));
59 if (zone
->type
!= ZBC_ZONE_TYPE_CONV
&&
60 zone
->cond
== ZBC_ZONE_COND_FULL
)
61 zone
->wp
= zone
->start
+ zone
->len
;
65 * sd_zbc_do_report_zones - Issue a REPORT ZONES scsi command.
66 * @sdkp: The target disk
67 * @buf: Buffer to use for the reply
68 * @buflen: the buffer size
69 * @lba: Start LBA of the report
70 * @partial: Do partial report
72 * For internal use during device validation.
73 * Using partial=true can significantly speed up execution of a report zones
74 * command because the disk does not have to count all possible report matching
75 * zones and will only report the count of zones fitting in the command reply
78 static int sd_zbc_do_report_zones(struct scsi_disk
*sdkp
, unsigned char *buf
,
79 unsigned int buflen
, sector_t lba
,
82 struct scsi_device
*sdp
= sdkp
->device
;
83 const int timeout
= sdp
->request_queue
->rq_timeout
;
84 struct scsi_sense_hdr sshdr
;
85 unsigned char cmd
[16];
91 cmd
[1] = ZI_REPORT_ZONES
;
92 put_unaligned_be64(lba
, &cmd
[2]);
93 put_unaligned_be32(buflen
, &cmd
[10]);
95 cmd
[14] = ZBC_REPORT_ZONE_PARTIAL
;
96 memset(buf
, 0, buflen
);
98 result
= scsi_execute_req(sdp
, cmd
, DMA_FROM_DEVICE
,
100 timeout
, SD_MAX_RETRIES
, NULL
);
102 sd_printk(KERN_ERR
, sdkp
,
103 "REPORT ZONES lba %llu failed with %d/%d\n",
104 (unsigned long long)lba
,
105 host_byte(result
), driver_byte(result
));
109 rep_len
= get_unaligned_be32(&buf
[0]);
111 sd_printk(KERN_ERR
, sdkp
,
112 "REPORT ZONES report invalid length %u\n",
121 * sd_zbc_report_zones - Disk report zones operation.
122 * @disk: The target disk
123 * @sector: Start 512B sector of the report
124 * @zones: Array of zone descriptors
125 * @nr_zones: Number of descriptors in the array
126 * @gfp_mask: Memory allocation mask
128 * Execute a report zones command on the target disk.
130 int sd_zbc_report_zones(struct gendisk
*disk
, sector_t sector
,
131 struct blk_zone
*zones
, unsigned int *nr_zones
,
134 struct scsi_disk
*sdkp
= scsi_disk(disk
);
135 unsigned int i
, buflen
, nrz
= *nr_zones
;
140 if (!sd_is_zoned(sdkp
))
141 /* Not a zoned device */
145 * Get a reply buffer for the number of requested zones plus a header,
146 * without exceeding the device maximum command size. For ATA disks,
147 * buffers must be aligned to 512B.
149 buflen
= min(queue_max_hw_sectors(disk
->queue
) << 9,
150 roundup((nrz
+ 1) * 64, 512));
151 buf
= kmalloc(buflen
, gfp_mask
);
155 ret
= sd_zbc_do_report_zones(sdkp
, buf
, buflen
,
156 sectors_to_logical(sdkp
->device
, sector
), true);
160 nrz
= min(nrz
, get_unaligned_be32(&buf
[0]) / 64);
161 for (i
= 0; i
< nrz
; i
++) {
163 sd_zbc_parse_report(sdkp
, buf
+ offset
, zones
);
176 * sd_zbc_zone_sectors - Get the device zone size in number of 512B sectors.
177 * @sdkp: The target disk
179 static inline sector_t
sd_zbc_zone_sectors(struct scsi_disk
*sdkp
)
181 return logical_to_sectors(sdkp
->device
, sdkp
->zone_blocks
);
185 * sd_zbc_setup_reset_cmnd - Prepare a RESET WRITE POINTER scsi command.
186 * @cmd: the command to setup
188 * Called from sd_init_command() for a REQ_OP_ZONE_RESET request.
190 blk_status_t
sd_zbc_setup_reset_cmnd(struct scsi_cmnd
*cmd
)
192 struct request
*rq
= cmd
->request
;
193 struct scsi_disk
*sdkp
= scsi_disk(rq
->rq_disk
);
194 sector_t sector
= blk_rq_pos(rq
);
195 sector_t block
= sectors_to_logical(sdkp
->device
, sector
);
197 if (!sd_is_zoned(sdkp
))
198 /* Not a zoned device */
199 return BLK_STS_IOERR
;
201 if (sdkp
->device
->changed
)
202 return BLK_STS_IOERR
;
204 if (sector
& (sd_zbc_zone_sectors(sdkp
) - 1))
205 /* Unaligned request */
206 return BLK_STS_IOERR
;
209 memset(cmd
->cmnd
, 0, cmd
->cmd_len
);
210 cmd
->cmnd
[0] = ZBC_OUT
;
211 cmd
->cmnd
[1] = ZO_RESET_WRITE_POINTER
;
212 put_unaligned_be64(block
, &cmd
->cmnd
[2]);
214 rq
->timeout
= SD_TIMEOUT
;
215 cmd
->sc_data_direction
= DMA_NONE
;
216 cmd
->transfersize
= 0;
223 * sd_zbc_complete - ZBC command post processing.
224 * @cmd: Completed command
225 * @good_bytes: Command reply bytes
226 * @sshdr: command sense header
228 * Called from sd_done(). Process report zones reply and handle reset zone
229 * and write commands errors.
231 void sd_zbc_complete(struct scsi_cmnd
*cmd
, unsigned int good_bytes
,
232 struct scsi_sense_hdr
*sshdr
)
234 int result
= cmd
->result
;
235 struct request
*rq
= cmd
->request
;
237 switch (req_op(rq
)) {
238 case REQ_OP_ZONE_RESET
:
241 sshdr
->sense_key
== ILLEGAL_REQUEST
&&
244 * INVALID FIELD IN CDB error: reset of a conventional
245 * zone was attempted. Nothing to worry about, so be
246 * quiet about the error.
248 rq
->rq_flags
|= RQF_QUIET
;
252 case REQ_OP_WRITE_ZEROES
:
253 case REQ_OP_WRITE_SAME
:
259 * sd_zbc_check_zoned_characteristics - Check zoned block device characteristics
261 * @buf: Buffer where to store the VPD page data
263 * Read VPD page B6, get information and check that reads are unconstrained.
265 static int sd_zbc_check_zoned_characteristics(struct scsi_disk
*sdkp
,
269 if (scsi_get_vpd_page(sdkp
->device
, 0xb6, buf
, 64)) {
270 sd_printk(KERN_NOTICE
, sdkp
,
271 "Read zoned characteristics VPD page failed\n");
275 if (sdkp
->device
->type
!= TYPE_ZBC
) {
278 sdkp
->zones_optimal_open
= get_unaligned_be32(&buf
[8]);
279 sdkp
->zones_optimal_nonseq
= get_unaligned_be32(&buf
[12]);
280 sdkp
->zones_max_open
= 0;
283 sdkp
->urswrz
= buf
[4] & 1;
284 sdkp
->zones_optimal_open
= 0;
285 sdkp
->zones_optimal_nonseq
= 0;
286 sdkp
->zones_max_open
= get_unaligned_be32(&buf
[16]);
290 * Check for unconstrained reads: host-managed devices with
291 * constrained reads (drives failing read after write pointer)
295 if (sdkp
->first_scan
)
296 sd_printk(KERN_NOTICE
, sdkp
,
297 "constrained reads devices are not supported\n");
304 #define SD_ZBC_BUF_SIZE 131072U
307 * sd_zbc_check_zones - Check the device capacity and zone sizes
310 * Check that the device capacity as reported by READ CAPACITY matches the
311 * max_lba value (plus one)of the report zones command reply. Also check that
312 * all zones of the device have an equal size, only allowing the last zone of
313 * the disk to have a smaller size (runt zone). The zone size must also be a
316 * Returns the zone size in number of blocks upon success or an error code
319 static int sd_zbc_check_zones(struct scsi_disk
*sdkp
, u32
*zblocks
)
322 sector_t max_lba
, block
= 0;
325 unsigned int buf_len
;
326 unsigned int list_length
;
331 buf
= kmalloc(SD_ZBC_BUF_SIZE
, GFP_KERNEL
);
335 /* Do a report zone to get max_lba and the same field */
336 ret
= sd_zbc_do_report_zones(sdkp
, buf
, SD_ZBC_BUF_SIZE
, 0, false);
340 if (sdkp
->rc_basis
== 0) {
341 /* The max_lba field is the capacity of this device */
342 max_lba
= get_unaligned_be64(&buf
[8]);
343 if (sdkp
->capacity
!= max_lba
+ 1) {
344 if (sdkp
->first_scan
)
345 sd_printk(KERN_WARNING
, sdkp
,
346 "Changing capacity from %llu to max LBA+1 %llu\n",
347 (unsigned long long)sdkp
->capacity
,
348 (unsigned long long)max_lba
+ 1);
349 sdkp
->capacity
= max_lba
+ 1;
354 * Check same field: for any value other than 0, we know that all zones
355 * have the same size.
357 same
= buf
[4] & 0x0f;
360 zone_blocks
= get_unaligned_be64(&rec
[8]);
365 * Check the size of all zones: all zones must be of
366 * equal size, except the last zone which can be smaller
371 /* Parse REPORT ZONES header */
372 list_length
= get_unaligned_be32(&buf
[0]) + 64;
374 buf_len
= min(list_length
, SD_ZBC_BUF_SIZE
);
376 /* Parse zone descriptors */
377 while (rec
< buf
+ buf_len
) {
378 u64 this_zone_blocks
= get_unaligned_be64(&rec
[8]);
380 if (zone_blocks
== 0) {
381 zone_blocks
= this_zone_blocks
;
382 } else if (this_zone_blocks
!= zone_blocks
&&
383 (block
+ this_zone_blocks
< sdkp
->capacity
384 || this_zone_blocks
> zone_blocks
)) {
388 block
+= this_zone_blocks
;
392 if (block
< sdkp
->capacity
) {
393 ret
= sd_zbc_do_report_zones(sdkp
, buf
, SD_ZBC_BUF_SIZE
,
399 } while (block
< sdkp
->capacity
);
403 if (sdkp
->first_scan
)
404 sd_printk(KERN_NOTICE
, sdkp
,
405 "Devices with non constant zone "
406 "size are not supported\n");
408 } else if (!is_power_of_2(zone_blocks
)) {
409 if (sdkp
->first_scan
)
410 sd_printk(KERN_NOTICE
, sdkp
,
411 "Devices with non power of 2 zone "
412 "size are not supported\n");
414 } else if (logical_to_sectors(sdkp
->device
, zone_blocks
) > UINT_MAX
) {
415 if (sdkp
->first_scan
)
416 sd_printk(KERN_NOTICE
, sdkp
,
417 "Zone size too large\n");
420 *zblocks
= zone_blocks
;
430 int sd_zbc_read_zones(struct scsi_disk
*sdkp
, unsigned char *buf
)
432 struct gendisk
*disk
= sdkp
->disk
;
433 unsigned int nr_zones
;
437 if (!sd_is_zoned(sdkp
))
439 * Device managed or normal SCSI disk,
440 * no special handling required
444 /* Check zoned block device characteristics (unconstrained reads) */
445 ret
= sd_zbc_check_zoned_characteristics(sdkp
, buf
);
450 * Check zone size: only devices with a constant zone size (except
451 * an eventual last runt zone) that is a power of 2 are supported.
453 ret
= sd_zbc_check_zones(sdkp
, &zone_blocks
);
457 /* The drive satisfies the kernel restrictions: set it up */
458 blk_queue_chunk_sectors(sdkp
->disk
->queue
,
459 logical_to_sectors(sdkp
->device
, zone_blocks
));
460 nr_zones
= round_up(sdkp
->capacity
, zone_blocks
) >> ilog2(zone_blocks
);
462 /* READ16/WRITE16 is mandatory for ZBC disks */
463 sdkp
->device
->use_16_for_rw
= 1;
464 sdkp
->device
->use_10_for_rw
= 0;
467 * Revalidate the disk zone bitmaps once the block device capacity is
468 * set on the second revalidate execution during disk scan and if
469 * something changed when executing a normal revalidate.
471 if (sdkp
->first_scan
) {
472 sdkp
->zone_blocks
= zone_blocks
;
473 sdkp
->nr_zones
= nr_zones
;
477 if (sdkp
->zone_blocks
!= zone_blocks
||
478 sdkp
->nr_zones
!= nr_zones
||
479 disk
->queue
->nr_zones
!= nr_zones
) {
480 ret
= blk_revalidate_disk_zones(disk
);
483 sdkp
->zone_blocks
= zone_blocks
;
484 sdkp
->nr_zones
= nr_zones
;
495 void sd_zbc_print_zones(struct scsi_disk
*sdkp
)
497 if (!sd_is_zoned(sdkp
) || !sdkp
->capacity
)
500 if (sdkp
->capacity
& (sdkp
->zone_blocks
- 1))
501 sd_printk(KERN_NOTICE
, sdkp
,
502 "%u zones of %u logical blocks + 1 runt zone\n",
506 sd_printk(KERN_NOTICE
, sdkp
,
507 "%u zones of %u logical blocks\n",