1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*******************************************************************************
3 * Filename: target_core_iblock.c
5 * This file contains the Storage Engine <-> Linux BlockIO transport
8 * (c) Copyright 2003-2013 Datera, Inc.
10 * Nicholas A. Bellinger <nab@kernel.org>
12 ******************************************************************************/
14 #include <linux/string.h>
15 #include <linux/parser.h>
16 #include <linux/timer.h>
18 #include <linux/blkdev.h>
19 #include <linux/blk-integrity.h>
20 #include <linux/slab.h>
21 #include <linux/spinlock.h>
22 #include <linux/bio.h>
23 #include <linux/file.h>
24 #include <linux/module.h>
25 #include <linux/scatterlist.h>
27 #include <scsi/scsi_proto.h>
28 #include <scsi/scsi_common.h>
29 #include <asm/unaligned.h>
31 #include <target/target_core_base.h>
32 #include <target/target_core_backend.h>
34 #include "target_core_iblock.h"
35 #include "target_core_pr.h"
37 #define IBLOCK_MAX_BIO_PER_TASK 32 /* max # of bios to submit at a time */
38 #define IBLOCK_BIO_POOL_SIZE 128
40 static inline struct iblock_dev *IBLOCK_DEV(struct se_device *dev)
42 return container_of(dev, struct iblock_dev, dev);
46 static int iblock_attach_hba(struct se_hba *hba, u32 host_id)
48 pr_debug("CORE_HBA[%d] - TCM iBlock HBA Driver %s on"
49 " Generic Target Core Stack %s\n", hba->hba_id,
50 IBLOCK_VERSION, TARGET_CORE_VERSION);
54 static void iblock_detach_hba(struct se_hba *hba)
58 static struct se_device *iblock_alloc_device(struct se_hba *hba, const char *name)
60 struct iblock_dev *ib_dev = NULL;
62 ib_dev = kzalloc(sizeof(struct iblock_dev), GFP_KERNEL);
64 pr_err("Unable to allocate struct iblock_dev\n");
68 ib_dev->ibd_plug = kcalloc(nr_cpu_ids, sizeof(*ib_dev->ibd_plug),
70 if (!ib_dev->ibd_plug)
73 pr_debug( "IBLOCK: Allocated ib_dev for %s\n", name);
82 static bool iblock_configure_unmap(struct se_device *dev)
84 struct iblock_dev *ib_dev = IBLOCK_DEV(dev);
86 return target_configure_unmap_from_queue(&dev->dev_attrib,
90 static int iblock_configure_device(struct se_device *dev)
92 struct iblock_dev *ib_dev = IBLOCK_DEV(dev);
93 struct request_queue *q;
94 struct block_device *bd = NULL;
95 struct blk_integrity *bi;
96 blk_mode_t mode = BLK_OPEN_READ;
97 unsigned int max_write_zeroes_sectors;
100 if (!(ib_dev->ibd_flags & IBDF_HAS_UDEV_PATH)) {
101 pr_err("Missing udev_path= parameters for IBLOCK\n");
105 ret = bioset_init(&ib_dev->ibd_bio_set, IBLOCK_BIO_POOL_SIZE, 0, BIOSET_NEED_BVECS);
107 pr_err("IBLOCK: Unable to create bioset\n");
111 pr_debug( "IBLOCK: Claiming struct block_device: %s\n",
112 ib_dev->ibd_udev_path);
114 if (!ib_dev->ibd_readonly)
115 mode |= BLK_OPEN_WRITE;
117 dev->dev_flags |= DF_READ_ONLY;
119 bd = blkdev_get_by_path(ib_dev->ibd_udev_path, mode, ib_dev, NULL);
122 goto out_free_bioset;
126 q = bdev_get_queue(bd);
128 dev->dev_attrib.hw_block_size = bdev_logical_block_size(bd);
129 dev->dev_attrib.hw_max_sectors = mult_frac(queue_max_hw_sectors(q),
131 dev->dev_attrib.hw_block_size);
132 dev->dev_attrib.hw_queue_depth = q->nr_requests;
135 * Enable write same emulation for IBLOCK and use 0xFFFF as
136 * the smaller WRITE_SAME(10) only has a two-byte block count.
138 max_write_zeroes_sectors = bdev_write_zeroes_sectors(bd);
139 if (max_write_zeroes_sectors)
140 dev->dev_attrib.max_write_same_len = max_write_zeroes_sectors;
142 dev->dev_attrib.max_write_same_len = 0xFFFF;
145 dev->dev_attrib.is_nonrot = 1;
147 bi = bdev_get_integrity(bd);
149 struct bio_set *bs = &ib_dev->ibd_bio_set;
151 if (!strcmp(bi->profile->name, "T10-DIF-TYPE3-IP") ||
152 !strcmp(bi->profile->name, "T10-DIF-TYPE1-IP")) {
153 pr_err("IBLOCK export of blk_integrity: %s not"
154 " supported\n", bi->profile->name);
159 if (!strcmp(bi->profile->name, "T10-DIF-TYPE3-CRC")) {
160 dev->dev_attrib.pi_prot_type = TARGET_DIF_TYPE3_PROT;
161 } else if (!strcmp(bi->profile->name, "T10-DIF-TYPE1-CRC")) {
162 dev->dev_attrib.pi_prot_type = TARGET_DIF_TYPE1_PROT;
165 if (dev->dev_attrib.pi_prot_type) {
166 if (bioset_integrity_create(bs, IBLOCK_BIO_POOL_SIZE) < 0) {
167 pr_err("Unable to allocate bioset for PI\n");
171 pr_debug("IBLOCK setup BIP bs->bio_integrity_pool: %p\n",
172 &bs->bio_integrity_pool);
174 dev->dev_attrib.hw_pi_prot_type = dev->dev_attrib.pi_prot_type;
180 blkdev_put(ib_dev->ibd_bd, ib_dev);
182 bioset_exit(&ib_dev->ibd_bio_set);
187 static void iblock_dev_call_rcu(struct rcu_head *p)
189 struct se_device *dev = container_of(p, struct se_device, rcu_head);
190 struct iblock_dev *ib_dev = IBLOCK_DEV(dev);
192 kfree(ib_dev->ibd_plug);
196 static void iblock_free_device(struct se_device *dev)
198 call_rcu(&dev->rcu_head, iblock_dev_call_rcu);
201 static void iblock_destroy_device(struct se_device *dev)
203 struct iblock_dev *ib_dev = IBLOCK_DEV(dev);
205 if (ib_dev->ibd_bd != NULL)
206 blkdev_put(ib_dev->ibd_bd, ib_dev);
207 bioset_exit(&ib_dev->ibd_bio_set);
210 static struct se_dev_plug *iblock_plug_device(struct se_device *se_dev)
212 struct iblock_dev *ib_dev = IBLOCK_DEV(se_dev);
213 struct iblock_dev_plug *ib_dev_plug;
216 * Each se_device has a per cpu work this can be run from. We
217 * shouldn't have multiple threads on the same cpu calling this
220 ib_dev_plug = &ib_dev->ibd_plug[raw_smp_processor_id()];
221 if (test_and_set_bit(IBD_PLUGF_PLUGGED, &ib_dev_plug->flags))
224 blk_start_plug(&ib_dev_plug->blk_plug);
225 return &ib_dev_plug->se_plug;
228 static void iblock_unplug_device(struct se_dev_plug *se_plug)
230 struct iblock_dev_plug *ib_dev_plug = container_of(se_plug,
231 struct iblock_dev_plug, se_plug);
233 blk_finish_plug(&ib_dev_plug->blk_plug);
234 clear_bit(IBD_PLUGF_PLUGGED, &ib_dev_plug->flags);
237 static sector_t iblock_get_blocks(struct se_device *dev)
239 struct iblock_dev *ib_dev = IBLOCK_DEV(dev);
240 u32 block_size = bdev_logical_block_size(ib_dev->ibd_bd);
241 unsigned long long blocks_long =
242 div_u64(bdev_nr_bytes(ib_dev->ibd_bd), block_size) - 1;
244 if (block_size == dev->dev_attrib.block_size)
247 switch (block_size) {
249 switch (dev->dev_attrib.block_size) {
264 switch (dev->dev_attrib.block_size) {
279 switch (dev->dev_attrib.block_size) {
294 switch (dev->dev_attrib.block_size) {
315 static void iblock_complete_cmd(struct se_cmd *cmd, blk_status_t blk_status)
317 struct iblock_req *ibr = cmd->priv;
320 if (!refcount_dec_and_test(&ibr->pending))
323 if (blk_status == BLK_STS_RESV_CONFLICT)
324 status = SAM_STAT_RESERVATION_CONFLICT;
325 else if (atomic_read(&ibr->ib_bio_err_cnt))
326 status = SAM_STAT_CHECK_CONDITION;
328 status = SAM_STAT_GOOD;
330 target_complete_cmd(cmd, status);
334 static void iblock_bio_done(struct bio *bio)
336 struct se_cmd *cmd = bio->bi_private;
337 struct iblock_req *ibr = cmd->priv;
338 blk_status_t blk_status = bio->bi_status;
340 if (bio->bi_status) {
341 pr_err("bio error: %p, err: %d\n", bio, bio->bi_status);
343 * Bump the ib_bio_err_cnt and release bio.
345 atomic_inc(&ibr->ib_bio_err_cnt);
346 smp_mb__after_atomic();
351 iblock_complete_cmd(cmd, blk_status);
354 static struct bio *iblock_get_bio(struct se_cmd *cmd, sector_t lba, u32 sg_num,
357 struct iblock_dev *ib_dev = IBLOCK_DEV(cmd->se_dev);
361 * Only allocate as many vector entries as the bio code allows us to,
362 * we'll loop later on until we have handled the whole request.
364 bio = bio_alloc_bioset(ib_dev->ibd_bd, bio_max_segs(sg_num), opf,
365 GFP_NOIO, &ib_dev->ibd_bio_set);
367 pr_err("Unable to allocate memory for bio\n");
371 bio->bi_private = cmd;
372 bio->bi_end_io = &iblock_bio_done;
373 bio->bi_iter.bi_sector = lba;
378 static void iblock_submit_bios(struct bio_list *list)
380 struct blk_plug plug;
383 * The block layer handles nested plugs, so just plug/unplug to handle
384 * fabric drivers that didn't support batching and multi bio cmds.
386 blk_start_plug(&plug);
387 while ((bio = bio_list_pop(list)))
389 blk_finish_plug(&plug);
392 static void iblock_end_io_flush(struct bio *bio)
394 struct se_cmd *cmd = bio->bi_private;
397 pr_err("IBLOCK: cache flush failed: %d\n", bio->bi_status);
401 target_complete_cmd(cmd, SAM_STAT_CHECK_CONDITION);
403 target_complete_cmd(cmd, SAM_STAT_GOOD);
410 * Implement SYCHRONIZE CACHE. Note that we can't handle lba ranges and must
411 * always flush the whole cache.
413 static sense_reason_t
414 iblock_execute_sync_cache(struct se_cmd *cmd)
416 struct iblock_dev *ib_dev = IBLOCK_DEV(cmd->se_dev);
417 int immed = (cmd->t_task_cdb[1] & 0x2);
421 * If the Immediate bit is set, queue up the GOOD response
422 * for this SYNCHRONIZE_CACHE op.
425 target_complete_cmd(cmd, SAM_STAT_GOOD);
427 bio = bio_alloc(ib_dev->ibd_bd, 0, REQ_OP_WRITE | REQ_PREFLUSH,
429 bio->bi_end_io = iblock_end_io_flush;
431 bio->bi_private = cmd;
436 static sense_reason_t
437 iblock_execute_unmap(struct se_cmd *cmd, sector_t lba, sector_t nolb)
439 struct block_device *bdev = IBLOCK_DEV(cmd->se_dev)->ibd_bd;
440 struct se_device *dev = cmd->se_dev;
443 ret = blkdev_issue_discard(bdev,
444 target_to_linux_sector(dev, lba),
445 target_to_linux_sector(dev, nolb),
448 pr_err("blkdev_issue_discard() failed: %d\n", ret);
449 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
455 static sense_reason_t
456 iblock_execute_zero_out(struct block_device *bdev, struct se_cmd *cmd)
458 struct se_device *dev = cmd->se_dev;
459 struct scatterlist *sg = &cmd->t_data_sg[0];
460 unsigned char *buf, *not_zero;
463 buf = kmap(sg_page(sg)) + sg->offset;
465 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
467 * Fall back to block_execute_write_same() slow-path if
468 * incoming WRITE_SAME payload does not contain zeros.
470 not_zero = memchr_inv(buf, 0x00, cmd->data_length);
474 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
476 ret = blkdev_issue_zeroout(bdev,
477 target_to_linux_sector(dev, cmd->t_task_lba),
478 target_to_linux_sector(dev,
479 sbc_get_write_same_sectors(cmd)),
480 GFP_KERNEL, BLKDEV_ZERO_NOUNMAP);
482 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
484 target_complete_cmd(cmd, SAM_STAT_GOOD);
488 static sense_reason_t
489 iblock_execute_write_same(struct se_cmd *cmd)
491 struct block_device *bdev = IBLOCK_DEV(cmd->se_dev)->ibd_bd;
492 struct iblock_req *ibr;
493 struct scatterlist *sg;
495 struct bio_list list;
496 struct se_device *dev = cmd->se_dev;
497 sector_t block_lba = target_to_linux_sector(dev, cmd->t_task_lba);
498 sector_t sectors = target_to_linux_sector(dev,
499 sbc_get_write_same_sectors(cmd));
502 pr_err("WRITE_SAME: Protection information with IBLOCK"
503 " backends not supported\n");
504 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
507 if (!cmd->t_data_nents)
508 return TCM_INVALID_CDB_FIELD;
510 sg = &cmd->t_data_sg[0];
512 if (cmd->t_data_nents > 1 ||
513 sg->length != cmd->se_dev->dev_attrib.block_size) {
514 pr_err("WRITE_SAME: Illegal SGL t_data_nents: %u length: %u"
515 " block_size: %u\n", cmd->t_data_nents, sg->length,
516 cmd->se_dev->dev_attrib.block_size);
517 return TCM_INVALID_CDB_FIELD;
520 if (bdev_write_zeroes_sectors(bdev)) {
521 if (!iblock_execute_zero_out(bdev, cmd))
525 ibr = kzalloc(sizeof(struct iblock_req), GFP_KERNEL);
530 bio = iblock_get_bio(cmd, block_lba, 1, REQ_OP_WRITE);
534 bio_list_init(&list);
535 bio_list_add(&list, bio);
537 refcount_set(&ibr->pending, 1);
540 while (bio_add_page(bio, sg_page(sg), sg->length, sg->offset)
543 bio = iblock_get_bio(cmd, block_lba, 1, REQ_OP_WRITE);
547 refcount_inc(&ibr->pending);
548 bio_list_add(&list, bio);
551 /* Always in 512 byte units for Linux/Block */
552 block_lba += sg->length >> SECTOR_SHIFT;
553 sectors -= sg->length >> SECTOR_SHIFT;
556 iblock_submit_bios(&list);
560 while ((bio = bio_list_pop(&list)))
565 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
569 Opt_udev_path, Opt_readonly, Opt_force, Opt_err
572 static match_table_t tokens = {
573 {Opt_udev_path, "udev_path=%s"},
574 {Opt_readonly, "readonly=%d"},
575 {Opt_force, "force=%d"},
579 static ssize_t iblock_set_configfs_dev_params(struct se_device *dev,
580 const char *page, ssize_t count)
582 struct iblock_dev *ib_dev = IBLOCK_DEV(dev);
583 char *orig, *ptr, *arg_p, *opts;
584 substring_t args[MAX_OPT_ARGS];
586 unsigned long tmp_readonly;
588 opts = kstrdup(page, GFP_KERNEL);
594 while ((ptr = strsep(&opts, ",\n")) != NULL) {
598 token = match_token(ptr, tokens, args);
601 if (ib_dev->ibd_bd) {
602 pr_err("Unable to set udev_path= while"
603 " ib_dev->ibd_bd exists\n");
607 if (match_strlcpy(ib_dev->ibd_udev_path, &args[0],
608 SE_UDEV_PATH_LEN) == 0) {
612 pr_debug("IBLOCK: Referencing UDEV path: %s\n",
613 ib_dev->ibd_udev_path);
614 ib_dev->ibd_flags |= IBDF_HAS_UDEV_PATH;
617 arg_p = match_strdup(&args[0]);
622 ret = kstrtoul(arg_p, 0, &tmp_readonly);
625 pr_err("kstrtoul() failed for"
629 ib_dev->ibd_readonly = tmp_readonly;
630 pr_debug("IBLOCK: readonly: %d\n", ib_dev->ibd_readonly);
641 return (!ret) ? count : ret;
644 static ssize_t iblock_show_configfs_dev_params(struct se_device *dev, char *b)
646 struct iblock_dev *ib_dev = IBLOCK_DEV(dev);
647 struct block_device *bd = ib_dev->ibd_bd;
651 bl += sprintf(b + bl, "iBlock device: %pg", bd);
652 if (ib_dev->ibd_flags & IBDF_HAS_UDEV_PATH)
653 bl += sprintf(b + bl, " UDEV PATH: %s",
654 ib_dev->ibd_udev_path);
655 bl += sprintf(b + bl, " readonly: %d\n", ib_dev->ibd_readonly);
657 bl += sprintf(b + bl, " ");
659 bl += sprintf(b + bl, "Major: %d Minor: %d %s\n",
660 MAJOR(bd->bd_dev), MINOR(bd->bd_dev),
663 bl += sprintf(b + bl, "Major: 0 Minor: 0\n");
670 iblock_alloc_bip(struct se_cmd *cmd, struct bio *bio,
671 struct sg_mapping_iter *miter)
673 struct se_device *dev = cmd->se_dev;
674 struct blk_integrity *bi;
675 struct bio_integrity_payload *bip;
676 struct iblock_dev *ib_dev = IBLOCK_DEV(dev);
680 bi = bdev_get_integrity(ib_dev->ibd_bd);
682 pr_err("Unable to locate bio_integrity\n");
686 bip = bio_integrity_alloc(bio, GFP_NOIO, bio_max_segs(cmd->t_prot_nents));
688 pr_err("Unable to allocate bio_integrity_payload\n");
692 bip->bip_iter.bi_size = bio_integrity_bytes(bi, bio_sectors(bio));
693 /* virtual start sector must be in integrity interval units */
694 bip_set_seed(bip, bio->bi_iter.bi_sector >>
695 (bi->interval_exp - SECTOR_SHIFT));
697 pr_debug("IBLOCK BIP Size: %u Sector: %llu\n", bip->bip_iter.bi_size,
698 (unsigned long long)bip->bip_iter.bi_sector);
700 resid = bip->bip_iter.bi_size;
701 while (resid > 0 && sg_miter_next(miter)) {
703 len = min_t(size_t, miter->length, resid);
704 rc = bio_integrity_add_page(bio, miter->page, len,
705 offset_in_page(miter->addr));
707 pr_err("bio_integrity_add_page() failed; %d\n", rc);
708 sg_miter_stop(miter);
712 pr_debug("Added bio integrity page: %p length: %zu offset: %lu\n",
713 miter->page, len, offset_in_page(miter->addr));
716 if (len < miter->length)
717 miter->consumed -= miter->length - len;
719 sg_miter_stop(miter);
724 static sense_reason_t
725 iblock_execute_rw(struct se_cmd *cmd, struct scatterlist *sgl, u32 sgl_nents,
726 enum dma_data_direction data_direction)
728 struct se_device *dev = cmd->se_dev;
729 sector_t block_lba = target_to_linux_sector(dev, cmd->t_task_lba);
730 struct iblock_req *ibr;
732 struct bio_list list;
733 struct scatterlist *sg;
734 u32 sg_num = sgl_nents;
738 struct sg_mapping_iter prot_miter;
739 unsigned int miter_dir;
741 if (data_direction == DMA_TO_DEVICE) {
742 struct iblock_dev *ib_dev = IBLOCK_DEV(dev);
744 * Force writethrough using REQ_FUA if a volatile write cache
745 * is not enabled, or if initiator set the Force Unit Access bit.
748 miter_dir = SG_MITER_TO_SG;
749 if (bdev_fua(ib_dev->ibd_bd)) {
750 if (cmd->se_cmd_flags & SCF_FUA)
752 else if (!bdev_write_cache(ib_dev->ibd_bd))
757 miter_dir = SG_MITER_FROM_SG;
760 ibr = kzalloc(sizeof(struct iblock_req), GFP_KERNEL);
766 refcount_set(&ibr->pending, 1);
767 iblock_complete_cmd(cmd, BLK_STS_OK);
771 bio = iblock_get_bio(cmd, block_lba, sgl_nents, opf);
775 bio_list_init(&list);
776 bio_list_add(&list, bio);
778 refcount_set(&ibr->pending, 2);
781 if (cmd->prot_type && dev->dev_attrib.pi_prot_type)
782 sg_miter_start(&prot_miter, cmd->t_prot_sg, cmd->t_prot_nents,
785 for_each_sg(sgl, sg, sgl_nents, i) {
787 * XXX: if the length the device accepts is shorter than the
788 * length of the S/G list entry this will cause and
789 * endless loop. Better hope no driver uses huge pages.
791 while (bio_add_page(bio, sg_page(sg), sg->length, sg->offset)
793 if (cmd->prot_type && dev->dev_attrib.pi_prot_type) {
794 rc = iblock_alloc_bip(cmd, bio, &prot_miter);
799 if (bio_cnt >= IBLOCK_MAX_BIO_PER_TASK) {
800 iblock_submit_bios(&list);
804 bio = iblock_get_bio(cmd, block_lba, sg_num, opf);
808 refcount_inc(&ibr->pending);
809 bio_list_add(&list, bio);
813 /* Always in 512 byte units for Linux/Block */
814 block_lba += sg->length >> SECTOR_SHIFT;
818 if (cmd->prot_type && dev->dev_attrib.pi_prot_type) {
819 rc = iblock_alloc_bip(cmd, bio, &prot_miter);
824 iblock_submit_bios(&list);
825 iblock_complete_cmd(cmd, BLK_STS_OK);
829 while ((bio = bio_list_pop(&list)))
834 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
837 static sense_reason_t iblock_execute_pr_out(struct se_cmd *cmd, u8 sa, u64 key,
838 u64 sa_key, u8 type, bool aptpl)
840 struct se_device *dev = cmd->se_dev;
841 struct iblock_dev *ib_dev = IBLOCK_DEV(dev);
842 struct block_device *bdev = ib_dev->ibd_bd;
843 const struct pr_ops *ops = bdev->bd_disk->fops->pr_ops;
847 pr_err("Block device does not support pr_ops but iblock device has been configured for PR passthrough.\n");
848 return TCM_UNSUPPORTED_SCSI_OPCODE;
853 case PRO_REGISTER_AND_IGNORE_EXISTING_KEY:
854 if (!ops->pr_register) {
855 pr_err("block device does not support pr_register.\n");
856 return TCM_UNSUPPORTED_SCSI_OPCODE;
859 /* The block layer pr ops always enables aptpl */
861 pr_info("APTPL not set by initiator, but will be used.\n");
863 ret = ops->pr_register(bdev, key, sa_key,
864 sa == PRO_REGISTER ? 0 : PR_FL_IGNORE_KEY);
867 if (!ops->pr_reserve) {
868 pr_err("block_device does not support pr_reserve.\n");
869 return TCM_UNSUPPORTED_SCSI_OPCODE;
872 ret = ops->pr_reserve(bdev, key, scsi_pr_type_to_block(type), 0);
875 if (!ops->pr_clear) {
876 pr_err("block_device does not support pr_clear.\n");
877 return TCM_UNSUPPORTED_SCSI_OPCODE;
880 ret = ops->pr_clear(bdev, key);
883 case PRO_PREEMPT_AND_ABORT:
884 if (!ops->pr_clear) {
885 pr_err("block_device does not support pr_preempt.\n");
886 return TCM_UNSUPPORTED_SCSI_OPCODE;
889 ret = ops->pr_preempt(bdev, key, sa_key,
890 scsi_pr_type_to_block(type),
891 sa == PRO_PREEMPT ? false : true);
894 if (!ops->pr_clear) {
895 pr_err("block_device does not support pr_pclear.\n");
896 return TCM_UNSUPPORTED_SCSI_OPCODE;
899 ret = ops->pr_release(bdev, key, scsi_pr_type_to_block(type));
902 pr_err("Unknown PERSISTENT_RESERVE_OUT SA: 0x%02x\n", sa);
903 return TCM_UNSUPPORTED_SCSI_OPCODE;
908 else if (ret == PR_STS_RESERVATION_CONFLICT)
909 return TCM_RESERVATION_CONFLICT;
911 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
914 static void iblock_pr_report_caps(unsigned char *param_data)
918 put_unaligned_be16(len, ¶m_data[0]);
920 * When using the pr_ops passthrough method we only support exporting
921 * the device through one target port because from the backend module
922 * level we can't see the target port config. As a result we only
923 * support registration directly from the I_T nexus the cmd is sent
924 * through and do not set ATP_C here.
926 * The block layer pr_ops do not support passing in initiators so
927 * we don't set SIP_C here.
929 /* PTPL_C: Persistence across Target Power Loss bit */
930 param_data[2] |= 0x01;
932 * We are filling in the PERSISTENT RESERVATION TYPE MASK below, so
933 * set the TMV: Task Mask Valid bit.
935 param_data[3] |= 0x80;
937 * Change ALLOW COMMANDs to 0x20 or 0x40 later from Table 166
939 param_data[3] |= 0x10; /* ALLOW COMMANDs field 001b */
941 * PTPL_A: Persistence across Target Power Loss Active bit. The block
942 * layer pr ops always enables this so report it active.
944 param_data[3] |= 0x01;
946 * Setup the PERSISTENT RESERVATION TYPE MASK from Table 212 spc4r37.
948 param_data[4] |= 0x80; /* PR_TYPE_EXCLUSIVE_ACCESS_ALLREG */
949 param_data[4] |= 0x40; /* PR_TYPE_EXCLUSIVE_ACCESS_REGONLY */
950 param_data[4] |= 0x20; /* PR_TYPE_WRITE_EXCLUSIVE_REGONLY */
951 param_data[4] |= 0x08; /* PR_TYPE_EXCLUSIVE_ACCESS */
952 param_data[4] |= 0x02; /* PR_TYPE_WRITE_EXCLUSIVE */
953 param_data[5] |= 0x01; /* PR_TYPE_EXCLUSIVE_ACCESS_ALLREG */
956 static sense_reason_t iblock_pr_read_keys(struct se_cmd *cmd,
957 unsigned char *param_data)
959 struct se_device *dev = cmd->se_dev;
960 struct iblock_dev *ib_dev = IBLOCK_DEV(dev);
961 struct block_device *bdev = ib_dev->ibd_bd;
962 const struct pr_ops *ops = bdev->bd_disk->fops->pr_ops;
963 int i, len, paths, data_offset;
964 struct pr_keys *keys;
968 pr_err("Block device does not support pr_ops but iblock device has been configured for PR passthrough.\n");
969 return TCM_UNSUPPORTED_SCSI_OPCODE;
972 if (!ops->pr_read_keys) {
973 pr_err("Block device does not support read_keys.\n");
974 return TCM_UNSUPPORTED_SCSI_OPCODE;
978 * We don't know what's under us, but dm-multipath will register every
979 * path with the same key, so start off with enough space for 16 paths.
980 * which is not a lot of memory and should normally be enough.
985 keys = kzalloc(sizeof(*keys) + len, GFP_KERNEL);
987 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
989 keys->num_keys = paths;
990 if (!ops->pr_read_keys(bdev, keys)) {
991 if (keys->num_keys > paths) {
997 ret = TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
1003 put_unaligned_be32(keys->generation, ¶m_data[0]);
1004 if (!keys->num_keys) {
1005 put_unaligned_be32(0, ¶m_data[4]);
1009 put_unaligned_be32(8 * keys->num_keys, ¶m_data[4]);
1012 for (i = 0; i < keys->num_keys; i++) {
1013 if (data_offset + 8 > cmd->data_length)
1016 put_unaligned_be64(keys->keys[i], ¶m_data[data_offset]);
1025 static sense_reason_t iblock_pr_read_reservation(struct se_cmd *cmd,
1026 unsigned char *param_data)
1028 struct se_device *dev = cmd->se_dev;
1029 struct iblock_dev *ib_dev = IBLOCK_DEV(dev);
1030 struct block_device *bdev = ib_dev->ibd_bd;
1031 const struct pr_ops *ops = bdev->bd_disk->fops->pr_ops;
1032 struct pr_held_reservation rsv = { };
1035 pr_err("Block device does not support pr_ops but iblock device has been configured for PR passthrough.\n");
1036 return TCM_UNSUPPORTED_SCSI_OPCODE;
1039 if (!ops->pr_read_reservation) {
1040 pr_err("Block device does not support read_keys.\n");
1041 return TCM_UNSUPPORTED_SCSI_OPCODE;
1044 if (ops->pr_read_reservation(bdev, &rsv))
1045 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
1047 put_unaligned_be32(rsv.generation, ¶m_data[0]);
1048 if (!block_pr_type_to_scsi(rsv.type)) {
1049 put_unaligned_be32(0, ¶m_data[4]);
1050 return TCM_NO_SENSE;
1053 put_unaligned_be32(16, ¶m_data[4]);
1055 if (cmd->data_length < 16)
1056 return TCM_NO_SENSE;
1057 put_unaligned_be64(rsv.key, ¶m_data[8]);
1059 if (cmd->data_length < 22)
1060 return TCM_NO_SENSE;
1061 param_data[21] = block_pr_type_to_scsi(rsv.type);
1063 return TCM_NO_SENSE;
1066 static sense_reason_t iblock_execute_pr_in(struct se_cmd *cmd, u8 sa,
1067 unsigned char *param_data)
1069 sense_reason_t ret = TCM_NO_SENSE;
1072 case PRI_REPORT_CAPABILITIES:
1073 iblock_pr_report_caps(param_data);
1076 ret = iblock_pr_read_keys(cmd, param_data);
1078 case PRI_READ_RESERVATION:
1079 ret = iblock_pr_read_reservation(cmd, param_data);
1082 pr_err("Unknown PERSISTENT_RESERVE_IN SA: 0x%02x\n", sa);
1083 return TCM_UNSUPPORTED_SCSI_OPCODE;
1089 static sector_t iblock_get_alignment_offset_lbas(struct se_device *dev)
1091 struct iblock_dev *ib_dev = IBLOCK_DEV(dev);
1092 struct block_device *bd = ib_dev->ibd_bd;
1095 ret = bdev_alignment_offset(bd);
1099 /* convert offset-bytes to offset-lbas */
1100 return ret / bdev_logical_block_size(bd);
1103 static unsigned int iblock_get_lbppbe(struct se_device *dev)
1105 struct iblock_dev *ib_dev = IBLOCK_DEV(dev);
1106 struct block_device *bd = ib_dev->ibd_bd;
1107 unsigned int logs_per_phys =
1108 bdev_physical_block_size(bd) / bdev_logical_block_size(bd);
1110 return ilog2(logs_per_phys);
1113 static unsigned int iblock_get_io_min(struct se_device *dev)
1115 struct iblock_dev *ib_dev = IBLOCK_DEV(dev);
1116 struct block_device *bd = ib_dev->ibd_bd;
1118 return bdev_io_min(bd);
1121 static unsigned int iblock_get_io_opt(struct se_device *dev)
1123 struct iblock_dev *ib_dev = IBLOCK_DEV(dev);
1124 struct block_device *bd = ib_dev->ibd_bd;
1126 return bdev_io_opt(bd);
1129 static struct exec_cmd_ops iblock_exec_cmd_ops = {
1130 .execute_rw = iblock_execute_rw,
1131 .execute_sync_cache = iblock_execute_sync_cache,
1132 .execute_write_same = iblock_execute_write_same,
1133 .execute_unmap = iblock_execute_unmap,
1134 .execute_pr_out = iblock_execute_pr_out,
1135 .execute_pr_in = iblock_execute_pr_in,
1138 static sense_reason_t
1139 iblock_parse_cdb(struct se_cmd *cmd)
1141 return sbc_parse_cdb(cmd, &iblock_exec_cmd_ops);
1144 static bool iblock_get_write_cache(struct se_device *dev)
1146 return bdev_write_cache(IBLOCK_DEV(dev)->ibd_bd);
1149 static const struct target_backend_ops iblock_ops = {
1151 .inquiry_prod = "IBLOCK",
1152 .transport_flags_changeable = TRANSPORT_FLAG_PASSTHROUGH_PGR,
1153 .inquiry_rev = IBLOCK_VERSION,
1154 .owner = THIS_MODULE,
1155 .attach_hba = iblock_attach_hba,
1156 .detach_hba = iblock_detach_hba,
1157 .alloc_device = iblock_alloc_device,
1158 .configure_device = iblock_configure_device,
1159 .destroy_device = iblock_destroy_device,
1160 .free_device = iblock_free_device,
1161 .configure_unmap = iblock_configure_unmap,
1162 .plug_device = iblock_plug_device,
1163 .unplug_device = iblock_unplug_device,
1164 .parse_cdb = iblock_parse_cdb,
1165 .set_configfs_dev_params = iblock_set_configfs_dev_params,
1166 .show_configfs_dev_params = iblock_show_configfs_dev_params,
1167 .get_device_type = sbc_get_device_type,
1168 .get_blocks = iblock_get_blocks,
1169 .get_alignment_offset_lbas = iblock_get_alignment_offset_lbas,
1170 .get_lbppbe = iblock_get_lbppbe,
1171 .get_io_min = iblock_get_io_min,
1172 .get_io_opt = iblock_get_io_opt,
1173 .get_write_cache = iblock_get_write_cache,
1174 .tb_dev_attrib_attrs = sbc_attrib_attrs,
1177 static int __init iblock_module_init(void)
1179 return transport_backend_register(&iblock_ops);
1182 static void __exit iblock_module_exit(void)
1184 target_backend_unregister(&iblock_ops);
1187 MODULE_DESCRIPTION("TCM IBLOCK subsystem plugin");
1188 MODULE_AUTHOR("nab@Linux-iSCSI.org");
1189 MODULE_LICENSE("GPL");
1191 module_init(iblock_module_init);
1192 module_exit(iblock_module_exit);