1  // SPDX-License-Identifier: GPL-2.0-or-later
2  /*
3   * Virtio SCSI HBA driver
4   *
5   * Copyright IBM Corp. 2010
6   * Copyright Red Hat, Inc. 2011
7   *
8   * Authors:
9   *  Stefan Hajnoczi   <stefanha@linux.vnet.ibm.com>
10   *  Paolo Bonzini   <pbonzini@redhat.com>
11   */
12  
13  #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
14  
15  #include <linux/module.h>
16  #include <linux/slab.h>
17  #include <linux/mempool.h>
18  #include <linux/interrupt.h>
19  #include <linux/virtio.h>
20  #include <linux/virtio_ids.h>
21  #include <linux/virtio_config.h>
22  #include <linux/virtio_scsi.h>
23  #include <linux/cpu.h>
24  #include <linux/blkdev.h>
25  #include <linux/blk-integrity.h>
26  #include <scsi/scsi_host.h>
27  #include <scsi/scsi_device.h>
28  #include <scsi/scsi_cmnd.h>
29  #include <scsi/scsi_tcq.h>
30  #include <scsi/scsi_devinfo.h>
31  #include <linux/seqlock.h>
32  #include <linux/blk-mq-virtio.h>
33  
34  #include "sd.h"
35  
36  #define VIRTIO_SCSI_MEMPOOL_SZ 64
37  #define VIRTIO_SCSI_EVENT_LEN 8
38  #define VIRTIO_SCSI_VQ_BASE 2
39  
40  static unsigned int virtscsi_poll_queues;
41  module_param(virtscsi_poll_queues, uint, 0644);
42  MODULE_PARM_DESC(virtscsi_poll_queues,
43  		 "The number of dedicated virtqueues for polling I/O");
44  
45  /* Command queue element */
46  struct virtio_scsi_cmd {
47  	struct scsi_cmnd *sc;
48  	struct completion *comp;
49  	union {
50  		struct virtio_scsi_cmd_req       cmd;
51  		struct virtio_scsi_cmd_req_pi    cmd_pi;
52  		struct virtio_scsi_ctrl_tmf_req  tmf;
53  		struct virtio_scsi_ctrl_an_req   an;
54  	} req;
55  	union {
56  		struct virtio_scsi_cmd_resp      cmd;
57  		struct virtio_scsi_ctrl_tmf_resp tmf;
58  		struct virtio_scsi_ctrl_an_resp  an;
59  		struct virtio_scsi_event         evt;
60  	} resp;
61  } ____cacheline_aligned_in_smp;
62  
63  struct virtio_scsi_event_node {
64  	struct virtio_scsi *vscsi;
65  	struct virtio_scsi_event event;
66  	struct work_struct work;
67  };
68  
69  struct virtio_scsi_vq {
70  	/* Protects vq */
71  	spinlock_t vq_lock;
72  
73  	struct virtqueue *vq;
74  };
75  
76  /* Driver instance state */
77  struct virtio_scsi {
78  	struct virtio_device *vdev;
79  
80  	/* Get some buffers ready for event vq */
81  	struct virtio_scsi_event_node event_list[VIRTIO_SCSI_EVENT_LEN];
82  
83  	u32 num_queues;
84  	int io_queues[HCTX_MAX_TYPES];
85  
86  	struct hlist_node node;
87  
88  	/* Protected by event_vq lock */
89  	bool stop_events;
90  
91  	struct virtio_scsi_vq ctrl_vq;
92  	struct virtio_scsi_vq event_vq;
93  	struct virtio_scsi_vq req_vqs[];
94  };
95  
96  static struct kmem_cache *virtscsi_cmd_cache;
97  static mempool_t *virtscsi_cmd_pool;
98  
virtio_scsi_host(struct virtio_device * vdev)99  static inline struct Scsi_Host *virtio_scsi_host(struct virtio_device *vdev)
100  {
101  	return vdev->priv;
102  }
103  
virtscsi_compute_resid(struct scsi_cmnd * sc,u32 resid)104  static void virtscsi_compute_resid(struct scsi_cmnd *sc, u32 resid)
105  {
106  	if (resid)
107  		scsi_set_resid(sc, min(resid, scsi_bufflen(sc)));
108  }
109  
110  /*
111   * virtscsi_complete_cmd - finish a scsi_cmd and invoke scsi_done
112   *
113   * Called with vq_lock held.
114   */
virtscsi_complete_cmd(struct virtio_scsi * vscsi,void * buf)115  static void virtscsi_complete_cmd(struct virtio_scsi *vscsi, void *buf)
116  {
117  	struct virtio_scsi_cmd *cmd = buf;
118  	struct scsi_cmnd *sc = cmd->sc;
119  	struct virtio_scsi_cmd_resp *resp = &cmd->resp.cmd;
120  
121  	dev_dbg(&sc->device->sdev_gendev,
122  		"cmd %p response %u status %#02x sense_len %u\n",
123  		sc, resp->response, resp->status, resp->sense_len);
124  
125  	sc->result = resp->status;
126  	virtscsi_compute_resid(sc, virtio32_to_cpu(vscsi->vdev, resp->resid));
127  	switch (resp->response) {
128  	case VIRTIO_SCSI_S_OK:
129  		set_host_byte(sc, DID_OK);
130  		break;
131  	case VIRTIO_SCSI_S_OVERRUN:
132  		set_host_byte(sc, DID_ERROR);
133  		break;
134  	case VIRTIO_SCSI_S_ABORTED:
135  		set_host_byte(sc, DID_ABORT);
136  		break;
137  	case VIRTIO_SCSI_S_BAD_TARGET:
138  		set_host_byte(sc, DID_BAD_TARGET);
139  		break;
140  	case VIRTIO_SCSI_S_RESET:
141  		set_host_byte(sc, DID_RESET);
142  		break;
143  	case VIRTIO_SCSI_S_BUSY:
144  		set_host_byte(sc, DID_BUS_BUSY);
145  		break;
146  	case VIRTIO_SCSI_S_TRANSPORT_FAILURE:
147  		set_host_byte(sc, DID_TRANSPORT_DISRUPTED);
148  		break;
149  	case VIRTIO_SCSI_S_TARGET_FAILURE:
150  		set_host_byte(sc, DID_BAD_TARGET);
151  		break;
152  	case VIRTIO_SCSI_S_NEXUS_FAILURE:
153  		set_status_byte(sc, SAM_STAT_RESERVATION_CONFLICT);
154  		break;
155  	default:
156  		scmd_printk(KERN_WARNING, sc, "Unknown response %d",
157  			    resp->response);
158  		fallthrough;
159  	case VIRTIO_SCSI_S_FAILURE:
160  		set_host_byte(sc, DID_ERROR);
161  		break;
162  	}
163  
164  	WARN_ON(virtio32_to_cpu(vscsi->vdev, resp->sense_len) >
165  		VIRTIO_SCSI_SENSE_SIZE);
166  	if (resp->sense_len) {
167  		memcpy(sc->sense_buffer, resp->sense,
168  		       min_t(u32,
169  			     virtio32_to_cpu(vscsi->vdev, resp->sense_len),
170  			     VIRTIO_SCSI_SENSE_SIZE));
171  	}
172  
173  	scsi_done(sc);
174  }
175  
virtscsi_vq_done(struct virtio_scsi * vscsi,struct virtio_scsi_vq * virtscsi_vq,void (* fn)(struct virtio_scsi * vscsi,void * buf))176  static void virtscsi_vq_done(struct virtio_scsi *vscsi,
177  			     struct virtio_scsi_vq *virtscsi_vq,
178  			     void (*fn)(struct virtio_scsi *vscsi, void *buf))
179  {
180  	void *buf;
181  	unsigned int len;
182  	unsigned long flags;
183  	struct virtqueue *vq = virtscsi_vq->vq;
184  
185  	spin_lock_irqsave(&virtscsi_vq->vq_lock, flags);
186  	do {
187  		virtqueue_disable_cb(vq);
188  		while ((buf = virtqueue_get_buf(vq, &len)) != NULL)
189  			fn(vscsi, buf);
190  
191  	} while (!virtqueue_enable_cb(vq));
192  	spin_unlock_irqrestore(&virtscsi_vq->vq_lock, flags);
193  }
194  
virtscsi_req_done(struct virtqueue * vq)195  static void virtscsi_req_done(struct virtqueue *vq)
196  {
197  	struct Scsi_Host *sh = virtio_scsi_host(vq->vdev);
198  	struct virtio_scsi *vscsi = shost_priv(sh);
199  	int index = vq->index - VIRTIO_SCSI_VQ_BASE;
200  	struct virtio_scsi_vq *req_vq = &vscsi->req_vqs[index];
201  
202  	virtscsi_vq_done(vscsi, req_vq, virtscsi_complete_cmd);
203  };
204  
virtscsi_poll_requests(struct virtio_scsi * vscsi)205  static void virtscsi_poll_requests(struct virtio_scsi *vscsi)
206  {
207  	int i, num_vqs;
208  
209  	num_vqs = vscsi->num_queues;
210  	for (i = 0; i < num_vqs; i++)
211  		virtscsi_vq_done(vscsi, &vscsi->req_vqs[i],
212  				 virtscsi_complete_cmd);
213  }
214  
virtscsi_complete_free(struct virtio_scsi * vscsi,void * buf)215  static void virtscsi_complete_free(struct virtio_scsi *vscsi, void *buf)
216  {
217  	struct virtio_scsi_cmd *cmd = buf;
218  
219  	if (cmd->comp)
220  		complete(cmd->comp);
221  }
222  
virtscsi_ctrl_done(struct virtqueue * vq)223  static void virtscsi_ctrl_done(struct virtqueue *vq)
224  {
225  	struct Scsi_Host *sh = virtio_scsi_host(vq->vdev);
226  	struct virtio_scsi *vscsi = shost_priv(sh);
227  
228  	virtscsi_vq_done(vscsi, &vscsi->ctrl_vq, virtscsi_complete_free);
229  };
230  
231  static void virtscsi_handle_event(struct work_struct *work);
232  
virtscsi_kick_event(struct virtio_scsi * vscsi,struct virtio_scsi_event_node * event_node)233  static int virtscsi_kick_event(struct virtio_scsi *vscsi,
234  			       struct virtio_scsi_event_node *event_node)
235  {
236  	int err;
237  	struct scatterlist sg;
238  	unsigned long flags;
239  
240  	INIT_WORK(&event_node->work, virtscsi_handle_event);
241  	sg_init_one(&sg, &event_node->event, sizeof(struct virtio_scsi_event));
242  
243  	spin_lock_irqsave(&vscsi->event_vq.vq_lock, flags);
244  
245  	err = virtqueue_add_inbuf(vscsi->event_vq.vq, &sg, 1, event_node,
246  				  GFP_ATOMIC);
247  	if (!err)
248  		virtqueue_kick(vscsi->event_vq.vq);
249  
250  	spin_unlock_irqrestore(&vscsi->event_vq.vq_lock, flags);
251  
252  	return err;
253  }
254  
virtscsi_kick_event_all(struct virtio_scsi * vscsi)255  static int virtscsi_kick_event_all(struct virtio_scsi *vscsi)
256  {
257  	int i;
258  
259  	for (i = 0; i < VIRTIO_SCSI_EVENT_LEN; i++) {
260  		vscsi->event_list[i].vscsi = vscsi;
261  		virtscsi_kick_event(vscsi, &vscsi->event_list[i]);
262  	}
263  
264  	return 0;
265  }
266  
virtscsi_cancel_event_work(struct virtio_scsi * vscsi)267  static void virtscsi_cancel_event_work(struct virtio_scsi *vscsi)
268  {
269  	int i;
270  
271  	/* Stop scheduling work before calling cancel_work_sync.  */
272  	spin_lock_irq(&vscsi->event_vq.vq_lock);
273  	vscsi->stop_events = true;
274  	spin_unlock_irq(&vscsi->event_vq.vq_lock);
275  
276  	for (i = 0; i < VIRTIO_SCSI_EVENT_LEN; i++)
277  		cancel_work_sync(&vscsi->event_list[i].work);
278  }
279  
virtscsi_handle_transport_reset(struct virtio_scsi * vscsi,struct virtio_scsi_event * event)280  static void virtscsi_handle_transport_reset(struct virtio_scsi *vscsi,
281  					    struct virtio_scsi_event *event)
282  {
283  	struct scsi_device *sdev;
284  	struct Scsi_Host *shost = virtio_scsi_host(vscsi->vdev);
285  	unsigned int target = event->lun[1];
286  	unsigned int lun = (event->lun[2] << 8) | event->lun[3];
287  
288  	switch (virtio32_to_cpu(vscsi->vdev, event->reason)) {
289  	case VIRTIO_SCSI_EVT_RESET_RESCAN:
290  		if (lun == 0) {
291  			scsi_scan_target(&shost->shost_gendev, 0, target,
292  					 SCAN_WILD_CARD, SCSI_SCAN_INITIAL);
293  		} else {
294  			scsi_add_device(shost, 0, target, lun);
295  		}
296  		break;
297  	case VIRTIO_SCSI_EVT_RESET_REMOVED:
298  		sdev = scsi_device_lookup(shost, 0, target, lun);
299  		if (sdev) {
300  			scsi_remove_device(sdev);
301  			scsi_device_put(sdev);
302  		} else {
303  			pr_err("SCSI device %d 0 %d %d not found\n",
304  				shost->host_no, target, lun);
305  		}
306  		break;
307  	default:
308  		pr_info("Unsupported virtio scsi event reason %x\n", event->reason);
309  	}
310  }
311  
virtscsi_handle_param_change(struct virtio_scsi * vscsi,struct virtio_scsi_event * event)312  static void virtscsi_handle_param_change(struct virtio_scsi *vscsi,
313  					 struct virtio_scsi_event *event)
314  {
315  	struct scsi_device *sdev;
316  	struct Scsi_Host *shost = virtio_scsi_host(vscsi->vdev);
317  	unsigned int target = event->lun[1];
318  	unsigned int lun = (event->lun[2] << 8) | event->lun[3];
319  	u8 asc = virtio32_to_cpu(vscsi->vdev, event->reason) & 255;
320  	u8 ascq = virtio32_to_cpu(vscsi->vdev, event->reason) >> 8;
321  
322  	sdev = scsi_device_lookup(shost, 0, target, lun);
323  	if (!sdev) {
324  		pr_err("SCSI device %d 0 %d %d not found\n",
325  			shost->host_no, target, lun);
326  		return;
327  	}
328  
329  	/* Handle "Parameters changed", "Mode parameters changed", and
330  	   "Capacity data has changed".  */
331  	if (asc == 0x2a && (ascq == 0x00 || ascq == 0x01 || ascq == 0x09))
332  		scsi_rescan_device(sdev);
333  
334  	scsi_device_put(sdev);
335  }
336  
virtscsi_rescan_hotunplug(struct virtio_scsi * vscsi)337  static int virtscsi_rescan_hotunplug(struct virtio_scsi *vscsi)
338  {
339  	struct scsi_device *sdev;
340  	struct Scsi_Host *shost = virtio_scsi_host(vscsi->vdev);
341  	unsigned char scsi_cmd[MAX_COMMAND_SIZE];
342  	int result, inquiry_len, inq_result_len = 256;
343  	char *inq_result = kmalloc(inq_result_len, GFP_KERNEL);
344  
345  	if (!inq_result)
346  		return -ENOMEM;
347  
348  	shost_for_each_device(sdev, shost) {
349  		inquiry_len = sdev->inquiry_len ? sdev->inquiry_len : 36;
350  
351  		memset(scsi_cmd, 0, sizeof(scsi_cmd));
352  		scsi_cmd[0] = INQUIRY;
353  		scsi_cmd[4] = (unsigned char) inquiry_len;
354  
355  		memset(inq_result, 0, inq_result_len);
356  
357  		result = scsi_execute_cmd(sdev, scsi_cmd, REQ_OP_DRV_IN,
358  					  inq_result, inquiry_len,
359  					  SD_TIMEOUT, SD_MAX_RETRIES, NULL);
360  
361  		if (result == 0 && inq_result[0] >> 5) {
362  			/* PQ indicates the LUN is not attached */
363  			scsi_remove_device(sdev);
364  		} else if (result > 0 && host_byte(result) == DID_BAD_TARGET) {
365  			/*
366  			 * If all LUNs of a virtio-scsi device are unplugged
367  			 * it will respond with BAD TARGET on any INQUIRY
368  			 * command.
369  			 * Remove the device in this case as well.
370  			 */
371  			scsi_remove_device(sdev);
372  		}
373  	}
374  
375  	kfree(inq_result);
376  	return 0;
377  }
378  
virtscsi_handle_event(struct work_struct * work)379  static void virtscsi_handle_event(struct work_struct *work)
380  {
381  	struct virtio_scsi_event_node *event_node =
382  		container_of(work, struct virtio_scsi_event_node, work);
383  	struct virtio_scsi *vscsi = event_node->vscsi;
384  	struct virtio_scsi_event *event = &event_node->event;
385  
386  	if (event->event &
387  	    cpu_to_virtio32(vscsi->vdev, VIRTIO_SCSI_T_EVENTS_MISSED)) {
388  		int ret;
389  
390  		event->event &= ~cpu_to_virtio32(vscsi->vdev,
391  						   VIRTIO_SCSI_T_EVENTS_MISSED);
392  		ret = virtscsi_rescan_hotunplug(vscsi);
393  		if (ret)
394  			return;
395  		scsi_scan_host(virtio_scsi_host(vscsi->vdev));
396  	}
397  
398  	switch (virtio32_to_cpu(vscsi->vdev, event->event)) {
399  	case VIRTIO_SCSI_T_NO_EVENT:
400  		break;
401  	case VIRTIO_SCSI_T_TRANSPORT_RESET:
402  		virtscsi_handle_transport_reset(vscsi, event);
403  		break;
404  	case VIRTIO_SCSI_T_PARAM_CHANGE:
405  		virtscsi_handle_param_change(vscsi, event);
406  		break;
407  	default:
408  		pr_err("Unsupported virtio scsi event %x\n", event->event);
409  	}
410  	virtscsi_kick_event(vscsi, event_node);
411  }
412  
virtscsi_complete_event(struct virtio_scsi * vscsi,void * buf)413  static void virtscsi_complete_event(struct virtio_scsi *vscsi, void *buf)
414  {
415  	struct virtio_scsi_event_node *event_node = buf;
416  
417  	if (!vscsi->stop_events)
418  		queue_work(system_freezable_wq, &event_node->work);
419  }
420  
virtscsi_event_done(struct virtqueue * vq)421  static void virtscsi_event_done(struct virtqueue *vq)
422  {
423  	struct Scsi_Host *sh = virtio_scsi_host(vq->vdev);
424  	struct virtio_scsi *vscsi = shost_priv(sh);
425  
426  	virtscsi_vq_done(vscsi, &vscsi->event_vq, virtscsi_complete_event);
427  };
428  
__virtscsi_add_cmd(struct virtqueue * vq,struct virtio_scsi_cmd * cmd,size_t req_size,size_t resp_size)429  static int __virtscsi_add_cmd(struct virtqueue *vq,
430  			    struct virtio_scsi_cmd *cmd,
431  			    size_t req_size, size_t resp_size)
432  {
433  	struct scsi_cmnd *sc = cmd->sc;
434  	struct scatterlist *sgs[6], req, resp;
435  	struct sg_table *out, *in;
436  	unsigned out_num = 0, in_num = 0;
437  
438  	out = in = NULL;
439  
440  	if (sc && sc->sc_data_direction != DMA_NONE) {
441  		if (sc->sc_data_direction != DMA_FROM_DEVICE)
442  			out = &sc->sdb.table;
443  		if (sc->sc_data_direction != DMA_TO_DEVICE)
444  			in = &sc->sdb.table;
445  	}
446  
447  	/* Request header.  */
448  	sg_init_one(&req, &cmd->req, req_size);
449  	sgs[out_num++] = &req;
450  
451  	/* Data-out buffer.  */
452  	if (out) {
453  		/* Place WRITE protection SGLs before Data OUT payload */
454  		if (scsi_prot_sg_count(sc))
455  			sgs[out_num++] = scsi_prot_sglist(sc);
456  		sgs[out_num++] = out->sgl;
457  	}
458  
459  	/* Response header.  */
460  	sg_init_one(&resp, &cmd->resp, resp_size);
461  	sgs[out_num + in_num++] = &resp;
462  
463  	/* Data-in buffer */
464  	if (in) {
465  		/* Place READ protection SGLs before Data IN payload */
466  		if (scsi_prot_sg_count(sc))
467  			sgs[out_num + in_num++] = scsi_prot_sglist(sc);
468  		sgs[out_num + in_num++] = in->sgl;
469  	}
470  
471  	return virtqueue_add_sgs(vq, sgs, out_num, in_num, cmd, GFP_ATOMIC);
472  }
473  
virtscsi_kick_vq(struct virtio_scsi_vq * vq)474  static void virtscsi_kick_vq(struct virtio_scsi_vq *vq)
475  {
476  	bool needs_kick;
477  	unsigned long flags;
478  
479  	spin_lock_irqsave(&vq->vq_lock, flags);
480  	needs_kick = virtqueue_kick_prepare(vq->vq);
481  	spin_unlock_irqrestore(&vq->vq_lock, flags);
482  
483  	if (needs_kick)
484  		virtqueue_notify(vq->vq);
485  }
486  
487  /**
488   * virtscsi_add_cmd - add a virtio_scsi_cmd to a virtqueue, optionally kick it
489   * @vq		: the struct virtqueue we're talking about
490   * @cmd		: command structure
491   * @req_size	: size of the request buffer
492   * @resp_size	: size of the response buffer
493   * @kick	: whether to kick the virtqueue immediately
494   */
virtscsi_add_cmd(struct virtio_scsi_vq * vq,struct virtio_scsi_cmd * cmd,size_t req_size,size_t resp_size,bool kick)495  static int virtscsi_add_cmd(struct virtio_scsi_vq *vq,
496  			     struct virtio_scsi_cmd *cmd,
497  			     size_t req_size, size_t resp_size,
498  			     bool kick)
499  {
500  	unsigned long flags;
501  	int err;
502  	bool needs_kick = false;
503  
504  	spin_lock_irqsave(&vq->vq_lock, flags);
505  	err = __virtscsi_add_cmd(vq->vq, cmd, req_size, resp_size);
506  	if (!err && kick)
507  		needs_kick = virtqueue_kick_prepare(vq->vq);
508  
509  	spin_unlock_irqrestore(&vq->vq_lock, flags);
510  
511  	if (needs_kick)
512  		virtqueue_notify(vq->vq);
513  	return err;
514  }
515  
virtio_scsi_init_hdr(struct virtio_device * vdev,struct virtio_scsi_cmd_req * cmd,struct scsi_cmnd * sc)516  static void virtio_scsi_init_hdr(struct virtio_device *vdev,
517  				 struct virtio_scsi_cmd_req *cmd,
518  				 struct scsi_cmnd *sc)
519  {
520  	cmd->lun[0] = 1;
521  	cmd->lun[1] = sc->device->id;
522  	cmd->lun[2] = (sc->device->lun >> 8) | 0x40;
523  	cmd->lun[3] = sc->device->lun & 0xff;
524  	cmd->tag = cpu_to_virtio64(vdev, (unsigned long)sc);
525  	cmd->task_attr = VIRTIO_SCSI_S_SIMPLE;
526  	cmd->prio = 0;
527  	cmd->crn = 0;
528  }
529  
530  #ifdef CONFIG_BLK_DEV_INTEGRITY
virtio_scsi_init_hdr_pi(struct virtio_device * vdev,struct virtio_scsi_cmd_req_pi * cmd_pi,struct scsi_cmnd * sc)531  static void virtio_scsi_init_hdr_pi(struct virtio_device *vdev,
532  				    struct virtio_scsi_cmd_req_pi *cmd_pi,
533  				    struct scsi_cmnd *sc)
534  {
535  	struct request *rq = scsi_cmd_to_rq(sc);
536  	struct blk_integrity *bi;
537  
538  	virtio_scsi_init_hdr(vdev, (struct virtio_scsi_cmd_req *)cmd_pi, sc);
539  
540  	if (!rq || !scsi_prot_sg_count(sc))
541  		return;
542  
543  	bi = blk_get_integrity(rq->q->disk);
544  
545  	if (sc->sc_data_direction == DMA_TO_DEVICE)
546  		cmd_pi->pi_bytesout = cpu_to_virtio32(vdev,
547  						      bio_integrity_bytes(bi,
548  							blk_rq_sectors(rq)));
549  	else if (sc->sc_data_direction == DMA_FROM_DEVICE)
550  		cmd_pi->pi_bytesin = cpu_to_virtio32(vdev,
551  						     bio_integrity_bytes(bi,
552  							blk_rq_sectors(rq)));
553  }
554  #endif
555  
virtscsi_pick_vq_mq(struct virtio_scsi * vscsi,struct scsi_cmnd * sc)556  static struct virtio_scsi_vq *virtscsi_pick_vq_mq(struct virtio_scsi *vscsi,
557  						  struct scsi_cmnd *sc)
558  {
559  	u32 tag = blk_mq_unique_tag(scsi_cmd_to_rq(sc));
560  	u16 hwq = blk_mq_unique_tag_to_hwq(tag);
561  
562  	return &vscsi->req_vqs[hwq];
563  }
564  
virtscsi_queuecommand(struct Scsi_Host * shost,struct scsi_cmnd * sc)565  static int virtscsi_queuecommand(struct Scsi_Host *shost,
566  				 struct scsi_cmnd *sc)
567  {
568  	struct virtio_scsi *vscsi = shost_priv(shost);
569  	struct virtio_scsi_vq *req_vq = virtscsi_pick_vq_mq(vscsi, sc);
570  	struct virtio_scsi_cmd *cmd = scsi_cmd_priv(sc);
571  	bool kick;
572  	unsigned long flags;
573  	int req_size;
574  	int ret;
575  
576  	BUG_ON(scsi_sg_count(sc) > shost->sg_tablesize);
577  
578  	/* TODO: check feature bit and fail if unsupported?  */
579  	BUG_ON(sc->sc_data_direction == DMA_BIDIRECTIONAL);
580  
581  	dev_dbg(&sc->device->sdev_gendev,
582  		"cmd %p CDB: %#02x\n", sc, sc->cmnd[0]);
583  
584  	cmd->sc = sc;
585  
586  	BUG_ON(sc->cmd_len > VIRTIO_SCSI_CDB_SIZE);
587  
588  #ifdef CONFIG_BLK_DEV_INTEGRITY
589  	if (virtio_has_feature(vscsi->vdev, VIRTIO_SCSI_F_T10_PI)) {
590  		virtio_scsi_init_hdr_pi(vscsi->vdev, &cmd->req.cmd_pi, sc);
591  		memcpy(cmd->req.cmd_pi.cdb, sc->cmnd, sc->cmd_len);
592  		req_size = sizeof(cmd->req.cmd_pi);
593  	} else
594  #endif
595  	{
596  		virtio_scsi_init_hdr(vscsi->vdev, &cmd->req.cmd, sc);
597  		memcpy(cmd->req.cmd.cdb, sc->cmnd, sc->cmd_len);
598  		req_size = sizeof(cmd->req.cmd);
599  	}
600  
601  	kick = (sc->flags & SCMD_LAST) != 0;
602  	ret = virtscsi_add_cmd(req_vq, cmd, req_size, sizeof(cmd->resp.cmd), kick);
603  	if (ret == -EIO) {
604  		cmd->resp.cmd.response = VIRTIO_SCSI_S_BAD_TARGET;
605  		spin_lock_irqsave(&req_vq->vq_lock, flags);
606  		virtscsi_complete_cmd(vscsi, cmd);
607  		spin_unlock_irqrestore(&req_vq->vq_lock, flags);
608  	} else if (ret != 0) {
609  		return SCSI_MLQUEUE_HOST_BUSY;
610  	}
611  	return 0;
612  }
613  
virtscsi_tmf(struct virtio_scsi * vscsi,struct virtio_scsi_cmd * cmd)614  static int virtscsi_tmf(struct virtio_scsi *vscsi, struct virtio_scsi_cmd *cmd)
615  {
616  	DECLARE_COMPLETION_ONSTACK(comp);
617  	int ret = FAILED;
618  
619  	cmd->comp = &comp;
620  	if (virtscsi_add_cmd(&vscsi->ctrl_vq, cmd,
621  			      sizeof cmd->req.tmf, sizeof cmd->resp.tmf, true) < 0)
622  		goto out;
623  
624  	wait_for_completion(&comp);
625  	if (cmd->resp.tmf.response == VIRTIO_SCSI_S_OK ||
626  	    cmd->resp.tmf.response == VIRTIO_SCSI_S_FUNCTION_SUCCEEDED)
627  		ret = SUCCESS;
628  
629  	/*
630  	 * The spec guarantees that all requests related to the TMF have
631  	 * been completed, but the callback might not have run yet if
632  	 * we're using independent interrupts (e.g. MSI).  Poll the
633  	 * virtqueues once.
634  	 *
635  	 * In the abort case, scsi_done() will do nothing, because the
636  	 * command timed out and hence SCMD_STATE_COMPLETE has been set.
637  	 */
638  	virtscsi_poll_requests(vscsi);
639  
640  out:
641  	mempool_free(cmd, virtscsi_cmd_pool);
642  	return ret;
643  }
644  
virtscsi_device_reset(struct scsi_cmnd * sc)645  static int virtscsi_device_reset(struct scsi_cmnd *sc)
646  {
647  	struct virtio_scsi *vscsi = shost_priv(sc->device->host);
648  	struct virtio_scsi_cmd *cmd;
649  
650  	sdev_printk(KERN_INFO, sc->device, "device reset\n");
651  	cmd = mempool_alloc(virtscsi_cmd_pool, GFP_NOIO);
652  	if (!cmd)
653  		return FAILED;
654  
655  	memset(cmd, 0, sizeof(*cmd));
656  	cmd->req.tmf = (struct virtio_scsi_ctrl_tmf_req){
657  		.type = VIRTIO_SCSI_T_TMF,
658  		.subtype = cpu_to_virtio32(vscsi->vdev,
659  					     VIRTIO_SCSI_T_TMF_LOGICAL_UNIT_RESET),
660  		.lun[0] = 1,
661  		.lun[1] = sc->device->id,
662  		.lun[2] = (sc->device->lun >> 8) | 0x40,
663  		.lun[3] = sc->device->lun & 0xff,
664  	};
665  	return virtscsi_tmf(vscsi, cmd);
666  }
667  
virtscsi_device_alloc(struct scsi_device * sdevice)668  static int virtscsi_device_alloc(struct scsi_device *sdevice)
669  {
670  	/*
671  	 * Passed through SCSI targets (e.g. with qemu's 'scsi-block')
672  	 * may have transfer limits which come from the host SCSI
673  	 * controller or something on the host side other than the
674  	 * target itself.
675  	 *
676  	 * To make this work properly, the hypervisor can adjust the
677  	 * target's VPD information to advertise these limits.  But
678  	 * for that to work, the guest has to look at the VPD pages,
679  	 * which we won't do by default if it is an SPC-2 device, even
680  	 * if it does actually support it.
681  	 *
682  	 * So, set the blist to always try to read the VPD pages.
683  	 */
684  	sdevice->sdev_bflags = BLIST_TRY_VPD_PAGES;
685  
686  	return 0;
687  }
688  
689  
690  /**
691   * virtscsi_change_queue_depth() - Change a virtscsi target's queue depth
692   * @sdev:	Virtscsi target whose queue depth to change
693   * @qdepth:	New queue depth
694   */
virtscsi_change_queue_depth(struct scsi_device * sdev,int qdepth)695  static int virtscsi_change_queue_depth(struct scsi_device *sdev, int qdepth)
696  {
697  	struct Scsi_Host *shost = sdev->host;
698  	int max_depth = shost->cmd_per_lun;
699  
700  	return scsi_change_queue_depth(sdev, min(max_depth, qdepth));
701  }
702  
virtscsi_abort(struct scsi_cmnd * sc)703  static int virtscsi_abort(struct scsi_cmnd *sc)
704  {
705  	struct virtio_scsi *vscsi = shost_priv(sc->device->host);
706  	struct virtio_scsi_cmd *cmd;
707  
708  	scmd_printk(KERN_INFO, sc, "abort\n");
709  	cmd = mempool_alloc(virtscsi_cmd_pool, GFP_NOIO);
710  	if (!cmd)
711  		return FAILED;
712  
713  	memset(cmd, 0, sizeof(*cmd));
714  	cmd->req.tmf = (struct virtio_scsi_ctrl_tmf_req){
715  		.type = VIRTIO_SCSI_T_TMF,
716  		.subtype = VIRTIO_SCSI_T_TMF_ABORT_TASK,
717  		.lun[0] = 1,
718  		.lun[1] = sc->device->id,
719  		.lun[2] = (sc->device->lun >> 8) | 0x40,
720  		.lun[3] = sc->device->lun & 0xff,
721  		.tag = cpu_to_virtio64(vscsi->vdev, (unsigned long)sc),
722  	};
723  	return virtscsi_tmf(vscsi, cmd);
724  }
725  
virtscsi_map_queues(struct Scsi_Host * shost)726  static void virtscsi_map_queues(struct Scsi_Host *shost)
727  {
728  	struct virtio_scsi *vscsi = shost_priv(shost);
729  	int i, qoff;
730  
731  	for (i = 0, qoff = 0; i < shost->nr_maps; i++) {
732  		struct blk_mq_queue_map *map = &shost->tag_set.map[i];
733  
734  		map->nr_queues = vscsi->io_queues[i];
735  		map->queue_offset = qoff;
736  		qoff += map->nr_queues;
737  
738  		if (map->nr_queues == 0)
739  			continue;
740  
741  		/*
742  		 * Regular queues have interrupts and hence CPU affinity is
743  		 * defined by the core virtio code, but polling queues have
744  		 * no interrupts so we let the block layer assign CPU affinity.
745  		 */
746  		if (i == HCTX_TYPE_POLL)
747  			blk_mq_map_queues(map);
748  		else
749  			blk_mq_virtio_map_queues(map, vscsi->vdev, 2);
750  	}
751  }
752  
virtscsi_mq_poll(struct Scsi_Host * shost,unsigned int queue_num)753  static int virtscsi_mq_poll(struct Scsi_Host *shost, unsigned int queue_num)
754  {
755  	struct virtio_scsi *vscsi = shost_priv(shost);
756  	struct virtio_scsi_vq *virtscsi_vq = &vscsi->req_vqs[queue_num];
757  	unsigned long flags;
758  	unsigned int len;
759  	int found = 0;
760  	void *buf;
761  
762  	spin_lock_irqsave(&virtscsi_vq->vq_lock, flags);
763  
764  	while ((buf = virtqueue_get_buf(virtscsi_vq->vq, &len)) != NULL) {
765  		virtscsi_complete_cmd(vscsi, buf);
766  		found++;
767  	}
768  
769  	spin_unlock_irqrestore(&virtscsi_vq->vq_lock, flags);
770  
771  	return found;
772  }
773  
virtscsi_commit_rqs(struct Scsi_Host * shost,u16 hwq)774  static void virtscsi_commit_rqs(struct Scsi_Host *shost, u16 hwq)
775  {
776  	struct virtio_scsi *vscsi = shost_priv(shost);
777  
778  	virtscsi_kick_vq(&vscsi->req_vqs[hwq]);
779  }
780  
781  /*
782   * The host guarantees to respond to each command, although I/O
783   * latencies might be higher than on bare metal.  Reset the timer
784   * unconditionally to give the host a chance to perform EH.
785   */
virtscsi_eh_timed_out(struct scsi_cmnd * scmnd)786  static enum scsi_timeout_action virtscsi_eh_timed_out(struct scsi_cmnd *scmnd)
787  {
788  	return SCSI_EH_RESET_TIMER;
789  }
790  
791  static const struct scsi_host_template virtscsi_host_template = {
792  	.module = THIS_MODULE,
793  	.name = "Virtio SCSI HBA",
794  	.proc_name = "virtio_scsi",
795  	.this_id = -1,
796  	.cmd_size = sizeof(struct virtio_scsi_cmd),
797  	.queuecommand = virtscsi_queuecommand,
798  	.mq_poll = virtscsi_mq_poll,
799  	.commit_rqs = virtscsi_commit_rqs,
800  	.change_queue_depth = virtscsi_change_queue_depth,
801  	.eh_abort_handler = virtscsi_abort,
802  	.eh_device_reset_handler = virtscsi_device_reset,
803  	.eh_timed_out = virtscsi_eh_timed_out,
804  	.slave_alloc = virtscsi_device_alloc,
805  
806  	.dma_boundary = UINT_MAX,
807  	.map_queues = virtscsi_map_queues,
808  	.track_queue_depth = 1,
809  };
810  
811  #define virtscsi_config_get(vdev, fld) \
812  	({ \
813  		__virtio_native_type(struct virtio_scsi_config, fld) __val; \
814  		virtio_cread(vdev, struct virtio_scsi_config, fld, &__val); \
815  		__val; \
816  	})
817  
818  #define virtscsi_config_set(vdev, fld, val) \
819  	do { \
820  		__virtio_native_type(struct virtio_scsi_config, fld) __val = (val); \
821  		virtio_cwrite(vdev, struct virtio_scsi_config, fld, &__val); \
822  	} while(0)
823  
virtscsi_init_vq(struct virtio_scsi_vq * virtscsi_vq,struct virtqueue * vq)824  static void virtscsi_init_vq(struct virtio_scsi_vq *virtscsi_vq,
825  			     struct virtqueue *vq)
826  {
827  	spin_lock_init(&virtscsi_vq->vq_lock);
828  	virtscsi_vq->vq = vq;
829  }
830  
virtscsi_remove_vqs(struct virtio_device * vdev)831  static void virtscsi_remove_vqs(struct virtio_device *vdev)
832  {
833  	/* Stop all the virtqueues. */
834  	virtio_reset_device(vdev);
835  	vdev->config->del_vqs(vdev);
836  }
837  
virtscsi_init(struct virtio_device * vdev,struct virtio_scsi * vscsi)838  static int virtscsi_init(struct virtio_device *vdev,
839  			 struct virtio_scsi *vscsi)
840  {
841  	int err;
842  	u32 i;
843  	u32 num_vqs, num_poll_vqs, num_req_vqs;
844  	struct virtqueue_info *vqs_info;
845  	struct virtqueue **vqs;
846  	struct irq_affinity desc = { .pre_vectors = 2 };
847  
848  	num_req_vqs = vscsi->num_queues;
849  	num_vqs = num_req_vqs + VIRTIO_SCSI_VQ_BASE;
850  	vqs = kmalloc_array(num_vqs, sizeof(struct virtqueue *), GFP_KERNEL);
851  	vqs_info = kcalloc(num_vqs, sizeof(*vqs_info), GFP_KERNEL);
852  
853  	if (!vqs || !vqs_info) {
854  		err = -ENOMEM;
855  		goto out;
856  	}
857  
858  	num_poll_vqs = min_t(unsigned int, virtscsi_poll_queues,
859  			     num_req_vqs - 1);
860  	vscsi->io_queues[HCTX_TYPE_DEFAULT] = num_req_vqs - num_poll_vqs;
861  	vscsi->io_queues[HCTX_TYPE_READ] = 0;
862  	vscsi->io_queues[HCTX_TYPE_POLL] = num_poll_vqs;
863  
864  	dev_info(&vdev->dev, "%d/%d/%d default/read/poll queues\n",
865  		 vscsi->io_queues[HCTX_TYPE_DEFAULT],
866  		 vscsi->io_queues[HCTX_TYPE_READ],
867  		 vscsi->io_queues[HCTX_TYPE_POLL]);
868  
869  	vqs_info[0].callback = virtscsi_ctrl_done;
870  	vqs_info[0].name = "control";
871  	vqs_info[1].callback = virtscsi_event_done;
872  	vqs_info[1].name = "event";
873  	for (i = VIRTIO_SCSI_VQ_BASE; i < num_vqs - num_poll_vqs; i++) {
874  		vqs_info[i].callback = virtscsi_req_done;
875  		vqs_info[i].name = "request";
876  	}
877  
878  	for (; i < num_vqs; i++)
879  		vqs_info[i].name = "request_poll";
880  
881  	/* Discover virtqueues and write information to configuration.  */
882  	err = virtio_find_vqs(vdev, num_vqs, vqs, vqs_info, &desc);
883  	if (err)
884  		goto out;
885  
886  	virtscsi_init_vq(&vscsi->ctrl_vq, vqs[0]);
887  	virtscsi_init_vq(&vscsi->event_vq, vqs[1]);
888  	for (i = VIRTIO_SCSI_VQ_BASE; i < num_vqs; i++)
889  		virtscsi_init_vq(&vscsi->req_vqs[i - VIRTIO_SCSI_VQ_BASE],
890  				 vqs[i]);
891  
892  	virtscsi_config_set(vdev, cdb_size, VIRTIO_SCSI_CDB_SIZE);
893  	virtscsi_config_set(vdev, sense_size, VIRTIO_SCSI_SENSE_SIZE);
894  
895  	err = 0;
896  
897  out:
898  	kfree(vqs_info);
899  	kfree(vqs);
900  	if (err)
901  		virtscsi_remove_vqs(vdev);
902  	return err;
903  }
904  
virtscsi_probe(struct virtio_device * vdev)905  static int virtscsi_probe(struct virtio_device *vdev)
906  {
907  	struct Scsi_Host *shost;
908  	struct virtio_scsi *vscsi;
909  	int err;
910  	u32 sg_elems, num_targets;
911  	u32 cmd_per_lun;
912  	u32 num_queues;
913  
914  	if (!vdev->config->get) {
915  		dev_err(&vdev->dev, "%s failure: config access disabled\n",
916  			__func__);
917  		return -EINVAL;
918  	}
919  
920  	/* We need to know how many queues before we allocate. */
921  	num_queues = virtscsi_config_get(vdev, num_queues) ? : 1;
922  	num_queues = min_t(unsigned int, nr_cpu_ids, num_queues);
923  
924  	num_targets = virtscsi_config_get(vdev, max_target) + 1;
925  
926  	shost = scsi_host_alloc(&virtscsi_host_template,
927  				struct_size(vscsi, req_vqs, num_queues));
928  	if (!shost)
929  		return -ENOMEM;
930  
931  	sg_elems = virtscsi_config_get(vdev, seg_max) ?: 1;
932  	shost->sg_tablesize = sg_elems;
933  	shost->nr_maps = 1;
934  	vscsi = shost_priv(shost);
935  	vscsi->vdev = vdev;
936  	vscsi->num_queues = num_queues;
937  	vdev->priv = shost;
938  
939  	err = virtscsi_init(vdev, vscsi);
940  	if (err)
941  		goto virtscsi_init_failed;
942  
943  	if (vscsi->io_queues[HCTX_TYPE_POLL])
944  		shost->nr_maps = HCTX_TYPE_POLL + 1;
945  
946  	shost->can_queue = virtqueue_get_vring_size(vscsi->req_vqs[0].vq);
947  
948  	cmd_per_lun = virtscsi_config_get(vdev, cmd_per_lun) ?: 1;
949  	shost->cmd_per_lun = min_t(u32, cmd_per_lun, shost->can_queue);
950  	shost->max_sectors = virtscsi_config_get(vdev, max_sectors) ?: 0xFFFF;
951  
952  	/* LUNs > 256 are reported with format 1, so they go in the range
953  	 * 16640-32767.
954  	 */
955  	shost->max_lun = virtscsi_config_get(vdev, max_lun) + 1 + 0x4000;
956  	shost->max_id = num_targets;
957  	shost->max_channel = 0;
958  	shost->max_cmd_len = VIRTIO_SCSI_CDB_SIZE;
959  	shost->nr_hw_queues = num_queues;
960  
961  #ifdef CONFIG_BLK_DEV_INTEGRITY
962  	if (virtio_has_feature(vdev, VIRTIO_SCSI_F_T10_PI)) {
963  		int host_prot;
964  
965  		host_prot = SHOST_DIF_TYPE1_PROTECTION | SHOST_DIF_TYPE2_PROTECTION |
966  			    SHOST_DIF_TYPE3_PROTECTION | SHOST_DIX_TYPE1_PROTECTION |
967  			    SHOST_DIX_TYPE2_PROTECTION | SHOST_DIX_TYPE3_PROTECTION;
968  
969  		scsi_host_set_prot(shost, host_prot);
970  		scsi_host_set_guard(shost, SHOST_DIX_GUARD_CRC);
971  	}
972  #endif
973  
974  	err = scsi_add_host(shost, &vdev->dev);
975  	if (err)
976  		goto scsi_add_host_failed;
977  
978  	virtio_device_ready(vdev);
979  
980  	if (virtio_has_feature(vdev, VIRTIO_SCSI_F_HOTPLUG))
981  		virtscsi_kick_event_all(vscsi);
982  
983  	scsi_scan_host(shost);
984  	return 0;
985  
986  scsi_add_host_failed:
987  	vdev->config->del_vqs(vdev);
988  virtscsi_init_failed:
989  	scsi_host_put(shost);
990  	return err;
991  }
992  
virtscsi_remove(struct virtio_device * vdev)993  static void virtscsi_remove(struct virtio_device *vdev)
994  {
995  	struct Scsi_Host *shost = virtio_scsi_host(vdev);
996  	struct virtio_scsi *vscsi = shost_priv(shost);
997  
998  	if (virtio_has_feature(vdev, VIRTIO_SCSI_F_HOTPLUG))
999  		virtscsi_cancel_event_work(vscsi);
1000  
1001  	scsi_remove_host(shost);
1002  	virtscsi_remove_vqs(vdev);
1003  	scsi_host_put(shost);
1004  }
1005  
1006  #ifdef CONFIG_PM_SLEEP
virtscsi_freeze(struct virtio_device * vdev)1007  static int virtscsi_freeze(struct virtio_device *vdev)
1008  {
1009  	virtscsi_remove_vqs(vdev);
1010  	return 0;
1011  }
1012  
virtscsi_restore(struct virtio_device * vdev)1013  static int virtscsi_restore(struct virtio_device *vdev)
1014  {
1015  	struct Scsi_Host *sh = virtio_scsi_host(vdev);
1016  	struct virtio_scsi *vscsi = shost_priv(sh);
1017  	int err;
1018  
1019  	err = virtscsi_init(vdev, vscsi);
1020  	if (err)
1021  		return err;
1022  
1023  	virtio_device_ready(vdev);
1024  
1025  	if (virtio_has_feature(vdev, VIRTIO_SCSI_F_HOTPLUG))
1026  		virtscsi_kick_event_all(vscsi);
1027  
1028  	return err;
1029  }
1030  #endif
1031  
1032  static struct virtio_device_id id_table[] = {
1033  	{ VIRTIO_ID_SCSI, VIRTIO_DEV_ANY_ID },
1034  	{ 0 },
1035  };
1036  
1037  static unsigned int features[] = {
1038  	VIRTIO_SCSI_F_HOTPLUG,
1039  	VIRTIO_SCSI_F_CHANGE,
1040  #ifdef CONFIG_BLK_DEV_INTEGRITY
1041  	VIRTIO_SCSI_F_T10_PI,
1042  #endif
1043  };
1044  
1045  static struct virtio_driver virtio_scsi_driver = {
1046  	.feature_table = features,
1047  	.feature_table_size = ARRAY_SIZE(features),
1048  	.driver.name = KBUILD_MODNAME,
1049  	.id_table = id_table,
1050  	.probe = virtscsi_probe,
1051  #ifdef CONFIG_PM_SLEEP
1052  	.freeze = virtscsi_freeze,
1053  	.restore = virtscsi_restore,
1054  #endif
1055  	.remove = virtscsi_remove,
1056  };
1057  
virtio_scsi_init(void)1058  static int __init virtio_scsi_init(void)
1059  {
1060  	int ret = -ENOMEM;
1061  
1062  	virtscsi_cmd_cache = KMEM_CACHE(virtio_scsi_cmd, 0);
1063  	if (!virtscsi_cmd_cache) {
1064  		pr_err("kmem_cache_create() for virtscsi_cmd_cache failed\n");
1065  		goto error;
1066  	}
1067  
1068  
1069  	virtscsi_cmd_pool =
1070  		mempool_create_slab_pool(VIRTIO_SCSI_MEMPOOL_SZ,
1071  					 virtscsi_cmd_cache);
1072  	if (!virtscsi_cmd_pool) {
1073  		pr_err("mempool_create() for virtscsi_cmd_pool failed\n");
1074  		goto error;
1075  	}
1076  	ret = register_virtio_driver(&virtio_scsi_driver);
1077  	if (ret < 0)
1078  		goto error;
1079  
1080  	return 0;
1081  
1082  error:
1083  	mempool_destroy(virtscsi_cmd_pool);
1084  	virtscsi_cmd_pool = NULL;
1085  	kmem_cache_destroy(virtscsi_cmd_cache);
1086  	virtscsi_cmd_cache = NULL;
1087  	return ret;
1088  }
1089  
virtio_scsi_fini(void)1090  static void __exit virtio_scsi_fini(void)
1091  {
1092  	unregister_virtio_driver(&virtio_scsi_driver);
1093  	mempool_destroy(virtscsi_cmd_pool);
1094  	kmem_cache_destroy(virtscsi_cmd_cache);
1095  }
1096  module_init(virtio_scsi_init);
1097  module_exit(virtio_scsi_fini);
1098  
1099  MODULE_DEVICE_TABLE(virtio, id_table);
1100  MODULE_DESCRIPTION("Virtio SCSI HBA driver");
1101  MODULE_LICENSE("GPL");
1102