1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*******************************************************************************
3 * Filename: target_core_xcopy.c
5 * This file contains support for SPC-4 Extended-Copy offload with generic
8 * Copyright (c) 2011-2013 Datera, Inc. All rights reserved.
11 * Nicholas A. Bellinger <nab@daterainc.com>
13 ******************************************************************************/
15 #include <linux/slab.h>
16 #include <linux/spinlock.h>
17 #include <linux/list.h>
18 #include <linux/configfs.h>
19 #include <linux/ratelimit.h>
20 #include <scsi/scsi_proto.h>
21 #include <asm/unaligned.h>
23 #include <target/target_core_base.h>
24 #include <target/target_core_backend.h>
25 #include <target/target_core_fabric.h>
27 #include "target_core_internal.h"
28 #include "target_core_pr.h"
29 #include "target_core_ua.h"
30 #include "target_core_xcopy.h"
32 static struct workqueue_struct
*xcopy_wq
= NULL
;
34 static sense_reason_t
target_parse_xcopy_cmd(struct xcopy_op
*xop
);
37 * target_xcopy_locate_se_dev_e4_iter - compare XCOPY NAA device identifiers
39 * @se_dev: device being considered for match
40 * @dev_wwn: XCOPY requested NAA dev_wwn
41 * @return: 1 on match, 0 on no-match
43 static int target_xcopy_locate_se_dev_e4_iter(struct se_device
*se_dev
,
44 const unsigned char *dev_wwn
)
46 unsigned char tmp_dev_wwn
[XCOPY_NAA_IEEE_REGEX_LEN
];
49 if (!se_dev
->dev_attrib
.emulate_3pc
) {
50 pr_debug("XCOPY: emulate_3pc disabled on se_dev %p\n", se_dev
);
54 memset(&tmp_dev_wwn
[0], 0, XCOPY_NAA_IEEE_REGEX_LEN
);
55 spc_gen_naa_6h_vendor_specific(se_dev
, &tmp_dev_wwn
[0]);
57 rc
= memcmp(&tmp_dev_wwn
[0], dev_wwn
, XCOPY_NAA_IEEE_REGEX_LEN
);
59 pr_debug("XCOPY: skip non-matching: %*ph\n",
60 XCOPY_NAA_IEEE_REGEX_LEN
, tmp_dev_wwn
);
63 pr_debug("XCOPY 0xe4: located se_dev: %p\n", se_dev
);
68 static int target_xcopy_locate_se_dev_e4(struct se_session
*sess
,
69 const unsigned char *dev_wwn
,
70 struct se_device
**_found_dev
,
71 struct percpu_ref
**_found_lun_ref
)
73 struct se_dev_entry
*deve
;
74 struct se_node_acl
*nacl
;
75 struct se_lun
*this_lun
= NULL
;
76 struct se_device
*found_dev
= NULL
;
78 /* cmd with NULL sess indicates no associated $FABRIC_MOD */
82 pr_debug("XCOPY 0xe4: searching for: %*ph\n",
83 XCOPY_NAA_IEEE_REGEX_LEN
, dev_wwn
);
85 nacl
= sess
->se_node_acl
;
87 hlist_for_each_entry_rcu(deve
, &nacl
->lun_entry_hlist
, link
) {
88 struct se_device
*this_dev
;
91 this_lun
= rcu_dereference(deve
->se_lun
);
92 this_dev
= rcu_dereference_raw(this_lun
->lun_se_dev
);
94 rc
= target_xcopy_locate_se_dev_e4_iter(this_dev
, dev_wwn
);
96 if (percpu_ref_tryget_live(&this_lun
->lun_ref
))
102 if (found_dev
== NULL
)
105 pr_debug("lun_ref held for se_dev: %p se_dev->se_dev_group: %p\n",
106 found_dev
, &found_dev
->dev_group
);
107 *_found_dev
= found_dev
;
108 *_found_lun_ref
= &this_lun
->lun_ref
;
111 pr_debug_ratelimited("Unable to locate 0xe4 descriptor for EXTENDED_COPY\n");
115 static int target_xcopy_parse_tiddesc_e4(struct se_cmd
*se_cmd
, struct xcopy_op
*xop
,
116 unsigned char *p
, unsigned short cscd_index
)
118 unsigned char *desc
= p
;
122 * Extract RELATIVE INITIATOR PORT IDENTIFIER
124 ript
= get_unaligned_be16(&desc
[2]);
125 pr_debug("XCOPY 0xe4: RELATIVE INITIATOR PORT IDENTIFIER: %hu\n", ript
);
127 * Check for supported code set, association, and designator type
129 if ((desc
[4] & 0x0f) != 0x1) {
130 pr_err("XCOPY 0xe4: code set of non binary type not supported\n");
133 if ((desc
[5] & 0x30) != 0x00) {
134 pr_err("XCOPY 0xe4: association other than LUN not supported\n");
137 if ((desc
[5] & 0x0f) != 0x3) {
138 pr_err("XCOPY 0xe4: designator type unsupported: 0x%02x\n",
143 * Check for matching 16 byte length for NAA IEEE Registered Extended
144 * Assigned designator
147 if (desig_len
!= XCOPY_NAA_IEEE_REGEX_LEN
) {
148 pr_err("XCOPY 0xe4: invalid desig_len: %d\n", (int)desig_len
);
151 pr_debug("XCOPY 0xe4: desig_len: %d\n", (int)desig_len
);
153 * Check for NAA IEEE Registered Extended Assigned header..
155 if ((desc
[8] & 0xf0) != 0x60) {
156 pr_err("XCOPY 0xe4: Unsupported DESIGNATOR TYPE: 0x%02x\n",
161 if (cscd_index
!= xop
->stdi
&& cscd_index
!= xop
->dtdi
) {
162 pr_debug("XCOPY 0xe4: ignoring CSCD entry %d - neither src nor "
163 "dest\n", cscd_index
);
167 if (cscd_index
== xop
->stdi
) {
168 memcpy(&xop
->src_tid_wwn
[0], &desc
[8], XCOPY_NAA_IEEE_REGEX_LEN
);
170 * Determine if the source designator matches the local device
172 if (!memcmp(&xop
->local_dev_wwn
[0], &xop
->src_tid_wwn
[0],
173 XCOPY_NAA_IEEE_REGEX_LEN
)) {
174 xop
->op_origin
= XCOL_SOURCE_RECV_OP
;
175 xop
->src_dev
= se_cmd
->se_dev
;
176 pr_debug("XCOPY 0xe4: Set xop->src_dev %p from source"
177 " received xop\n", xop
->src_dev
);
181 if (cscd_index
== xop
->dtdi
) {
182 memcpy(&xop
->dst_tid_wwn
[0], &desc
[8], XCOPY_NAA_IEEE_REGEX_LEN
);
184 * Determine if the destination designator matches the local
185 * device. If @cscd_index corresponds to both source (stdi) and
186 * destination (dtdi), or dtdi comes after stdi, then
187 * XCOL_DEST_RECV_OP wins.
189 if (!memcmp(&xop
->local_dev_wwn
[0], &xop
->dst_tid_wwn
[0],
190 XCOPY_NAA_IEEE_REGEX_LEN
)) {
191 xop
->op_origin
= XCOL_DEST_RECV_OP
;
192 xop
->dst_dev
= se_cmd
->se_dev
;
193 pr_debug("XCOPY 0xe4: Set xop->dst_dev: %p from destination"
194 " received xop\n", xop
->dst_dev
);
201 static int target_xcopy_parse_target_descriptors(struct se_cmd
*se_cmd
,
202 struct xcopy_op
*xop
, unsigned char *p
,
203 unsigned short tdll
, sense_reason_t
*sense_ret
)
205 struct se_device
*local_dev
= se_cmd
->se_dev
;
206 unsigned char *desc
= p
;
207 int offset
= tdll
% XCOPY_TARGET_DESC_LEN
, rc
;
208 unsigned short cscd_index
= 0;
209 unsigned short start
= 0;
211 *sense_ret
= TCM_INVALID_PARAMETER_LIST
;
214 pr_err("XCOPY target descriptor list length is not"
215 " multiple of %d\n", XCOPY_TARGET_DESC_LEN
);
216 *sense_ret
= TCM_UNSUPPORTED_TARGET_DESC_TYPE_CODE
;
219 if (tdll
> RCR_OP_MAX_TARGET_DESC_COUNT
* XCOPY_TARGET_DESC_LEN
) {
220 pr_err("XCOPY target descriptor supports a maximum"
221 " two src/dest descriptors, tdll: %hu too large..\n", tdll
);
222 /* spc4r37 6.4.3.4 CSCD DESCRIPTOR LIST LENGTH field */
223 *sense_ret
= TCM_TOO_MANY_TARGET_DESCS
;
227 * Generate an IEEE Registered Extended designator based upon the
228 * se_device the XCOPY was received upon..
230 memset(&xop
->local_dev_wwn
[0], 0, XCOPY_NAA_IEEE_REGEX_LEN
);
231 spc_gen_naa_6h_vendor_specific(local_dev
, &xop
->local_dev_wwn
[0]);
233 while (start
< tdll
) {
235 * Check target descriptor identification with 0xE4 type, and
236 * compare the current index with the CSCD descriptor IDs in
237 * the segment descriptor. Use VPD 0x83 WWPN matching ..
241 rc
= target_xcopy_parse_tiddesc_e4(se_cmd
, xop
,
242 &desc
[0], cscd_index
);
245 start
+= XCOPY_TARGET_DESC_LEN
;
246 desc
+= XCOPY_TARGET_DESC_LEN
;
250 pr_err("XCOPY unsupported descriptor type code:"
251 " 0x%02x\n", desc
[0]);
252 *sense_ret
= TCM_UNSUPPORTED_TARGET_DESC_TYPE_CODE
;
257 switch (xop
->op_origin
) {
258 case XCOL_SOURCE_RECV_OP
:
259 rc
= target_xcopy_locate_se_dev_e4(se_cmd
->se_sess
,
262 &xop
->remote_lun_ref
);
264 case XCOL_DEST_RECV_OP
:
265 rc
= target_xcopy_locate_se_dev_e4(se_cmd
->se_sess
,
268 &xop
->remote_lun_ref
);
271 pr_err("XCOPY CSCD descriptor IDs not found in CSCD list - "
272 "stdi: %hu dtdi: %hu\n", xop
->stdi
, xop
->dtdi
);
277 * If a matching IEEE NAA 0x83 descriptor for the requested device
278 * is not located on this node, return COPY_ABORTED with ASQ/ASQC
279 * 0x0d/0x02 - COPY_TARGET_DEVICE_NOT_REACHABLE to request the
280 * initiator to fall back to normal copy method.
283 *sense_ret
= TCM_COPY_TARGET_DEVICE_NOT_REACHABLE
;
287 pr_debug("XCOPY TGT desc: Source dev: %p NAA IEEE WWN: 0x%16phN\n",
288 xop
->src_dev
, &xop
->src_tid_wwn
[0]);
289 pr_debug("XCOPY TGT desc: Dest dev: %p NAA IEEE WWN: 0x%16phN\n",
290 xop
->dst_dev
, &xop
->dst_tid_wwn
[0]);
298 static int target_xcopy_parse_segdesc_02(struct se_cmd
*se_cmd
, struct xcopy_op
*xop
,
301 unsigned char *desc
= p
;
302 int dc
= (desc
[1] & 0x02);
303 unsigned short desc_len
;
305 desc_len
= get_unaligned_be16(&desc
[2]);
306 if (desc_len
!= 0x18) {
307 pr_err("XCOPY segment desc 0x02: Illegal desc_len:"
312 xop
->stdi
= get_unaligned_be16(&desc
[4]);
313 xop
->dtdi
= get_unaligned_be16(&desc
[6]);
315 if (xop
->stdi
> XCOPY_CSCD_DESC_ID_LIST_OFF_MAX
||
316 xop
->dtdi
> XCOPY_CSCD_DESC_ID_LIST_OFF_MAX
) {
317 pr_err("XCOPY segment desc 0x02: unsupported CSCD ID > 0x%x; stdi: %hu dtdi: %hu\n",
318 XCOPY_CSCD_DESC_ID_LIST_OFF_MAX
, xop
->stdi
, xop
->dtdi
);
322 pr_debug("XCOPY seg desc 0x02: desc_len: %hu stdi: %hu dtdi: %hu, DC: %d\n",
323 desc_len
, xop
->stdi
, xop
->dtdi
, dc
);
325 xop
->nolb
= get_unaligned_be16(&desc
[10]);
326 xop
->src_lba
= get_unaligned_be64(&desc
[12]);
327 xop
->dst_lba
= get_unaligned_be64(&desc
[20]);
328 pr_debug("XCOPY seg desc 0x02: nolb: %hu src_lba: %llu dst_lba: %llu\n",
329 xop
->nolb
, (unsigned long long)xop
->src_lba
,
330 (unsigned long long)xop
->dst_lba
);
335 static int target_xcopy_parse_segment_descriptors(struct se_cmd
*se_cmd
,
336 struct xcopy_op
*xop
, unsigned char *p
,
337 unsigned int sdll
, sense_reason_t
*sense_ret
)
339 unsigned char *desc
= p
;
340 unsigned int start
= 0;
341 int offset
= sdll
% XCOPY_SEGMENT_DESC_LEN
, rc
, ret
= 0;
343 *sense_ret
= TCM_INVALID_PARAMETER_LIST
;
346 pr_err("XCOPY segment descriptor list length is not"
347 " multiple of %d\n", XCOPY_SEGMENT_DESC_LEN
);
348 *sense_ret
= TCM_UNSUPPORTED_SEGMENT_DESC_TYPE_CODE
;
351 if (sdll
> RCR_OP_MAX_SG_DESC_COUNT
* XCOPY_SEGMENT_DESC_LEN
) {
352 pr_err("XCOPY supports %u segment descriptor(s), sdll: %u too"
353 " large..\n", RCR_OP_MAX_SG_DESC_COUNT
, sdll
);
354 /* spc4r37 6.4.3.5 SEGMENT DESCRIPTOR LIST LENGTH field */
355 *sense_ret
= TCM_TOO_MANY_SEGMENT_DESCS
;
359 while (start
< sdll
) {
361 * Check segment descriptor type code for block -> block
365 rc
= target_xcopy_parse_segdesc_02(se_cmd
, xop
, desc
);
370 start
+= XCOPY_SEGMENT_DESC_LEN
;
371 desc
+= XCOPY_SEGMENT_DESC_LEN
;
374 pr_err("XCOPY unsupported segment descriptor"
375 "type: 0x%02x\n", desc
[0]);
376 *sense_ret
= TCM_UNSUPPORTED_SEGMENT_DESC_TYPE_CODE
;
391 struct xcopy_pt_cmd
{
392 struct se_cmd se_cmd
;
393 struct completion xpt_passthrough_sem
;
394 unsigned char sense_buffer
[TRANSPORT_SENSE_BUFFER
];
397 struct se_portal_group xcopy_pt_tpg
;
398 static struct se_session xcopy_pt_sess
;
399 static struct se_node_acl xcopy_pt_nacl
;
401 static int xcopy_pt_get_cmd_state(struct se_cmd
*se_cmd
)
406 static void xcopy_pt_undepend_remotedev(struct xcopy_op
*xop
)
408 if (xop
->op_origin
== XCOL_SOURCE_RECV_OP
)
409 pr_debug("putting dst lun_ref for %p\n", xop
->dst_dev
);
411 pr_debug("putting src lun_ref for %p\n", xop
->src_dev
);
413 percpu_ref_put(xop
->remote_lun_ref
);
416 static void xcopy_pt_release_cmd(struct se_cmd
*se_cmd
)
418 struct xcopy_pt_cmd
*xpt_cmd
= container_of(se_cmd
,
419 struct xcopy_pt_cmd
, se_cmd
);
421 /* xpt_cmd is on the stack, nothing to free here */
422 pr_debug("xpt_cmd done: %p\n", xpt_cmd
);
425 static int xcopy_pt_check_stop_free(struct se_cmd
*se_cmd
)
427 struct xcopy_pt_cmd
*xpt_cmd
= container_of(se_cmd
,
428 struct xcopy_pt_cmd
, se_cmd
);
430 complete(&xpt_cmd
->xpt_passthrough_sem
);
434 static int xcopy_pt_write_pending(struct se_cmd
*se_cmd
)
439 static int xcopy_pt_queue_data_in(struct se_cmd
*se_cmd
)
444 static int xcopy_pt_queue_status(struct se_cmd
*se_cmd
)
449 static const struct target_core_fabric_ops xcopy_pt_tfo
= {
450 .fabric_name
= "xcopy-pt",
451 .get_cmd_state
= xcopy_pt_get_cmd_state
,
452 .release_cmd
= xcopy_pt_release_cmd
,
453 .check_stop_free
= xcopy_pt_check_stop_free
,
454 .write_pending
= xcopy_pt_write_pending
,
455 .queue_data_in
= xcopy_pt_queue_data_in
,
456 .queue_status
= xcopy_pt_queue_status
,
463 int target_xcopy_setup_pt(void)
467 xcopy_wq
= alloc_workqueue("xcopy_wq", WQ_MEM_RECLAIM
, 0);
469 pr_err("Unable to allocate xcopy_wq\n");
473 memset(&xcopy_pt_tpg
, 0, sizeof(struct se_portal_group
));
474 INIT_LIST_HEAD(&xcopy_pt_tpg
.acl_node_list
);
475 INIT_LIST_HEAD(&xcopy_pt_tpg
.tpg_sess_list
);
477 xcopy_pt_tpg
.se_tpg_tfo
= &xcopy_pt_tfo
;
479 memset(&xcopy_pt_nacl
, 0, sizeof(struct se_node_acl
));
480 INIT_LIST_HEAD(&xcopy_pt_nacl
.acl_list
);
481 INIT_LIST_HEAD(&xcopy_pt_nacl
.acl_sess_list
);
482 memset(&xcopy_pt_sess
, 0, sizeof(struct se_session
));
483 ret
= transport_init_session(&xcopy_pt_sess
);
487 xcopy_pt_nacl
.se_tpg
= &xcopy_pt_tpg
;
488 xcopy_pt_nacl
.nacl_sess
= &xcopy_pt_sess
;
490 xcopy_pt_sess
.se_tpg
= &xcopy_pt_tpg
;
491 xcopy_pt_sess
.se_node_acl
= &xcopy_pt_nacl
;
496 destroy_workqueue(xcopy_wq
);
501 void target_xcopy_release_pt(void)
504 destroy_workqueue(xcopy_wq
);
505 transport_uninit_session(&xcopy_pt_sess
);
510 * target_xcopy_setup_pt_cmd - set up a pass-through command
511 * @xpt_cmd: Data structure to initialize.
512 * @xop: Describes the XCOPY operation received from an initiator.
513 * @se_dev: Backend device to associate with @xpt_cmd if
514 * @remote_port == true.
515 * @cdb: SCSI CDB to be copied into @xpt_cmd.
516 * @remote_port: If false, use the LUN through which the XCOPY command has
517 * been received. If true, use @se_dev->xcopy_lun.
519 * Set up a SCSI command (READ or WRITE) that will be used to execute an
522 static int target_xcopy_setup_pt_cmd(
523 struct xcopy_pt_cmd
*xpt_cmd
,
524 struct xcopy_op
*xop
,
525 struct se_device
*se_dev
,
529 struct se_cmd
*cmd
= &xpt_cmd
->se_cmd
;
532 * Setup LUN+port to honor reservations based upon xop->op_origin for
533 * X-COPY PUSH or X-COPY PULL based upon where the CDB was received.
536 cmd
->se_lun
= &se_dev
->xcopy_lun
;
537 cmd
->se_dev
= se_dev
;
539 cmd
->se_lun
= xop
->xop_se_cmd
->se_lun
;
540 cmd
->se_dev
= xop
->xop_se_cmd
->se_dev
;
542 cmd
->se_cmd_flags
|= SCF_SE_LUN_CMD
;
544 if (target_cmd_init_cdb(cmd
, cdb
, GFP_KERNEL
))
548 if (target_cmd_parse_cdb(cmd
))
551 if (transport_generic_map_mem_to_cmd(cmd
, xop
->xop_data_sg
,
552 xop
->xop_data_nents
, NULL
, 0))
555 pr_debug("Setup PASSTHROUGH_NOALLOC t_data_sg: %p t_data_nents:"
556 " %u\n", cmd
->t_data_sg
, cmd
->t_data_nents
);
561 static int target_xcopy_issue_pt_cmd(struct xcopy_pt_cmd
*xpt_cmd
)
563 struct se_cmd
*se_cmd
= &xpt_cmd
->se_cmd
;
564 sense_reason_t sense_rc
;
566 sense_rc
= transport_generic_new_cmd(se_cmd
);
570 if (se_cmd
->data_direction
== DMA_TO_DEVICE
)
571 target_execute_cmd(se_cmd
);
573 wait_for_completion_interruptible(&xpt_cmd
->xpt_passthrough_sem
);
575 pr_debug("target_xcopy_issue_pt_cmd(): SCSI status: 0x%02x\n",
576 se_cmd
->scsi_status
);
578 return (se_cmd
->scsi_status
) ? -EINVAL
: 0;
581 static int target_xcopy_read_source(
582 struct se_cmd
*ec_cmd
,
583 struct xcopy_op
*xop
,
584 struct se_device
*src_dev
,
588 struct xcopy_pt_cmd xpt_cmd
;
589 struct se_cmd
*se_cmd
= &xpt_cmd
.se_cmd
;
590 u32 length
= (src_sectors
* src_dev
->dev_attrib
.block_size
);
592 unsigned char cdb
[16];
593 bool remote_port
= (xop
->op_origin
== XCOL_DEST_RECV_OP
);
595 memset(&xpt_cmd
, 0, sizeof(xpt_cmd
));
596 init_completion(&xpt_cmd
.xpt_passthrough_sem
);
598 memset(&cdb
[0], 0, 16);
600 put_unaligned_be64(src_lba
, &cdb
[2]);
601 put_unaligned_be32(src_sectors
, &cdb
[10]);
602 pr_debug("XCOPY: Built READ_16: LBA: %llu Sectors: %u Length: %u\n",
603 (unsigned long long)src_lba
, src_sectors
, length
);
605 __target_init_cmd(se_cmd
, &xcopy_pt_tfo
, &xcopy_pt_sess
, length
,
606 DMA_FROM_DEVICE
, 0, &xpt_cmd
.sense_buffer
[0], 0);
608 rc
= target_xcopy_setup_pt_cmd(&xpt_cmd
, xop
, src_dev
, &cdb
[0],
611 ec_cmd
->scsi_status
= se_cmd
->scsi_status
;
615 pr_debug("XCOPY-READ: Saved xop->xop_data_sg: %p, num: %u for READ"
616 " memory\n", xop
->xop_data_sg
, xop
->xop_data_nents
);
618 rc
= target_xcopy_issue_pt_cmd(&xpt_cmd
);
620 ec_cmd
->scsi_status
= se_cmd
->scsi_status
;
622 transport_generic_free_cmd(se_cmd
, 0);
626 static int target_xcopy_write_destination(
627 struct se_cmd
*ec_cmd
,
628 struct xcopy_op
*xop
,
629 struct se_device
*dst_dev
,
633 struct xcopy_pt_cmd xpt_cmd
;
634 struct se_cmd
*se_cmd
= &xpt_cmd
.se_cmd
;
635 u32 length
= (dst_sectors
* dst_dev
->dev_attrib
.block_size
);
637 unsigned char cdb
[16];
638 bool remote_port
= (xop
->op_origin
== XCOL_SOURCE_RECV_OP
);
640 memset(&xpt_cmd
, 0, sizeof(xpt_cmd
));
641 init_completion(&xpt_cmd
.xpt_passthrough_sem
);
643 memset(&cdb
[0], 0, 16);
645 put_unaligned_be64(dst_lba
, &cdb
[2]);
646 put_unaligned_be32(dst_sectors
, &cdb
[10]);
647 pr_debug("XCOPY: Built WRITE_16: LBA: %llu Sectors: %u Length: %u\n",
648 (unsigned long long)dst_lba
, dst_sectors
, length
);
650 __target_init_cmd(se_cmd
, &xcopy_pt_tfo
, &xcopy_pt_sess
, length
,
651 DMA_TO_DEVICE
, 0, &xpt_cmd
.sense_buffer
[0], 0);
653 rc
= target_xcopy_setup_pt_cmd(&xpt_cmd
, xop
, dst_dev
, &cdb
[0],
656 ec_cmd
->scsi_status
= se_cmd
->scsi_status
;
660 rc
= target_xcopy_issue_pt_cmd(&xpt_cmd
);
662 ec_cmd
->scsi_status
= se_cmd
->scsi_status
;
664 transport_generic_free_cmd(se_cmd
, 0);
668 static void target_xcopy_do_work(struct work_struct
*work
)
670 struct xcopy_op
*xop
= container_of(work
, struct xcopy_op
, xop_work
);
671 struct se_cmd
*ec_cmd
= xop
->xop_se_cmd
;
672 struct se_device
*src_dev
, *dst_dev
;
673 sector_t src_lba
, dst_lba
, end_lba
;
674 unsigned int max_sectors
;
676 unsigned short nolb
, max_nolb
, copied_nolb
= 0;
677 sense_reason_t sense_rc
;
679 sense_rc
= target_parse_xcopy_cmd(xop
);
680 if (sense_rc
!= TCM_NO_SENSE
)
683 if (WARN_ON_ONCE(!xop
->src_dev
) || WARN_ON_ONCE(!xop
->dst_dev
)) {
684 sense_rc
= TCM_INVALID_PARAMETER_LIST
;
688 src_dev
= xop
->src_dev
;
689 dst_dev
= xop
->dst_dev
;
690 src_lba
= xop
->src_lba
;
691 dst_lba
= xop
->dst_lba
;
693 end_lba
= src_lba
+ nolb
;
695 * Break up XCOPY I/O into hw_max_sectors sized I/O based on the
696 * smallest max_sectors between src_dev + dev_dev, or
698 max_sectors
= min(src_dev
->dev_attrib
.hw_max_sectors
,
699 dst_dev
->dev_attrib
.hw_max_sectors
);
700 max_sectors
= min_t(u32
, max_sectors
, XCOPY_MAX_SECTORS
);
702 max_nolb
= min_t(u16
, max_sectors
, ((u16
)(~0U)));
704 pr_debug("target_xcopy_do_work: nolb: %hu, max_nolb: %hu end_lba: %llu\n",
705 nolb
, max_nolb
, (unsigned long long)end_lba
);
706 pr_debug("target_xcopy_do_work: Starting src_lba: %llu, dst_lba: %llu\n",
707 (unsigned long long)src_lba
, (unsigned long long)dst_lba
);
709 while (src_lba
< end_lba
) {
710 unsigned short cur_nolb
= min(nolb
, max_nolb
);
711 u32 cur_bytes
= cur_nolb
* src_dev
->dev_attrib
.block_size
;
713 if (cur_bytes
!= xop
->xop_data_bytes
) {
715 * (Re)allocate a buffer large enough to hold the XCOPY
716 * I/O size, which can be reused each read / write loop.
718 target_free_sgl(xop
->xop_data_sg
, xop
->xop_data_nents
);
719 rc
= target_alloc_sgl(&xop
->xop_data_sg
,
720 &xop
->xop_data_nents
,
725 xop
->xop_data_bytes
= cur_bytes
;
728 pr_debug("target_xcopy_do_work: Calling read src_dev: %p src_lba: %llu,"
729 " cur_nolb: %hu\n", src_dev
, (unsigned long long)src_lba
, cur_nolb
);
731 rc
= target_xcopy_read_source(ec_cmd
, xop
, src_dev
, src_lba
, cur_nolb
);
736 pr_debug("target_xcopy_do_work: Incremented READ src_lba to %llu\n",
737 (unsigned long long)src_lba
);
739 pr_debug("target_xcopy_do_work: Calling write dst_dev: %p dst_lba: %llu,"
740 " cur_nolb: %hu\n", dst_dev
, (unsigned long long)dst_lba
, cur_nolb
);
742 rc
= target_xcopy_write_destination(ec_cmd
, xop
, dst_dev
,
748 pr_debug("target_xcopy_do_work: Incremented WRITE dst_lba to %llu\n",
749 (unsigned long long)dst_lba
);
751 copied_nolb
+= cur_nolb
;
755 xcopy_pt_undepend_remotedev(xop
);
756 target_free_sgl(xop
->xop_data_sg
, xop
->xop_data_nents
);
759 pr_debug("target_xcopy_do_work: Final src_lba: %llu, dst_lba: %llu\n",
760 (unsigned long long)src_lba
, (unsigned long long)dst_lba
);
761 pr_debug("target_xcopy_do_work: Blocks copied: %hu, Bytes Copied: %u\n",
762 copied_nolb
, copied_nolb
* dst_dev
->dev_attrib
.block_size
);
764 pr_debug("target_xcopy_do_work: Setting X-COPY GOOD status -> sending response\n");
765 target_complete_cmd(ec_cmd
, SAM_STAT_GOOD
);
770 * The XCOPY command was aborted after some data was transferred.
771 * Terminate command with CHECK CONDITION status, with the sense key
772 * set to COPY ABORTED.
774 sense_rc
= TCM_COPY_TARGET_DEVICE_NOT_REACHABLE
;
775 xcopy_pt_undepend_remotedev(xop
);
776 target_free_sgl(xop
->xop_data_sg
, xop
->xop_data_nents
);
780 pr_warn_ratelimited("target_xcopy_do_work: rc: %d, sense: %u, XCOPY operation failed\n",
782 target_complete_cmd_with_sense(ec_cmd
, SAM_STAT_CHECK_CONDITION
, sense_rc
);
786 * Returns TCM_NO_SENSE upon success or a sense code != TCM_NO_SENSE if parsing
789 static sense_reason_t
target_parse_xcopy_cmd(struct xcopy_op
*xop
)
791 struct se_cmd
*se_cmd
= xop
->xop_se_cmd
;
792 unsigned char *p
= NULL
, *seg_desc
;
793 unsigned int list_id
, list_id_usage
, sdll
, inline_dl
;
794 sense_reason_t ret
= TCM_INVALID_PARAMETER_LIST
;
798 p
= transport_kmap_data_sg(se_cmd
);
800 pr_err("transport_kmap_data_sg() failed in target_do_xcopy\n");
801 return TCM_OUT_OF_RESOURCES
;
805 list_id_usage
= (p
[1] & 0x18) >> 3;
808 * Determine TARGET DESCRIPTOR LIST LENGTH + SEGMENT DESCRIPTOR LIST LENGTH
810 tdll
= get_unaligned_be16(&p
[2]);
811 sdll
= get_unaligned_be32(&p
[8]);
812 if (tdll
+ sdll
> RCR_OP_MAX_DESC_LIST_LEN
) {
813 pr_err("XCOPY descriptor list length %u exceeds maximum %u\n",
814 tdll
+ sdll
, RCR_OP_MAX_DESC_LIST_LEN
);
815 ret
= TCM_PARAMETER_LIST_LENGTH_ERROR
;
819 inline_dl
= get_unaligned_be32(&p
[12]);
820 if (inline_dl
!= 0) {
821 pr_err("XCOPY with non zero inline data length\n");
825 if (se_cmd
->data_length
< (XCOPY_HDR_LEN
+ tdll
+ sdll
+ inline_dl
)) {
826 pr_err("XCOPY parameter truncation: data length %u too small "
827 "for tdll: %hu sdll: %u inline_dl: %u\n",
828 se_cmd
->data_length
, tdll
, sdll
, inline_dl
);
829 ret
= TCM_PARAMETER_LIST_LENGTH_ERROR
;
833 pr_debug("Processing XCOPY with list_id: 0x%02x list_id_usage: 0x%02x"
834 " tdll: %hu sdll: %u inline_dl: %u\n", list_id
, list_id_usage
,
835 tdll
, sdll
, inline_dl
);
838 * skip over the target descriptors until segment descriptors
839 * have been passed - CSCD ids are needed to determine src and dest.
841 seg_desc
= &p
[16] + tdll
;
843 rc
= target_xcopy_parse_segment_descriptors(se_cmd
, xop
, seg_desc
,
848 pr_debug("XCOPY: Processed %d segment descriptors, length: %u\n", rc
,
849 rc
* XCOPY_SEGMENT_DESC_LEN
);
851 rc
= target_xcopy_parse_target_descriptors(se_cmd
, xop
, &p
[16], tdll
, &ret
);
855 if (xop
->src_dev
->dev_attrib
.block_size
!=
856 xop
->dst_dev
->dev_attrib
.block_size
) {
857 pr_err("XCOPY: Non matching src_dev block_size: %u + dst_dev"
858 " block_size: %u currently unsupported\n",
859 xop
->src_dev
->dev_attrib
.block_size
,
860 xop
->dst_dev
->dev_attrib
.block_size
);
861 xcopy_pt_undepend_remotedev(xop
);
862 ret
= TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
866 pr_debug("XCOPY: Processed %d target descriptors, length: %u\n", rc
,
867 rc
* XCOPY_TARGET_DESC_LEN
);
868 transport_kunmap_data_sg(se_cmd
);
873 transport_kunmap_data_sg(se_cmd
);
877 sense_reason_t
target_do_xcopy(struct se_cmd
*se_cmd
)
879 struct se_device
*dev
= se_cmd
->se_dev
;
880 struct xcopy_op
*xop
;
883 if (!dev
->dev_attrib
.emulate_3pc
) {
884 pr_err("EXTENDED_COPY operation explicitly disabled\n");
885 return TCM_UNSUPPORTED_SCSI_OPCODE
;
888 sa
= se_cmd
->t_task_cdb
[1] & 0x1f;
890 pr_err("EXTENDED_COPY(LID4) not supported\n");
891 return TCM_UNSUPPORTED_SCSI_OPCODE
;
894 if (se_cmd
->data_length
== 0) {
895 target_complete_cmd(se_cmd
, SAM_STAT_GOOD
);
898 if (se_cmd
->data_length
< XCOPY_HDR_LEN
) {
899 pr_err("XCOPY parameter truncation: length %u < hdr_len %u\n",
900 se_cmd
->data_length
, XCOPY_HDR_LEN
);
901 return TCM_PARAMETER_LIST_LENGTH_ERROR
;
904 xop
= kzalloc(sizeof(struct xcopy_op
), GFP_KERNEL
);
907 xop
->xop_se_cmd
= se_cmd
;
908 INIT_WORK(&xop
->xop_work
, target_xcopy_do_work
);
909 if (WARN_ON_ONCE(!queue_work(xcopy_wq
, &xop
->xop_work
)))
917 return TCM_OUT_OF_RESOURCES
;
920 static sense_reason_t
target_rcr_operating_parameters(struct se_cmd
*se_cmd
)
924 p
= transport_kmap_data_sg(se_cmd
);
926 pr_err("transport_kmap_data_sg failed in"
927 " target_rcr_operating_parameters\n");
928 return TCM_OUT_OF_RESOURCES
;
931 if (se_cmd
->data_length
< 54) {
932 pr_err("Receive Copy Results Op Parameters length"
933 " too small: %u\n", se_cmd
->data_length
);
934 transport_kunmap_data_sg(se_cmd
);
935 return TCM_INVALID_CDB_FIELD
;
938 * Set SNLID=1 (Supports no List ID)
942 * MAXIMUM TARGET DESCRIPTOR COUNT
944 put_unaligned_be16(RCR_OP_MAX_TARGET_DESC_COUNT
, &p
[8]);
946 * MAXIMUM SEGMENT DESCRIPTOR COUNT
948 put_unaligned_be16(RCR_OP_MAX_SG_DESC_COUNT
, &p
[10]);
950 * MAXIMUM DESCRIPTOR LIST LENGTH
952 put_unaligned_be32(RCR_OP_MAX_DESC_LIST_LEN
, &p
[12]);
954 * MAXIMUM SEGMENT LENGTH
956 put_unaligned_be32(RCR_OP_MAX_SEGMENT_LEN
, &p
[16]);
958 * MAXIMUM INLINE DATA LENGTH for SA 0x04 (NOT SUPPORTED)
960 put_unaligned_be32(0x0, &p
[20]);
964 put_unaligned_be32(0x0, &p
[24]);
966 * MAXIMUM STREAM DEVICE TRANSFER SIZE
968 put_unaligned_be32(0x0, &p
[28]);
970 * TOTAL CONCURRENT COPIES
972 put_unaligned_be16(RCR_OP_TOTAL_CONCURR_COPIES
, &p
[34]);
974 * MAXIMUM CONCURRENT COPIES
976 p
[36] = RCR_OP_MAX_CONCURR_COPIES
;
978 * DATA SEGMENT GRANULARITY (log 2)
980 p
[37] = RCR_OP_DATA_SEG_GRAN_LOG2
;
982 * INLINE DATA GRANULARITY log 2)
984 p
[38] = RCR_OP_INLINE_DATA_GRAN_LOG2
;
986 * HELD DATA GRANULARITY
988 p
[39] = RCR_OP_HELD_DATA_GRAN_LOG2
;
990 * IMPLEMENTED DESCRIPTOR LIST LENGTH
994 * List of implemented descriptor type codes (ordered)
996 p
[44] = 0x02; /* Copy Block to Block device */
997 p
[45] = 0xe4; /* Identification descriptor target descriptor */
1000 * AVAILABLE DATA (n-3)
1002 put_unaligned_be32(42, &p
[0]);
1004 transport_kunmap_data_sg(se_cmd
);
1005 target_complete_cmd(se_cmd
, SAM_STAT_GOOD
);
1007 return TCM_NO_SENSE
;
1010 sense_reason_t
target_do_receive_copy_results(struct se_cmd
*se_cmd
)
1012 unsigned char *cdb
= &se_cmd
->t_task_cdb
[0];
1013 int sa
= (cdb
[1] & 0x1f), list_id
= cdb
[2];
1014 sense_reason_t rc
= TCM_NO_SENSE
;
1016 pr_debug("Entering target_do_receive_copy_results: SA: 0x%02x, List ID:"
1017 " 0x%02x, AL: %u\n", sa
, list_id
, se_cmd
->data_length
);
1020 pr_err("Receive Copy Results with non zero list identifier"
1021 " not supported\n");
1022 return TCM_INVALID_CDB_FIELD
;
1026 case RCR_SA_OPERATING_PARAMETERS
:
1027 rc
= target_rcr_operating_parameters(se_cmd
);
1029 case RCR_SA_COPY_STATUS
:
1030 case RCR_SA_RECEIVE_DATA
:
1031 case RCR_SA_FAILED_SEGMENT_DETAILS
:
1033 pr_err("Unsupported SA for receive copy results: 0x%02x\n", sa
);
1034 return TCM_INVALID_CDB_FIELD
;