1 /*******************************************************************************
2 * Filename: target_core_device.c (based on iscsi_target_device.c)
4 * This file contains the TCM Virtual Device and Disk Transport
5 * agnostic related functions.
7 * (c) Copyright 2003-2013 Datera, Inc.
9 * Nicholas A. Bellinger <nab@kernel.org>
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
21 * You should have received a copy of the GNU General Public License
22 * along with this program; if not, write to the Free Software
23 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
25 ******************************************************************************/
27 #include <linux/net.h>
28 #include <linux/string.h>
29 #include <linux/delay.h>
30 #include <linux/timer.h>
31 #include <linux/slab.h>
32 #include <linux/spinlock.h>
33 #include <linux/kthread.h>
35 #include <linux/export.h>
36 #include <linux/t10-pi.h>
37 #include <asm/unaligned.h>
40 #include <scsi/scsi_common.h>
41 #include <scsi/scsi_proto.h>
43 #include <target/target_core_base.h>
44 #include <target/target_core_backend.h>
45 #include <target/target_core_fabric.h>
47 #include "target_core_internal.h"
48 #include "target_core_alua.h"
49 #include "target_core_pr.h"
50 #include "target_core_ua.h"
52 static DEFINE_MUTEX(device_mutex
);
53 static LIST_HEAD(device_list
);
54 static DEFINE_IDR(devices_idr
);
56 static struct se_hba
*lun0_hba
;
57 /* not static, needed by tpg.c */
58 struct se_device
*g_lun0_dev
;
61 transport_lookup_cmd_lun(struct se_cmd
*se_cmd
, u64 unpacked_lun
)
63 struct se_lun
*se_lun
= NULL
;
64 struct se_session
*se_sess
= se_cmd
->se_sess
;
65 struct se_node_acl
*nacl
= se_sess
->se_node_acl
;
66 struct se_dev_entry
*deve
;
67 sense_reason_t ret
= TCM_NO_SENSE
;
70 deve
= target_nacl_find_deve(nacl
, unpacked_lun
);
72 atomic_long_inc(&deve
->total_cmds
);
74 if (se_cmd
->data_direction
== DMA_TO_DEVICE
)
75 atomic_long_add(se_cmd
->data_length
,
77 else if (se_cmd
->data_direction
== DMA_FROM_DEVICE
)
78 atomic_long_add(se_cmd
->data_length
,
81 se_lun
= rcu_dereference(deve
->se_lun
);
83 if (!percpu_ref_tryget_live(&se_lun
->lun_ref
)) {
88 se_cmd
->se_lun
= se_lun
;
89 se_cmd
->pr_res_key
= deve
->pr_res_key
;
90 se_cmd
->orig_fe_lun
= unpacked_lun
;
91 se_cmd
->se_cmd_flags
|= SCF_SE_LUN_CMD
;
92 se_cmd
->lun_ref_active
= true;
94 if ((se_cmd
->data_direction
== DMA_TO_DEVICE
) &&
95 deve
->lun_access_ro
) {
96 pr_err("TARGET_CORE[%s]: Detected WRITE_PROTECTED LUN"
97 " Access for 0x%08llx\n",
98 se_cmd
->se_tfo
->get_fabric_name(),
101 ret
= TCM_WRITE_PROTECTED
;
110 * Use the se_portal_group->tpg_virt_lun0 to allow for
111 * REPORT_LUNS, et al to be returned when no active
112 * MappedLUN=0 exists for this Initiator Port.
114 if (unpacked_lun
!= 0) {
115 pr_err("TARGET_CORE[%s]: Detected NON_EXISTENT_LUN"
116 " Access for 0x%08llx\n",
117 se_cmd
->se_tfo
->get_fabric_name(),
119 return TCM_NON_EXISTENT_LUN
;
122 se_lun
= se_sess
->se_tpg
->tpg_virt_lun0
;
123 se_cmd
->se_lun
= se_sess
->se_tpg
->tpg_virt_lun0
;
124 se_cmd
->orig_fe_lun
= 0;
125 se_cmd
->se_cmd_flags
|= SCF_SE_LUN_CMD
;
127 percpu_ref_get(&se_lun
->lun_ref
);
128 se_cmd
->lun_ref_active
= true;
131 * Force WRITE PROTECT for virtual LUN 0
133 if ((se_cmd
->data_direction
!= DMA_FROM_DEVICE
) &&
134 (se_cmd
->data_direction
!= DMA_NONE
)) {
135 ret
= TCM_WRITE_PROTECTED
;
140 * RCU reference protected by percpu se_lun->lun_ref taken above that
141 * must drop to zero (including initial reference) before this se_lun
142 * pointer can be kfree_rcu() by the final se_lun->lun_group put via
143 * target_core_fabric_configfs.c:target_fabric_port_release
146 se_cmd
->se_dev
= rcu_dereference_raw(se_lun
->lun_se_dev
);
147 atomic_long_inc(&se_cmd
->se_dev
->num_cmds
);
149 if (se_cmd
->data_direction
== DMA_TO_DEVICE
)
150 atomic_long_add(se_cmd
->data_length
,
151 &se_cmd
->se_dev
->write_bytes
);
152 else if (se_cmd
->data_direction
== DMA_FROM_DEVICE
)
153 atomic_long_add(se_cmd
->data_length
,
154 &se_cmd
->se_dev
->read_bytes
);
158 EXPORT_SYMBOL(transport_lookup_cmd_lun
);
160 int transport_lookup_tmr_lun(struct se_cmd
*se_cmd
, u64 unpacked_lun
)
162 struct se_dev_entry
*deve
;
163 struct se_lun
*se_lun
= NULL
;
164 struct se_session
*se_sess
= se_cmd
->se_sess
;
165 struct se_node_acl
*nacl
= se_sess
->se_node_acl
;
166 struct se_tmr_req
*se_tmr
= se_cmd
->se_tmr_req
;
170 deve
= target_nacl_find_deve(nacl
, unpacked_lun
);
172 se_lun
= rcu_dereference(deve
->se_lun
);
174 if (!percpu_ref_tryget_live(&se_lun
->lun_ref
)) {
179 se_cmd
->se_lun
= se_lun
;
180 se_cmd
->pr_res_key
= deve
->pr_res_key
;
181 se_cmd
->orig_fe_lun
= unpacked_lun
;
182 se_cmd
->se_cmd_flags
|= SCF_SE_LUN_CMD
;
183 se_cmd
->lun_ref_active
= true;
189 pr_debug("TARGET_CORE[%s]: Detected NON_EXISTENT_LUN"
190 " Access for 0x%08llx\n",
191 se_cmd
->se_tfo
->get_fabric_name(),
195 se_cmd
->se_dev
= rcu_dereference_raw(se_lun
->lun_se_dev
);
196 se_tmr
->tmr_dev
= rcu_dereference_raw(se_lun
->lun_se_dev
);
198 spin_lock_irqsave(&se_tmr
->tmr_dev
->se_tmr_lock
, flags
);
199 list_add_tail(&se_tmr
->tmr_list
, &se_tmr
->tmr_dev
->dev_tmr_list
);
200 spin_unlock_irqrestore(&se_tmr
->tmr_dev
->se_tmr_lock
, flags
);
204 EXPORT_SYMBOL(transport_lookup_tmr_lun
);
206 bool target_lun_is_rdonly(struct se_cmd
*cmd
)
208 struct se_session
*se_sess
= cmd
->se_sess
;
209 struct se_dev_entry
*deve
;
213 deve
= target_nacl_find_deve(se_sess
->se_node_acl
, cmd
->orig_fe_lun
);
214 ret
= deve
&& deve
->lun_access_ro
;
219 EXPORT_SYMBOL(target_lun_is_rdonly
);
222 * This function is called from core_scsi3_emulate_pro_register_and_move()
223 * and core_scsi3_decode_spec_i_port(), and will increment &deve->pr_kref
224 * when a matching rtpi is found.
226 struct se_dev_entry
*core_get_se_deve_from_rtpi(
227 struct se_node_acl
*nacl
,
230 struct se_dev_entry
*deve
;
232 struct se_portal_group
*tpg
= nacl
->se_tpg
;
235 hlist_for_each_entry_rcu(deve
, &nacl
->lun_entry_hlist
, link
) {
236 lun
= rcu_dereference(deve
->se_lun
);
238 pr_err("%s device entries device pointer is"
239 " NULL, but Initiator has access.\n",
240 tpg
->se_tpg_tfo
->get_fabric_name());
243 if (lun
->lun_rtpi
!= rtpi
)
246 kref_get(&deve
->pr_kref
);
256 void core_free_device_list_for_node(
257 struct se_node_acl
*nacl
,
258 struct se_portal_group
*tpg
)
260 struct se_dev_entry
*deve
;
262 mutex_lock(&nacl
->lun_entry_mutex
);
263 hlist_for_each_entry_rcu(deve
, &nacl
->lun_entry_hlist
, link
) {
264 struct se_lun
*lun
= rcu_dereference_check(deve
->se_lun
,
265 lockdep_is_held(&nacl
->lun_entry_mutex
));
266 core_disable_device_list_for_node(lun
, deve
, nacl
, tpg
);
268 mutex_unlock(&nacl
->lun_entry_mutex
);
271 void core_update_device_list_access(
274 struct se_node_acl
*nacl
)
276 struct se_dev_entry
*deve
;
278 mutex_lock(&nacl
->lun_entry_mutex
);
279 deve
= target_nacl_find_deve(nacl
, mapped_lun
);
281 deve
->lun_access_ro
= lun_access_ro
;
282 mutex_unlock(&nacl
->lun_entry_mutex
);
286 * Called with rcu_read_lock or nacl->device_list_lock held.
288 struct se_dev_entry
*target_nacl_find_deve(struct se_node_acl
*nacl
, u64 mapped_lun
)
290 struct se_dev_entry
*deve
;
292 hlist_for_each_entry_rcu(deve
, &nacl
->lun_entry_hlist
, link
)
293 if (deve
->mapped_lun
== mapped_lun
)
298 EXPORT_SYMBOL(target_nacl_find_deve
);
300 void target_pr_kref_release(struct kref
*kref
)
302 struct se_dev_entry
*deve
= container_of(kref
, struct se_dev_entry
,
304 complete(&deve
->pr_comp
);
308 target_luns_data_has_changed(struct se_node_acl
*nacl
, struct se_dev_entry
*new,
311 struct se_dev_entry
*tmp
;
314 hlist_for_each_entry_rcu(tmp
, &nacl
->lun_entry_hlist
, link
) {
315 if (skip_new
&& tmp
== new)
317 core_scsi3_ua_allocate(tmp
, 0x3F,
318 ASCQ_3FH_REPORTED_LUNS_DATA_HAS_CHANGED
);
323 int core_enable_device_list_for_node(
325 struct se_lun_acl
*lun_acl
,
328 struct se_node_acl
*nacl
,
329 struct se_portal_group
*tpg
)
331 struct se_dev_entry
*orig
, *new;
333 new = kzalloc(sizeof(*new), GFP_KERNEL
);
335 pr_err("Unable to allocate se_dev_entry memory\n");
339 spin_lock_init(&new->ua_lock
);
340 INIT_LIST_HEAD(&new->ua_list
);
341 INIT_LIST_HEAD(&new->lun_link
);
343 new->mapped_lun
= mapped_lun
;
344 kref_init(&new->pr_kref
);
345 init_completion(&new->pr_comp
);
347 new->lun_access_ro
= lun_access_ro
;
348 new->creation_time
= get_jiffies_64();
351 mutex_lock(&nacl
->lun_entry_mutex
);
352 orig
= target_nacl_find_deve(nacl
, mapped_lun
);
353 if (orig
&& orig
->se_lun
) {
354 struct se_lun
*orig_lun
= rcu_dereference_check(orig
->se_lun
,
355 lockdep_is_held(&nacl
->lun_entry_mutex
));
357 if (orig_lun
!= lun
) {
358 pr_err("Existing orig->se_lun doesn't match new lun"
359 " for dynamic -> explicit NodeACL conversion:"
360 " %s\n", nacl
->initiatorname
);
361 mutex_unlock(&nacl
->lun_entry_mutex
);
365 if (orig
->se_lun_acl
!= NULL
) {
366 pr_warn_ratelimited("Detected existing explicit"
367 " se_lun_acl->se_lun_group reference for %s"
368 " mapped_lun: %llu, failing\n",
369 nacl
->initiatorname
, mapped_lun
);
370 mutex_unlock(&nacl
->lun_entry_mutex
);
375 rcu_assign_pointer(new->se_lun
, lun
);
376 rcu_assign_pointer(new->se_lun_acl
, lun_acl
);
377 hlist_del_rcu(&orig
->link
);
378 hlist_add_head_rcu(&new->link
, &nacl
->lun_entry_hlist
);
379 mutex_unlock(&nacl
->lun_entry_mutex
);
381 spin_lock(&lun
->lun_deve_lock
);
382 list_del(&orig
->lun_link
);
383 list_add_tail(&new->lun_link
, &lun
->lun_deve_list
);
384 spin_unlock(&lun
->lun_deve_lock
);
386 kref_put(&orig
->pr_kref
, target_pr_kref_release
);
387 wait_for_completion(&orig
->pr_comp
);
389 target_luns_data_has_changed(nacl
, new, true);
390 kfree_rcu(orig
, rcu_head
);
394 rcu_assign_pointer(new->se_lun
, lun
);
395 rcu_assign_pointer(new->se_lun_acl
, lun_acl
);
396 hlist_add_head_rcu(&new->link
, &nacl
->lun_entry_hlist
);
397 mutex_unlock(&nacl
->lun_entry_mutex
);
399 spin_lock(&lun
->lun_deve_lock
);
400 list_add_tail(&new->lun_link
, &lun
->lun_deve_list
);
401 spin_unlock(&lun
->lun_deve_lock
);
403 target_luns_data_has_changed(nacl
, new, true);
408 * Called with se_node_acl->lun_entry_mutex held.
410 void core_disable_device_list_for_node(
412 struct se_dev_entry
*orig
,
413 struct se_node_acl
*nacl
,
414 struct se_portal_group
*tpg
)
417 * rcu_dereference_raw protected by se_lun->lun_group symlink
418 * reference to se_device->dev_group.
420 struct se_device
*dev
= rcu_dereference_raw(lun
->lun_se_dev
);
422 * If the MappedLUN entry is being disabled, the entry in
423 * lun->lun_deve_list must be removed now before clearing the
424 * struct se_dev_entry pointers below as logic in
425 * core_alua_do_transition_tg_pt() depends on these being present.
427 * deve->se_lun_acl will be NULL for demo-mode created LUNs
428 * that have not been explicitly converted to MappedLUNs ->
429 * struct se_lun_acl, but we remove deve->lun_link from
430 * lun->lun_deve_list. This also means that active UAs and
431 * NodeACL context specific PR metadata for demo-mode
432 * MappedLUN *deve will be released below..
434 spin_lock(&lun
->lun_deve_lock
);
435 list_del(&orig
->lun_link
);
436 spin_unlock(&lun
->lun_deve_lock
);
438 * Disable struct se_dev_entry LUN ACL mapping
440 core_scsi3_ua_release_all(orig
);
442 hlist_del_rcu(&orig
->link
);
443 clear_bit(DEF_PR_REG_ACTIVE
, &orig
->deve_flags
);
444 orig
->lun_access_ro
= false;
445 orig
->creation_time
= 0;
446 orig
->attach_count
--;
448 * Before firing off RCU callback, wait for any in process SPEC_I_PT=1
449 * or REGISTER_AND_MOVE PR operation to complete.
451 kref_put(&orig
->pr_kref
, target_pr_kref_release
);
452 wait_for_completion(&orig
->pr_comp
);
454 rcu_assign_pointer(orig
->se_lun
, NULL
);
455 rcu_assign_pointer(orig
->se_lun_acl
, NULL
);
457 kfree_rcu(orig
, rcu_head
);
459 core_scsi3_free_pr_reg_from_nacl(dev
, nacl
);
460 target_luns_data_has_changed(nacl
, NULL
, false);
463 /* core_clear_lun_from_tpg():
467 void core_clear_lun_from_tpg(struct se_lun
*lun
, struct se_portal_group
*tpg
)
469 struct se_node_acl
*nacl
;
470 struct se_dev_entry
*deve
;
472 mutex_lock(&tpg
->acl_node_mutex
);
473 list_for_each_entry(nacl
, &tpg
->acl_node_list
, acl_list
) {
475 mutex_lock(&nacl
->lun_entry_mutex
);
476 hlist_for_each_entry_rcu(deve
, &nacl
->lun_entry_hlist
, link
) {
477 struct se_lun
*tmp_lun
= rcu_dereference_check(deve
->se_lun
,
478 lockdep_is_held(&nacl
->lun_entry_mutex
));
483 core_disable_device_list_for_node(lun
, deve
, nacl
, tpg
);
485 mutex_unlock(&nacl
->lun_entry_mutex
);
487 mutex_unlock(&tpg
->acl_node_mutex
);
490 int core_alloc_rtpi(struct se_lun
*lun
, struct se_device
*dev
)
494 spin_lock(&dev
->se_port_lock
);
495 if (dev
->export_count
== 0x0000ffff) {
496 pr_warn("Reached dev->dev_port_count =="
498 spin_unlock(&dev
->se_port_lock
);
503 * Allocate the next RELATIVE TARGET PORT IDENTIFIER for this struct se_device
504 * Here is the table from spc4r17 section 7.7.3.8.
506 * Table 473 -- RELATIVE TARGET PORT IDENTIFIER field
510 * 1h Relative port 1, historically known as port A
511 * 2h Relative port 2, historically known as port B
512 * 3h to FFFFh Relative port 3 through 65 535
514 lun
->lun_rtpi
= dev
->dev_rpti_counter
++;
518 list_for_each_entry(tmp
, &dev
->dev_sep_list
, lun_dev_link
) {
520 * Make sure RELATIVE TARGET PORT IDENTIFIER is unique
523 if (lun
->lun_rtpi
== tmp
->lun_rtpi
)
526 spin_unlock(&dev
->se_port_lock
);
531 static void se_release_vpd_for_dev(struct se_device
*dev
)
533 struct t10_vpd
*vpd
, *vpd_tmp
;
535 spin_lock(&dev
->t10_wwn
.t10_vpd_lock
);
536 list_for_each_entry_safe(vpd
, vpd_tmp
,
537 &dev
->t10_wwn
.t10_vpd_list
, vpd_list
) {
538 list_del(&vpd
->vpd_list
);
541 spin_unlock(&dev
->t10_wwn
.t10_vpd_lock
);
544 static u32
se_dev_align_max_sectors(u32 max_sectors
, u32 block_size
)
546 u32 aligned_max_sectors
;
549 * Limit max_sectors to a PAGE_SIZE aligned value for modern
550 * transport_allocate_data_tasks() operation.
552 alignment
= max(1ul, PAGE_SIZE
/ block_size
);
553 aligned_max_sectors
= rounddown(max_sectors
, alignment
);
555 if (max_sectors
!= aligned_max_sectors
)
556 pr_info("Rounding down aligned max_sectors from %u to %u\n",
557 max_sectors
, aligned_max_sectors
);
559 return aligned_max_sectors
;
562 int core_dev_add_lun(
563 struct se_portal_group
*tpg
,
564 struct se_device
*dev
,
569 rc
= core_tpg_add_lun(tpg
, lun
, false, dev
);
573 pr_debug("%s_TPG[%u]_LUN[%llu] - Activated %s Logical Unit from"
574 " CORE HBA: %u\n", tpg
->se_tpg_tfo
->get_fabric_name(),
575 tpg
->se_tpg_tfo
->tpg_get_tag(tpg
), lun
->unpacked_lun
,
576 tpg
->se_tpg_tfo
->get_fabric_name(), dev
->se_hba
->hba_id
);
578 * Update LUN maps for dynamically added initiators when
579 * generate_node_acl is enabled.
581 if (tpg
->se_tpg_tfo
->tpg_check_demo_mode(tpg
)) {
582 struct se_node_acl
*acl
;
584 mutex_lock(&tpg
->acl_node_mutex
);
585 list_for_each_entry(acl
, &tpg
->acl_node_list
, acl_list
) {
586 if (acl
->dynamic_node_acl
&&
587 (!tpg
->se_tpg_tfo
->tpg_check_demo_mode_login_only
||
588 !tpg
->se_tpg_tfo
->tpg_check_demo_mode_login_only(tpg
))) {
589 core_tpg_add_node_to_devs(acl
, tpg
, lun
);
592 mutex_unlock(&tpg
->acl_node_mutex
);
598 /* core_dev_del_lun():
602 void core_dev_del_lun(
603 struct se_portal_group
*tpg
,
606 pr_debug("%s_TPG[%u]_LUN[%llu] - Deactivating %s Logical Unit from"
607 " device object\n", tpg
->se_tpg_tfo
->get_fabric_name(),
608 tpg
->se_tpg_tfo
->tpg_get_tag(tpg
), lun
->unpacked_lun
,
609 tpg
->se_tpg_tfo
->get_fabric_name());
611 core_tpg_remove_lun(tpg
, lun
);
614 struct se_lun_acl
*core_dev_init_initiator_node_lun_acl(
615 struct se_portal_group
*tpg
,
616 struct se_node_acl
*nacl
,
620 struct se_lun_acl
*lacl
;
622 if (strlen(nacl
->initiatorname
) >= TRANSPORT_IQN_LEN
) {
623 pr_err("%s InitiatorName exceeds maximum size.\n",
624 tpg
->se_tpg_tfo
->get_fabric_name());
628 lacl
= kzalloc(sizeof(struct se_lun_acl
), GFP_KERNEL
);
630 pr_err("Unable to allocate memory for struct se_lun_acl.\n");
635 lacl
->mapped_lun
= mapped_lun
;
636 lacl
->se_lun_nacl
= nacl
;
641 int core_dev_add_initiator_node_lun_acl(
642 struct se_portal_group
*tpg
,
643 struct se_lun_acl
*lacl
,
647 struct se_node_acl
*nacl
= lacl
->se_lun_nacl
;
649 * rcu_dereference_raw protected by se_lun->lun_group symlink
650 * reference to se_device->dev_group.
652 struct se_device
*dev
= rcu_dereference_raw(lun
->lun_se_dev
);
657 if (lun
->lun_access_ro
)
658 lun_access_ro
= true;
662 if (core_enable_device_list_for_node(lun
, lacl
, lacl
->mapped_lun
,
663 lun_access_ro
, nacl
, tpg
) < 0)
666 pr_debug("%s_TPG[%hu]_LUN[%llu->%llu] - Added %s ACL for "
667 " InitiatorNode: %s\n", tpg
->se_tpg_tfo
->get_fabric_name(),
668 tpg
->se_tpg_tfo
->tpg_get_tag(tpg
), lun
->unpacked_lun
, lacl
->mapped_lun
,
669 lun_access_ro
? "RO" : "RW",
670 nacl
->initiatorname
);
672 * Check to see if there are any existing persistent reservation APTPL
673 * pre-registrations that need to be enabled for this LUN ACL..
675 core_scsi3_check_aptpl_registration(dev
, tpg
, lun
, nacl
,
680 int core_dev_del_initiator_node_lun_acl(
682 struct se_lun_acl
*lacl
)
684 struct se_portal_group
*tpg
= lun
->lun_tpg
;
685 struct se_node_acl
*nacl
;
686 struct se_dev_entry
*deve
;
688 nacl
= lacl
->se_lun_nacl
;
692 mutex_lock(&nacl
->lun_entry_mutex
);
693 deve
= target_nacl_find_deve(nacl
, lacl
->mapped_lun
);
695 core_disable_device_list_for_node(lun
, deve
, nacl
, tpg
);
696 mutex_unlock(&nacl
->lun_entry_mutex
);
698 pr_debug("%s_TPG[%hu]_LUN[%llu] - Removed ACL for"
699 " InitiatorNode: %s Mapped LUN: %llu\n",
700 tpg
->se_tpg_tfo
->get_fabric_name(),
701 tpg
->se_tpg_tfo
->tpg_get_tag(tpg
), lun
->unpacked_lun
,
702 nacl
->initiatorname
, lacl
->mapped_lun
);
707 void core_dev_free_initiator_node_lun_acl(
708 struct se_portal_group
*tpg
,
709 struct se_lun_acl
*lacl
)
711 pr_debug("%s_TPG[%hu] - Freeing ACL for %s InitiatorNode: %s"
712 " Mapped LUN: %llu\n", tpg
->se_tpg_tfo
->get_fabric_name(),
713 tpg
->se_tpg_tfo
->tpg_get_tag(tpg
),
714 tpg
->se_tpg_tfo
->get_fabric_name(),
715 lacl
->se_lun_nacl
->initiatorname
, lacl
->mapped_lun
);
720 static void scsi_dump_inquiry(struct se_device
*dev
)
722 struct t10_wwn
*wwn
= &dev
->t10_wwn
;
726 * Print Linux/SCSI style INQUIRY formatting to the kernel ring buffer
728 for (i
= 0; i
< 8; i
++)
729 if (wwn
->vendor
[i
] >= 0x20)
730 buf
[i
] = wwn
->vendor
[i
];
734 pr_debug(" Vendor: %s\n", buf
);
736 for (i
= 0; i
< 16; i
++)
737 if (wwn
->model
[i
] >= 0x20)
738 buf
[i
] = wwn
->model
[i
];
742 pr_debug(" Model: %s\n", buf
);
744 for (i
= 0; i
< 4; i
++)
745 if (wwn
->revision
[i
] >= 0x20)
746 buf
[i
] = wwn
->revision
[i
];
750 pr_debug(" Revision: %s\n", buf
);
752 device_type
= dev
->transport
->get_device_type(dev
);
753 pr_debug(" Type: %s ", scsi_device_type(device_type
));
756 struct se_device
*target_alloc_device(struct se_hba
*hba
, const char *name
)
758 struct se_device
*dev
;
759 struct se_lun
*xcopy_lun
;
761 dev
= hba
->backend
->ops
->alloc_device(hba
, name
);
766 dev
->transport
= hba
->backend
->ops
;
767 dev
->prot_length
= sizeof(struct t10_pi_tuple
);
768 dev
->hba_index
= hba
->hba_index
;
770 INIT_LIST_HEAD(&dev
->dev_sep_list
);
771 INIT_LIST_HEAD(&dev
->dev_tmr_list
);
772 INIT_LIST_HEAD(&dev
->delayed_cmd_list
);
773 INIT_LIST_HEAD(&dev
->state_list
);
774 INIT_LIST_HEAD(&dev
->qf_cmd_list
);
775 spin_lock_init(&dev
->execute_task_lock
);
776 spin_lock_init(&dev
->delayed_cmd_lock
);
777 spin_lock_init(&dev
->dev_reservation_lock
);
778 spin_lock_init(&dev
->se_port_lock
);
779 spin_lock_init(&dev
->se_tmr_lock
);
780 spin_lock_init(&dev
->qf_cmd_lock
);
781 sema_init(&dev
->caw_sem
, 1);
782 INIT_LIST_HEAD(&dev
->t10_wwn
.t10_vpd_list
);
783 spin_lock_init(&dev
->t10_wwn
.t10_vpd_lock
);
784 INIT_LIST_HEAD(&dev
->t10_pr
.registration_list
);
785 INIT_LIST_HEAD(&dev
->t10_pr
.aptpl_reg_list
);
786 spin_lock_init(&dev
->t10_pr
.registration_lock
);
787 spin_lock_init(&dev
->t10_pr
.aptpl_reg_lock
);
788 INIT_LIST_HEAD(&dev
->t10_alua
.tg_pt_gps_list
);
789 spin_lock_init(&dev
->t10_alua
.tg_pt_gps_lock
);
790 INIT_LIST_HEAD(&dev
->t10_alua
.lba_map_list
);
791 spin_lock_init(&dev
->t10_alua
.lba_map_lock
);
793 dev
->t10_wwn
.t10_dev
= dev
;
794 dev
->t10_alua
.t10_dev
= dev
;
796 dev
->dev_attrib
.da_dev
= dev
;
797 dev
->dev_attrib
.emulate_model_alias
= DA_EMULATE_MODEL_ALIAS
;
798 dev
->dev_attrib
.emulate_dpo
= 1;
799 dev
->dev_attrib
.emulate_fua_write
= 1;
800 dev
->dev_attrib
.emulate_fua_read
= 1;
801 dev
->dev_attrib
.emulate_write_cache
= DA_EMULATE_WRITE_CACHE
;
802 dev
->dev_attrib
.emulate_ua_intlck_ctrl
= DA_EMULATE_UA_INTLLCK_CTRL
;
803 dev
->dev_attrib
.emulate_tas
= DA_EMULATE_TAS
;
804 dev
->dev_attrib
.emulate_tpu
= DA_EMULATE_TPU
;
805 dev
->dev_attrib
.emulate_tpws
= DA_EMULATE_TPWS
;
806 dev
->dev_attrib
.emulate_caw
= DA_EMULATE_CAW
;
807 dev
->dev_attrib
.emulate_3pc
= DA_EMULATE_3PC
;
808 dev
->dev_attrib
.pi_prot_type
= TARGET_DIF_TYPE0_PROT
;
809 dev
->dev_attrib
.enforce_pr_isids
= DA_ENFORCE_PR_ISIDS
;
810 dev
->dev_attrib
.force_pr_aptpl
= DA_FORCE_PR_APTPL
;
811 dev
->dev_attrib
.is_nonrot
= DA_IS_NONROT
;
812 dev
->dev_attrib
.emulate_rest_reord
= DA_EMULATE_REST_REORD
;
813 dev
->dev_attrib
.max_unmap_lba_count
= DA_MAX_UNMAP_LBA_COUNT
;
814 dev
->dev_attrib
.max_unmap_block_desc_count
=
815 DA_MAX_UNMAP_BLOCK_DESC_COUNT
;
816 dev
->dev_attrib
.unmap_granularity
= DA_UNMAP_GRANULARITY_DEFAULT
;
817 dev
->dev_attrib
.unmap_granularity_alignment
=
818 DA_UNMAP_GRANULARITY_ALIGNMENT_DEFAULT
;
819 dev
->dev_attrib
.unmap_zeroes_data
=
820 DA_UNMAP_ZEROES_DATA_DEFAULT
;
821 dev
->dev_attrib
.max_write_same_len
= DA_MAX_WRITE_SAME_LEN
;
823 xcopy_lun
= &dev
->xcopy_lun
;
824 rcu_assign_pointer(xcopy_lun
->lun_se_dev
, dev
);
825 init_completion(&xcopy_lun
->lun_ref_comp
);
826 init_completion(&xcopy_lun
->lun_shutdown_comp
);
827 INIT_LIST_HEAD(&xcopy_lun
->lun_deve_list
);
828 INIT_LIST_HEAD(&xcopy_lun
->lun_dev_link
);
829 mutex_init(&xcopy_lun
->lun_tg_pt_md_mutex
);
830 xcopy_lun
->lun_tpg
= &xcopy_pt_tpg
;
836 * Check if the underlying struct block_device request_queue supports
837 * the QUEUE_FLAG_DISCARD bit for UNMAP/WRITE_SAME in SCSI + TRIM
838 * in ATA and we need to set TPE=1
840 bool target_configure_unmap_from_queue(struct se_dev_attrib
*attrib
,
841 struct request_queue
*q
)
843 int block_size
= queue_logical_block_size(q
);
845 if (!blk_queue_discard(q
))
848 attrib
->max_unmap_lba_count
=
849 q
->limits
.max_discard_sectors
>> (ilog2(block_size
) - 9);
851 * Currently hardcoded to 1 in Linux/SCSI code..
853 attrib
->max_unmap_block_desc_count
= 1;
854 attrib
->unmap_granularity
= q
->limits
.discard_granularity
/ block_size
;
855 attrib
->unmap_granularity_alignment
= q
->limits
.discard_alignment
/
857 attrib
->unmap_zeroes_data
= (q
->limits
.max_write_zeroes_sectors
);
860 EXPORT_SYMBOL(target_configure_unmap_from_queue
);
863 * Convert from blocksize advertised to the initiator to the 512 byte
864 * units unconditionally used by the Linux block layer.
866 sector_t
target_to_linux_sector(struct se_device
*dev
, sector_t lb
)
868 switch (dev
->dev_attrib
.block_size
) {
879 EXPORT_SYMBOL(target_to_linux_sector
);
881 struct devices_idr_iter
{
882 struct config_item
*prev_item
;
883 int (*fn
)(struct se_device
*dev
, void *data
);
887 static int target_devices_idr_iter(int id
, void *p
, void *data
)
888 __must_hold(&device_mutex
)
890 struct devices_idr_iter
*iter
= data
;
891 struct se_device
*dev
= p
;
894 config_item_put(iter
->prev_item
);
895 iter
->prev_item
= NULL
;
898 * We add the device early to the idr, so it can be used
899 * by backend modules during configuration. We do not want
900 * to allow other callers to access partially setup devices,
901 * so we skip them here.
903 if (!target_dev_configured(dev
))
906 iter
->prev_item
= config_item_get_unless_zero(&dev
->dev_group
.cg_item
);
907 if (!iter
->prev_item
)
909 mutex_unlock(&device_mutex
);
911 ret
= iter
->fn(dev
, iter
->data
);
913 mutex_lock(&device_mutex
);
918 * target_for_each_device - iterate over configured devices
919 * @fn: iterator function
920 * @data: pointer to data that will be passed to fn
922 * fn must return 0 to continue looping over devices. non-zero will break
923 * from the loop and return that value to the caller.
925 int target_for_each_device(int (*fn
)(struct se_device
*dev
, void *data
),
928 struct devices_idr_iter iter
= { .fn
= fn
, .data
= data
};
931 mutex_lock(&device_mutex
);
932 ret
= idr_for_each(&devices_idr
, target_devices_idr_iter
, &iter
);
933 mutex_unlock(&device_mutex
);
934 config_item_put(iter
.prev_item
);
938 int target_configure_device(struct se_device
*dev
)
940 struct se_hba
*hba
= dev
->se_hba
;
943 if (target_dev_configured(dev
)) {
944 pr_err("se_dev->se_dev_ptr already set for storage"
950 * Add early so modules like tcmu can use during its
953 mutex_lock(&device_mutex
);
955 * Use cyclic to try and avoid collisions with devices
956 * that were recently removed.
958 id
= idr_alloc_cyclic(&devices_idr
, dev
, 0, INT_MAX
, GFP_KERNEL
);
959 mutex_unlock(&device_mutex
);
966 ret
= dev
->transport
->configure_device(dev
);
970 * XXX: there is not much point to have two different values here..
972 dev
->dev_attrib
.block_size
= dev
->dev_attrib
.hw_block_size
;
973 dev
->dev_attrib
.queue_depth
= dev
->dev_attrib
.hw_queue_depth
;
976 * Align max_hw_sectors down to PAGE_SIZE I/O transfers
978 dev
->dev_attrib
.hw_max_sectors
=
979 se_dev_align_max_sectors(dev
->dev_attrib
.hw_max_sectors
,
980 dev
->dev_attrib
.hw_block_size
);
981 dev
->dev_attrib
.optimal_sectors
= dev
->dev_attrib
.hw_max_sectors
;
983 dev
->creation_time
= get_jiffies_64();
985 ret
= core_setup_alua(dev
);
987 goto out_destroy_device
;
990 * Startup the struct se_device processing thread
992 dev
->tmr_wq
= alloc_workqueue("tmr-%s", WQ_MEM_RECLAIM
| WQ_UNBOUND
, 1,
993 dev
->transport
->name
);
995 pr_err("Unable to create tmr workqueue for %s\n",
996 dev
->transport
->name
);
1002 * Setup work_queue for QUEUE_FULL
1004 INIT_WORK(&dev
->qf_work_queue
, target_qf_do_work
);
1007 * Preload the initial INQUIRY const values if we are doing
1008 * anything virtual (IBLOCK, FILEIO, RAMDISK), but not for TCM/pSCSI
1009 * passthrough because this is being provided by the backend LLD.
1011 if (!(dev
->transport
->transport_flags
& TRANSPORT_FLAG_PASSTHROUGH
)) {
1012 strncpy(&dev
->t10_wwn
.vendor
[0], "LIO-ORG", 8);
1013 strncpy(&dev
->t10_wwn
.model
[0],
1014 dev
->transport
->inquiry_prod
, 16);
1015 strncpy(&dev
->t10_wwn
.revision
[0],
1016 dev
->transport
->inquiry_rev
, 4);
1019 scsi_dump_inquiry(dev
);
1021 spin_lock(&hba
->device_lock
);
1023 spin_unlock(&hba
->device_lock
);
1025 dev
->dev_flags
|= DF_CONFIGURED
;
1030 core_alua_free_lu_gp_mem(dev
);
1032 dev
->transport
->destroy_device(dev
);
1034 mutex_lock(&device_mutex
);
1035 idr_remove(&devices_idr
, dev
->dev_index
);
1036 mutex_unlock(&device_mutex
);
1038 se_release_vpd_for_dev(dev
);
1042 void target_free_device(struct se_device
*dev
)
1044 struct se_hba
*hba
= dev
->se_hba
;
1046 WARN_ON(!list_empty(&dev
->dev_sep_list
));
1048 if (target_dev_configured(dev
)) {
1049 destroy_workqueue(dev
->tmr_wq
);
1051 dev
->transport
->destroy_device(dev
);
1053 mutex_lock(&device_mutex
);
1054 idr_remove(&devices_idr
, dev
->dev_index
);
1055 mutex_unlock(&device_mutex
);
1057 spin_lock(&hba
->device_lock
);
1059 spin_unlock(&hba
->device_lock
);
1062 core_alua_free_lu_gp_mem(dev
);
1063 core_alua_set_lba_map(dev
, NULL
, 0, 0);
1064 core_scsi3_free_all_registrations(dev
);
1065 se_release_vpd_for_dev(dev
);
1067 if (dev
->transport
->free_prot
)
1068 dev
->transport
->free_prot(dev
);
1070 dev
->transport
->free_device(dev
);
1073 int core_dev_setup_virtual_lun0(void)
1076 struct se_device
*dev
;
1077 char buf
[] = "rd_pages=8,rd_nullio=1";
1080 hba
= core_alloc_hba("rd_mcp", 0, HBA_FLAGS_INTERNAL_USE
);
1082 return PTR_ERR(hba
);
1084 dev
= target_alloc_device(hba
, "virt_lun0");
1090 hba
->backend
->ops
->set_configfs_dev_params(dev
, buf
, sizeof(buf
));
1092 ret
= target_configure_device(dev
);
1094 goto out_free_se_dev
;
1101 target_free_device(dev
);
1103 core_delete_hba(hba
);
1108 void core_dev_release_virtual_lun0(void)
1110 struct se_hba
*hba
= lun0_hba
;
1116 target_free_device(g_lun0_dev
);
1117 core_delete_hba(hba
);
1121 * Common CDB parsing for kernel and user passthrough.
1124 passthrough_parse_cdb(struct se_cmd
*cmd
,
1125 sense_reason_t (*exec_cmd
)(struct se_cmd
*cmd
))
1127 unsigned char *cdb
= cmd
->t_task_cdb
;
1128 struct se_device
*dev
= cmd
->se_dev
;
1132 * For REPORT LUNS we always need to emulate the response, for everything
1135 if (cdb
[0] == REPORT_LUNS
) {
1136 cmd
->execute_cmd
= spc_emulate_report_luns
;
1137 return TCM_NO_SENSE
;
1141 * For PERSISTENT RESERVE IN/OUT, RELEASE, and RESERVE we need to
1142 * emulate the response, since tcmu does not have the information
1143 * required to process these commands.
1145 if (!(dev
->transport
->transport_flags
&
1146 TRANSPORT_FLAG_PASSTHROUGH_PGR
)) {
1147 if (cdb
[0] == PERSISTENT_RESERVE_IN
) {
1148 cmd
->execute_cmd
= target_scsi3_emulate_pr_in
;
1149 size
= get_unaligned_be16(&cdb
[7]);
1150 return target_cmd_size_check(cmd
, size
);
1152 if (cdb
[0] == PERSISTENT_RESERVE_OUT
) {
1153 cmd
->execute_cmd
= target_scsi3_emulate_pr_out
;
1154 size
= get_unaligned_be32(&cdb
[5]);
1155 return target_cmd_size_check(cmd
, size
);
1158 if (cdb
[0] == RELEASE
|| cdb
[0] == RELEASE_10
) {
1159 cmd
->execute_cmd
= target_scsi2_reservation_release
;
1160 if (cdb
[0] == RELEASE_10
)
1161 size
= get_unaligned_be16(&cdb
[7]);
1163 size
= cmd
->data_length
;
1164 return target_cmd_size_check(cmd
, size
);
1166 if (cdb
[0] == RESERVE
|| cdb
[0] == RESERVE_10
) {
1167 cmd
->execute_cmd
= target_scsi2_reservation_reserve
;
1168 if (cdb
[0] == RESERVE_10
)
1169 size
= get_unaligned_be16(&cdb
[7]);
1171 size
= cmd
->data_length
;
1172 return target_cmd_size_check(cmd
, size
);
1176 /* Set DATA_CDB flag for ops that should have it */
1187 case WRITE_VERIFY_12
:
1188 case WRITE_VERIFY_16
:
1189 case COMPARE_AND_WRITE
:
1190 case XDWRITEREAD_10
:
1191 cmd
->se_cmd_flags
|= SCF_SCSI_DATA_CDB
;
1193 case VARIABLE_LENGTH_CMD
:
1194 switch (get_unaligned_be16(&cdb
[8])) {
1197 case WRITE_VERIFY_32
:
1198 case XDWRITEREAD_32
:
1199 cmd
->se_cmd_flags
|= SCF_SCSI_DATA_CDB
;
1204 cmd
->execute_cmd
= exec_cmd
;
1206 return TCM_NO_SENSE
;
1208 EXPORT_SYMBOL(passthrough_parse_cdb
);