1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*******************************************************************************
3 * Filename: target_core_device.c (based on iscsi_target_device.c)
5 * This file contains the TCM Virtual Device and Disk Transport
6 * agnostic related functions.
8 * (c) Copyright 2003-2013 Datera, Inc.
10 * Nicholas A. Bellinger <nab@kernel.org>
12 ******************************************************************************/
14 #include <linux/net.h>
15 #include <linux/string.h>
16 #include <linux/delay.h>
17 #include <linux/timer.h>
18 #include <linux/slab.h>
19 #include <linux/spinlock.h>
20 #include <linux/kthread.h>
22 #include <linux/export.h>
23 #include <linux/t10-pi.h>
24 #include <asm/unaligned.h>
27 #include <scsi/scsi_common.h>
28 #include <scsi/scsi_proto.h>
30 #include <target/target_core_base.h>
31 #include <target/target_core_backend.h>
32 #include <target/target_core_fabric.h>
34 #include "target_core_internal.h"
35 #include "target_core_alua.h"
36 #include "target_core_pr.h"
37 #include "target_core_ua.h"
39 static DEFINE_MUTEX(device_mutex
);
40 static LIST_HEAD(device_list
);
41 static DEFINE_IDR(devices_idr
);
43 static struct se_hba
*lun0_hba
;
44 /* not static, needed by tpg.c */
45 struct se_device
*g_lun0_dev
;
48 transport_lookup_cmd_lun(struct se_cmd
*se_cmd
)
50 struct se_lun
*se_lun
= NULL
;
51 struct se_session
*se_sess
= se_cmd
->se_sess
;
52 struct se_node_acl
*nacl
= se_sess
->se_node_acl
;
53 struct se_dev_entry
*deve
;
54 sense_reason_t ret
= TCM_NO_SENSE
;
57 deve
= target_nacl_find_deve(nacl
, se_cmd
->orig_fe_lun
);
59 atomic_long_inc(&deve
->total_cmds
);
61 if (se_cmd
->data_direction
== DMA_TO_DEVICE
)
62 atomic_long_add(se_cmd
->data_length
,
64 else if (se_cmd
->data_direction
== DMA_FROM_DEVICE
)
65 atomic_long_add(se_cmd
->data_length
,
68 if ((se_cmd
->data_direction
== DMA_TO_DEVICE
) &&
69 deve
->lun_access_ro
) {
70 pr_err("TARGET_CORE[%s]: Detected WRITE_PROTECTED LUN"
71 " Access for 0x%08llx\n",
72 se_cmd
->se_tfo
->fabric_name
,
75 return TCM_WRITE_PROTECTED
;
78 se_lun
= rcu_dereference(deve
->se_lun
);
80 if (!percpu_ref_tryget_live(&se_lun
->lun_ref
)) {
85 se_cmd
->se_lun
= se_lun
;
86 se_cmd
->pr_res_key
= deve
->pr_res_key
;
87 se_cmd
->se_cmd_flags
|= SCF_SE_LUN_CMD
;
88 se_cmd
->lun_ref_active
= true;
95 * Use the se_portal_group->tpg_virt_lun0 to allow for
96 * REPORT_LUNS, et al to be returned when no active
97 * MappedLUN=0 exists for this Initiator Port.
99 if (se_cmd
->orig_fe_lun
!= 0) {
100 pr_err("TARGET_CORE[%s]: Detected NON_EXISTENT_LUN"
101 " Access for 0x%08llx from %s\n",
102 se_cmd
->se_tfo
->fabric_name
,
104 nacl
->initiatorname
);
105 return TCM_NON_EXISTENT_LUN
;
109 * Force WRITE PROTECT for virtual LUN 0
111 if ((se_cmd
->data_direction
!= DMA_FROM_DEVICE
) &&
112 (se_cmd
->data_direction
!= DMA_NONE
))
113 return TCM_WRITE_PROTECTED
;
115 se_lun
= se_sess
->se_tpg
->tpg_virt_lun0
;
116 if (!percpu_ref_tryget_live(&se_lun
->lun_ref
))
117 return TCM_NON_EXISTENT_LUN
;
119 se_cmd
->se_lun
= se_sess
->se_tpg
->tpg_virt_lun0
;
120 se_cmd
->se_cmd_flags
|= SCF_SE_LUN_CMD
;
121 se_cmd
->lun_ref_active
= true;
124 * RCU reference protected by percpu se_lun->lun_ref taken above that
125 * must drop to zero (including initial reference) before this se_lun
126 * pointer can be kfree_rcu() by the final se_lun->lun_group put via
127 * target_core_fabric_configfs.c:target_fabric_port_release
129 se_cmd
->se_dev
= rcu_dereference_raw(se_lun
->lun_se_dev
);
130 atomic_long_inc(&se_cmd
->se_dev
->num_cmds
);
132 if (se_cmd
->data_direction
== DMA_TO_DEVICE
)
133 atomic_long_add(se_cmd
->data_length
,
134 &se_cmd
->se_dev
->write_bytes
);
135 else if (se_cmd
->data_direction
== DMA_FROM_DEVICE
)
136 atomic_long_add(se_cmd
->data_length
,
137 &se_cmd
->se_dev
->read_bytes
);
141 EXPORT_SYMBOL(transport_lookup_cmd_lun
);
143 int transport_lookup_tmr_lun(struct se_cmd
*se_cmd
)
145 struct se_dev_entry
*deve
;
146 struct se_lun
*se_lun
= NULL
;
147 struct se_session
*se_sess
= se_cmd
->se_sess
;
148 struct se_node_acl
*nacl
= se_sess
->se_node_acl
;
149 struct se_tmr_req
*se_tmr
= se_cmd
->se_tmr_req
;
153 deve
= target_nacl_find_deve(nacl
, se_cmd
->orig_fe_lun
);
155 se_lun
= rcu_dereference(deve
->se_lun
);
157 if (!percpu_ref_tryget_live(&se_lun
->lun_ref
)) {
162 se_cmd
->se_lun
= se_lun
;
163 se_cmd
->pr_res_key
= deve
->pr_res_key
;
164 se_cmd
->se_cmd_flags
|= SCF_SE_LUN_CMD
;
165 se_cmd
->lun_ref_active
= true;
171 pr_debug("TARGET_CORE[%s]: Detected NON_EXISTENT_LUN"
172 " Access for 0x%08llx for %s\n",
173 se_cmd
->se_tfo
->fabric_name
,
175 nacl
->initiatorname
);
178 se_cmd
->se_dev
= rcu_dereference_raw(se_lun
->lun_se_dev
);
179 se_tmr
->tmr_dev
= rcu_dereference_raw(se_lun
->lun_se_dev
);
181 spin_lock_irqsave(&se_tmr
->tmr_dev
->se_tmr_lock
, flags
);
182 list_add_tail(&se_tmr
->tmr_list
, &se_tmr
->tmr_dev
->dev_tmr_list
);
183 spin_unlock_irqrestore(&se_tmr
->tmr_dev
->se_tmr_lock
, flags
);
187 EXPORT_SYMBOL(transport_lookup_tmr_lun
);
189 bool target_lun_is_rdonly(struct se_cmd
*cmd
)
191 struct se_session
*se_sess
= cmd
->se_sess
;
192 struct se_dev_entry
*deve
;
196 deve
= target_nacl_find_deve(se_sess
->se_node_acl
, cmd
->orig_fe_lun
);
197 ret
= deve
&& deve
->lun_access_ro
;
202 EXPORT_SYMBOL(target_lun_is_rdonly
);
205 * This function is called from core_scsi3_emulate_pro_register_and_move()
206 * and core_scsi3_decode_spec_i_port(), and will increment &deve->pr_kref
207 * when a matching rtpi is found.
209 struct se_dev_entry
*core_get_se_deve_from_rtpi(
210 struct se_node_acl
*nacl
,
213 struct se_dev_entry
*deve
;
215 struct se_portal_group
*tpg
= nacl
->se_tpg
;
218 hlist_for_each_entry_rcu(deve
, &nacl
->lun_entry_hlist
, link
) {
219 lun
= rcu_dereference(deve
->se_lun
);
221 pr_err("%s device entries device pointer is"
222 " NULL, but Initiator has access.\n",
223 tpg
->se_tpg_tfo
->fabric_name
);
226 if (lun
->lun_rtpi
!= rtpi
)
229 kref_get(&deve
->pr_kref
);
239 void core_free_device_list_for_node(
240 struct se_node_acl
*nacl
,
241 struct se_portal_group
*tpg
)
243 struct se_dev_entry
*deve
;
245 mutex_lock(&nacl
->lun_entry_mutex
);
246 hlist_for_each_entry_rcu(deve
, &nacl
->lun_entry_hlist
, link
) {
247 struct se_lun
*lun
= rcu_dereference_check(deve
->se_lun
,
248 lockdep_is_held(&nacl
->lun_entry_mutex
));
249 core_disable_device_list_for_node(lun
, deve
, nacl
, tpg
);
251 mutex_unlock(&nacl
->lun_entry_mutex
);
254 void core_update_device_list_access(
257 struct se_node_acl
*nacl
)
259 struct se_dev_entry
*deve
;
261 mutex_lock(&nacl
->lun_entry_mutex
);
262 deve
= target_nacl_find_deve(nacl
, mapped_lun
);
264 deve
->lun_access_ro
= lun_access_ro
;
265 mutex_unlock(&nacl
->lun_entry_mutex
);
269 * Called with rcu_read_lock or nacl->device_list_lock held.
271 struct se_dev_entry
*target_nacl_find_deve(struct se_node_acl
*nacl
, u64 mapped_lun
)
273 struct se_dev_entry
*deve
;
275 hlist_for_each_entry_rcu(deve
, &nacl
->lun_entry_hlist
, link
)
276 if (deve
->mapped_lun
== mapped_lun
)
281 EXPORT_SYMBOL(target_nacl_find_deve
);
283 void target_pr_kref_release(struct kref
*kref
)
285 struct se_dev_entry
*deve
= container_of(kref
, struct se_dev_entry
,
287 complete(&deve
->pr_comp
);
291 target_luns_data_has_changed(struct se_node_acl
*nacl
, struct se_dev_entry
*new,
294 struct se_dev_entry
*tmp
;
297 hlist_for_each_entry_rcu(tmp
, &nacl
->lun_entry_hlist
, link
) {
298 if (skip_new
&& tmp
== new)
300 core_scsi3_ua_allocate(tmp
, 0x3F,
301 ASCQ_3FH_REPORTED_LUNS_DATA_HAS_CHANGED
);
306 int core_enable_device_list_for_node(
308 struct se_lun_acl
*lun_acl
,
311 struct se_node_acl
*nacl
,
312 struct se_portal_group
*tpg
)
314 struct se_dev_entry
*orig
, *new;
316 new = kzalloc(sizeof(*new), GFP_KERNEL
);
318 pr_err("Unable to allocate se_dev_entry memory\n");
322 spin_lock_init(&new->ua_lock
);
323 INIT_LIST_HEAD(&new->ua_list
);
324 INIT_LIST_HEAD(&new->lun_link
);
326 new->mapped_lun
= mapped_lun
;
327 kref_init(&new->pr_kref
);
328 init_completion(&new->pr_comp
);
330 new->lun_access_ro
= lun_access_ro
;
331 new->creation_time
= get_jiffies_64();
334 mutex_lock(&nacl
->lun_entry_mutex
);
335 orig
= target_nacl_find_deve(nacl
, mapped_lun
);
336 if (orig
&& orig
->se_lun
) {
337 struct se_lun
*orig_lun
= rcu_dereference_check(orig
->se_lun
,
338 lockdep_is_held(&nacl
->lun_entry_mutex
));
340 if (orig_lun
!= lun
) {
341 pr_err("Existing orig->se_lun doesn't match new lun"
342 " for dynamic -> explicit NodeACL conversion:"
343 " %s\n", nacl
->initiatorname
);
344 mutex_unlock(&nacl
->lun_entry_mutex
);
348 if (orig
->se_lun_acl
!= NULL
) {
349 pr_warn_ratelimited("Detected existing explicit"
350 " se_lun_acl->se_lun_group reference for %s"
351 " mapped_lun: %llu, failing\n",
352 nacl
->initiatorname
, mapped_lun
);
353 mutex_unlock(&nacl
->lun_entry_mutex
);
358 rcu_assign_pointer(new->se_lun
, lun
);
359 rcu_assign_pointer(new->se_lun_acl
, lun_acl
);
360 hlist_del_rcu(&orig
->link
);
361 hlist_add_head_rcu(&new->link
, &nacl
->lun_entry_hlist
);
362 mutex_unlock(&nacl
->lun_entry_mutex
);
364 spin_lock(&lun
->lun_deve_lock
);
365 list_del(&orig
->lun_link
);
366 list_add_tail(&new->lun_link
, &lun
->lun_deve_list
);
367 spin_unlock(&lun
->lun_deve_lock
);
369 kref_put(&orig
->pr_kref
, target_pr_kref_release
);
370 wait_for_completion(&orig
->pr_comp
);
372 target_luns_data_has_changed(nacl
, new, true);
373 kfree_rcu(orig
, rcu_head
);
377 rcu_assign_pointer(new->se_lun
, lun
);
378 rcu_assign_pointer(new->se_lun_acl
, lun_acl
);
379 hlist_add_head_rcu(&new->link
, &nacl
->lun_entry_hlist
);
380 mutex_unlock(&nacl
->lun_entry_mutex
);
382 spin_lock(&lun
->lun_deve_lock
);
383 list_add_tail(&new->lun_link
, &lun
->lun_deve_list
);
384 spin_unlock(&lun
->lun_deve_lock
);
386 target_luns_data_has_changed(nacl
, new, true);
390 void core_disable_device_list_for_node(
392 struct se_dev_entry
*orig
,
393 struct se_node_acl
*nacl
,
394 struct se_portal_group
*tpg
)
397 * rcu_dereference_raw protected by se_lun->lun_group symlink
398 * reference to se_device->dev_group.
400 struct se_device
*dev
= rcu_dereference_raw(lun
->lun_se_dev
);
402 lockdep_assert_held(&nacl
->lun_entry_mutex
);
405 * If the MappedLUN entry is being disabled, the entry in
406 * lun->lun_deve_list must be removed now before clearing the
407 * struct se_dev_entry pointers below as logic in
408 * core_alua_do_transition_tg_pt() depends on these being present.
410 * deve->se_lun_acl will be NULL for demo-mode created LUNs
411 * that have not been explicitly converted to MappedLUNs ->
412 * struct se_lun_acl, but we remove deve->lun_link from
413 * lun->lun_deve_list. This also means that active UAs and
414 * NodeACL context specific PR metadata for demo-mode
415 * MappedLUN *deve will be released below..
417 spin_lock(&lun
->lun_deve_lock
);
418 list_del(&orig
->lun_link
);
419 spin_unlock(&lun
->lun_deve_lock
);
421 * Disable struct se_dev_entry LUN ACL mapping
423 core_scsi3_ua_release_all(orig
);
425 hlist_del_rcu(&orig
->link
);
426 clear_bit(DEF_PR_REG_ACTIVE
, &orig
->deve_flags
);
427 orig
->lun_access_ro
= false;
428 orig
->creation_time
= 0;
429 orig
->attach_count
--;
431 * Before firing off RCU callback, wait for any in process SPEC_I_PT=1
432 * or REGISTER_AND_MOVE PR operation to complete.
434 kref_put(&orig
->pr_kref
, target_pr_kref_release
);
435 wait_for_completion(&orig
->pr_comp
);
437 rcu_assign_pointer(orig
->se_lun
, NULL
);
438 rcu_assign_pointer(orig
->se_lun_acl
, NULL
);
440 kfree_rcu(orig
, rcu_head
);
442 core_scsi3_free_pr_reg_from_nacl(dev
, nacl
);
443 target_luns_data_has_changed(nacl
, NULL
, false);
446 /* core_clear_lun_from_tpg():
450 void core_clear_lun_from_tpg(struct se_lun
*lun
, struct se_portal_group
*tpg
)
452 struct se_node_acl
*nacl
;
453 struct se_dev_entry
*deve
;
455 mutex_lock(&tpg
->acl_node_mutex
);
456 list_for_each_entry(nacl
, &tpg
->acl_node_list
, acl_list
) {
458 mutex_lock(&nacl
->lun_entry_mutex
);
459 hlist_for_each_entry_rcu(deve
, &nacl
->lun_entry_hlist
, link
) {
460 struct se_lun
*tmp_lun
= rcu_dereference_check(deve
->se_lun
,
461 lockdep_is_held(&nacl
->lun_entry_mutex
));
466 core_disable_device_list_for_node(lun
, deve
, nacl
, tpg
);
468 mutex_unlock(&nacl
->lun_entry_mutex
);
470 mutex_unlock(&tpg
->acl_node_mutex
);
473 int core_alloc_rtpi(struct se_lun
*lun
, struct se_device
*dev
)
477 spin_lock(&dev
->se_port_lock
);
478 if (dev
->export_count
== 0x0000ffff) {
479 pr_warn("Reached dev->dev_port_count =="
481 spin_unlock(&dev
->se_port_lock
);
486 * Allocate the next RELATIVE TARGET PORT IDENTIFIER for this struct se_device
487 * Here is the table from spc4r17 section 7.7.3.8.
489 * Table 473 -- RELATIVE TARGET PORT IDENTIFIER field
493 * 1h Relative port 1, historically known as port A
494 * 2h Relative port 2, historically known as port B
495 * 3h to FFFFh Relative port 3 through 65 535
497 lun
->lun_rtpi
= dev
->dev_rpti_counter
++;
501 list_for_each_entry(tmp
, &dev
->dev_sep_list
, lun_dev_link
) {
503 * Make sure RELATIVE TARGET PORT IDENTIFIER is unique
506 if (lun
->lun_rtpi
== tmp
->lun_rtpi
)
509 spin_unlock(&dev
->se_port_lock
);
514 static void se_release_vpd_for_dev(struct se_device
*dev
)
516 struct t10_vpd
*vpd
, *vpd_tmp
;
518 spin_lock(&dev
->t10_wwn
.t10_vpd_lock
);
519 list_for_each_entry_safe(vpd
, vpd_tmp
,
520 &dev
->t10_wwn
.t10_vpd_list
, vpd_list
) {
521 list_del(&vpd
->vpd_list
);
524 spin_unlock(&dev
->t10_wwn
.t10_vpd_lock
);
527 static u32
se_dev_align_max_sectors(u32 max_sectors
, u32 block_size
)
529 u32 aligned_max_sectors
;
532 * Limit max_sectors to a PAGE_SIZE aligned value for modern
533 * transport_allocate_data_tasks() operation.
535 alignment
= max(1ul, PAGE_SIZE
/ block_size
);
536 aligned_max_sectors
= rounddown(max_sectors
, alignment
);
538 if (max_sectors
!= aligned_max_sectors
)
539 pr_info("Rounding down aligned max_sectors from %u to %u\n",
540 max_sectors
, aligned_max_sectors
);
542 return aligned_max_sectors
;
545 int core_dev_add_lun(
546 struct se_portal_group
*tpg
,
547 struct se_device
*dev
,
552 rc
= core_tpg_add_lun(tpg
, lun
, false, dev
);
556 pr_debug("%s_TPG[%u]_LUN[%llu] - Activated %s Logical Unit from"
557 " CORE HBA: %u\n", tpg
->se_tpg_tfo
->fabric_name
,
558 tpg
->se_tpg_tfo
->tpg_get_tag(tpg
), lun
->unpacked_lun
,
559 tpg
->se_tpg_tfo
->fabric_name
, dev
->se_hba
->hba_id
);
561 * Update LUN maps for dynamically added initiators when
562 * generate_node_acl is enabled.
564 if (tpg
->se_tpg_tfo
->tpg_check_demo_mode(tpg
)) {
565 struct se_node_acl
*acl
;
567 mutex_lock(&tpg
->acl_node_mutex
);
568 list_for_each_entry(acl
, &tpg
->acl_node_list
, acl_list
) {
569 if (acl
->dynamic_node_acl
&&
570 (!tpg
->se_tpg_tfo
->tpg_check_demo_mode_login_only
||
571 !tpg
->se_tpg_tfo
->tpg_check_demo_mode_login_only(tpg
))) {
572 core_tpg_add_node_to_devs(acl
, tpg
, lun
);
575 mutex_unlock(&tpg
->acl_node_mutex
);
581 /* core_dev_del_lun():
585 void core_dev_del_lun(
586 struct se_portal_group
*tpg
,
589 pr_debug("%s_TPG[%u]_LUN[%llu] - Deactivating %s Logical Unit from"
590 " device object\n", tpg
->se_tpg_tfo
->fabric_name
,
591 tpg
->se_tpg_tfo
->tpg_get_tag(tpg
), lun
->unpacked_lun
,
592 tpg
->se_tpg_tfo
->fabric_name
);
594 core_tpg_remove_lun(tpg
, lun
);
597 struct se_lun_acl
*core_dev_init_initiator_node_lun_acl(
598 struct se_portal_group
*tpg
,
599 struct se_node_acl
*nacl
,
603 struct se_lun_acl
*lacl
;
605 if (strlen(nacl
->initiatorname
) >= TRANSPORT_IQN_LEN
) {
606 pr_err("%s InitiatorName exceeds maximum size.\n",
607 tpg
->se_tpg_tfo
->fabric_name
);
611 lacl
= kzalloc(sizeof(struct se_lun_acl
), GFP_KERNEL
);
613 pr_err("Unable to allocate memory for struct se_lun_acl.\n");
618 lacl
->mapped_lun
= mapped_lun
;
619 lacl
->se_lun_nacl
= nacl
;
624 int core_dev_add_initiator_node_lun_acl(
625 struct se_portal_group
*tpg
,
626 struct se_lun_acl
*lacl
,
630 struct se_node_acl
*nacl
= lacl
->se_lun_nacl
;
632 * rcu_dereference_raw protected by se_lun->lun_group symlink
633 * reference to se_device->dev_group.
635 struct se_device
*dev
= rcu_dereference_raw(lun
->lun_se_dev
);
640 if (lun
->lun_access_ro
)
641 lun_access_ro
= true;
645 if (core_enable_device_list_for_node(lun
, lacl
, lacl
->mapped_lun
,
646 lun_access_ro
, nacl
, tpg
) < 0)
649 pr_debug("%s_TPG[%hu]_LUN[%llu->%llu] - Added %s ACL for "
650 " InitiatorNode: %s\n", tpg
->se_tpg_tfo
->fabric_name
,
651 tpg
->se_tpg_tfo
->tpg_get_tag(tpg
), lun
->unpacked_lun
, lacl
->mapped_lun
,
652 lun_access_ro
? "RO" : "RW",
653 nacl
->initiatorname
);
655 * Check to see if there are any existing persistent reservation APTPL
656 * pre-registrations that need to be enabled for this LUN ACL..
658 core_scsi3_check_aptpl_registration(dev
, tpg
, lun
, nacl
,
663 int core_dev_del_initiator_node_lun_acl(
665 struct se_lun_acl
*lacl
)
667 struct se_portal_group
*tpg
= lun
->lun_tpg
;
668 struct se_node_acl
*nacl
;
669 struct se_dev_entry
*deve
;
671 nacl
= lacl
->se_lun_nacl
;
675 mutex_lock(&nacl
->lun_entry_mutex
);
676 deve
= target_nacl_find_deve(nacl
, lacl
->mapped_lun
);
678 core_disable_device_list_for_node(lun
, deve
, nacl
, tpg
);
679 mutex_unlock(&nacl
->lun_entry_mutex
);
681 pr_debug("%s_TPG[%hu]_LUN[%llu] - Removed ACL for"
682 " InitiatorNode: %s Mapped LUN: %llu\n",
683 tpg
->se_tpg_tfo
->fabric_name
,
684 tpg
->se_tpg_tfo
->tpg_get_tag(tpg
), lun
->unpacked_lun
,
685 nacl
->initiatorname
, lacl
->mapped_lun
);
690 void core_dev_free_initiator_node_lun_acl(
691 struct se_portal_group
*tpg
,
692 struct se_lun_acl
*lacl
)
694 pr_debug("%s_TPG[%hu] - Freeing ACL for %s InitiatorNode: %s"
695 " Mapped LUN: %llu\n", tpg
->se_tpg_tfo
->fabric_name
,
696 tpg
->se_tpg_tfo
->tpg_get_tag(tpg
),
697 tpg
->se_tpg_tfo
->fabric_name
,
698 lacl
->se_lun_nacl
->initiatorname
, lacl
->mapped_lun
);
703 static void scsi_dump_inquiry(struct se_device
*dev
)
705 struct t10_wwn
*wwn
= &dev
->t10_wwn
;
706 int device_type
= dev
->transport
->get_device_type(dev
);
709 * Print Linux/SCSI style INQUIRY formatting to the kernel ring buffer
711 pr_debug(" Vendor: %-" __stringify(INQUIRY_VENDOR_LEN
) "s\n",
713 pr_debug(" Model: %-" __stringify(INQUIRY_MODEL_LEN
) "s\n",
715 pr_debug(" Revision: %-" __stringify(INQUIRY_REVISION_LEN
) "s\n",
717 pr_debug(" Type: %s ", scsi_device_type(device_type
));
720 struct se_device
*target_alloc_device(struct se_hba
*hba
, const char *name
)
722 struct se_device
*dev
;
723 struct se_lun
*xcopy_lun
;
726 dev
= hba
->backend
->ops
->alloc_device(hba
, name
);
730 dev
->queues
= kcalloc(nr_cpu_ids
, sizeof(*dev
->queues
), GFP_KERNEL
);
732 dev
->transport
->free_device(dev
);
736 dev
->queue_cnt
= nr_cpu_ids
;
737 for (i
= 0; i
< dev
->queue_cnt
; i
++) {
738 INIT_LIST_HEAD(&dev
->queues
[i
].state_list
);
739 spin_lock_init(&dev
->queues
[i
].lock
);
743 dev
->transport
= hba
->backend
->ops
;
744 dev
->transport_flags
= dev
->transport
->transport_flags_default
;
745 dev
->prot_length
= sizeof(struct t10_pi_tuple
);
746 dev
->hba_index
= hba
->hba_index
;
748 INIT_LIST_HEAD(&dev
->dev_sep_list
);
749 INIT_LIST_HEAD(&dev
->dev_tmr_list
);
750 INIT_LIST_HEAD(&dev
->delayed_cmd_list
);
751 INIT_LIST_HEAD(&dev
->qf_cmd_list
);
752 spin_lock_init(&dev
->delayed_cmd_lock
);
753 spin_lock_init(&dev
->dev_reservation_lock
);
754 spin_lock_init(&dev
->se_port_lock
);
755 spin_lock_init(&dev
->se_tmr_lock
);
756 spin_lock_init(&dev
->qf_cmd_lock
);
757 sema_init(&dev
->caw_sem
, 1);
758 INIT_LIST_HEAD(&dev
->t10_wwn
.t10_vpd_list
);
759 spin_lock_init(&dev
->t10_wwn
.t10_vpd_lock
);
760 INIT_LIST_HEAD(&dev
->t10_pr
.registration_list
);
761 INIT_LIST_HEAD(&dev
->t10_pr
.aptpl_reg_list
);
762 spin_lock_init(&dev
->t10_pr
.registration_lock
);
763 spin_lock_init(&dev
->t10_pr
.aptpl_reg_lock
);
764 INIT_LIST_HEAD(&dev
->t10_alua
.tg_pt_gps_list
);
765 spin_lock_init(&dev
->t10_alua
.tg_pt_gps_lock
);
766 INIT_LIST_HEAD(&dev
->t10_alua
.lba_map_list
);
767 spin_lock_init(&dev
->t10_alua
.lba_map_lock
);
769 dev
->t10_wwn
.t10_dev
= dev
;
770 dev
->t10_alua
.t10_dev
= dev
;
772 dev
->dev_attrib
.da_dev
= dev
;
773 dev
->dev_attrib
.emulate_model_alias
= DA_EMULATE_MODEL_ALIAS
;
774 dev
->dev_attrib
.emulate_dpo
= 1;
775 dev
->dev_attrib
.emulate_fua_write
= 1;
776 dev
->dev_attrib
.emulate_fua_read
= 1;
777 dev
->dev_attrib
.emulate_write_cache
= DA_EMULATE_WRITE_CACHE
;
778 dev
->dev_attrib
.emulate_ua_intlck_ctrl
= TARGET_UA_INTLCK_CTRL_CLEAR
;
779 dev
->dev_attrib
.emulate_tas
= DA_EMULATE_TAS
;
780 dev
->dev_attrib
.emulate_tpu
= DA_EMULATE_TPU
;
781 dev
->dev_attrib
.emulate_tpws
= DA_EMULATE_TPWS
;
782 dev
->dev_attrib
.emulate_caw
= DA_EMULATE_CAW
;
783 dev
->dev_attrib
.emulate_3pc
= DA_EMULATE_3PC
;
784 dev
->dev_attrib
.emulate_pr
= DA_EMULATE_PR
;
785 dev
->dev_attrib
.pi_prot_type
= TARGET_DIF_TYPE0_PROT
;
786 dev
->dev_attrib
.enforce_pr_isids
= DA_ENFORCE_PR_ISIDS
;
787 dev
->dev_attrib
.force_pr_aptpl
= DA_FORCE_PR_APTPL
;
788 dev
->dev_attrib
.is_nonrot
= DA_IS_NONROT
;
789 dev
->dev_attrib
.emulate_rest_reord
= DA_EMULATE_REST_REORD
;
790 dev
->dev_attrib
.max_unmap_lba_count
= DA_MAX_UNMAP_LBA_COUNT
;
791 dev
->dev_attrib
.max_unmap_block_desc_count
=
792 DA_MAX_UNMAP_BLOCK_DESC_COUNT
;
793 dev
->dev_attrib
.unmap_granularity
= DA_UNMAP_GRANULARITY_DEFAULT
;
794 dev
->dev_attrib
.unmap_granularity_alignment
=
795 DA_UNMAP_GRANULARITY_ALIGNMENT_DEFAULT
;
796 dev
->dev_attrib
.unmap_zeroes_data
=
797 DA_UNMAP_ZEROES_DATA_DEFAULT
;
798 dev
->dev_attrib
.max_write_same_len
= DA_MAX_WRITE_SAME_LEN
;
800 xcopy_lun
= &dev
->xcopy_lun
;
801 rcu_assign_pointer(xcopy_lun
->lun_se_dev
, dev
);
802 init_completion(&xcopy_lun
->lun_shutdown_comp
);
803 INIT_LIST_HEAD(&xcopy_lun
->lun_deve_list
);
804 INIT_LIST_HEAD(&xcopy_lun
->lun_dev_link
);
805 mutex_init(&xcopy_lun
->lun_tg_pt_md_mutex
);
806 xcopy_lun
->lun_tpg
= &xcopy_pt_tpg
;
808 /* Preload the default INQUIRY const values */
809 strlcpy(dev
->t10_wwn
.vendor
, "LIO-ORG", sizeof(dev
->t10_wwn
.vendor
));
810 strlcpy(dev
->t10_wwn
.model
, dev
->transport
->inquiry_prod
,
811 sizeof(dev
->t10_wwn
.model
));
812 strlcpy(dev
->t10_wwn
.revision
, dev
->transport
->inquiry_rev
,
813 sizeof(dev
->t10_wwn
.revision
));
819 * Check if the underlying struct block_device request_queue supports
820 * the QUEUE_FLAG_DISCARD bit for UNMAP/WRITE_SAME in SCSI + TRIM
821 * in ATA and we need to set TPE=1
823 bool target_configure_unmap_from_queue(struct se_dev_attrib
*attrib
,
824 struct request_queue
*q
)
826 int block_size
= queue_logical_block_size(q
);
828 if (!blk_queue_discard(q
))
831 attrib
->max_unmap_lba_count
=
832 q
->limits
.max_discard_sectors
>> (ilog2(block_size
) - 9);
834 * Currently hardcoded to 1 in Linux/SCSI code..
836 attrib
->max_unmap_block_desc_count
= 1;
837 attrib
->unmap_granularity
= q
->limits
.discard_granularity
/ block_size
;
838 attrib
->unmap_granularity_alignment
= q
->limits
.discard_alignment
/
840 attrib
->unmap_zeroes_data
= !!(q
->limits
.max_write_zeroes_sectors
);
843 EXPORT_SYMBOL(target_configure_unmap_from_queue
);
846 * Convert from blocksize advertised to the initiator to the 512 byte
847 * units unconditionally used by the Linux block layer.
849 sector_t
target_to_linux_sector(struct se_device
*dev
, sector_t lb
)
851 switch (dev
->dev_attrib
.block_size
) {
862 EXPORT_SYMBOL(target_to_linux_sector
);
864 struct devices_idr_iter
{
865 struct config_item
*prev_item
;
866 int (*fn
)(struct se_device
*dev
, void *data
);
870 static int target_devices_idr_iter(int id
, void *p
, void *data
)
871 __must_hold(&device_mutex
)
873 struct devices_idr_iter
*iter
= data
;
874 struct se_device
*dev
= p
;
877 config_item_put(iter
->prev_item
);
878 iter
->prev_item
= NULL
;
881 * We add the device early to the idr, so it can be used
882 * by backend modules during configuration. We do not want
883 * to allow other callers to access partially setup devices,
884 * so we skip them here.
886 if (!target_dev_configured(dev
))
889 iter
->prev_item
= config_item_get_unless_zero(&dev
->dev_group
.cg_item
);
890 if (!iter
->prev_item
)
892 mutex_unlock(&device_mutex
);
894 ret
= iter
->fn(dev
, iter
->data
);
896 mutex_lock(&device_mutex
);
901 * target_for_each_device - iterate over configured devices
902 * @fn: iterator function
903 * @data: pointer to data that will be passed to fn
905 * fn must return 0 to continue looping over devices. non-zero will break
906 * from the loop and return that value to the caller.
908 int target_for_each_device(int (*fn
)(struct se_device
*dev
, void *data
),
911 struct devices_idr_iter iter
= { .fn
= fn
, .data
= data
};
914 mutex_lock(&device_mutex
);
915 ret
= idr_for_each(&devices_idr
, target_devices_idr_iter
, &iter
);
916 mutex_unlock(&device_mutex
);
917 config_item_put(iter
.prev_item
);
921 int target_configure_device(struct se_device
*dev
)
923 struct se_hba
*hba
= dev
->se_hba
;
926 if (target_dev_configured(dev
)) {
927 pr_err("se_dev->se_dev_ptr already set for storage"
933 * Add early so modules like tcmu can use during its
936 mutex_lock(&device_mutex
);
938 * Use cyclic to try and avoid collisions with devices
939 * that were recently removed.
941 id
= idr_alloc_cyclic(&devices_idr
, dev
, 0, INT_MAX
, GFP_KERNEL
);
942 mutex_unlock(&device_mutex
);
949 ret
= dev
->transport
->configure_device(dev
);
953 * XXX: there is not much point to have two different values here..
955 dev
->dev_attrib
.block_size
= dev
->dev_attrib
.hw_block_size
;
956 dev
->dev_attrib
.queue_depth
= dev
->dev_attrib
.hw_queue_depth
;
959 * Align max_hw_sectors down to PAGE_SIZE I/O transfers
961 dev
->dev_attrib
.hw_max_sectors
=
962 se_dev_align_max_sectors(dev
->dev_attrib
.hw_max_sectors
,
963 dev
->dev_attrib
.hw_block_size
);
964 dev
->dev_attrib
.optimal_sectors
= dev
->dev_attrib
.hw_max_sectors
;
966 dev
->creation_time
= get_jiffies_64();
968 ret
= core_setup_alua(dev
);
970 goto out_destroy_device
;
973 * Setup work_queue for QUEUE_FULL
975 INIT_WORK(&dev
->qf_work_queue
, target_qf_do_work
);
977 scsi_dump_inquiry(dev
);
979 spin_lock(&hba
->device_lock
);
981 spin_unlock(&hba
->device_lock
);
983 dev
->dev_flags
|= DF_CONFIGURED
;
988 dev
->transport
->destroy_device(dev
);
990 mutex_lock(&device_mutex
);
991 idr_remove(&devices_idr
, dev
->dev_index
);
992 mutex_unlock(&device_mutex
);
994 se_release_vpd_for_dev(dev
);
998 void target_free_device(struct se_device
*dev
)
1000 struct se_hba
*hba
= dev
->se_hba
;
1002 WARN_ON(!list_empty(&dev
->dev_sep_list
));
1004 if (target_dev_configured(dev
)) {
1005 dev
->transport
->destroy_device(dev
);
1007 mutex_lock(&device_mutex
);
1008 idr_remove(&devices_idr
, dev
->dev_index
);
1009 mutex_unlock(&device_mutex
);
1011 spin_lock(&hba
->device_lock
);
1013 spin_unlock(&hba
->device_lock
);
1016 core_alua_free_lu_gp_mem(dev
);
1017 core_alua_set_lba_map(dev
, NULL
, 0, 0);
1018 core_scsi3_free_all_registrations(dev
);
1019 se_release_vpd_for_dev(dev
);
1021 if (dev
->transport
->free_prot
)
1022 dev
->transport
->free_prot(dev
);
1025 dev
->transport
->free_device(dev
);
1028 int core_dev_setup_virtual_lun0(void)
1031 struct se_device
*dev
;
1032 char buf
[] = "rd_pages=8,rd_nullio=1";
1035 hba
= core_alloc_hba("rd_mcp", 0, HBA_FLAGS_INTERNAL_USE
);
1037 return PTR_ERR(hba
);
1039 dev
= target_alloc_device(hba
, "virt_lun0");
1045 hba
->backend
->ops
->set_configfs_dev_params(dev
, buf
, sizeof(buf
));
1047 ret
= target_configure_device(dev
);
1049 goto out_free_se_dev
;
1056 target_free_device(dev
);
1058 core_delete_hba(hba
);
1063 void core_dev_release_virtual_lun0(void)
1065 struct se_hba
*hba
= lun0_hba
;
1071 target_free_device(g_lun0_dev
);
1072 core_delete_hba(hba
);
1076 * Common CDB parsing for kernel and user passthrough.
1079 passthrough_parse_cdb(struct se_cmd
*cmd
,
1080 sense_reason_t (*exec_cmd
)(struct se_cmd
*cmd
))
1082 unsigned char *cdb
= cmd
->t_task_cdb
;
1083 struct se_device
*dev
= cmd
->se_dev
;
1087 * For REPORT LUNS we always need to emulate the response, for everything
1090 if (cdb
[0] == REPORT_LUNS
) {
1091 cmd
->execute_cmd
= spc_emulate_report_luns
;
1092 return TCM_NO_SENSE
;
1096 * With emulate_pr disabled, all reservation requests should fail,
1097 * regardless of whether or not TRANSPORT_FLAG_PASSTHROUGH_PGR is set.
1099 if (!dev
->dev_attrib
.emulate_pr
&&
1100 ((cdb
[0] == PERSISTENT_RESERVE_IN
) ||
1101 (cdb
[0] == PERSISTENT_RESERVE_OUT
) ||
1102 (cdb
[0] == RELEASE
|| cdb
[0] == RELEASE_10
) ||
1103 (cdb
[0] == RESERVE
|| cdb
[0] == RESERVE_10
))) {
1104 return TCM_UNSUPPORTED_SCSI_OPCODE
;
1108 * For PERSISTENT RESERVE IN/OUT, RELEASE, and RESERVE we need to
1109 * emulate the response, since tcmu does not have the information
1110 * required to process these commands.
1112 if (!(dev
->transport_flags
&
1113 TRANSPORT_FLAG_PASSTHROUGH_PGR
)) {
1114 if (cdb
[0] == PERSISTENT_RESERVE_IN
) {
1115 cmd
->execute_cmd
= target_scsi3_emulate_pr_in
;
1116 size
= get_unaligned_be16(&cdb
[7]);
1117 return target_cmd_size_check(cmd
, size
);
1119 if (cdb
[0] == PERSISTENT_RESERVE_OUT
) {
1120 cmd
->execute_cmd
= target_scsi3_emulate_pr_out
;
1121 size
= get_unaligned_be32(&cdb
[5]);
1122 return target_cmd_size_check(cmd
, size
);
1125 if (cdb
[0] == RELEASE
|| cdb
[0] == RELEASE_10
) {
1126 cmd
->execute_cmd
= target_scsi2_reservation_release
;
1127 if (cdb
[0] == RELEASE_10
)
1128 size
= get_unaligned_be16(&cdb
[7]);
1130 size
= cmd
->data_length
;
1131 return target_cmd_size_check(cmd
, size
);
1133 if (cdb
[0] == RESERVE
|| cdb
[0] == RESERVE_10
) {
1134 cmd
->execute_cmd
= target_scsi2_reservation_reserve
;
1135 if (cdb
[0] == RESERVE_10
)
1136 size
= get_unaligned_be16(&cdb
[7]);
1138 size
= cmd
->data_length
;
1139 return target_cmd_size_check(cmd
, size
);
1143 /* Set DATA_CDB flag for ops that should have it */
1154 case WRITE_VERIFY_12
:
1155 case WRITE_VERIFY_16
:
1156 case COMPARE_AND_WRITE
:
1157 case XDWRITEREAD_10
:
1158 cmd
->se_cmd_flags
|= SCF_SCSI_DATA_CDB
;
1160 case VARIABLE_LENGTH_CMD
:
1161 switch (get_unaligned_be16(&cdb
[8])) {
1164 case WRITE_VERIFY_32
:
1165 case XDWRITEREAD_32
:
1166 cmd
->se_cmd_flags
|= SCF_SCSI_DATA_CDB
;
1171 cmd
->execute_cmd
= exec_cmd
;
1173 return TCM_NO_SENSE
;
1175 EXPORT_SYMBOL(passthrough_parse_cdb
);