2 * Copyright (c) 2009, Microsoft Corporation.
4 * This program is free software; you can redistribute it and/or modify it
5 * under the terms and conditions of the GNU General Public License,
6 * version 2, as published by the Free Software Foundation.
8 * This program is distributed in the hope it will be useful, but WITHOUT
9 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
13 * You should have received a copy of the GNU General Public License along with
14 * this program; if not, write to the Free Software Foundation, Inc., 59 Temple
15 * Place - Suite 330, Boston, MA 02111-1307 USA.
18 * Haiyang Zhang <haiyangz@microsoft.com>
19 * Hank Janssen <hjanssen@microsoft.com>
20 * K. Y. Srinivasan <kys@microsoft.com>
23 #include <linux/kernel.h>
24 #include <linux/wait.h>
25 #include <linux/sched.h>
26 #include <linux/completion.h>
27 #include <linux/string.h>
29 #include <linux/delay.h>
30 #include <linux/init.h>
31 #include <linux/slab.h>
32 #include <linux/module.h>
33 #include <linux/device.h>
34 #include <linux/hyperv.h>
35 #include <linux/blkdev.h>
36 #include <scsi/scsi.h>
37 #include <scsi/scsi_cmnd.h>
38 #include <scsi/scsi_host.h>
39 #include <scsi/scsi_device.h>
40 #include <scsi/scsi_tcq.h>
41 #include <scsi/scsi_eh.h>
42 #include <scsi/scsi_devinfo.h>
43 #include <scsi/scsi_dbg.h>
44 #include <scsi/scsi_transport_fc.h>
45 #include <scsi/scsi_transport.h>
48 * All wire protocol details (storage protocol between the guest and the host)
49 * are consolidated here.
51 * Begin protocol definitions.
57 * V1 RC < 2008/1/31: 1.0
58 * V1 RC > 2008/1/31: 2.0
65 #define VMSTOR_PROTO_VERSION(MAJOR_, MINOR_) ((((MAJOR_) & 0xff) << 8) | \
68 #define VMSTOR_PROTO_VERSION_WIN6 VMSTOR_PROTO_VERSION(2, 0)
69 #define VMSTOR_PROTO_VERSION_WIN7 VMSTOR_PROTO_VERSION(4, 2)
70 #define VMSTOR_PROTO_VERSION_WIN8 VMSTOR_PROTO_VERSION(5, 1)
71 #define VMSTOR_PROTO_VERSION_WIN8_1 VMSTOR_PROTO_VERSION(6, 0)
72 #define VMSTOR_PROTO_VERSION_WIN10 VMSTOR_PROTO_VERSION(6, 2)
74 /* Packet structure describing virtual storage requests. */
75 enum vstor_packet_operation
{
76 VSTOR_OPERATION_COMPLETE_IO
= 1,
77 VSTOR_OPERATION_REMOVE_DEVICE
= 2,
78 VSTOR_OPERATION_EXECUTE_SRB
= 3,
79 VSTOR_OPERATION_RESET_LUN
= 4,
80 VSTOR_OPERATION_RESET_ADAPTER
= 5,
81 VSTOR_OPERATION_RESET_BUS
= 6,
82 VSTOR_OPERATION_BEGIN_INITIALIZATION
= 7,
83 VSTOR_OPERATION_END_INITIALIZATION
= 8,
84 VSTOR_OPERATION_QUERY_PROTOCOL_VERSION
= 9,
85 VSTOR_OPERATION_QUERY_PROPERTIES
= 10,
86 VSTOR_OPERATION_ENUMERATE_BUS
= 11,
87 VSTOR_OPERATION_FCHBA_DATA
= 12,
88 VSTOR_OPERATION_CREATE_SUB_CHANNELS
= 13,
89 VSTOR_OPERATION_MAXIMUM
= 13
93 * WWN packet for Fibre Channel HBA
96 struct hv_fc_wwn_packet
{
99 u8 primary_port_wwn
[8];
100 u8 primary_node_wwn
[8];
101 u8 secondary_port_wwn
[8];
102 u8 secondary_node_wwn
[8];
111 #define SRB_FLAGS_QUEUE_ACTION_ENABLE 0x00000002
112 #define SRB_FLAGS_DISABLE_DISCONNECT 0x00000004
113 #define SRB_FLAGS_DISABLE_SYNCH_TRANSFER 0x00000008
114 #define SRB_FLAGS_BYPASS_FROZEN_QUEUE 0x00000010
115 #define SRB_FLAGS_DISABLE_AUTOSENSE 0x00000020
116 #define SRB_FLAGS_DATA_IN 0x00000040
117 #define SRB_FLAGS_DATA_OUT 0x00000080
118 #define SRB_FLAGS_NO_DATA_TRANSFER 0x00000000
119 #define SRB_FLAGS_UNSPECIFIED_DIRECTION (SRB_FLAGS_DATA_IN | SRB_FLAGS_DATA_OUT)
120 #define SRB_FLAGS_NO_QUEUE_FREEZE 0x00000100
121 #define SRB_FLAGS_ADAPTER_CACHE_ENABLE 0x00000200
122 #define SRB_FLAGS_FREE_SENSE_BUFFER 0x00000400
125 * This flag indicates the request is part of the workflow for processing a D3.
127 #define SRB_FLAGS_D3_PROCESSING 0x00000800
128 #define SRB_FLAGS_IS_ACTIVE 0x00010000
129 #define SRB_FLAGS_ALLOCATED_FROM_ZONE 0x00020000
130 #define SRB_FLAGS_SGLIST_FROM_POOL 0x00040000
131 #define SRB_FLAGS_BYPASS_LOCKED_QUEUE 0x00080000
132 #define SRB_FLAGS_NO_KEEP_AWAKE 0x00100000
133 #define SRB_FLAGS_PORT_DRIVER_ALLOCSENSE 0x00200000
134 #define SRB_FLAGS_PORT_DRIVER_SENSEHASPORT 0x00400000
135 #define SRB_FLAGS_DONT_START_NEXT_PACKET 0x00800000
136 #define SRB_FLAGS_PORT_DRIVER_RESERVED 0x0F000000
137 #define SRB_FLAGS_CLASS_DRIVER_RESERVED 0xF0000000
139 #define SP_UNTAGGED ((unsigned char) ~0)
140 #define SRB_SIMPLE_TAG_REQUEST 0x20
143 * Platform neutral description of a scsi request -
144 * this remains the same across the write regardless of 32/64 bit
145 * note: it's patterned off the SCSI_PASS_THROUGH structure
147 #define STORVSC_MAX_CMD_LEN 0x10
149 #define POST_WIN7_STORVSC_SENSE_BUFFER_SIZE 0x14
150 #define PRE_WIN8_STORVSC_SENSE_BUFFER_SIZE 0x12
152 #define STORVSC_SENSE_BUFFER_SIZE 0x14
153 #define STORVSC_MAX_BUF_LEN_WITH_PADDING 0x14
156 * Sense buffer size changed in win8; have a run-time
157 * variable to track the size we should use. This value will
158 * likely change during protocol negotiation but it is valid
159 * to start by assuming pre-Win8.
161 static int sense_buffer_size
= PRE_WIN8_STORVSC_SENSE_BUFFER_SIZE
;
164 * The storage protocol version is determined during the
165 * initial exchange with the host. It will indicate which
166 * storage functionality is available in the host.
168 static int vmstor_proto_version
;
170 #define STORVSC_LOGGING_NONE 0
171 #define STORVSC_LOGGING_ERROR 1
172 #define STORVSC_LOGGING_WARN 2
174 static int logging_level
= STORVSC_LOGGING_ERROR
;
175 module_param(logging_level
, int, S_IRUGO
|S_IWUSR
);
176 MODULE_PARM_DESC(logging_level
,
177 "Logging level, 0 - None, 1 - Error (default), 2 - Warning.");
179 static inline bool do_logging(int level
)
181 return logging_level
>= level
;
184 #define storvsc_log(dev, level, fmt, ...) \
186 if (do_logging(level)) \
187 dev_warn(&(dev)->device, fmt, ##__VA_ARGS__); \
190 struct vmscsi_win8_extension
{
192 * The following were added in Windows 8
202 struct vmscsi_request
{
213 u8 sense_info_length
;
217 u32 data_transfer_length
;
220 u8 cdb
[STORVSC_MAX_CMD_LEN
];
221 u8 sense_data
[STORVSC_SENSE_BUFFER_SIZE
];
222 u8 reserved_array
[STORVSC_MAX_BUF_LEN_WITH_PADDING
];
225 * The following was added in win8.
227 struct vmscsi_win8_extension win8_extension
;
229 } __attribute((packed
));
233 * The size of the vmscsi_request has changed in win8. The
234 * additional size is because of new elements added to the
235 * structure. These elements are valid only when we are talking
237 * Track the correction to size we need to apply. This value
238 * will likely change during protocol negotiation but it is
239 * valid to start by assuming pre-Win8.
241 static int vmscsi_size_delta
= sizeof(struct vmscsi_win8_extension
);
244 * The list of storage protocols in order of preference.
246 struct vmstor_protocol
{
247 int protocol_version
;
248 int sense_buffer_size
;
249 int vmscsi_size_delta
;
253 static const struct vmstor_protocol vmstor_protocols
[] = {
255 VMSTOR_PROTO_VERSION_WIN10
,
256 POST_WIN7_STORVSC_SENSE_BUFFER_SIZE
,
260 VMSTOR_PROTO_VERSION_WIN8_1
,
261 POST_WIN7_STORVSC_SENSE_BUFFER_SIZE
,
265 VMSTOR_PROTO_VERSION_WIN8
,
266 POST_WIN7_STORVSC_SENSE_BUFFER_SIZE
,
270 VMSTOR_PROTO_VERSION_WIN7
,
271 PRE_WIN8_STORVSC_SENSE_BUFFER_SIZE
,
272 sizeof(struct vmscsi_win8_extension
),
275 VMSTOR_PROTO_VERSION_WIN6
,
276 PRE_WIN8_STORVSC_SENSE_BUFFER_SIZE
,
277 sizeof(struct vmscsi_win8_extension
),
283 * This structure is sent during the initialization phase to get the different
284 * properties of the channel.
287 #define STORAGE_CHANNEL_SUPPORTS_MULTI_CHANNEL 0x1
289 struct vmstorage_channel_properties
{
295 u32 max_transfer_bytes
;
300 /* This structure is sent during the storage protocol negotiations. */
301 struct vmstorage_protocol_version
{
302 /* Major (MSW) and minor (LSW) version numbers. */
306 * Revision number is auto-incremented whenever this file is changed
307 * (See FILL_VMSTOR_REVISION macro above). Mismatch does not
308 * definitely indicate incompatibility--but it does indicate mismatched
310 * This is only used on the windows side. Just set it to 0.
315 /* Channel Property Flags */
316 #define STORAGE_CHANNEL_REMOVABLE_FLAG 0x1
317 #define STORAGE_CHANNEL_EMULATED_IDE_FLAG 0x2
319 struct vstor_packet
{
320 /* Requested operation type */
321 enum vstor_packet_operation operation
;
323 /* Flags - see below for values */
326 /* Status of the request returned from the server side. */
329 /* Data payload area */
332 * Structure used to forward SCSI commands from the
333 * client to the server.
335 struct vmscsi_request vm_srb
;
337 /* Structure used to query channel properties. */
338 struct vmstorage_channel_properties storage_channel_properties
;
340 /* Used during version negotiations. */
341 struct vmstorage_protocol_version version
;
343 /* Fibre channel address packet */
344 struct hv_fc_wwn_packet wwn_packet
;
346 /* Number of sub-channels to create */
347 u16 sub_channel_count
;
349 /* This will be the maximum of the union members */
357 * This flag indicates that the server should send back a completion for this
361 #define REQUEST_COMPLETION_FLAG 0x1
363 /* Matches Windows-end */
364 enum storvsc_request_type
{
371 * SRB status codes and masks; a subset of the codes used here.
374 #define SRB_STATUS_AUTOSENSE_VALID 0x80
375 #define SRB_STATUS_QUEUE_FROZEN 0x40
376 #define SRB_STATUS_INVALID_LUN 0x20
377 #define SRB_STATUS_SUCCESS 0x01
378 #define SRB_STATUS_ABORTED 0x02
379 #define SRB_STATUS_ERROR 0x04
380 #define SRB_STATUS_DATA_OVERRUN 0x12
382 #define SRB_STATUS(status) \
383 (status & ~(SRB_STATUS_AUTOSENSE_VALID | SRB_STATUS_QUEUE_FROZEN))
385 * This is the end of Protocol specific defines.
388 static int storvsc_ringbuffer_size
= (256 * PAGE_SIZE
);
389 static u32 max_outstanding_req_per_channel
;
391 static int storvsc_vcpus_per_sub_channel
= 4;
393 module_param(storvsc_ringbuffer_size
, int, S_IRUGO
);
394 MODULE_PARM_DESC(storvsc_ringbuffer_size
, "Ring buffer size (bytes)");
396 module_param(storvsc_vcpus_per_sub_channel
, int, S_IRUGO
);
397 MODULE_PARM_DESC(storvsc_vcpus_per_sub_channel
, "Ratio of VCPUs to subchannels");
399 static int ring_avail_percent_lowater
= 10;
400 module_param(ring_avail_percent_lowater
, int, S_IRUGO
);
401 MODULE_PARM_DESC(ring_avail_percent_lowater
,
402 "Select a channel if available ring size > this in percent");
405 * Timeout in seconds for all devices managed by this driver.
407 static int storvsc_timeout
= 180;
409 #if IS_ENABLED(CONFIG_SCSI_FC_ATTRS)
410 static struct scsi_transport_template
*fc_transport_template
;
413 static void storvsc_on_channel_callback(void *context
);
415 #define STORVSC_MAX_LUNS_PER_TARGET 255
416 #define STORVSC_MAX_TARGETS 2
417 #define STORVSC_MAX_CHANNELS 8
419 #define STORVSC_FC_MAX_LUNS_PER_TARGET 255
420 #define STORVSC_FC_MAX_TARGETS 128
421 #define STORVSC_FC_MAX_CHANNELS 8
423 #define STORVSC_IDE_MAX_LUNS_PER_TARGET 64
424 #define STORVSC_IDE_MAX_TARGETS 1
425 #define STORVSC_IDE_MAX_CHANNELS 1
427 struct storvsc_cmd_request
{
428 struct scsi_cmnd
*cmd
;
430 struct hv_device
*device
;
432 /* Synchronize the request/response if needed */
433 struct completion wait_event
;
435 struct vmbus_channel_packet_multipage_buffer mpb
;
436 struct vmbus_packet_mpb_array
*payload
;
439 struct vstor_packet vstor_packet
;
443 /* A storvsc device is a device object that contains a vmbus channel */
444 struct storvsc_device
{
445 struct hv_device
*device
;
449 bool open_sub_channel
;
450 atomic_t num_outstanding_req
;
451 struct Scsi_Host
*host
;
453 wait_queue_head_t waiting_to_drain
;
456 * Each unique Port/Path/Target represents 1 channel ie scsi
457 * controller. In reality, the pathid, targetid is always 0
458 * and the port is set by us
460 unsigned int port_number
;
461 unsigned char path_id
;
462 unsigned char target_id
;
465 * Max I/O, the device can support.
467 u32 max_transfer_bytes
;
469 * Number of sub-channels we will open.
472 struct vmbus_channel
**stor_chns
;
474 * Mask of CPUs bound to subchannels.
476 struct cpumask alloced_cpus
;
477 /* Used for vsc/vsp channel reset process */
478 struct storvsc_cmd_request init_request
;
479 struct storvsc_cmd_request reset_request
;
481 * Currently active port and node names for FC devices.
485 #if IS_ENABLED(CONFIG_SCSI_FC_ATTRS)
486 struct fc_rport
*rport
;
490 struct hv_host_device
{
491 struct hv_device
*dev
;
494 unsigned char target
;
495 struct workqueue_struct
*handle_error_wq
;
496 struct work_struct host_scan_work
;
497 struct Scsi_Host
*host
;
500 struct storvsc_scan_work
{
501 struct work_struct work
;
502 struct Scsi_Host
*host
;
507 static void storvsc_device_scan(struct work_struct
*work
)
509 struct storvsc_scan_work
*wrk
;
510 struct scsi_device
*sdev
;
512 wrk
= container_of(work
, struct storvsc_scan_work
, work
);
514 sdev
= scsi_device_lookup(wrk
->host
, 0, wrk
->tgt_id
, wrk
->lun
);
517 scsi_rescan_device(&sdev
->sdev_gendev
);
518 scsi_device_put(sdev
);
524 static void storvsc_host_scan(struct work_struct
*work
)
526 struct Scsi_Host
*host
;
527 struct scsi_device
*sdev
;
528 struct hv_host_device
*host_device
=
529 container_of(work
, struct hv_host_device
, host_scan_work
);
531 host
= host_device
->host
;
533 * Before scanning the host, first check to see if any of the
534 * currrently known devices have been hot removed. We issue a
535 * "unit ready" command against all currently known devices.
536 * This I/O will result in an error for devices that have been
537 * removed. As part of handling the I/O error, we remove the device.
539 * When a LUN is added or removed, the host sends us a signal to
540 * scan the host. Thus we are forced to discover the LUNs that
541 * may have been removed this way.
543 mutex_lock(&host
->scan_mutex
);
544 shost_for_each_device(sdev
, host
)
545 scsi_test_unit_ready(sdev
, 1, 1, NULL
);
546 mutex_unlock(&host
->scan_mutex
);
548 * Now scan the host to discover LUNs that may have been added.
550 scsi_scan_host(host
);
553 static void storvsc_remove_lun(struct work_struct
*work
)
555 struct storvsc_scan_work
*wrk
;
556 struct scsi_device
*sdev
;
558 wrk
= container_of(work
, struct storvsc_scan_work
, work
);
559 if (!scsi_host_get(wrk
->host
))
562 sdev
= scsi_device_lookup(wrk
->host
, 0, wrk
->tgt_id
, wrk
->lun
);
565 scsi_remove_device(sdev
);
566 scsi_device_put(sdev
);
568 scsi_host_put(wrk
->host
);
576 * We can get incoming messages from the host that are not in response to
577 * messages that we have sent out. An example of this would be messages
578 * received by the guest to notify dynamic addition/removal of LUNs. To
579 * deal with potential race conditions where the driver may be in the
580 * midst of being unloaded when we might receive an unsolicited message
581 * from the host, we have implemented a mechanism to gurantee sequential
584 * 1) Once the device is marked as being destroyed, we will fail all
586 * 2) We permit incoming messages when the device is being destroyed,
587 * only to properly account for messages already sent out.
590 static inline struct storvsc_device
*get_out_stor_device(
591 struct hv_device
*device
)
593 struct storvsc_device
*stor_device
;
595 stor_device
= hv_get_drvdata(device
);
597 if (stor_device
&& stor_device
->destroy
)
604 static inline void storvsc_wait_to_drain(struct storvsc_device
*dev
)
606 dev
->drain_notify
= true;
607 wait_event(dev
->waiting_to_drain
,
608 atomic_read(&dev
->num_outstanding_req
) == 0);
609 dev
->drain_notify
= false;
612 static inline struct storvsc_device
*get_in_stor_device(
613 struct hv_device
*device
)
615 struct storvsc_device
*stor_device
;
617 stor_device
= hv_get_drvdata(device
);
623 * If the device is being destroyed; allow incoming
624 * traffic only to cleanup outstanding requests.
627 if (stor_device
->destroy
&&
628 (atomic_read(&stor_device
->num_outstanding_req
) == 0))
636 static void handle_sc_creation(struct vmbus_channel
*new_sc
)
638 struct hv_device
*device
= new_sc
->primary_channel
->device_obj
;
639 struct storvsc_device
*stor_device
;
640 struct vmstorage_channel_properties props
;
642 stor_device
= get_out_stor_device(device
);
646 if (stor_device
->open_sub_channel
== false)
649 memset(&props
, 0, sizeof(struct vmstorage_channel_properties
));
652 storvsc_ringbuffer_size
,
653 storvsc_ringbuffer_size
,
655 sizeof(struct vmstorage_channel_properties
),
656 storvsc_on_channel_callback
, new_sc
);
658 if (new_sc
->state
== CHANNEL_OPENED_STATE
) {
659 stor_device
->stor_chns
[new_sc
->target_cpu
] = new_sc
;
660 cpumask_set_cpu(new_sc
->target_cpu
, &stor_device
->alloced_cpus
);
664 static void handle_multichannel_storage(struct hv_device
*device
, int max_chns
)
666 struct storvsc_device
*stor_device
;
668 struct storvsc_cmd_request
*request
;
669 struct vstor_packet
*vstor_packet
;
673 * If the number of CPUs is artificially restricted, such as
674 * with maxcpus=1 on the kernel boot line, Hyper-V could offer
675 * sub-channels >= the number of CPUs. These sub-channels
676 * should not be created. The primary channel is already created
677 * and assigned to one CPU, so check against # CPUs - 1.
679 num_sc
= min((int)(num_online_cpus() - 1), max_chns
);
683 stor_device
= get_out_stor_device(device
);
687 stor_device
->num_sc
= num_sc
;
688 request
= &stor_device
->init_request
;
689 vstor_packet
= &request
->vstor_packet
;
691 stor_device
->open_sub_channel
= true;
693 * Establish a handler for dealing with subchannels.
695 vmbus_set_sc_create_callback(device
->channel
, handle_sc_creation
);
698 * Check to see if sub-channels have already been created. This
699 * can happen when this driver is re-loaded after unloading.
702 if (vmbus_are_subchannels_present(device
->channel
))
705 stor_device
->open_sub_channel
= false;
707 * Request the host to create sub-channels.
709 memset(request
, 0, sizeof(struct storvsc_cmd_request
));
710 init_completion(&request
->wait_event
);
711 vstor_packet
->operation
= VSTOR_OPERATION_CREATE_SUB_CHANNELS
;
712 vstor_packet
->flags
= REQUEST_COMPLETION_FLAG
;
713 vstor_packet
->sub_channel_count
= num_sc
;
715 ret
= vmbus_sendpacket(device
->channel
, vstor_packet
,
716 (sizeof(struct vstor_packet
) -
718 (unsigned long)request
,
720 VMBUS_DATA_PACKET_FLAG_COMPLETION_REQUESTED
);
725 t
= wait_for_completion_timeout(&request
->wait_event
, 10*HZ
);
729 if (vstor_packet
->operation
!= VSTOR_OPERATION_COMPLETE_IO
||
730 vstor_packet
->status
!= 0)
734 * Now that we created the sub-channels, invoke the check; this
735 * may trigger the callback.
737 stor_device
->open_sub_channel
= true;
738 vmbus_are_subchannels_present(device
->channel
);
741 static void cache_wwn(struct storvsc_device
*stor_device
,
742 struct vstor_packet
*vstor_packet
)
745 * Cache the currently active port and node ww names.
747 if (vstor_packet
->wwn_packet
.primary_active
) {
748 stor_device
->node_name
=
749 wwn_to_u64(vstor_packet
->wwn_packet
.primary_node_wwn
);
750 stor_device
->port_name
=
751 wwn_to_u64(vstor_packet
->wwn_packet
.primary_port_wwn
);
753 stor_device
->node_name
=
754 wwn_to_u64(vstor_packet
->wwn_packet
.secondary_node_wwn
);
755 stor_device
->port_name
=
756 wwn_to_u64(vstor_packet
->wwn_packet
.secondary_port_wwn
);
761 static int storvsc_execute_vstor_op(struct hv_device
*device
,
762 struct storvsc_cmd_request
*request
,
765 struct vstor_packet
*vstor_packet
;
768 vstor_packet
= &request
->vstor_packet
;
770 init_completion(&request
->wait_event
);
771 vstor_packet
->flags
= REQUEST_COMPLETION_FLAG
;
773 ret
= vmbus_sendpacket(device
->channel
, vstor_packet
,
774 (sizeof(struct vstor_packet
) -
776 (unsigned long)request
,
778 VMBUS_DATA_PACKET_FLAG_COMPLETION_REQUESTED
);
782 t
= wait_for_completion_timeout(&request
->wait_event
, 5*HZ
);
789 if (vstor_packet
->operation
!= VSTOR_OPERATION_COMPLETE_IO
||
790 vstor_packet
->status
!= 0)
796 static int storvsc_channel_init(struct hv_device
*device
, bool is_fc
)
798 struct storvsc_device
*stor_device
;
799 struct storvsc_cmd_request
*request
;
800 struct vstor_packet
*vstor_packet
;
803 bool process_sub_channels
= false;
805 stor_device
= get_out_stor_device(device
);
809 request
= &stor_device
->init_request
;
810 vstor_packet
= &request
->vstor_packet
;
813 * Now, initiate the vsc/vsp initialization protocol on the open
816 memset(request
, 0, sizeof(struct storvsc_cmd_request
));
817 vstor_packet
->operation
= VSTOR_OPERATION_BEGIN_INITIALIZATION
;
818 ret
= storvsc_execute_vstor_op(device
, request
, true);
822 * Query host supported protocol version.
825 for (i
= 0; i
< ARRAY_SIZE(vmstor_protocols
); i
++) {
826 /* reuse the packet for version range supported */
827 memset(vstor_packet
, 0, sizeof(struct vstor_packet
));
828 vstor_packet
->operation
=
829 VSTOR_OPERATION_QUERY_PROTOCOL_VERSION
;
831 vstor_packet
->version
.major_minor
=
832 vmstor_protocols
[i
].protocol_version
;
835 * The revision number is only used in Windows; set it to 0.
837 vstor_packet
->version
.revision
= 0;
838 ret
= storvsc_execute_vstor_op(device
, request
, false);
842 if (vstor_packet
->operation
!= VSTOR_OPERATION_COMPLETE_IO
)
845 if (vstor_packet
->status
== 0) {
846 vmstor_proto_version
=
847 vmstor_protocols
[i
].protocol_version
;
850 vmstor_protocols
[i
].sense_buffer_size
;
853 vmstor_protocols
[i
].vmscsi_size_delta
;
859 if (vstor_packet
->status
!= 0)
863 memset(vstor_packet
, 0, sizeof(struct vstor_packet
));
864 vstor_packet
->operation
= VSTOR_OPERATION_QUERY_PROPERTIES
;
865 ret
= storvsc_execute_vstor_op(device
, request
, true);
870 * Check to see if multi-channel support is there.
871 * Hosts that implement protocol version of 5.1 and above
872 * support multi-channel.
874 max_chns
= vstor_packet
->storage_channel_properties
.max_channel_cnt
;
877 * Allocate state to manage the sub-channels.
878 * We allocate an array based on the numbers of possible CPUs
879 * (Hyper-V does not support cpu online/offline).
880 * This Array will be sparseley populated with unique
881 * channels - primary + sub-channels.
882 * We will however populate all the slots to evenly distribute
885 stor_device
->stor_chns
= kcalloc(num_possible_cpus(), sizeof(void *),
887 if (stor_device
->stor_chns
== NULL
)
890 stor_device
->stor_chns
[device
->channel
->target_cpu
] = device
->channel
;
891 cpumask_set_cpu(device
->channel
->target_cpu
,
892 &stor_device
->alloced_cpus
);
894 if (vmstor_proto_version
>= VMSTOR_PROTO_VERSION_WIN8
) {
895 if (vstor_packet
->storage_channel_properties
.flags
&
896 STORAGE_CHANNEL_SUPPORTS_MULTI_CHANNEL
)
897 process_sub_channels
= true;
899 stor_device
->max_transfer_bytes
=
900 vstor_packet
->storage_channel_properties
.max_transfer_bytes
;
906 * For FC devices retrieve FC HBA data.
908 memset(vstor_packet
, 0, sizeof(struct vstor_packet
));
909 vstor_packet
->operation
= VSTOR_OPERATION_FCHBA_DATA
;
910 ret
= storvsc_execute_vstor_op(device
, request
, true);
915 * Cache the currently active port and node ww names.
917 cache_wwn(stor_device
, vstor_packet
);
921 memset(vstor_packet
, 0, sizeof(struct vstor_packet
));
922 vstor_packet
->operation
= VSTOR_OPERATION_END_INITIALIZATION
;
923 ret
= storvsc_execute_vstor_op(device
, request
, true);
927 if (process_sub_channels
)
928 handle_multichannel_storage(device
, max_chns
);
933 static void storvsc_handle_error(struct vmscsi_request
*vm_srb
,
934 struct scsi_cmnd
*scmnd
,
935 struct Scsi_Host
*host
,
938 struct storvsc_scan_work
*wrk
;
939 void (*process_err_fn
)(struct work_struct
*work
);
940 struct hv_host_device
*host_dev
= shost_priv(host
);
941 bool do_work
= false;
943 switch (SRB_STATUS(vm_srb
->srb_status
)) {
944 case SRB_STATUS_ERROR
:
946 * Let upper layer deal with error when
947 * sense message is present.
950 if (vm_srb
->srb_status
& SRB_STATUS_AUTOSENSE_VALID
)
953 * If there is an error; offline the device since all
954 * error recovery strategies would have already been
955 * deployed on the host side. However, if the command
956 * were a pass-through command deal with it appropriately.
958 switch (scmnd
->cmnd
[0]) {
961 set_host_byte(scmnd
, DID_PASSTHROUGH
);
964 * On Some Windows hosts TEST_UNIT_READY command can return
965 * SRB_STATUS_ERROR, let the upper level code deal with it
966 * based on the sense information.
968 case TEST_UNIT_READY
:
971 set_host_byte(scmnd
, DID_ERROR
);
974 case SRB_STATUS_INVALID_LUN
:
975 set_host_byte(scmnd
, DID_NO_CONNECT
);
977 process_err_fn
= storvsc_remove_lun
;
979 case SRB_STATUS_ABORTED
:
980 if (vm_srb
->srb_status
& SRB_STATUS_AUTOSENSE_VALID
&&
981 (asc
== 0x2a) && (ascq
== 0x9)) {
983 process_err_fn
= storvsc_device_scan
;
985 * Retry the I/O that trigerred this.
987 set_host_byte(scmnd
, DID_REQUEUE
);
996 * We need to schedule work to process this error; schedule it.
998 wrk
= kmalloc(sizeof(struct storvsc_scan_work
), GFP_ATOMIC
);
1000 set_host_byte(scmnd
, DID_TARGET_FAILURE
);
1005 wrk
->lun
= vm_srb
->lun
;
1006 wrk
->tgt_id
= vm_srb
->target_id
;
1007 INIT_WORK(&wrk
->work
, process_err_fn
);
1008 queue_work(host_dev
->handle_error_wq
, &wrk
->work
);
1012 static void storvsc_command_completion(struct storvsc_cmd_request
*cmd_request
,
1013 struct storvsc_device
*stor_dev
)
1015 struct scsi_cmnd
*scmnd
= cmd_request
->cmd
;
1016 struct scsi_sense_hdr sense_hdr
;
1017 struct vmscsi_request
*vm_srb
;
1018 u32 data_transfer_length
;
1019 struct Scsi_Host
*host
;
1020 u32 payload_sz
= cmd_request
->payload_sz
;
1021 void *payload
= cmd_request
->payload
;
1023 host
= stor_dev
->host
;
1025 vm_srb
= &cmd_request
->vstor_packet
.vm_srb
;
1026 data_transfer_length
= vm_srb
->data_transfer_length
;
1028 scmnd
->result
= vm_srb
->scsi_status
;
1030 if (scmnd
->result
) {
1031 if (scsi_normalize_sense(scmnd
->sense_buffer
,
1032 SCSI_SENSE_BUFFERSIZE
, &sense_hdr
) &&
1033 !(sense_hdr
.sense_key
== NOT_READY
&&
1034 sense_hdr
.asc
== 0x03A) &&
1035 do_logging(STORVSC_LOGGING_ERROR
))
1036 scsi_print_sense_hdr(scmnd
->device
, "storvsc",
1040 if (vm_srb
->srb_status
!= SRB_STATUS_SUCCESS
) {
1041 storvsc_handle_error(vm_srb
, scmnd
, host
, sense_hdr
.asc
,
1044 * The Windows driver set data_transfer_length on
1045 * SRB_STATUS_DATA_OVERRUN. On other errors, this value
1046 * is untouched. In these cases we set it to 0.
1048 if (vm_srb
->srb_status
!= SRB_STATUS_DATA_OVERRUN
)
1049 data_transfer_length
= 0;
1052 scsi_set_resid(scmnd
,
1053 cmd_request
->payload
->range
.len
- data_transfer_length
);
1055 scmnd
->scsi_done(scmnd
);
1058 sizeof(struct vmbus_channel_packet_multipage_buffer
))
1062 static void storvsc_on_io_completion(struct storvsc_device
*stor_device
,
1063 struct vstor_packet
*vstor_packet
,
1064 struct storvsc_cmd_request
*request
)
1066 struct vstor_packet
*stor_pkt
;
1067 struct hv_device
*device
= stor_device
->device
;
1069 stor_pkt
= &request
->vstor_packet
;
1072 * The current SCSI handling on the host side does
1073 * not correctly handle:
1074 * INQUIRY command with page code parameter set to 0x80
1075 * MODE_SENSE command with cmd[2] == 0x1c
1077 * Setup srb and scsi status so this won't be fatal.
1078 * We do this so we can distinguish truly fatal failues
1079 * (srb status == 0x4) and off-line the device in that case.
1082 if ((stor_pkt
->vm_srb
.cdb
[0] == INQUIRY
) ||
1083 (stor_pkt
->vm_srb
.cdb
[0] == MODE_SENSE
)) {
1084 vstor_packet
->vm_srb
.scsi_status
= 0;
1085 vstor_packet
->vm_srb
.srb_status
= SRB_STATUS_SUCCESS
;
1089 /* Copy over the status...etc */
1090 stor_pkt
->vm_srb
.scsi_status
= vstor_packet
->vm_srb
.scsi_status
;
1091 stor_pkt
->vm_srb
.srb_status
= vstor_packet
->vm_srb
.srb_status
;
1092 stor_pkt
->vm_srb
.sense_info_length
=
1093 vstor_packet
->vm_srb
.sense_info_length
;
1095 if (vstor_packet
->vm_srb
.scsi_status
!= 0 ||
1096 vstor_packet
->vm_srb
.srb_status
!= SRB_STATUS_SUCCESS
)
1097 storvsc_log(device
, STORVSC_LOGGING_WARN
,
1098 "cmd 0x%x scsi status 0x%x srb status 0x%x\n",
1099 stor_pkt
->vm_srb
.cdb
[0],
1100 vstor_packet
->vm_srb
.scsi_status
,
1101 vstor_packet
->vm_srb
.srb_status
);
1103 if ((vstor_packet
->vm_srb
.scsi_status
& 0xFF) == 0x02) {
1104 /* CHECK_CONDITION */
1105 if (vstor_packet
->vm_srb
.srb_status
&
1106 SRB_STATUS_AUTOSENSE_VALID
) {
1107 /* autosense data available */
1109 storvsc_log(device
, STORVSC_LOGGING_WARN
,
1110 "stor pkt %p autosense data valid - len %d\n",
1111 request
, vstor_packet
->vm_srb
.sense_info_length
);
1113 memcpy(request
->cmd
->sense_buffer
,
1114 vstor_packet
->vm_srb
.sense_data
,
1115 vstor_packet
->vm_srb
.sense_info_length
);
1120 stor_pkt
->vm_srb
.data_transfer_length
=
1121 vstor_packet
->vm_srb
.data_transfer_length
;
1123 storvsc_command_completion(request
, stor_device
);
1125 if (atomic_dec_and_test(&stor_device
->num_outstanding_req
) &&
1126 stor_device
->drain_notify
)
1127 wake_up(&stor_device
->waiting_to_drain
);
1132 static void storvsc_on_receive(struct storvsc_device
*stor_device
,
1133 struct vstor_packet
*vstor_packet
,
1134 struct storvsc_cmd_request
*request
)
1136 struct hv_host_device
*host_dev
;
1137 switch (vstor_packet
->operation
) {
1138 case VSTOR_OPERATION_COMPLETE_IO
:
1139 storvsc_on_io_completion(stor_device
, vstor_packet
, request
);
1142 case VSTOR_OPERATION_REMOVE_DEVICE
:
1143 case VSTOR_OPERATION_ENUMERATE_BUS
:
1144 host_dev
= shost_priv(stor_device
->host
);
1146 host_dev
->handle_error_wq
, &host_dev
->host_scan_work
);
1149 case VSTOR_OPERATION_FCHBA_DATA
:
1150 cache_wwn(stor_device
, vstor_packet
);
1151 #if IS_ENABLED(CONFIG_SCSI_FC_ATTRS)
1152 fc_host_node_name(stor_device
->host
) = stor_device
->node_name
;
1153 fc_host_port_name(stor_device
->host
) = stor_device
->port_name
;
1161 static void storvsc_on_channel_callback(void *context
)
1163 struct vmbus_channel
*channel
= (struct vmbus_channel
*)context
;
1164 const struct vmpacket_descriptor
*desc
;
1165 struct hv_device
*device
;
1166 struct storvsc_device
*stor_device
;
1168 if (channel
->primary_channel
!= NULL
)
1169 device
= channel
->primary_channel
->device_obj
;
1171 device
= channel
->device_obj
;
1173 stor_device
= get_in_stor_device(device
);
1177 foreach_vmbus_pkt(desc
, channel
) {
1178 void *packet
= hv_pkt_data(desc
);
1179 struct storvsc_cmd_request
*request
;
1181 request
= (struct storvsc_cmd_request
*)
1182 ((unsigned long)desc
->trans_id
);
1184 if (request
== &stor_device
->init_request
||
1185 request
== &stor_device
->reset_request
) {
1186 memcpy(&request
->vstor_packet
, packet
,
1187 (sizeof(struct vstor_packet
) - vmscsi_size_delta
));
1188 complete(&request
->wait_event
);
1190 storvsc_on_receive(stor_device
, packet
, request
);
1195 static int storvsc_connect_to_vsp(struct hv_device
*device
, u32 ring_size
,
1198 struct vmstorage_channel_properties props
;
1201 memset(&props
, 0, sizeof(struct vmstorage_channel_properties
));
1203 ret
= vmbus_open(device
->channel
,
1207 sizeof(struct vmstorage_channel_properties
),
1208 storvsc_on_channel_callback
, device
->channel
);
1213 ret
= storvsc_channel_init(device
, is_fc
);
1218 static int storvsc_dev_remove(struct hv_device
*device
)
1220 struct storvsc_device
*stor_device
;
1222 stor_device
= hv_get_drvdata(device
);
1224 stor_device
->destroy
= true;
1226 /* Make sure flag is set before waiting */
1230 * At this point, all outbound traffic should be disable. We
1231 * only allow inbound traffic (responses) to proceed so that
1232 * outstanding requests can be completed.
1235 storvsc_wait_to_drain(stor_device
);
1238 * Since we have already drained, we don't need to busy wait
1239 * as was done in final_release_stor_device()
1240 * Note that we cannot set the ext pointer to NULL until
1241 * we have drained - to drain the outgoing packets, we need to
1242 * allow incoming packets.
1244 hv_set_drvdata(device
, NULL
);
1246 /* Close the channel */
1247 vmbus_close(device
->channel
);
1249 kfree(stor_device
->stor_chns
);
1254 static struct vmbus_channel
*get_og_chn(struct storvsc_device
*stor_device
,
1259 const struct cpumask
*node_mask
;
1260 int num_channels
, tgt_cpu
;
1262 if (stor_device
->num_sc
== 0)
1263 return stor_device
->device
->channel
;
1266 * Our channel array is sparsley populated and we
1267 * initiated I/O on a processor/hw-q that does not
1268 * currently have a designated channel. Fix this.
1269 * The strategy is simple:
1270 * I. Ensure NUMA locality
1271 * II. Distribute evenly (best effort)
1272 * III. Mapping is persistent.
1275 node_mask
= cpumask_of_node(cpu_to_node(q_num
));
1278 for_each_cpu(tgt_cpu
, &stor_device
->alloced_cpus
) {
1279 if (cpumask_test_cpu(tgt_cpu
, node_mask
))
1282 if (num_channels
== 0)
1283 return stor_device
->device
->channel
;
1286 while (hash_qnum
>= num_channels
)
1287 hash_qnum
-= num_channels
;
1289 for_each_cpu(tgt_cpu
, &stor_device
->alloced_cpus
) {
1290 if (!cpumask_test_cpu(tgt_cpu
, node_mask
))
1292 if (slot
== hash_qnum
)
1297 stor_device
->stor_chns
[q_num
] = stor_device
->stor_chns
[tgt_cpu
];
1299 return stor_device
->stor_chns
[q_num
];
1303 static int storvsc_do_io(struct hv_device
*device
,
1304 struct storvsc_cmd_request
*request
, u16 q_num
)
1306 struct storvsc_device
*stor_device
;
1307 struct vstor_packet
*vstor_packet
;
1308 struct vmbus_channel
*outgoing_channel
, *channel
;
1310 const struct cpumask
*node_mask
;
1313 vstor_packet
= &request
->vstor_packet
;
1314 stor_device
= get_out_stor_device(device
);
1320 request
->device
= device
;
1322 * Select an an appropriate channel to send the request out.
1324 if (stor_device
->stor_chns
[q_num
] != NULL
) {
1325 outgoing_channel
= stor_device
->stor_chns
[q_num
];
1326 if (outgoing_channel
->target_cpu
== q_num
) {
1328 * Ideally, we want to pick a different channel if
1329 * available on the same NUMA node.
1331 node_mask
= cpumask_of_node(cpu_to_node(q_num
));
1332 for_each_cpu_wrap(tgt_cpu
,
1333 &stor_device
->alloced_cpus
, q_num
+ 1) {
1334 if (!cpumask_test_cpu(tgt_cpu
, node_mask
))
1336 if (tgt_cpu
== q_num
)
1338 channel
= stor_device
->stor_chns
[tgt_cpu
];
1339 if (hv_get_avail_to_write_percent(
1341 > ring_avail_percent_lowater
) {
1342 outgoing_channel
= channel
;
1348 * All the other channels on the same NUMA node are
1349 * busy. Try to use the channel on the current CPU
1351 if (hv_get_avail_to_write_percent(
1352 &outgoing_channel
->outbound
)
1353 > ring_avail_percent_lowater
)
1357 * If we reach here, all the channels on the current
1358 * NUMA node are busy. Try to find a channel in
1361 for_each_cpu(tgt_cpu
, &stor_device
->alloced_cpus
) {
1362 if (cpumask_test_cpu(tgt_cpu
, node_mask
))
1364 channel
= stor_device
->stor_chns
[tgt_cpu
];
1365 if (hv_get_avail_to_write_percent(
1367 > ring_avail_percent_lowater
) {
1368 outgoing_channel
= channel
;
1374 outgoing_channel
= get_og_chn(stor_device
, q_num
);
1378 vstor_packet
->flags
|= REQUEST_COMPLETION_FLAG
;
1380 vstor_packet
->vm_srb
.length
= (sizeof(struct vmscsi_request
) -
1384 vstor_packet
->vm_srb
.sense_info_length
= sense_buffer_size
;
1387 vstor_packet
->vm_srb
.data_transfer_length
=
1388 request
->payload
->range
.len
;
1390 vstor_packet
->operation
= VSTOR_OPERATION_EXECUTE_SRB
;
1392 if (request
->payload
->range
.len
) {
1394 ret
= vmbus_sendpacket_mpb_desc(outgoing_channel
,
1395 request
->payload
, request
->payload_sz
,
1397 (sizeof(struct vstor_packet
) -
1399 (unsigned long)request
);
1401 ret
= vmbus_sendpacket(outgoing_channel
, vstor_packet
,
1402 (sizeof(struct vstor_packet
) -
1404 (unsigned long)request
,
1406 VMBUS_DATA_PACKET_FLAG_COMPLETION_REQUESTED
);
1412 atomic_inc(&stor_device
->num_outstanding_req
);
1417 static int storvsc_device_alloc(struct scsi_device
*sdevice
)
1420 * Set blist flag to permit the reading of the VPD pages even when
1421 * the target may claim SPC-2 compliance. MSFT targets currently
1422 * claim SPC-2 compliance while they implement post SPC-2 features.
1423 * With this flag we can correctly handle WRITE_SAME_16 issues.
1425 * Hypervisor reports SCSI_UNKNOWN type for DVD ROM device but
1426 * still supports REPORT LUN.
1428 sdevice
->sdev_bflags
= BLIST_REPORTLUN2
| BLIST_TRY_VPD_PAGES
;
1433 static int storvsc_device_configure(struct scsi_device
*sdevice
)
1435 blk_queue_rq_timeout(sdevice
->request_queue
, (storvsc_timeout
* HZ
));
1437 /* Ensure there are no gaps in presented sgls */
1438 blk_queue_virt_boundary(sdevice
->request_queue
, PAGE_SIZE
- 1);
1440 sdevice
->no_write_same
= 1;
1443 * If the host is WIN8 or WIN8 R2, claim conformance to SPC-3
1444 * if the device is a MSFT virtual device. If the host is
1445 * WIN10 or newer, allow write_same.
1447 if (!strncmp(sdevice
->vendor
, "Msft", 4)) {
1448 switch (vmstor_proto_version
) {
1449 case VMSTOR_PROTO_VERSION_WIN8
:
1450 case VMSTOR_PROTO_VERSION_WIN8_1
:
1451 sdevice
->scsi_level
= SCSI_SPC_3
;
1455 if (vmstor_proto_version
>= VMSTOR_PROTO_VERSION_WIN10
)
1456 sdevice
->no_write_same
= 0;
1462 static int storvsc_get_chs(struct scsi_device
*sdev
, struct block_device
* bdev
,
1463 sector_t capacity
, int *info
)
1465 sector_t nsect
= capacity
;
1466 sector_t cylinders
= nsect
;
1467 int heads
, sectors_pt
;
1470 * We are making up these values; let us keep it simple.
1473 sectors_pt
= 0x3f; /* Sectors per track */
1474 sector_div(cylinders
, heads
* sectors_pt
);
1475 if ((sector_t
)(cylinders
+ 1) * heads
* sectors_pt
< nsect
)
1479 info
[1] = sectors_pt
;
1480 info
[2] = (int)cylinders
;
1485 static int storvsc_host_reset_handler(struct scsi_cmnd
*scmnd
)
1487 struct hv_host_device
*host_dev
= shost_priv(scmnd
->device
->host
);
1488 struct hv_device
*device
= host_dev
->dev
;
1490 struct storvsc_device
*stor_device
;
1491 struct storvsc_cmd_request
*request
;
1492 struct vstor_packet
*vstor_packet
;
1496 stor_device
= get_out_stor_device(device
);
1500 request
= &stor_device
->reset_request
;
1501 vstor_packet
= &request
->vstor_packet
;
1503 init_completion(&request
->wait_event
);
1505 vstor_packet
->operation
= VSTOR_OPERATION_RESET_BUS
;
1506 vstor_packet
->flags
= REQUEST_COMPLETION_FLAG
;
1507 vstor_packet
->vm_srb
.path_id
= stor_device
->path_id
;
1509 ret
= vmbus_sendpacket(device
->channel
, vstor_packet
,
1510 (sizeof(struct vstor_packet
) -
1512 (unsigned long)&stor_device
->reset_request
,
1514 VMBUS_DATA_PACKET_FLAG_COMPLETION_REQUESTED
);
1518 t
= wait_for_completion_timeout(&request
->wait_event
, 5*HZ
);
1520 return TIMEOUT_ERROR
;
1524 * At this point, all outstanding requests in the adapter
1525 * should have been flushed out and return to us
1526 * There is a potential race here where the host may be in
1527 * the process of responding when we return from here.
1528 * Just wait for all in-transit packets to be accounted for
1529 * before we return from here.
1531 storvsc_wait_to_drain(stor_device
);
1537 * The host guarantees to respond to each command, although I/O latencies might
1538 * be unbounded on Azure. Reset the timer unconditionally to give the host a
1539 * chance to perform EH.
1541 static enum blk_eh_timer_return
storvsc_eh_timed_out(struct scsi_cmnd
*scmnd
)
1543 #if IS_ENABLED(CONFIG_SCSI_FC_ATTRS)
1544 if (scmnd
->device
->host
->transportt
== fc_transport_template
)
1545 return fc_eh_timed_out(scmnd
);
1547 return BLK_EH_RESET_TIMER
;
1550 static bool storvsc_scsi_cmd_ok(struct scsi_cmnd
*scmnd
)
1552 bool allowed
= true;
1553 u8 scsi_op
= scmnd
->cmnd
[0];
1556 /* the host does not handle WRITE_SAME, log accident usage */
1559 * smartd sends this command and the host does not handle
1560 * this. So, don't send it.
1563 scmnd
->result
= ILLEGAL_REQUEST
<< 16;
1572 static int storvsc_queuecommand(struct Scsi_Host
*host
, struct scsi_cmnd
*scmnd
)
1575 struct hv_host_device
*host_dev
= shost_priv(host
);
1576 struct hv_device
*dev
= host_dev
->dev
;
1577 struct storvsc_cmd_request
*cmd_request
= scsi_cmd_priv(scmnd
);
1579 struct scatterlist
*sgl
;
1580 unsigned int sg_count
= 0;
1581 struct vmscsi_request
*vm_srb
;
1582 struct scatterlist
*cur_sgl
;
1583 struct vmbus_packet_mpb_array
*payload
;
1587 if (vmstor_proto_version
<= VMSTOR_PROTO_VERSION_WIN8
) {
1589 * On legacy hosts filter unimplemented commands.
1590 * Future hosts are expected to correctly handle
1591 * unsupported commands. Furthermore, it is
1592 * possible that some of the currently
1593 * unsupported commands maybe supported in
1594 * future versions of the host.
1596 if (!storvsc_scsi_cmd_ok(scmnd
)) {
1597 scmnd
->scsi_done(scmnd
);
1602 /* Setup the cmd request */
1603 cmd_request
->cmd
= scmnd
;
1605 vm_srb
= &cmd_request
->vstor_packet
.vm_srb
;
1606 vm_srb
->win8_extension
.time_out_value
= 60;
1608 vm_srb
->win8_extension
.srb_flags
|=
1609 SRB_FLAGS_DISABLE_SYNCH_TRANSFER
;
1611 if (scmnd
->device
->tagged_supported
) {
1612 vm_srb
->win8_extension
.srb_flags
|=
1613 (SRB_FLAGS_QUEUE_ACTION_ENABLE
| SRB_FLAGS_NO_QUEUE_FREEZE
);
1614 vm_srb
->win8_extension
.queue_tag
= SP_UNTAGGED
;
1615 vm_srb
->win8_extension
.queue_action
= SRB_SIMPLE_TAG_REQUEST
;
1619 switch (scmnd
->sc_data_direction
) {
1621 vm_srb
->data_in
= WRITE_TYPE
;
1622 vm_srb
->win8_extension
.srb_flags
|= SRB_FLAGS_DATA_OUT
;
1624 case DMA_FROM_DEVICE
:
1625 vm_srb
->data_in
= READ_TYPE
;
1626 vm_srb
->win8_extension
.srb_flags
|= SRB_FLAGS_DATA_IN
;
1629 vm_srb
->data_in
= UNKNOWN_TYPE
;
1630 vm_srb
->win8_extension
.srb_flags
|= SRB_FLAGS_NO_DATA_TRANSFER
;
1634 * This is DMA_BIDIRECTIONAL or something else we are never
1635 * supposed to see here.
1637 WARN(1, "Unexpected data direction: %d\n",
1638 scmnd
->sc_data_direction
);
1643 vm_srb
->port_number
= host_dev
->port
;
1644 vm_srb
->path_id
= scmnd
->device
->channel
;
1645 vm_srb
->target_id
= scmnd
->device
->id
;
1646 vm_srb
->lun
= scmnd
->device
->lun
;
1648 vm_srb
->cdb_length
= scmnd
->cmd_len
;
1650 memcpy(vm_srb
->cdb
, scmnd
->cmnd
, vm_srb
->cdb_length
);
1652 sgl
= (struct scatterlist
*)scsi_sglist(scmnd
);
1653 sg_count
= scsi_sg_count(scmnd
);
1655 length
= scsi_bufflen(scmnd
);
1656 payload
= (struct vmbus_packet_mpb_array
*)&cmd_request
->mpb
;
1657 payload_sz
= sizeof(cmd_request
->mpb
);
1660 if (sg_count
> MAX_PAGE_BUFFER_COUNT
) {
1662 payload_sz
= (sg_count
* sizeof(u64
) +
1663 sizeof(struct vmbus_packet_mpb_array
));
1664 payload
= kzalloc(payload_sz
, GFP_ATOMIC
);
1666 return SCSI_MLQUEUE_DEVICE_BUSY
;
1669 payload
->range
.len
= length
;
1670 payload
->range
.offset
= sgl
[0].offset
;
1673 for (i
= 0; i
< sg_count
; i
++) {
1674 payload
->range
.pfn_array
[i
] =
1675 page_to_pfn(sg_page((cur_sgl
)));
1676 cur_sgl
= sg_next(cur_sgl
);
1680 cmd_request
->payload
= payload
;
1681 cmd_request
->payload_sz
= payload_sz
;
1683 /* Invokes the vsc to start an IO */
1684 ret
= storvsc_do_io(dev
, cmd_request
, get_cpu());
1687 if (ret
== -EAGAIN
) {
1688 if (payload_sz
> sizeof(cmd_request
->mpb
))
1691 return SCSI_MLQUEUE_DEVICE_BUSY
;
1697 static struct scsi_host_template scsi_driver
= {
1698 .module
= THIS_MODULE
,
1699 .name
= "storvsc_host_t",
1700 .cmd_size
= sizeof(struct storvsc_cmd_request
),
1701 .bios_param
= storvsc_get_chs
,
1702 .queuecommand
= storvsc_queuecommand
,
1703 .eh_host_reset_handler
= storvsc_host_reset_handler
,
1704 .proc_name
= "storvsc_host",
1705 .eh_timed_out
= storvsc_eh_timed_out
,
1706 .slave_alloc
= storvsc_device_alloc
,
1707 .slave_configure
= storvsc_device_configure
,
1708 .cmd_per_lun
= 2048,
1710 .use_clustering
= ENABLE_CLUSTERING
,
1711 /* Make sure we dont get a sg segment crosses a page boundary */
1712 .dma_boundary
= PAGE_SIZE
-1,
1714 .track_queue_depth
= 1,
1723 static const struct hv_vmbus_device_id id_table
[] = {
1726 .driver_data
= SCSI_GUID
1730 .driver_data
= IDE_GUID
1732 /* Fibre Channel GUID */
1735 .driver_data
= SFC_GUID
1740 MODULE_DEVICE_TABLE(vmbus
, id_table
);
1742 static int storvsc_probe(struct hv_device
*device
,
1743 const struct hv_vmbus_device_id
*dev_id
)
1746 int num_cpus
= num_online_cpus();
1747 struct Scsi_Host
*host
;
1748 struct hv_host_device
*host_dev
;
1749 bool dev_is_ide
= ((dev_id
->driver_data
== IDE_GUID
) ? true : false);
1750 bool is_fc
= ((dev_id
->driver_data
== SFC_GUID
) ? true : false);
1752 struct storvsc_device
*stor_device
;
1753 int max_luns_per_target
;
1756 int max_sub_channels
= 0;
1759 * Based on the windows host we are running on,
1760 * set state to properly communicate with the host.
1763 if (vmbus_proto_version
< VERSION_WIN8
) {
1764 max_luns_per_target
= STORVSC_IDE_MAX_LUNS_PER_TARGET
;
1765 max_targets
= STORVSC_IDE_MAX_TARGETS
;
1766 max_channels
= STORVSC_IDE_MAX_CHANNELS
;
1768 max_luns_per_target
= STORVSC_MAX_LUNS_PER_TARGET
;
1769 max_targets
= STORVSC_MAX_TARGETS
;
1770 max_channels
= STORVSC_MAX_CHANNELS
;
1772 * On Windows8 and above, we support sub-channels for storage
1773 * on SCSI and FC controllers.
1774 * The number of sub-channels offerred is based on the number of
1775 * VCPUs in the guest.
1779 (num_cpus
- 1) / storvsc_vcpus_per_sub_channel
;
1782 scsi_driver
.can_queue
= max_outstanding_req_per_channel
*
1783 (max_sub_channels
+ 1) *
1784 (100 - ring_avail_percent_lowater
) / 100;
1786 host
= scsi_host_alloc(&scsi_driver
,
1787 sizeof(struct hv_host_device
));
1791 host_dev
= shost_priv(host
);
1792 memset(host_dev
, 0, sizeof(struct hv_host_device
));
1794 host_dev
->port
= host
->host_no
;
1795 host_dev
->dev
= device
;
1796 host_dev
->host
= host
;
1799 stor_device
= kzalloc(sizeof(struct storvsc_device
), GFP_KERNEL
);
1805 stor_device
->destroy
= false;
1806 stor_device
->open_sub_channel
= false;
1807 init_waitqueue_head(&stor_device
->waiting_to_drain
);
1808 stor_device
->device
= device
;
1809 stor_device
->host
= host
;
1810 hv_set_drvdata(device
, stor_device
);
1812 stor_device
->port_number
= host
->host_no
;
1813 ret
= storvsc_connect_to_vsp(device
, storvsc_ringbuffer_size
, is_fc
);
1817 host_dev
->path
= stor_device
->path_id
;
1818 host_dev
->target
= stor_device
->target_id
;
1820 switch (dev_id
->driver_data
) {
1822 host
->max_lun
= STORVSC_FC_MAX_LUNS_PER_TARGET
;
1823 host
->max_id
= STORVSC_FC_MAX_TARGETS
;
1824 host
->max_channel
= STORVSC_FC_MAX_CHANNELS
- 1;
1825 #if IS_ENABLED(CONFIG_SCSI_FC_ATTRS)
1826 host
->transportt
= fc_transport_template
;
1831 host
->max_lun
= max_luns_per_target
;
1832 host
->max_id
= max_targets
;
1833 host
->max_channel
= max_channels
- 1;
1837 host
->max_lun
= STORVSC_IDE_MAX_LUNS_PER_TARGET
;
1838 host
->max_id
= STORVSC_IDE_MAX_TARGETS
;
1839 host
->max_channel
= STORVSC_IDE_MAX_CHANNELS
- 1;
1842 /* max cmd length */
1843 host
->max_cmd_len
= STORVSC_MAX_CMD_LEN
;
1846 * set the table size based on the info we got
1849 host
->sg_tablesize
= (stor_device
->max_transfer_bytes
>> PAGE_SHIFT
);
1851 * Set the number of HW queues we are supporting.
1853 if (stor_device
->num_sc
!= 0)
1854 host
->nr_hw_queues
= stor_device
->num_sc
+ 1;
1857 * Set the error handler work queue.
1859 host_dev
->handle_error_wq
=
1860 alloc_ordered_workqueue("storvsc_error_wq_%d",
1863 if (!host_dev
->handle_error_wq
)
1865 INIT_WORK(&host_dev
->host_scan_work
, storvsc_host_scan
);
1866 /* Register the HBA and start the scsi bus scan */
1867 ret
= scsi_add_host(host
, &device
->device
);
1872 scsi_scan_host(host
);
1874 target
= (device
->dev_instance
.b
[5] << 8 |
1875 device
->dev_instance
.b
[4]);
1876 ret
= scsi_add_device(host
, 0, target
, 0);
1880 #if IS_ENABLED(CONFIG_SCSI_FC_ATTRS)
1881 if (host
->transportt
== fc_transport_template
) {
1882 struct fc_rport_identifiers ids
= {
1883 .roles
= FC_PORT_ROLE_FCP_DUMMY_INITIATOR
,
1886 fc_host_node_name(host
) = stor_device
->node_name
;
1887 fc_host_port_name(host
) = stor_device
->port_name
;
1888 stor_device
->rport
= fc_remote_port_add(host
, 0, &ids
);
1889 if (!stor_device
->rport
) {
1898 scsi_remove_host(host
);
1901 destroy_workqueue(host_dev
->handle_error_wq
);
1905 * Once we have connected with the host, we would need to
1906 * to invoke storvsc_dev_remove() to rollback this state and
1907 * this call also frees up the stor_device; hence the jump around
1910 storvsc_dev_remove(device
);
1914 kfree(stor_device
->stor_chns
);
1918 scsi_host_put(host
);
1922 static int storvsc_remove(struct hv_device
*dev
)
1924 struct storvsc_device
*stor_device
= hv_get_drvdata(dev
);
1925 struct Scsi_Host
*host
= stor_device
->host
;
1926 struct hv_host_device
*host_dev
= shost_priv(host
);
1928 #if IS_ENABLED(CONFIG_SCSI_FC_ATTRS)
1929 if (host
->transportt
== fc_transport_template
) {
1930 fc_remote_port_delete(stor_device
->rport
);
1931 fc_remove_host(host
);
1934 destroy_workqueue(host_dev
->handle_error_wq
);
1935 scsi_remove_host(host
);
1936 storvsc_dev_remove(dev
);
1937 scsi_host_put(host
);
1942 static struct hv_driver storvsc_drv
= {
1943 .name
= KBUILD_MODNAME
,
1944 .id_table
= id_table
,
1945 .probe
= storvsc_probe
,
1946 .remove
= storvsc_remove
,
1948 .probe_type
= PROBE_PREFER_ASYNCHRONOUS
,
1952 #if IS_ENABLED(CONFIG_SCSI_FC_ATTRS)
1953 static struct fc_function_template fc_transport_functions
= {
1954 .show_host_node_name
= 1,
1955 .show_host_port_name
= 1,
1959 static int __init
storvsc_drv_init(void)
1964 * Divide the ring buffer data size (which is 1 page less
1965 * than the ring buffer size since that page is reserved for
1966 * the ring buffer indices) by the max request size (which is
1967 * vmbus_channel_packet_multipage_buffer + struct vstor_packet + u64)
1969 max_outstanding_req_per_channel
=
1970 ((storvsc_ringbuffer_size
- PAGE_SIZE
) /
1971 ALIGN(MAX_MULTIPAGE_BUFFER_PACKET
+
1972 sizeof(struct vstor_packet
) + sizeof(u64
) -
1976 #if IS_ENABLED(CONFIG_SCSI_FC_ATTRS)
1977 fc_transport_template
= fc_attach_transport(&fc_transport_functions
);
1978 if (!fc_transport_template
)
1982 ret
= vmbus_driver_register(&storvsc_drv
);
1984 #if IS_ENABLED(CONFIG_SCSI_FC_ATTRS)
1986 fc_release_transport(fc_transport_template
);
1992 static void __exit
storvsc_drv_exit(void)
1994 vmbus_driver_unregister(&storvsc_drv
);
1995 #if IS_ENABLED(CONFIG_SCSI_FC_ATTRS)
1996 fc_release_transport(fc_transport_template
);
2000 MODULE_LICENSE("GPL");
2001 MODULE_DESCRIPTION("Microsoft Hyper-V virtual storage driver");
2002 module_init(storvsc_drv_init
);
2003 module_exit(storvsc_drv_exit
);