1 /*******************************************************************************
2 * Filename: target_core_pscsi.c
4 * This file contains the generic target mode <-> Linux SCSI subsystem plugin.
6 * (c) Copyright 2003-2013 Datera, Inc.
8 * Nicholas A. Bellinger <nab@kernel.org>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
24 ******************************************************************************/
26 #include <linux/string.h>
27 #include <linux/parser.h>
28 #include <linux/timer.h>
29 #include <linux/blkdev.h>
30 #include <linux/blk_types.h>
31 #include <linux/slab.h>
32 #include <linux/spinlock.h>
33 #include <linux/genhd.h>
34 #include <linux/cdrom.h>
35 #include <linux/ratelimit.h>
36 #include <linux/module.h>
37 #include <asm/unaligned.h>
39 #include <scsi/scsi.h>
40 #include <scsi/scsi_device.h>
41 #include <scsi/scsi_cmnd.h>
42 #include <scsi/scsi_host.h>
43 #include <scsi/scsi_tcq.h>
45 #include <target/target_core_base.h>
46 #include <target/target_core_backend.h>
47 #include <target/target_core_backend_configfs.h>
49 #include "target_core_alua.h"
50 #include "target_core_pscsi.h"
52 #define ISPRINT(a) ((a >= ' ') && (a <= '~'))
54 static inline struct pscsi_dev_virt
*PSCSI_DEV(struct se_device
*dev
)
56 return container_of(dev
, struct pscsi_dev_virt
, dev
);
59 static struct se_subsystem_api pscsi_template
;
61 static sense_reason_t
pscsi_execute_cmd(struct se_cmd
*cmd
);
62 static void pscsi_req_done(struct request
*, int);
64 /* pscsi_attach_hba():
66 * pscsi_get_sh() used scsi_host_lookup() to locate struct Scsi_Host.
67 * from the passed SCSI Host ID.
69 static int pscsi_attach_hba(struct se_hba
*hba
, u32 host_id
)
71 struct pscsi_hba_virt
*phv
;
73 phv
= kzalloc(sizeof(struct pscsi_hba_virt
), GFP_KERNEL
);
75 pr_err("Unable to allocate struct pscsi_hba_virt\n");
78 phv
->phv_host_id
= host_id
;
79 phv
->phv_mode
= PHV_VIRTUAL_HOST_ID
;
83 pr_debug("CORE_HBA[%d] - TCM SCSI HBA Driver %s on"
84 " Generic Target Core Stack %s\n", hba
->hba_id
,
85 PSCSI_VERSION
, TARGET_CORE_MOD_VERSION
);
86 pr_debug("CORE_HBA[%d] - Attached SCSI HBA to Generic\n",
92 static void pscsi_detach_hba(struct se_hba
*hba
)
94 struct pscsi_hba_virt
*phv
= hba
->hba_ptr
;
95 struct Scsi_Host
*scsi_host
= phv
->phv_lld_host
;
98 scsi_host_put(scsi_host
);
100 pr_debug("CORE_HBA[%d] - Detached SCSI HBA: %s from"
101 " Generic Target Core\n", hba
->hba_id
,
102 (scsi_host
->hostt
->name
) ? (scsi_host
->hostt
->name
) :
105 pr_debug("CORE_HBA[%d] - Detached Virtual SCSI HBA"
106 " from Generic Target Core\n", hba
->hba_id
);
112 static int pscsi_pmode_enable_hba(struct se_hba
*hba
, unsigned long mode_flag
)
114 struct pscsi_hba_virt
*phv
= hba
->hba_ptr
;
115 struct Scsi_Host
*sh
= phv
->phv_lld_host
;
117 * Release the struct Scsi_Host
123 phv
->phv_lld_host
= NULL
;
124 phv
->phv_mode
= PHV_VIRTUAL_HOST_ID
;
126 pr_debug("CORE_HBA[%d] - Disabled pSCSI HBA Passthrough"
127 " %s\n", hba
->hba_id
, (sh
->hostt
->name
) ?
128 (sh
->hostt
->name
) : "Unknown");
134 * Otherwise, locate struct Scsi_Host from the original passed
135 * pSCSI Host ID and enable for phba mode
137 sh
= scsi_host_lookup(phv
->phv_host_id
);
139 pr_err("pSCSI: Unable to locate SCSI Host for"
140 " phv_host_id: %d\n", phv
->phv_host_id
);
144 phv
->phv_lld_host
= sh
;
145 phv
->phv_mode
= PHV_LLD_SCSI_HOST_NO
;
147 pr_debug("CORE_HBA[%d] - Enabled pSCSI HBA Passthrough %s\n",
148 hba
->hba_id
, (sh
->hostt
->name
) ? (sh
->hostt
->name
) : "Unknown");
153 static void pscsi_tape_read_blocksize(struct se_device
*dev
,
154 struct scsi_device
*sdev
)
156 unsigned char cdb
[MAX_COMMAND_SIZE
], *buf
;
159 buf
= kzalloc(12, GFP_KERNEL
);
163 memset(cdb
, 0, MAX_COMMAND_SIZE
);
165 cdb
[4] = 0x0c; /* 12 bytes */
167 ret
= scsi_execute_req(sdev
, cdb
, DMA_FROM_DEVICE
, buf
, 12, NULL
,
173 * If MODE_SENSE still returns zero, set the default value to 1024.
175 sdev
->sector_size
= (buf
[9] << 16) | (buf
[10] << 8) | (buf
[11]);
176 if (!sdev
->sector_size
)
177 sdev
->sector_size
= 1024;
183 pscsi_set_inquiry_info(struct scsi_device
*sdev
, struct t10_wwn
*wwn
)
187 if (sdev
->inquiry_len
< INQUIRY_LEN
)
194 * Use sdev->inquiry from drivers/scsi/scsi_scan.c:scsi_alloc_sdev()
196 memcpy(&wwn
->vendor
[0], &buf
[8], sizeof(wwn
->vendor
));
197 memcpy(&wwn
->model
[0], &buf
[16], sizeof(wwn
->model
));
198 memcpy(&wwn
->revision
[0], &buf
[32], sizeof(wwn
->revision
));
202 pscsi_get_inquiry_vpd_serial(struct scsi_device
*sdev
, struct t10_wwn
*wwn
)
204 unsigned char cdb
[MAX_COMMAND_SIZE
], *buf
;
207 buf
= kzalloc(INQUIRY_VPD_SERIAL_LEN
, GFP_KERNEL
);
211 memset(cdb
, 0, MAX_COMMAND_SIZE
);
213 cdb
[1] = 0x01; /* Query VPD */
214 cdb
[2] = 0x80; /* Unit Serial Number */
215 cdb
[3] = (INQUIRY_VPD_SERIAL_LEN
>> 8) & 0xff;
216 cdb
[4] = (INQUIRY_VPD_SERIAL_LEN
& 0xff);
218 ret
= scsi_execute_req(sdev
, cdb
, DMA_FROM_DEVICE
, buf
,
219 INQUIRY_VPD_SERIAL_LEN
, NULL
, HZ
, 1, NULL
);
223 snprintf(&wwn
->unit_serial
[0], INQUIRY_VPD_SERIAL_LEN
, "%s", &buf
[4]);
225 wwn
->t10_dev
->dev_flags
|= DF_FIRMWARE_VPD_UNIT_SERIAL
;
236 pscsi_get_inquiry_vpd_device_ident(struct scsi_device
*sdev
,
239 unsigned char cdb
[MAX_COMMAND_SIZE
], *buf
, *page_83
;
240 int ident_len
, page_len
, off
= 4, ret
;
243 buf
= kzalloc(INQUIRY_VPD_SERIAL_LEN
, GFP_KERNEL
);
247 memset(cdb
, 0, MAX_COMMAND_SIZE
);
249 cdb
[1] = 0x01; /* Query VPD */
250 cdb
[2] = 0x83; /* Device Identifier */
251 cdb
[3] = (INQUIRY_VPD_DEVICE_IDENTIFIER_LEN
>> 8) & 0xff;
252 cdb
[4] = (INQUIRY_VPD_DEVICE_IDENTIFIER_LEN
& 0xff);
254 ret
= scsi_execute_req(sdev
, cdb
, DMA_FROM_DEVICE
, buf
,
255 INQUIRY_VPD_DEVICE_IDENTIFIER_LEN
,
260 page_len
= (buf
[2] << 8) | buf
[3];
261 while (page_len
> 0) {
262 /* Grab a pointer to the Identification descriptor */
264 ident_len
= page_83
[3];
266 pr_err("page_83[3]: identifier"
270 pr_debug("T10 VPD Identifier Length: %d\n", ident_len
);
272 vpd
= kzalloc(sizeof(struct t10_vpd
), GFP_KERNEL
);
274 pr_err("Unable to allocate memory for"
275 " struct t10_vpd\n");
278 INIT_LIST_HEAD(&vpd
->vpd_list
);
280 transport_set_vpd_proto_id(vpd
, page_83
);
281 transport_set_vpd_assoc(vpd
, page_83
);
283 if (transport_set_vpd_ident_type(vpd
, page_83
) < 0) {
284 off
+= (ident_len
+ 4);
285 page_len
-= (ident_len
+ 4);
289 if (transport_set_vpd_ident(vpd
, page_83
) < 0) {
290 off
+= (ident_len
+ 4);
291 page_len
-= (ident_len
+ 4);
296 list_add_tail(&vpd
->vpd_list
, &wwn
->t10_vpd_list
);
297 off
+= (ident_len
+ 4);
298 page_len
-= (ident_len
+ 4);
305 static int pscsi_add_device_to_list(struct se_device
*dev
,
306 struct scsi_device
*sd
)
308 struct pscsi_dev_virt
*pdv
= PSCSI_DEV(dev
);
309 struct request_queue
*q
= sd
->request_queue
;
313 if (!sd
->queue_depth
) {
314 sd
->queue_depth
= PSCSI_DEFAULT_QUEUEDEPTH
;
316 pr_err("Set broken SCSI Device %d:%d:%llu"
317 " queue_depth to %d\n", sd
->channel
, sd
->id
,
318 sd
->lun
, sd
->queue_depth
);
321 dev
->dev_attrib
.hw_block_size
= sd
->sector_size
;
322 dev
->dev_attrib
.hw_max_sectors
=
323 min_t(int, sd
->host
->max_sectors
, queue_max_hw_sectors(q
));
324 dev
->dev_attrib
.hw_queue_depth
= sd
->queue_depth
;
327 * Setup our standard INQUIRY info into se_dev->t10_wwn
329 pscsi_set_inquiry_info(sd
, &dev
->t10_wwn
);
332 * Locate VPD WWN Information used for various purposes within
333 * the Storage Engine.
335 if (!pscsi_get_inquiry_vpd_serial(sd
, &dev
->t10_wwn
)) {
337 * If VPD Unit Serial returned GOOD status, try
338 * VPD Device Identification page (0x83).
340 pscsi_get_inquiry_vpd_device_ident(sd
, &dev
->t10_wwn
);
344 * For TYPE_TAPE, attempt to determine blocksize with MODE_SENSE.
346 if (sd
->type
== TYPE_TAPE
)
347 pscsi_tape_read_blocksize(dev
, sd
);
351 static struct se_device
*pscsi_alloc_device(struct se_hba
*hba
,
354 struct pscsi_dev_virt
*pdv
;
356 pdv
= kzalloc(sizeof(struct pscsi_dev_virt
), GFP_KERNEL
);
358 pr_err("Unable to allocate memory for struct pscsi_dev_virt\n");
362 pr_debug("PSCSI: Allocated pdv: %p for %s\n", pdv
, name
);
367 * Called with struct Scsi_Host->host_lock called.
369 static int pscsi_create_type_disk(struct se_device
*dev
, struct scsi_device
*sd
)
370 __releases(sh
->host_lock
)
372 struct pscsi_hba_virt
*phv
= dev
->se_hba
->hba_ptr
;
373 struct pscsi_dev_virt
*pdv
= PSCSI_DEV(dev
);
374 struct Scsi_Host
*sh
= sd
->host
;
375 struct block_device
*bd
;
378 if (scsi_device_get(sd
)) {
379 pr_err("scsi_device_get() failed for %d:%d:%d:%llu\n",
380 sh
->host_no
, sd
->channel
, sd
->id
, sd
->lun
);
381 spin_unlock_irq(sh
->host_lock
);
384 spin_unlock_irq(sh
->host_lock
);
386 * Claim exclusive struct block_device access to struct scsi_device
387 * for TYPE_DISK using supplied udev_path
389 bd
= blkdev_get_by_path(dev
->udev_path
,
390 FMODE_WRITE
|FMODE_READ
|FMODE_EXCL
, pdv
);
392 pr_err("pSCSI: blkdev_get_by_path() failed\n");
398 ret
= pscsi_add_device_to_list(dev
, sd
);
400 blkdev_put(pdv
->pdv_bd
, FMODE_WRITE
|FMODE_READ
|FMODE_EXCL
);
405 pr_debug("CORE_PSCSI[%d] - Added TYPE_DISK for %d:%d:%d:%llu\n",
406 phv
->phv_host_id
, sh
->host_no
, sd
->channel
, sd
->id
, sd
->lun
);
411 * Called with struct Scsi_Host->host_lock called.
413 static int pscsi_create_type_rom(struct se_device
*dev
, struct scsi_device
*sd
)
414 __releases(sh
->host_lock
)
416 struct pscsi_hba_virt
*phv
= dev
->se_hba
->hba_ptr
;
417 struct Scsi_Host
*sh
= sd
->host
;
420 if (scsi_device_get(sd
)) {
421 pr_err("scsi_device_get() failed for %d:%d:%d:%llu\n",
422 sh
->host_no
, sd
->channel
, sd
->id
, sd
->lun
);
423 spin_unlock_irq(sh
->host_lock
);
426 spin_unlock_irq(sh
->host_lock
);
428 ret
= pscsi_add_device_to_list(dev
, sd
);
433 pr_debug("CORE_PSCSI[%d] - Added Type: %s for %d:%d:%d:%llu\n",
434 phv
->phv_host_id
, scsi_device_type(sd
->type
), sh
->host_no
,
435 sd
->channel
, sd
->id
, sd
->lun
);
441 * Called with struct Scsi_Host->host_lock called.
443 static int pscsi_create_type_other(struct se_device
*dev
,
444 struct scsi_device
*sd
)
445 __releases(sh
->host_lock
)
447 struct pscsi_hba_virt
*phv
= dev
->se_hba
->hba_ptr
;
448 struct Scsi_Host
*sh
= sd
->host
;
451 spin_unlock_irq(sh
->host_lock
);
452 ret
= pscsi_add_device_to_list(dev
, sd
);
456 pr_debug("CORE_PSCSI[%d] - Added Type: %s for %d:%d:%d:%llu\n",
457 phv
->phv_host_id
, scsi_device_type(sd
->type
), sh
->host_no
,
458 sd
->channel
, sd
->id
, sd
->lun
);
462 static int pscsi_configure_device(struct se_device
*dev
)
464 struct se_hba
*hba
= dev
->se_hba
;
465 struct pscsi_dev_virt
*pdv
= PSCSI_DEV(dev
);
466 struct scsi_device
*sd
;
467 struct pscsi_hba_virt
*phv
= dev
->se_hba
->hba_ptr
;
468 struct Scsi_Host
*sh
= phv
->phv_lld_host
;
469 int legacy_mode_enable
= 0;
472 if (!(pdv
->pdv_flags
& PDF_HAS_CHANNEL_ID
) ||
473 !(pdv
->pdv_flags
& PDF_HAS_TARGET_ID
) ||
474 !(pdv
->pdv_flags
& PDF_HAS_LUN_ID
)) {
475 pr_err("Missing scsi_channel_id=, scsi_target_id= and"
476 " scsi_lun_id= parameters\n");
481 * If not running in PHV_LLD_SCSI_HOST_NO mode, locate the
482 * struct Scsi_Host we will need to bring the TCM/pSCSI object online
485 if (phv
->phv_mode
== PHV_LLD_SCSI_HOST_NO
) {
486 pr_err("pSCSI: Unable to locate struct"
487 " Scsi_Host for PHV_LLD_SCSI_HOST_NO\n");
491 * For the newer PHV_VIRTUAL_HOST_ID struct scsi_device
492 * reference, we enforce that udev_path has been set
494 if (!(dev
->dev_flags
& DF_USING_UDEV_PATH
)) {
495 pr_err("pSCSI: udev_path attribute has not"
496 " been set before ENABLE=1\n");
500 * If no scsi_host_id= was passed for PHV_VIRTUAL_HOST_ID,
501 * use the original TCM hba ID to reference Linux/SCSI Host No
502 * and enable for PHV_LLD_SCSI_HOST_NO mode.
504 if (!(pdv
->pdv_flags
& PDF_HAS_VIRT_HOST_ID
)) {
505 if (hba
->dev_count
) {
506 pr_err("pSCSI: Unable to set hba_mode"
507 " with active devices\n");
511 if (pscsi_pmode_enable_hba(hba
, 1) != 1)
514 legacy_mode_enable
= 1;
515 hba
->hba_flags
|= HBA_FLAGS_PSCSI_MODE
;
516 sh
= phv
->phv_lld_host
;
518 sh
= scsi_host_lookup(pdv
->pdv_host_id
);
520 pr_err("pSCSI: Unable to locate"
521 " pdv_host_id: %d\n", pdv
->pdv_host_id
);
526 if (phv
->phv_mode
== PHV_VIRTUAL_HOST_ID
) {
527 pr_err("pSCSI: PHV_VIRTUAL_HOST_ID set while"
528 " struct Scsi_Host exists\n");
533 spin_lock_irq(sh
->host_lock
);
534 list_for_each_entry(sd
, &sh
->__devices
, siblings
) {
535 if ((pdv
->pdv_channel_id
!= sd
->channel
) ||
536 (pdv
->pdv_target_id
!= sd
->id
) ||
537 (pdv
->pdv_lun_id
!= sd
->lun
))
540 * Functions will release the held struct scsi_host->host_lock
541 * before calling calling pscsi_add_device_to_list() to register
542 * struct scsi_device with target_core_mod.
546 ret
= pscsi_create_type_disk(dev
, sd
);
549 ret
= pscsi_create_type_rom(dev
, sd
);
552 ret
= pscsi_create_type_other(dev
, sd
);
557 if (phv
->phv_mode
== PHV_VIRTUAL_HOST_ID
)
559 else if (legacy_mode_enable
) {
560 pscsi_pmode_enable_hba(hba
, 0);
561 hba
->hba_flags
&= ~HBA_FLAGS_PSCSI_MODE
;
568 spin_unlock_irq(sh
->host_lock
);
570 pr_err("pSCSI: Unable to locate %d:%d:%d:%d\n", sh
->host_no
,
571 pdv
->pdv_channel_id
, pdv
->pdv_target_id
, pdv
->pdv_lun_id
);
573 if (phv
->phv_mode
== PHV_VIRTUAL_HOST_ID
)
575 else if (legacy_mode_enable
) {
576 pscsi_pmode_enable_hba(hba
, 0);
577 hba
->hba_flags
&= ~HBA_FLAGS_PSCSI_MODE
;
583 static void pscsi_free_device(struct se_device
*dev
)
585 struct pscsi_dev_virt
*pdv
= PSCSI_DEV(dev
);
586 struct pscsi_hba_virt
*phv
= dev
->se_hba
->hba_ptr
;
587 struct scsi_device
*sd
= pdv
->pdv_sd
;
591 * Release exclusive pSCSI internal struct block_device claim for
592 * struct scsi_device with TYPE_DISK from pscsi_create_type_disk()
594 if ((sd
->type
== TYPE_DISK
) && pdv
->pdv_bd
) {
595 blkdev_put(pdv
->pdv_bd
,
596 FMODE_WRITE
|FMODE_READ
|FMODE_EXCL
);
600 * For HBA mode PHV_LLD_SCSI_HOST_NO, release the reference
601 * to struct Scsi_Host now.
603 if ((phv
->phv_mode
== PHV_LLD_SCSI_HOST_NO
) &&
604 (phv
->phv_lld_host
!= NULL
))
605 scsi_host_put(phv
->phv_lld_host
);
607 if ((sd
->type
== TYPE_DISK
) || (sd
->type
== TYPE_ROM
))
616 static void pscsi_transport_complete(struct se_cmd
*cmd
, struct scatterlist
*sg
,
617 unsigned char *sense_buffer
)
619 struct pscsi_dev_virt
*pdv
= PSCSI_DEV(cmd
->se_dev
);
620 struct scsi_device
*sd
= pdv
->pdv_sd
;
622 struct pscsi_plugin_task
*pt
= cmd
->priv
;
625 * Special case for REPORT_LUNs handling where pscsi_plugin_task has
626 * not been allocated because TCM is handling the emulation directly.
631 cdb
= &pt
->pscsi_cdb
[0];
632 result
= pt
->pscsi_result
;
634 * Hack to make sure that Write-Protect modepage is set if R/O mode is
637 if (!cmd
->se_deve
|| !cmd
->data_length
)
638 goto after_mode_sense
;
640 if (((cdb
[0] == MODE_SENSE
) || (cdb
[0] == MODE_SENSE_10
)) &&
641 (status_byte(result
) << 1) == SAM_STAT_GOOD
) {
642 if (cmd
->se_deve
->lun_flags
& TRANSPORT_LUNFLAGS_READ_ONLY
) {
645 buf
= transport_kmap_data_sg(cmd
);
647 ; /* XXX: TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE */
649 if (cdb
[0] == MODE_SENSE_10
) {
650 if (!(buf
[3] & 0x80))
653 if (!(buf
[2] & 0x80))
657 transport_kunmap_data_sg(cmd
);
662 if (sd
->type
!= TYPE_TAPE
|| !cmd
->data_length
)
663 goto after_mode_select
;
666 * Hack to correctly obtain the initiator requested blocksize for
667 * TYPE_TAPE. Since this value is dependent upon each tape media,
668 * struct scsi_device->sector_size will not contain the correct value
669 * by default, so we go ahead and set it so
670 * TRANSPORT(dev)->get_blockdev() returns the correct value to the
673 if (((cdb
[0] == MODE_SELECT
) || (cdb
[0] == MODE_SELECT_10
)) &&
674 (status_byte(result
) << 1) == SAM_STAT_GOOD
) {
679 buf
= sg_virt(&sg
[0]);
681 pr_err("Unable to get buf for scatterlist\n");
682 goto after_mode_select
;
685 if (cdb
[0] == MODE_SELECT
)
688 bdl
= (buf
[6] << 8) | (buf
[7]);
691 goto after_mode_select
;
693 if (cdb
[0] == MODE_SELECT
)
694 blocksize
= (buf
[9] << 16) | (buf
[10] << 8) |
697 blocksize
= (buf
[13] << 16) | (buf
[14] << 8) |
700 sd
->sector_size
= blocksize
;
704 if (sense_buffer
&& (status_byte(result
) & CHECK_CONDITION
)) {
705 memcpy(sense_buffer
, pt
->pscsi_sense
, TRANSPORT_SENSE_BUFFER
);
706 cmd
->se_cmd_flags
|= SCF_TRANSPORT_TASK_SENSE
;
711 Opt_scsi_host_id
, Opt_scsi_channel_id
, Opt_scsi_target_id
,
712 Opt_scsi_lun_id
, Opt_err
715 static match_table_t tokens
= {
716 {Opt_scsi_host_id
, "scsi_host_id=%d"},
717 {Opt_scsi_channel_id
, "scsi_channel_id=%d"},
718 {Opt_scsi_target_id
, "scsi_target_id=%d"},
719 {Opt_scsi_lun_id
, "scsi_lun_id=%d"},
723 static ssize_t
pscsi_set_configfs_dev_params(struct se_device
*dev
,
724 const char *page
, ssize_t count
)
726 struct pscsi_dev_virt
*pdv
= PSCSI_DEV(dev
);
727 struct pscsi_hba_virt
*phv
= dev
->se_hba
->hba_ptr
;
728 char *orig
, *ptr
, *opts
;
729 substring_t args
[MAX_OPT_ARGS
];
730 int ret
= 0, arg
, token
;
732 opts
= kstrdup(page
, GFP_KERNEL
);
738 while ((ptr
= strsep(&opts
, ",\n")) != NULL
) {
742 token
= match_token(ptr
, tokens
, args
);
744 case Opt_scsi_host_id
:
745 if (phv
->phv_mode
== PHV_LLD_SCSI_HOST_NO
) {
746 pr_err("PSCSI[%d]: Unable to accept"
747 " scsi_host_id while phv_mode =="
748 " PHV_LLD_SCSI_HOST_NO\n",
753 ret
= match_int(args
, &arg
);
756 pdv
->pdv_host_id
= arg
;
757 pr_debug("PSCSI[%d]: Referencing SCSI Host ID:"
758 " %d\n", phv
->phv_host_id
, pdv
->pdv_host_id
);
759 pdv
->pdv_flags
|= PDF_HAS_VIRT_HOST_ID
;
761 case Opt_scsi_channel_id
:
762 ret
= match_int(args
, &arg
);
765 pdv
->pdv_channel_id
= arg
;
766 pr_debug("PSCSI[%d]: Referencing SCSI Channel"
767 " ID: %d\n", phv
->phv_host_id
,
768 pdv
->pdv_channel_id
);
769 pdv
->pdv_flags
|= PDF_HAS_CHANNEL_ID
;
771 case Opt_scsi_target_id
:
772 ret
= match_int(args
, &arg
);
775 pdv
->pdv_target_id
= arg
;
776 pr_debug("PSCSI[%d]: Referencing SCSI Target"
777 " ID: %d\n", phv
->phv_host_id
,
779 pdv
->pdv_flags
|= PDF_HAS_TARGET_ID
;
781 case Opt_scsi_lun_id
:
782 ret
= match_int(args
, &arg
);
785 pdv
->pdv_lun_id
= arg
;
786 pr_debug("PSCSI[%d]: Referencing SCSI LUN ID:"
787 " %d\n", phv
->phv_host_id
, pdv
->pdv_lun_id
);
788 pdv
->pdv_flags
|= PDF_HAS_LUN_ID
;
797 return (!ret
) ? count
: ret
;
800 static ssize_t
pscsi_show_configfs_dev_params(struct se_device
*dev
, char *b
)
802 struct pscsi_hba_virt
*phv
= dev
->se_hba
->hba_ptr
;
803 struct pscsi_dev_virt
*pdv
= PSCSI_DEV(dev
);
804 struct scsi_device
*sd
= pdv
->pdv_sd
;
805 unsigned char host_id
[16];
809 if (phv
->phv_mode
== PHV_VIRTUAL_HOST_ID
)
810 snprintf(host_id
, 16, "%d", pdv
->pdv_host_id
);
812 snprintf(host_id
, 16, "PHBA Mode");
814 bl
= sprintf(b
, "SCSI Device Bus Location:"
815 " Channel ID: %d Target ID: %d LUN: %d Host ID: %s\n",
816 pdv
->pdv_channel_id
, pdv
->pdv_target_id
, pdv
->pdv_lun_id
,
820 bl
+= sprintf(b
+ bl
, " ");
821 bl
+= sprintf(b
+ bl
, "Vendor: ");
822 for (i
= 0; i
< 8; i
++) {
823 if (ISPRINT(sd
->vendor
[i
])) /* printable character? */
824 bl
+= sprintf(b
+ bl
, "%c", sd
->vendor
[i
]);
826 bl
+= sprintf(b
+ bl
, " ");
828 bl
+= sprintf(b
+ bl
, " Model: ");
829 for (i
= 0; i
< 16; i
++) {
830 if (ISPRINT(sd
->model
[i
])) /* printable character ? */
831 bl
+= sprintf(b
+ bl
, "%c", sd
->model
[i
]);
833 bl
+= sprintf(b
+ bl
, " ");
835 bl
+= sprintf(b
+ bl
, " Rev: ");
836 for (i
= 0; i
< 4; i
++) {
837 if (ISPRINT(sd
->rev
[i
])) /* printable character ? */
838 bl
+= sprintf(b
+ bl
, "%c", sd
->rev
[i
]);
840 bl
+= sprintf(b
+ bl
, " ");
842 bl
+= sprintf(b
+ bl
, "\n");
847 static void pscsi_bi_endio(struct bio
*bio
, int error
)
852 static inline struct bio
*pscsi_get_bio(int nr_vecs
)
856 * Use bio_malloc() following the comment in for bio -> struct request
857 * in block/blk-core.c:blk_make_request()
859 bio
= bio_kmalloc(GFP_KERNEL
, nr_vecs
);
861 pr_err("PSCSI: bio_kmalloc() failed\n");
864 bio
->bi_end_io
= pscsi_bi_endio
;
869 static sense_reason_t
870 pscsi_map_sg(struct se_cmd
*cmd
, struct scatterlist
*sgl
, u32 sgl_nents
,
871 enum dma_data_direction data_direction
, struct bio
**hbio
)
873 struct pscsi_dev_virt
*pdv
= PSCSI_DEV(cmd
->se_dev
);
874 struct bio
*bio
= NULL
, *tbio
= NULL
;
876 struct scatterlist
*sg
;
877 u32 data_len
= cmd
->data_length
, i
, len
, bytes
, off
;
878 int nr_pages
= (cmd
->data_length
+ sgl
[0].offset
+
879 PAGE_SIZE
- 1) >> PAGE_SHIFT
;
881 int rw
= (data_direction
== DMA_TO_DEVICE
);
885 pr_debug("PSCSI: nr_pages: %d\n", nr_pages
);
887 for_each_sg(sgl
, sg
, sgl_nents
, i
) {
892 pr_debug("PSCSI: i: %d page: %p len: %d off: %d\n", i
,
896 * We only have one page of data in each sg element,
897 * we can not cross a page boundary.
899 if (off
+ len
> PAGE_SIZE
)
902 if (len
> 0 && data_len
> 0) {
903 bytes
= min_t(unsigned int, len
, PAGE_SIZE
- off
);
904 bytes
= min(bytes
, data_len
);
907 nr_vecs
= min_t(int, BIO_MAX_PAGES
, nr_pages
);
910 * Calls bio_kmalloc() and sets bio->bi_end_io()
912 bio
= pscsi_get_bio(nr_vecs
);
917 bio
->bi_rw
|= REQ_WRITE
;
919 pr_debug("PSCSI: Allocated bio: %p,"
920 " dir: %s nr_vecs: %d\n", bio
,
921 (rw
) ? "rw" : "r", nr_vecs
);
923 * Set *hbio pointer to handle the case:
924 * nr_pages > BIO_MAX_PAGES, where additional
925 * bios need to be added to complete a given
931 tbio
= tbio
->bi_next
= bio
;
934 pr_debug("PSCSI: Calling bio_add_pc_page() i: %d"
935 " bio: %p page: %p len: %d off: %d\n", i
, bio
,
938 rc
= bio_add_pc_page(pdv
->pdv_sd
->request_queue
,
939 bio
, page
, bytes
, off
);
943 pr_debug("PSCSI: bio->bi_vcnt: %d nr_vecs: %d\n",
944 bio
->bi_vcnt
, nr_vecs
);
946 if (bio
->bi_vcnt
> nr_vecs
) {
947 pr_debug("PSCSI: Reached bio->bi_vcnt max:"
948 " %d i: %d bio: %p, allocating another"
949 " bio\n", bio
->bi_vcnt
, i
, bio
);
951 * Clear the pointer so that another bio will
952 * be allocated with pscsi_get_bio() above, the
953 * current bio has already been set *tbio and
967 *hbio
= (*hbio
)->bi_next
;
968 bio_endio(bio
, 0); /* XXX: should be error */
970 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
974 * Clear a lun set in the cdb if the initiator talking to use spoke
975 * and old standards version, as we can't assume the underlying device
976 * won't choke up on it.
978 static inline void pscsi_clear_cdb_lun(unsigned char *cdb
)
981 case READ_10
: /* SBC - RDProtect */
982 case READ_12
: /* SBC - RDProtect */
983 case READ_16
: /* SBC - RDProtect */
984 case SEND_DIAGNOSTIC
: /* SPC - SELF-TEST Code */
985 case VERIFY
: /* SBC - VRProtect */
986 case VERIFY_16
: /* SBC - VRProtect */
987 case WRITE_VERIFY
: /* SBC - VRProtect */
988 case WRITE_VERIFY_12
: /* SBC - VRProtect */
989 case MAINTENANCE_IN
: /* SPC - Parameter Data Format for SA RTPG */
992 cdb
[1] &= 0x1f; /* clear logical unit number */
997 static sense_reason_t
998 pscsi_parse_cdb(struct se_cmd
*cmd
)
1000 unsigned char *cdb
= cmd
->t_task_cdb
;
1002 if (cmd
->se_cmd_flags
& SCF_BIDI
)
1003 return TCM_UNSUPPORTED_SCSI_OPCODE
;
1005 pscsi_clear_cdb_lun(cdb
);
1008 * For REPORT LUNS we always need to emulate the response, for everything
1009 * else the default for pSCSI is to pass the command to the underlying
1010 * LLD / physical hardware.
1014 cmd
->execute_cmd
= spc_emulate_report_luns
;
1025 cmd
->se_cmd_flags
|= SCF_SCSI_DATA_CDB
;
1028 cmd
->execute_cmd
= pscsi_execute_cmd
;
1033 static sense_reason_t
1034 pscsi_execute_cmd(struct se_cmd
*cmd
)
1036 struct scatterlist
*sgl
= cmd
->t_data_sg
;
1037 u32 sgl_nents
= cmd
->t_data_nents
;
1038 enum dma_data_direction data_direction
= cmd
->data_direction
;
1039 struct pscsi_dev_virt
*pdv
= PSCSI_DEV(cmd
->se_dev
);
1040 struct pscsi_plugin_task
*pt
;
1041 struct request
*req
;
1046 * Dynamically alloc cdb space, since it may be larger than
1047 * TCM_MAX_COMMAND_SIZE
1049 pt
= kzalloc(sizeof(*pt
) + scsi_command_size(cmd
->t_task_cdb
), GFP_KERNEL
);
1051 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
1055 memcpy(pt
->pscsi_cdb
, cmd
->t_task_cdb
,
1056 scsi_command_size(cmd
->t_task_cdb
));
1059 req
= blk_get_request(pdv
->pdv_sd
->request_queue
,
1060 (data_direction
== DMA_TO_DEVICE
),
1063 pr_err("PSCSI: blk_get_request() failed\n");
1064 ret
= TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
1068 blk_rq_set_block_pc(req
);
1070 BUG_ON(!cmd
->data_length
);
1072 ret
= pscsi_map_sg(cmd
, sgl
, sgl_nents
, data_direction
, &hbio
);
1076 req
= blk_make_request(pdv
->pdv_sd
->request_queue
, hbio
,
1079 pr_err("pSCSI: blk_make_request() failed\n");
1080 ret
= TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
1085 req
->end_io
= pscsi_req_done
;
1086 req
->end_io_data
= cmd
;
1087 req
->cmd_len
= scsi_command_size(pt
->pscsi_cdb
);
1088 req
->cmd
= &pt
->pscsi_cdb
[0];
1089 req
->sense
= &pt
->pscsi_sense
[0];
1091 if (pdv
->pdv_sd
->type
== TYPE_DISK
)
1092 req
->timeout
= PS_TIMEOUT_DISK
;
1094 req
->timeout
= PS_TIMEOUT_OTHER
;
1095 req
->retries
= PS_RETRY
;
1097 blk_execute_rq_nowait(pdv
->pdv_sd
->request_queue
, NULL
, req
,
1098 (cmd
->sam_task_attr
== TCM_HEAD_TAG
),
1105 struct bio
*bio
= hbio
;
1106 hbio
= hbio
->bi_next
;
1107 bio_endio(bio
, 0); /* XXX: should be error */
1109 ret
= TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
1115 /* pscsi_get_device_type():
1119 static u32
pscsi_get_device_type(struct se_device
*dev
)
1121 struct pscsi_dev_virt
*pdv
= PSCSI_DEV(dev
);
1122 struct scsi_device
*sd
= pdv
->pdv_sd
;
1127 static sector_t
pscsi_get_blocks(struct se_device
*dev
)
1129 struct pscsi_dev_virt
*pdv
= PSCSI_DEV(dev
);
1131 if (pdv
->pdv_bd
&& pdv
->pdv_bd
->bd_part
)
1132 return pdv
->pdv_bd
->bd_part
->nr_sects
;
1138 static void pscsi_req_done(struct request
*req
, int uptodate
)
1140 struct se_cmd
*cmd
= req
->end_io_data
;
1141 struct pscsi_plugin_task
*pt
= cmd
->priv
;
1143 pt
->pscsi_result
= req
->errors
;
1144 pt
->pscsi_resid
= req
->resid_len
;
1146 cmd
->scsi_status
= status_byte(pt
->pscsi_result
) << 1;
1147 if (cmd
->scsi_status
) {
1148 pr_debug("PSCSI Status Byte exception at cmd: %p CDB:"
1149 " 0x%02x Result: 0x%08x\n", cmd
, pt
->pscsi_cdb
[0],
1153 switch (host_byte(pt
->pscsi_result
)) {
1155 target_complete_cmd(cmd
, cmd
->scsi_status
);
1158 pr_debug("PSCSI Host Byte exception at cmd: %p CDB:"
1159 " 0x%02x Result: 0x%08x\n", cmd
, pt
->pscsi_cdb
[0],
1161 target_complete_cmd(cmd
, SAM_STAT_CHECK_CONDITION
);
1165 __blk_put_request(req
->q
, req
);
1169 DEF_TB_DEV_ATTRIB_RO(pscsi
, hw_pi_prot_type
);
1170 TB_DEV_ATTR_RO(pscsi
, hw_pi_prot_type
);
1172 DEF_TB_DEV_ATTRIB_RO(pscsi
, hw_block_size
);
1173 TB_DEV_ATTR_RO(pscsi
, hw_block_size
);
1175 DEF_TB_DEV_ATTRIB_RO(pscsi
, hw_max_sectors
);
1176 TB_DEV_ATTR_RO(pscsi
, hw_max_sectors
);
1178 DEF_TB_DEV_ATTRIB_RO(pscsi
, hw_queue_depth
);
1179 TB_DEV_ATTR_RO(pscsi
, hw_queue_depth
);
1181 static struct configfs_attribute
*pscsi_backend_dev_attrs
[] = {
1182 &pscsi_dev_attrib_hw_pi_prot_type
.attr
,
1183 &pscsi_dev_attrib_hw_block_size
.attr
,
1184 &pscsi_dev_attrib_hw_max_sectors
.attr
,
1185 &pscsi_dev_attrib_hw_queue_depth
.attr
,
1189 static struct se_subsystem_api pscsi_template
= {
1191 .owner
= THIS_MODULE
,
1192 .transport_type
= TRANSPORT_PLUGIN_PHBA_PDEV
,
1193 .attach_hba
= pscsi_attach_hba
,
1194 .detach_hba
= pscsi_detach_hba
,
1195 .pmode_enable_hba
= pscsi_pmode_enable_hba
,
1196 .alloc_device
= pscsi_alloc_device
,
1197 .configure_device
= pscsi_configure_device
,
1198 .free_device
= pscsi_free_device
,
1199 .transport_complete
= pscsi_transport_complete
,
1200 .parse_cdb
= pscsi_parse_cdb
,
1201 .set_configfs_dev_params
= pscsi_set_configfs_dev_params
,
1202 .show_configfs_dev_params
= pscsi_show_configfs_dev_params
,
1203 .get_device_type
= pscsi_get_device_type
,
1204 .get_blocks
= pscsi_get_blocks
,
1207 static int __init
pscsi_module_init(void)
1209 struct target_backend_cits
*tbc
= &pscsi_template
.tb_cits
;
1211 target_core_setup_sub_cits(&pscsi_template
);
1212 tbc
->tb_dev_attrib_cit
.ct_attrs
= pscsi_backend_dev_attrs
;
1214 return transport_subsystem_register(&pscsi_template
);
1217 static void __exit
pscsi_module_exit(void)
1219 transport_subsystem_release(&pscsi_template
);
1222 MODULE_DESCRIPTION("TCM PSCSI subsystem plugin");
1223 MODULE_AUTHOR("nab@Linux-iSCSI.org");
1224 MODULE_LICENSE("GPL");
1226 module_init(pscsi_module_init
);
1227 module_exit(pscsi_module_exit
);