xref: /linux/drivers/usb/usbip/vhci_hcd.c (revision e5c86679d5e864947a52fb31e45a425dea3e7fa9)
1 /*
2  * Copyright (C) 2003-2008 Takahiro Hirofuchi
3  * Copyright (C) 2015-2016 Nobuo Iwata
4  *
5  * This is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License as published by
7  * the Free Software Foundation; either version 2 of the License, or
8  * (at your option) any later version.
9  *
10  * This is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program; if not, write to the Free Software
17  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
18  * USA.
19  */
20 
21 #include <linux/init.h>
22 #include <linux/file.h>
23 #include <linux/kernel.h>
24 #include <linux/kthread.h>
25 #include <linux/module.h>
26 #include <linux/platform_device.h>
27 #include <linux/slab.h>
28 
29 #include "usbip_common.h"
30 #include "vhci.h"
31 
32 #define DRIVER_AUTHOR "Takahiro Hirofuchi"
33 #define DRIVER_DESC "USB/IP 'Virtual' Host Controller (VHCI) Driver"
34 
35 /*
36  * TODO
37  *	- update root hub emulation
38  *	- move the emulation code to userland ?
39  *		porting to other operating systems
40  *		minimize kernel code
41  *	- add suspend/resume code
42  *	- clean up everything
43  */
44 
45 /* See usb gadget dummy hcd */
46 
47 static int vhci_hub_status(struct usb_hcd *hcd, char *buff);
48 static int vhci_hub_control(struct usb_hcd *hcd, u16 typeReq, u16 wValue,
49 			    u16 wIndex, char *buff, u16 wLength);
50 static int vhci_urb_enqueue(struct usb_hcd *hcd, struct urb *urb,
51 			    gfp_t mem_flags);
52 static int vhci_urb_dequeue(struct usb_hcd *hcd, struct urb *urb, int status);
53 static int vhci_start(struct usb_hcd *vhci_hcd);
54 static void vhci_stop(struct usb_hcd *hcd);
55 static int vhci_get_frame_number(struct usb_hcd *hcd);
56 
57 static const char driver_name[] = "vhci_hcd";
58 static const char driver_desc[] = "USB/IP Virtual Host Controller";
59 
60 int vhci_num_controllers = VHCI_NR_HCS;
61 
62 struct platform_device **vhci_pdevs;
63 
64 static const char * const bit_desc[] = {
65 	"CONNECTION",		/*0*/
66 	"ENABLE",		/*1*/
67 	"SUSPEND",		/*2*/
68 	"OVER_CURRENT",		/*3*/
69 	"RESET",		/*4*/
70 	"R5",			/*5*/
71 	"R6",			/*6*/
72 	"R7",			/*7*/
73 	"POWER",		/*8*/
74 	"LOWSPEED",		/*9*/
75 	"HIGHSPEED",		/*10*/
76 	"PORT_TEST",		/*11*/
77 	"INDICATOR",		/*12*/
78 	"R13",			/*13*/
79 	"R14",			/*14*/
80 	"R15",			/*15*/
81 	"C_CONNECTION",		/*16*/
82 	"C_ENABLE",		/*17*/
83 	"C_SUSPEND",		/*18*/
84 	"C_OVER_CURRENT",	/*19*/
85 	"C_RESET",		/*20*/
86 	"R21",			/*21*/
87 	"R22",			/*22*/
88 	"R23",			/*23*/
89 	"R24",			/*24*/
90 	"R25",			/*25*/
91 	"R26",			/*26*/
92 	"R27",			/*27*/
93 	"R28",			/*28*/
94 	"R29",			/*29*/
95 	"R30",			/*30*/
96 	"R31",			/*31*/
97 };
98 
99 static void dump_port_status_diff(u32 prev_status, u32 new_status)
100 {
101 	int i = 0;
102 	u32 bit = 1;
103 
104 	pr_debug("status prev -> new: %08x -> %08x\n", prev_status, new_status);
105 	while (bit) {
106 		u32 prev = prev_status & bit;
107 		u32 new = new_status & bit;
108 		char change;
109 
110 		if (!prev && new)
111 			change = '+';
112 		else if (prev && !new)
113 			change = '-';
114 		else
115 			change = ' ';
116 
117 		if (prev || new)
118 			pr_debug(" %c%s\n", change, bit_desc[i]);
119 		bit <<= 1;
120 		i++;
121 	}
122 	pr_debug("\n");
123 }
124 
125 void rh_port_connect(struct vhci_device *vdev, enum usb_device_speed speed)
126 {
127 	struct vhci_hcd	*vhci = vdev_to_vhci(vdev);
128 	int		rhport = vdev->rhport;
129 	u32		status;
130 	unsigned long	flags;
131 
132 	usbip_dbg_vhci_rh("rh_port_connect %d\n", rhport);
133 
134 	spin_lock_irqsave(&vhci->lock, flags);
135 
136 	status = vhci->port_status[rhport];
137 
138 	status |= USB_PORT_STAT_CONNECTION | (1 << USB_PORT_FEAT_C_CONNECTION);
139 
140 	switch (speed) {
141 	case USB_SPEED_HIGH:
142 		status |= USB_PORT_STAT_HIGH_SPEED;
143 		break;
144 	case USB_SPEED_LOW:
145 		status |= USB_PORT_STAT_LOW_SPEED;
146 		break;
147 	default:
148 		break;
149 	}
150 
151 	vhci->port_status[rhport] = status;
152 
153 	spin_unlock_irqrestore(&vhci->lock, flags);
154 
155 	usb_hcd_poll_rh_status(vhci_to_hcd(vhci));
156 }
157 
158 static void rh_port_disconnect(struct vhci_device *vdev)
159 {
160 	struct vhci_hcd	*vhci = vdev_to_vhci(vdev);
161 	int		rhport = vdev->rhport;
162 	u32		status;
163 	unsigned long	flags;
164 
165 	usbip_dbg_vhci_rh("rh_port_disconnect %d\n", rhport);
166 
167 	spin_lock_irqsave(&vhci->lock, flags);
168 
169 	status = vhci->port_status[rhport];
170 
171 	status &= ~USB_PORT_STAT_CONNECTION;
172 	status |= (1 << USB_PORT_FEAT_C_CONNECTION);
173 
174 	vhci->port_status[rhport] = status;
175 
176 	spin_unlock_irqrestore(&vhci->lock, flags);
177 	usb_hcd_poll_rh_status(vhci_to_hcd(vhci));
178 }
179 
180 #define PORT_C_MASK				\
181 	((USB_PORT_STAT_C_CONNECTION		\
182 	  | USB_PORT_STAT_C_ENABLE		\
183 	  | USB_PORT_STAT_C_SUSPEND		\
184 	  | USB_PORT_STAT_C_OVERCURRENT		\
185 	  | USB_PORT_STAT_C_RESET) << 16)
186 
187 /*
188  * Returns 0 if the status hasn't changed, or the number of bytes in buf.
189  * Ports are 0-indexed from the HCD point of view,
190  * and 1-indexed from the USB core pointer of view.
191  *
192  * @buf: a bitmap to show which port status has been changed.
193  *  bit  0: reserved
194  *  bit  1: the status of port 0 has been changed.
195  *  bit  2: the status of port 1 has been changed.
196  *  ...
197  */
198 static int vhci_hub_status(struct usb_hcd *hcd, char *buf)
199 {
200 	struct vhci_hcd	*vhci;
201 	int		retval;
202 	int		rhport;
203 	int		changed = 0;
204 	unsigned long	flags;
205 
206 	retval = DIV_ROUND_UP(VHCI_HC_PORTS + 1, 8);
207 	memset(buf, 0, retval);
208 
209 	vhci = hcd_to_vhci(hcd);
210 
211 	spin_lock_irqsave(&vhci->lock, flags);
212 	if (!HCD_HW_ACCESSIBLE(hcd)) {
213 		usbip_dbg_vhci_rh("hw accessible flag not on?\n");
214 		goto done;
215 	}
216 
217 	/* check pseudo status register for each port */
218 	for (rhport = 0; rhport < VHCI_HC_PORTS; rhport++) {
219 		if ((vhci->port_status[rhport] & PORT_C_MASK)) {
220 			/* The status of a port has been changed, */
221 			usbip_dbg_vhci_rh("port %d status changed\n", rhport);
222 
223 			buf[(rhport + 1) / 8] |= 1 << (rhport + 1) % 8;
224 			changed = 1;
225 		}
226 	}
227 
228 	if ((hcd->state == HC_STATE_SUSPENDED) && (changed == 1))
229 		usb_hcd_resume_root_hub(hcd);
230 
231 done:
232 	spin_unlock_irqrestore(&vhci->lock, flags);
233 	return changed ? retval : 0;
234 }
235 
236 static inline void hub_descriptor(struct usb_hub_descriptor *desc)
237 {
238 	memset(desc, 0, sizeof(*desc));
239 	desc->bDescriptorType = USB_DT_HUB;
240 	desc->bDescLength = 9;
241 	desc->wHubCharacteristics = cpu_to_le16(
242 		HUB_CHAR_INDV_PORT_LPSM | HUB_CHAR_COMMON_OCPM);
243 	desc->bNbrPorts = VHCI_HC_PORTS;
244 	desc->u.hs.DeviceRemovable[0] = 0xff;
245 	desc->u.hs.DeviceRemovable[1] = 0xff;
246 }
247 
248 static int vhci_hub_control(struct usb_hcd *hcd, u16 typeReq, u16 wValue,
249 			    u16 wIndex, char *buf, u16 wLength)
250 {
251 	struct vhci_hcd	*dum;
252 	int             retval = 0;
253 	int		rhport;
254 	unsigned long	flags;
255 
256 	u32 prev_port_status[VHCI_HC_PORTS];
257 
258 	if (!HCD_HW_ACCESSIBLE(hcd))
259 		return -ETIMEDOUT;
260 
261 	/*
262 	 * NOTE:
263 	 * wIndex shows the port number and begins from 1.
264 	 */
265 	usbip_dbg_vhci_rh("typeReq %x wValue %x wIndex %x\n", typeReq, wValue,
266 			  wIndex);
267 	if (wIndex > VHCI_HC_PORTS)
268 		pr_err("invalid port number %d\n", wIndex);
269 	rhport = ((__u8)(wIndex & 0x00ff)) - 1;
270 
271 	dum = hcd_to_vhci(hcd);
272 
273 	spin_lock_irqsave(&dum->lock, flags);
274 
275 	/* store old status and compare now and old later */
276 	if (usbip_dbg_flag_vhci_rh) {
277 		memcpy(prev_port_status, dum->port_status,
278 			sizeof(prev_port_status));
279 	}
280 
281 	switch (typeReq) {
282 	case ClearHubFeature:
283 		usbip_dbg_vhci_rh(" ClearHubFeature\n");
284 		break;
285 	case ClearPortFeature:
286 		switch (wValue) {
287 		case USB_PORT_FEAT_SUSPEND:
288 			if (dum->port_status[rhport] & USB_PORT_STAT_SUSPEND) {
289 				/* 20msec signaling */
290 				dum->resuming = 1;
291 				dum->re_timeout =
292 					jiffies + msecs_to_jiffies(20);
293 			}
294 			break;
295 		case USB_PORT_FEAT_POWER:
296 			usbip_dbg_vhci_rh(
297 				" ClearPortFeature: USB_PORT_FEAT_POWER\n");
298 			dum->port_status[rhport] = 0;
299 			dum->resuming = 0;
300 			break;
301 		case USB_PORT_FEAT_C_RESET:
302 			usbip_dbg_vhci_rh(
303 				" ClearPortFeature: USB_PORT_FEAT_C_RESET\n");
304 			switch (dum->vdev[rhport].speed) {
305 			case USB_SPEED_HIGH:
306 				dum->port_status[rhport] |=
307 					USB_PORT_STAT_HIGH_SPEED;
308 				break;
309 			case USB_SPEED_LOW:
310 				dum->port_status[rhport] |=
311 					USB_PORT_STAT_LOW_SPEED;
312 				break;
313 			default:
314 				break;
315 			}
316 			break;
317 		default:
318 			usbip_dbg_vhci_rh(" ClearPortFeature: default %x\n",
319 					  wValue);
320 			dum->port_status[rhport] &= ~(1 << wValue);
321 			break;
322 		}
323 		break;
324 	case GetHubDescriptor:
325 		usbip_dbg_vhci_rh(" GetHubDescriptor\n");
326 		hub_descriptor((struct usb_hub_descriptor *) buf);
327 		break;
328 	case GetHubStatus:
329 		usbip_dbg_vhci_rh(" GetHubStatus\n");
330 		*(__le32 *) buf = cpu_to_le32(0);
331 		break;
332 	case GetPortStatus:
333 		usbip_dbg_vhci_rh(" GetPortStatus port %x\n", wIndex);
334 		if (wIndex > VHCI_HC_PORTS || wIndex < 1) {
335 			pr_err("invalid port number %d\n", wIndex);
336 			retval = -EPIPE;
337 		}
338 
339 		/* we do not care about resume. */
340 
341 		/* whoever resets or resumes must GetPortStatus to
342 		 * complete it!!
343 		 */
344 		if (dum->resuming && time_after(jiffies, dum->re_timeout)) {
345 			dum->port_status[rhport] |=
346 				(1 << USB_PORT_FEAT_C_SUSPEND);
347 			dum->port_status[rhport] &=
348 				~(1 << USB_PORT_FEAT_SUSPEND);
349 			dum->resuming = 0;
350 			dum->re_timeout = 0;
351 		}
352 
353 		if ((dum->port_status[rhport] & (1 << USB_PORT_FEAT_RESET)) !=
354 		    0 && time_after(jiffies, dum->re_timeout)) {
355 			dum->port_status[rhport] |=
356 				(1 << USB_PORT_FEAT_C_RESET);
357 			dum->port_status[rhport] &=
358 				~(1 << USB_PORT_FEAT_RESET);
359 			dum->re_timeout = 0;
360 
361 			if (dum->vdev[rhport].ud.status ==
362 			    VDEV_ST_NOTASSIGNED) {
363 				usbip_dbg_vhci_rh(
364 					" enable rhport %d (status %u)\n",
365 					rhport,
366 					dum->vdev[rhport].ud.status);
367 				dum->port_status[rhport] |=
368 					USB_PORT_STAT_ENABLE;
369 			}
370 		}
371 		((__le16 *) buf)[0] = cpu_to_le16(dum->port_status[rhport]);
372 		((__le16 *) buf)[1] =
373 			cpu_to_le16(dum->port_status[rhport] >> 16);
374 
375 		usbip_dbg_vhci_rh(" GetPortStatus bye %x %x\n", ((u16 *)buf)[0],
376 				  ((u16 *)buf)[1]);
377 		break;
378 	case SetHubFeature:
379 		usbip_dbg_vhci_rh(" SetHubFeature\n");
380 		retval = -EPIPE;
381 		break;
382 	case SetPortFeature:
383 		switch (wValue) {
384 		case USB_PORT_FEAT_SUSPEND:
385 			usbip_dbg_vhci_rh(
386 				" SetPortFeature: USB_PORT_FEAT_SUSPEND\n");
387 			break;
388 		case USB_PORT_FEAT_RESET:
389 			usbip_dbg_vhci_rh(
390 				" SetPortFeature: USB_PORT_FEAT_RESET\n");
391 			/* if it's already running, disconnect first */
392 			if (dum->port_status[rhport] & USB_PORT_STAT_ENABLE) {
393 				dum->port_status[rhport] &=
394 					~(USB_PORT_STAT_ENABLE |
395 					  USB_PORT_STAT_LOW_SPEED |
396 					  USB_PORT_STAT_HIGH_SPEED);
397 				/* FIXME test that code path! */
398 			}
399 			/* 50msec reset signaling */
400 			dum->re_timeout = jiffies + msecs_to_jiffies(50);
401 
402 			/* FALLTHROUGH */
403 		default:
404 			usbip_dbg_vhci_rh(" SetPortFeature: default %d\n",
405 					  wValue);
406 			dum->port_status[rhport] |= (1 << wValue);
407 			break;
408 		}
409 		break;
410 
411 	default:
412 		pr_err("default: no such request\n");
413 
414 		/* "protocol stall" on error */
415 		retval = -EPIPE;
416 	}
417 
418 	if (usbip_dbg_flag_vhci_rh) {
419 		pr_debug("port %d\n", rhport);
420 		/* Only dump valid port status */
421 		if (rhport >= 0) {
422 			dump_port_status_diff(prev_port_status[rhport],
423 					      dum->port_status[rhport]);
424 		}
425 	}
426 	usbip_dbg_vhci_rh(" bye\n");
427 
428 	spin_unlock_irqrestore(&dum->lock, flags);
429 
430 	return retval;
431 }
432 
433 static struct vhci_device *get_vdev(struct usb_device *udev)
434 {
435 	struct platform_device *pdev;
436 	struct usb_hcd *hcd;
437 	struct vhci_hcd *vhci;
438 	int pdev_nr, rhport;
439 
440 	if (!udev)
441 		return NULL;
442 
443 	for (pdev_nr = 0; pdev_nr < vhci_num_controllers; pdev_nr++) {
444 		pdev = *(vhci_pdevs + pdev_nr);
445 		if (pdev == NULL)
446 			continue;
447 		hcd = platform_get_drvdata(pdev);
448 		if (hcd == NULL)
449 			continue;
450 		vhci = hcd_to_vhci(hcd);
451 		for (rhport = 0; rhport < VHCI_HC_PORTS; rhport++) {
452 			if (vhci->vdev[rhport].udev == udev)
453 				return &vhci->vdev[rhport];
454 		}
455 	}
456 
457 	return NULL;
458 }
459 
460 static void vhci_tx_urb(struct urb *urb)
461 {
462 	struct vhci_device *vdev = get_vdev(urb->dev);
463 	struct vhci_priv *priv;
464 	struct vhci_hcd *vhci;
465 	unsigned long flags;
466 
467 	if (!vdev) {
468 		pr_err("could not get virtual device");
469 		return;
470 	}
471 	vhci = vdev_to_vhci(vdev);
472 
473 	priv = kzalloc(sizeof(struct vhci_priv), GFP_ATOMIC);
474 	if (!priv) {
475 		usbip_event_add(&vdev->ud, VDEV_EVENT_ERROR_MALLOC);
476 		return;
477 	}
478 
479 	spin_lock_irqsave(&vdev->priv_lock, flags);
480 
481 	priv->seqnum = atomic_inc_return(&vhci->seqnum);
482 	if (priv->seqnum == 0xffff)
483 		dev_info(&urb->dev->dev, "seqnum max\n");
484 
485 	priv->vdev = vdev;
486 	priv->urb = urb;
487 
488 	urb->hcpriv = (void *) priv;
489 
490 	list_add_tail(&priv->list, &vdev->priv_tx);
491 
492 	wake_up(&vdev->waitq_tx);
493 	spin_unlock_irqrestore(&vdev->priv_lock, flags);
494 }
495 
496 static int vhci_urb_enqueue(struct usb_hcd *hcd, struct urb *urb,
497 			    gfp_t mem_flags)
498 {
499 	struct vhci_hcd *vhci = hcd_to_vhci(hcd);
500 	struct device *dev = &urb->dev->dev;
501 	u8 portnum = urb->dev->portnum;
502 	int ret = 0;
503 	struct vhci_device *vdev;
504 	unsigned long flags;
505 
506 	usbip_dbg_vhci_hc("enter, usb_hcd %p urb %p mem_flags %d\n",
507 			  hcd, urb, mem_flags);
508 
509 	if (portnum > VHCI_HC_PORTS) {
510 		pr_err("invalid port number %d\n", portnum);
511 		return -ENODEV;
512 	}
513 	vdev = &vhci->vdev[portnum-1];
514 
515 	/* patch to usb_sg_init() is in 2.5.60 */
516 	BUG_ON(!urb->transfer_buffer && urb->transfer_buffer_length);
517 
518 	spin_lock_irqsave(&vhci->lock, flags);
519 
520 	if (urb->status != -EINPROGRESS) {
521 		dev_err(dev, "URB already unlinked!, status %d\n", urb->status);
522 		spin_unlock_irqrestore(&vhci->lock, flags);
523 		return urb->status;
524 	}
525 
526 	/* refuse enqueue for dead connection */
527 	spin_lock(&vdev->ud.lock);
528 	if (vdev->ud.status == VDEV_ST_NULL ||
529 	    vdev->ud.status == VDEV_ST_ERROR) {
530 		dev_err(dev, "enqueue for inactive port %d\n", vdev->rhport);
531 		spin_unlock(&vdev->ud.lock);
532 		spin_unlock_irqrestore(&vhci->lock, flags);
533 		return -ENODEV;
534 	}
535 	spin_unlock(&vdev->ud.lock);
536 
537 	ret = usb_hcd_link_urb_to_ep(hcd, urb);
538 	if (ret)
539 		goto no_need_unlink;
540 
541 	/*
542 	 * The enumeration process is as follows;
543 	 *
544 	 *  1. Get_Descriptor request to DevAddrs(0) EndPoint(0)
545 	 *     to get max packet length of default pipe
546 	 *
547 	 *  2. Set_Address request to DevAddr(0) EndPoint(0)
548 	 *
549 	 */
550 	if (usb_pipedevice(urb->pipe) == 0) {
551 		__u8 type = usb_pipetype(urb->pipe);
552 		struct usb_ctrlrequest *ctrlreq =
553 			(struct usb_ctrlrequest *) urb->setup_packet;
554 
555 		if (type != PIPE_CONTROL || !ctrlreq) {
556 			dev_err(dev, "invalid request to devnum 0\n");
557 			ret = -EINVAL;
558 			goto no_need_xmit;
559 		}
560 
561 		switch (ctrlreq->bRequest) {
562 		case USB_REQ_SET_ADDRESS:
563 			/* set_address may come when a device is reset */
564 			dev_info(dev, "SetAddress Request (%d) to port %d\n",
565 				 ctrlreq->wValue, vdev->rhport);
566 
567 			usb_put_dev(vdev->udev);
568 			vdev->udev = usb_get_dev(urb->dev);
569 
570 			spin_lock(&vdev->ud.lock);
571 			vdev->ud.status = VDEV_ST_USED;
572 			spin_unlock(&vdev->ud.lock);
573 
574 			if (urb->status == -EINPROGRESS) {
575 				/* This request is successfully completed. */
576 				/* If not -EINPROGRESS, possibly unlinked. */
577 				urb->status = 0;
578 			}
579 
580 			goto no_need_xmit;
581 
582 		case USB_REQ_GET_DESCRIPTOR:
583 			if (ctrlreq->wValue == cpu_to_le16(USB_DT_DEVICE << 8))
584 				usbip_dbg_vhci_hc(
585 					"Not yet?:Get_Descriptor to device 0 (get max pipe size)\n");
586 
587 			usb_put_dev(vdev->udev);
588 			vdev->udev = usb_get_dev(urb->dev);
589 			goto out;
590 
591 		default:
592 			/* NOT REACHED */
593 			dev_err(dev,
594 				"invalid request to devnum 0 bRequest %u, wValue %u\n",
595 				ctrlreq->bRequest,
596 				ctrlreq->wValue);
597 			ret =  -EINVAL;
598 			goto no_need_xmit;
599 		}
600 
601 	}
602 
603 out:
604 	vhci_tx_urb(urb);
605 	spin_unlock_irqrestore(&vhci->lock, flags);
606 
607 	return 0;
608 
609 no_need_xmit:
610 	usb_hcd_unlink_urb_from_ep(hcd, urb);
611 no_need_unlink:
612 	spin_unlock_irqrestore(&vhci->lock, flags);
613 	if (!ret)
614 		usb_hcd_giveback_urb(hcd, urb, urb->status);
615 	return ret;
616 }
617 
618 /*
619  * vhci_rx gives back the urb after receiving the reply of the urb.  If an
620  * unlink pdu is sent or not, vhci_rx receives a normal return pdu and gives
621  * back its urb. For the driver unlinking the urb, the content of the urb is
622  * not important, but the calling to its completion handler is important; the
623  * completion of unlinking is notified by the completion handler.
624  *
625  *
626  * CLIENT SIDE
627  *
628  * - When vhci_hcd receives RET_SUBMIT,
629  *
630  *	- case 1a). the urb of the pdu is not unlinking.
631  *		- normal case
632  *		=> just give back the urb
633  *
634  *	- case 1b). the urb of the pdu is unlinking.
635  *		- usbip.ko will return a reply of the unlinking request.
636  *		=> give back the urb now and go to case 2b).
637  *
638  * - When vhci_hcd receives RET_UNLINK,
639  *
640  *	- case 2a). a submit request is still pending in vhci_hcd.
641  *		- urb was really pending in usbip.ko and urb_unlink_urb() was
642  *		  completed there.
643  *		=> free a pending submit request
644  *		=> notify unlink completeness by giving back the urb
645  *
646  *	- case 2b). a submit request is *not* pending in vhci_hcd.
647  *		- urb was already given back to the core driver.
648  *		=> do not give back the urb
649  *
650  *
651  * SERVER SIDE
652  *
653  * - When usbip receives CMD_UNLINK,
654  *
655  *	- case 3a). the urb of the unlink request is now in submission.
656  *		=> do usb_unlink_urb().
657  *		=> after the unlink is completed, send RET_UNLINK.
658  *
659  *	- case 3b). the urb of the unlink request is not in submission.
660  *		- may be already completed or never be received
661  *		=> send RET_UNLINK
662  *
663  */
664 static int vhci_urb_dequeue(struct usb_hcd *hcd, struct urb *urb, int status)
665 {
666 	struct vhci_hcd *vhci = hcd_to_vhci(hcd);
667 	struct vhci_priv *priv;
668 	struct vhci_device *vdev;
669 	unsigned long flags;
670 
671 	pr_info("dequeue a urb %p\n", urb);
672 
673 	spin_lock_irqsave(&vhci->lock, flags);
674 
675 	priv = urb->hcpriv;
676 	if (!priv) {
677 		/* URB was never linked! or will be soon given back by
678 		 * vhci_rx. */
679 		spin_unlock_irqrestore(&vhci->lock, flags);
680 		return -EIDRM;
681 	}
682 
683 	{
684 		int ret = 0;
685 
686 		ret = usb_hcd_check_unlink_urb(hcd, urb, status);
687 		if (ret) {
688 			spin_unlock_irqrestore(&vhci->lock, flags);
689 			return ret;
690 		}
691 	}
692 
693 	 /* send unlink request here? */
694 	vdev = priv->vdev;
695 
696 	if (!vdev->ud.tcp_socket) {
697 		/* tcp connection is closed */
698 		spin_lock(&vdev->priv_lock);
699 
700 		pr_info("device %p seems to be disconnected\n", vdev);
701 		list_del(&priv->list);
702 		kfree(priv);
703 		urb->hcpriv = NULL;
704 
705 		spin_unlock(&vdev->priv_lock);
706 
707 		/*
708 		 * If tcp connection is alive, we have sent CMD_UNLINK.
709 		 * vhci_rx will receive RET_UNLINK and give back the URB.
710 		 * Otherwise, we give back it here.
711 		 */
712 		pr_info("gives back urb %p\n", urb);
713 
714 		usb_hcd_unlink_urb_from_ep(hcd, urb);
715 
716 		spin_unlock_irqrestore(&vhci->lock, flags);
717 		usb_hcd_giveback_urb(vhci_to_hcd(vhci), urb, urb->status);
718 		spin_lock_irqsave(&vhci->lock, flags);
719 
720 	} else {
721 		/* tcp connection is alive */
722 		struct vhci_unlink *unlink;
723 
724 		spin_lock(&vdev->priv_lock);
725 
726 		/* setup CMD_UNLINK pdu */
727 		unlink = kzalloc(sizeof(struct vhci_unlink), GFP_ATOMIC);
728 		if (!unlink) {
729 			spin_unlock(&vdev->priv_lock);
730 			spin_unlock_irqrestore(&vhci->lock, flags);
731 			usbip_event_add(&vdev->ud, VDEV_EVENT_ERROR_MALLOC);
732 			return -ENOMEM;
733 		}
734 
735 		unlink->seqnum = atomic_inc_return(&vhci->seqnum);
736 		if (unlink->seqnum == 0xffff)
737 			pr_info("seqnum max\n");
738 
739 		unlink->unlink_seqnum = priv->seqnum;
740 
741 		pr_info("device %p seems to be still connected\n", vdev);
742 
743 		/* send cmd_unlink and try to cancel the pending URB in the
744 		 * peer */
745 		list_add_tail(&unlink->list, &vdev->unlink_tx);
746 		wake_up(&vdev->waitq_tx);
747 
748 		spin_unlock(&vdev->priv_lock);
749 	}
750 
751 	spin_unlock_irqrestore(&vhci->lock, flags);
752 
753 	usbip_dbg_vhci_hc("leave\n");
754 	return 0;
755 }
756 
757 static void vhci_device_unlink_cleanup(struct vhci_device *vdev)
758 {
759 	struct vhci_hcd *vhci = vdev_to_vhci(vdev);
760 	struct usb_hcd *hcd = vhci_to_hcd(vhci);
761 	struct vhci_unlink *unlink, *tmp;
762 	unsigned long flags;
763 
764 	spin_lock_irqsave(&vhci->lock, flags);
765 	spin_lock(&vdev->priv_lock);
766 
767 	list_for_each_entry_safe(unlink, tmp, &vdev->unlink_tx, list) {
768 		pr_info("unlink cleanup tx %lu\n", unlink->unlink_seqnum);
769 		list_del(&unlink->list);
770 		kfree(unlink);
771 	}
772 
773 	while (!list_empty(&vdev->unlink_rx)) {
774 		struct urb *urb;
775 
776 		unlink = list_first_entry(&vdev->unlink_rx, struct vhci_unlink,
777 			list);
778 
779 		/* give back URB of unanswered unlink request */
780 		pr_info("unlink cleanup rx %lu\n", unlink->unlink_seqnum);
781 
782 		urb = pickup_urb_and_free_priv(vdev, unlink->unlink_seqnum);
783 		if (!urb) {
784 			pr_info("the urb (seqnum %lu) was already given back\n",
785 				unlink->unlink_seqnum);
786 			list_del(&unlink->list);
787 			kfree(unlink);
788 			continue;
789 		}
790 
791 		urb->status = -ENODEV;
792 
793 		usb_hcd_unlink_urb_from_ep(hcd, urb);
794 
795 		list_del(&unlink->list);
796 
797 		spin_unlock(&vdev->priv_lock);
798 		spin_unlock_irqrestore(&vhci->lock, flags);
799 
800 		usb_hcd_giveback_urb(hcd, urb, urb->status);
801 
802 		spin_lock_irqsave(&vhci->lock, flags);
803 		spin_lock(&vdev->priv_lock);
804 
805 		kfree(unlink);
806 	}
807 
808 	spin_unlock(&vdev->priv_lock);
809 	spin_unlock_irqrestore(&vhci->lock, flags);
810 }
811 
812 /*
813  * The important thing is that only one context begins cleanup.
814  * This is why error handling and cleanup become simple.
815  * We do not want to consider race condition as possible.
816  */
817 static void vhci_shutdown_connection(struct usbip_device *ud)
818 {
819 	struct vhci_device *vdev = container_of(ud, struct vhci_device, ud);
820 
821 	/* need this? see stub_dev.c */
822 	if (ud->tcp_socket) {
823 		pr_debug("shutdown tcp_socket %p\n", ud->tcp_socket);
824 		kernel_sock_shutdown(ud->tcp_socket, SHUT_RDWR);
825 	}
826 
827 	/* kill threads related to this sdev */
828 	if (vdev->ud.tcp_rx) {
829 		kthread_stop_put(vdev->ud.tcp_rx);
830 		vdev->ud.tcp_rx = NULL;
831 	}
832 	if (vdev->ud.tcp_tx) {
833 		kthread_stop_put(vdev->ud.tcp_tx);
834 		vdev->ud.tcp_tx = NULL;
835 	}
836 	pr_info("stop threads\n");
837 
838 	/* active connection is closed */
839 	if (vdev->ud.tcp_socket) {
840 		sockfd_put(vdev->ud.tcp_socket);
841 		vdev->ud.tcp_socket = NULL;
842 	}
843 	pr_info("release socket\n");
844 
845 	vhci_device_unlink_cleanup(vdev);
846 
847 	/*
848 	 * rh_port_disconnect() is a trigger of ...
849 	 *   usb_disable_device():
850 	 *	disable all the endpoints for a USB device.
851 	 *   usb_disable_endpoint():
852 	 *	disable endpoints. pending urbs are unlinked(dequeued).
853 	 *
854 	 * NOTE: After calling rh_port_disconnect(), the USB device drivers of a
855 	 * detached device should release used urbs in a cleanup function (i.e.
856 	 * xxx_disconnect()). Therefore, vhci_hcd does not need to release
857 	 * pushed urbs and their private data in this function.
858 	 *
859 	 * NOTE: vhci_dequeue() must be considered carefully. When shutting down
860 	 * a connection, vhci_shutdown_connection() expects vhci_dequeue()
861 	 * gives back pushed urbs and frees their private data by request of
862 	 * the cleanup function of a USB driver. When unlinking a urb with an
863 	 * active connection, vhci_dequeue() does not give back the urb which
864 	 * is actually given back by vhci_rx after receiving its return pdu.
865 	 *
866 	 */
867 	rh_port_disconnect(vdev);
868 
869 	pr_info("disconnect device\n");
870 }
871 
872 
873 static void vhci_device_reset(struct usbip_device *ud)
874 {
875 	struct vhci_device *vdev = container_of(ud, struct vhci_device, ud);
876 	unsigned long flags;
877 
878 	spin_lock_irqsave(&ud->lock, flags);
879 
880 	vdev->speed  = 0;
881 	vdev->devid  = 0;
882 
883 	usb_put_dev(vdev->udev);
884 	vdev->udev = NULL;
885 
886 	if (ud->tcp_socket) {
887 		sockfd_put(ud->tcp_socket);
888 		ud->tcp_socket = NULL;
889 	}
890 	ud->status = VDEV_ST_NULL;
891 
892 	spin_unlock_irqrestore(&ud->lock, flags);
893 }
894 
895 static void vhci_device_unusable(struct usbip_device *ud)
896 {
897 	unsigned long flags;
898 
899 	spin_lock_irqsave(&ud->lock, flags);
900 	ud->status = VDEV_ST_ERROR;
901 	spin_unlock_irqrestore(&ud->lock, flags);
902 }
903 
904 static void vhci_device_init(struct vhci_device *vdev)
905 {
906 	memset(vdev, 0, sizeof(struct vhci_device));
907 
908 	vdev->ud.side   = USBIP_VHCI;
909 	vdev->ud.status = VDEV_ST_NULL;
910 	spin_lock_init(&vdev->ud.lock);
911 
912 	INIT_LIST_HEAD(&vdev->priv_rx);
913 	INIT_LIST_HEAD(&vdev->priv_tx);
914 	INIT_LIST_HEAD(&vdev->unlink_tx);
915 	INIT_LIST_HEAD(&vdev->unlink_rx);
916 	spin_lock_init(&vdev->priv_lock);
917 
918 	init_waitqueue_head(&vdev->waitq_tx);
919 
920 	vdev->ud.eh_ops.shutdown = vhci_shutdown_connection;
921 	vdev->ud.eh_ops.reset = vhci_device_reset;
922 	vdev->ud.eh_ops.unusable = vhci_device_unusable;
923 
924 	usbip_start_eh(&vdev->ud);
925 }
926 
927 static int hcd_name_to_id(const char *name)
928 {
929 	char *c;
930 	long val;
931 	int ret;
932 
933 	c = strchr(name, '.');
934 	if (c == NULL)
935 		return 0;
936 
937 	ret = kstrtol(c+1, 10, &val);
938 	if (ret < 0)
939 		return ret;
940 
941 	return val;
942 }
943 
944 static int vhci_start(struct usb_hcd *hcd)
945 {
946 	struct vhci_hcd *vhci = hcd_to_vhci(hcd);
947 	int id, rhport;
948 	int err = 0;
949 
950 	usbip_dbg_vhci_hc("enter vhci_start\n");
951 
952 	/* initialize private data of usb_hcd */
953 
954 	for (rhport = 0; rhport < VHCI_HC_PORTS; rhport++) {
955 		struct vhci_device *vdev = &vhci->vdev[rhport];
956 
957 		vhci_device_init(vdev);
958 		vdev->rhport = rhport;
959 	}
960 
961 	atomic_set(&vhci->seqnum, 0);
962 	spin_lock_init(&vhci->lock);
963 
964 	hcd->power_budget = 0; /* no limit */
965 	hcd->uses_new_polling = 1;
966 
967 	id = hcd_name_to_id(hcd_name(hcd));
968 	if (id < 0) {
969 		pr_err("invalid vhci name %s\n", hcd_name(hcd));
970 		return -EINVAL;
971 	}
972 
973 	/* vhci_hcd is now ready to be controlled through sysfs */
974 	if (id == 0) {
975 		err = vhci_init_attr_group();
976 		if (err) {
977 			pr_err("init attr group\n");
978 			return err;
979 		}
980 		err = sysfs_create_group(&hcd_dev(hcd)->kobj, &vhci_attr_group);
981 		if (err) {
982 			pr_err("create sysfs files\n");
983 			vhci_finish_attr_group();
984 			return err;
985 		}
986 		pr_info("created sysfs %s\n", hcd_name(hcd));
987 	}
988 
989 	return 0;
990 }
991 
992 static void vhci_stop(struct usb_hcd *hcd)
993 {
994 	struct vhci_hcd *vhci = hcd_to_vhci(hcd);
995 	int id, rhport;
996 
997 	usbip_dbg_vhci_hc("stop VHCI controller\n");
998 
999 	/* 1. remove the userland interface of vhci_hcd */
1000 	id = hcd_name_to_id(hcd_name(hcd));
1001 	if (id == 0) {
1002 		sysfs_remove_group(&hcd_dev(hcd)->kobj, &vhci_attr_group);
1003 		vhci_finish_attr_group();
1004 	}
1005 
1006 	/* 2. shutdown all the ports of vhci_hcd */
1007 	for (rhport = 0; rhport < VHCI_HC_PORTS; rhport++) {
1008 		struct vhci_device *vdev = &vhci->vdev[rhport];
1009 
1010 		usbip_event_add(&vdev->ud, VDEV_EVENT_REMOVED);
1011 		usbip_stop_eh(&vdev->ud);
1012 	}
1013 }
1014 
1015 static int vhci_get_frame_number(struct usb_hcd *hcd)
1016 {
1017 	dev_err_ratelimited(&hcd->self.root_hub->dev, "Not yet implemented\n");
1018 	return 0;
1019 }
1020 
1021 #ifdef CONFIG_PM
1022 
1023 /* FIXME: suspend/resume */
1024 static int vhci_bus_suspend(struct usb_hcd *hcd)
1025 {
1026 	struct vhci_hcd *vhci = hcd_to_vhci(hcd);
1027 	unsigned long flags;
1028 
1029 	dev_dbg(&hcd->self.root_hub->dev, "%s\n", __func__);
1030 
1031 	spin_lock_irqsave(&vhci->lock, flags);
1032 	hcd->state = HC_STATE_SUSPENDED;
1033 	spin_unlock_irqrestore(&vhci->lock, flags);
1034 
1035 	return 0;
1036 }
1037 
1038 static int vhci_bus_resume(struct usb_hcd *hcd)
1039 {
1040 	struct vhci_hcd *vhci = hcd_to_vhci(hcd);
1041 	int rc = 0;
1042 	unsigned long flags;
1043 
1044 	dev_dbg(&hcd->self.root_hub->dev, "%s\n", __func__);
1045 
1046 	spin_lock_irqsave(&vhci->lock, flags);
1047 	if (!HCD_HW_ACCESSIBLE(hcd))
1048 		rc = -ESHUTDOWN;
1049 	else
1050 		hcd->state = HC_STATE_RUNNING;
1051 	spin_unlock_irqrestore(&vhci->lock, flags);
1052 
1053 	return rc;
1054 }
1055 
1056 #else
1057 
1058 #define vhci_bus_suspend      NULL
1059 #define vhci_bus_resume       NULL
1060 #endif
1061 
1062 static struct hc_driver vhci_hc_driver = {
1063 	.description	= driver_name,
1064 	.product_desc	= driver_desc,
1065 	.hcd_priv_size	= sizeof(struct vhci_hcd),
1066 
1067 	.flags		= HCD_USB2,
1068 
1069 	.start		= vhci_start,
1070 	.stop		= vhci_stop,
1071 
1072 	.urb_enqueue	= vhci_urb_enqueue,
1073 	.urb_dequeue	= vhci_urb_dequeue,
1074 
1075 	.get_frame_number = vhci_get_frame_number,
1076 
1077 	.hub_status_data = vhci_hub_status,
1078 	.hub_control    = vhci_hub_control,
1079 	.bus_suspend	= vhci_bus_suspend,
1080 	.bus_resume	= vhci_bus_resume,
1081 };
1082 
1083 static int vhci_hcd_probe(struct platform_device *pdev)
1084 {
1085 	struct usb_hcd		*hcd;
1086 	int			ret;
1087 
1088 	usbip_dbg_vhci_hc("name %s id %d\n", pdev->name, pdev->id);
1089 
1090 	/*
1091 	 * Allocate and initialize hcd.
1092 	 * Our private data is also allocated automatically.
1093 	 */
1094 	hcd = usb_create_hcd(&vhci_hc_driver, &pdev->dev, dev_name(&pdev->dev));
1095 	if (!hcd) {
1096 		pr_err("create hcd failed\n");
1097 		return -ENOMEM;
1098 	}
1099 	hcd->has_tt = 1;
1100 
1101 	/*
1102 	 * Finish generic HCD structure initialization and register.
1103 	 * Call the driver's reset() and start() routines.
1104 	 */
1105 	ret = usb_add_hcd(hcd, 0, 0);
1106 	if (ret != 0) {
1107 		pr_err("usb_add_hcd failed %d\n", ret);
1108 		usb_put_hcd(hcd);
1109 		return ret;
1110 	}
1111 
1112 	usbip_dbg_vhci_hc("bye\n");
1113 	return 0;
1114 }
1115 
1116 static int vhci_hcd_remove(struct platform_device *pdev)
1117 {
1118 	struct usb_hcd	*hcd;
1119 
1120 	hcd = platform_get_drvdata(pdev);
1121 	if (!hcd)
1122 		return 0;
1123 
1124 	/*
1125 	 * Disconnects the root hub,
1126 	 * then reverses the effects of usb_add_hcd(),
1127 	 * invoking the HCD's stop() methods.
1128 	 */
1129 	usb_remove_hcd(hcd);
1130 	usb_put_hcd(hcd);
1131 
1132 	return 0;
1133 }
1134 
1135 #ifdef CONFIG_PM
1136 
1137 /* what should happen for USB/IP under suspend/resume? */
1138 static int vhci_hcd_suspend(struct platform_device *pdev, pm_message_t state)
1139 {
1140 	struct usb_hcd *hcd;
1141 	struct vhci_hcd *vhci;
1142 	int rhport;
1143 	int connected = 0;
1144 	int ret = 0;
1145 	unsigned long flags;
1146 
1147 	hcd = platform_get_drvdata(pdev);
1148 	if (!hcd)
1149 		return 0;
1150 	vhci = hcd_to_vhci(hcd);
1151 
1152 	spin_lock_irqsave(&vhci->lock, flags);
1153 
1154 	for (rhport = 0; rhport < VHCI_HC_PORTS; rhport++)
1155 		if (vhci->port_status[rhport] & USB_PORT_STAT_CONNECTION)
1156 			connected += 1;
1157 
1158 	spin_unlock_irqrestore(&vhci->lock, flags);
1159 
1160 	if (connected > 0) {
1161 		dev_info(&pdev->dev,
1162 			 "We have %d active connection%s. Do not suspend.\n",
1163 			 connected, (connected == 1 ? "" : "s"));
1164 		ret =  -EBUSY;
1165 	} else {
1166 		dev_info(&pdev->dev, "suspend vhci_hcd");
1167 		clear_bit(HCD_FLAG_HW_ACCESSIBLE, &hcd->flags);
1168 	}
1169 
1170 	return ret;
1171 }
1172 
1173 static int vhci_hcd_resume(struct platform_device *pdev)
1174 {
1175 	struct usb_hcd *hcd;
1176 
1177 	dev_dbg(&pdev->dev, "%s\n", __func__);
1178 
1179 	hcd = platform_get_drvdata(pdev);
1180 	if (!hcd)
1181 		return 0;
1182 	set_bit(HCD_FLAG_HW_ACCESSIBLE, &hcd->flags);
1183 	usb_hcd_poll_rh_status(hcd);
1184 
1185 	return 0;
1186 }
1187 
1188 #else
1189 
1190 #define vhci_hcd_suspend	NULL
1191 #define vhci_hcd_resume		NULL
1192 
1193 #endif
1194 
1195 static struct platform_driver vhci_driver = {
1196 	.probe	= vhci_hcd_probe,
1197 	.remove	= vhci_hcd_remove,
1198 	.suspend = vhci_hcd_suspend,
1199 	.resume	= vhci_hcd_resume,
1200 	.driver	= {
1201 		.name = driver_name,
1202 	},
1203 };
1204 
1205 static int add_platform_device(int id)
1206 {
1207 	struct platform_device *pdev;
1208 	int dev_nr;
1209 
1210 	if (id == 0)
1211 		dev_nr = -1;
1212 	else
1213 		dev_nr = id;
1214 
1215 	pdev = platform_device_register_simple(driver_name, dev_nr, NULL, 0);
1216 	if (IS_ERR(pdev))
1217 		return PTR_ERR(pdev);
1218 
1219 	*(vhci_pdevs + id) = pdev;
1220 	return 0;
1221 }
1222 
1223 static void del_platform_devices(void)
1224 {
1225 	struct platform_device *pdev;
1226 	int i;
1227 
1228 	for (i = 0; i < vhci_num_controllers; i++) {
1229 		pdev = *(vhci_pdevs + i);
1230 		if (pdev != NULL)
1231 			platform_device_unregister(pdev);
1232 		*(vhci_pdevs + i) = NULL;
1233 	}
1234 	sysfs_remove_link(&platform_bus.kobj, driver_name);
1235 }
1236 
1237 static int __init vhci_hcd_init(void)
1238 {
1239 	int i, ret;
1240 
1241 	if (usb_disabled())
1242 		return -ENODEV;
1243 
1244 	if (vhci_num_controllers < 1)
1245 		vhci_num_controllers = 1;
1246 
1247 	vhci_pdevs = kcalloc(vhci_num_controllers, sizeof(void *), GFP_KERNEL);
1248 	if (vhci_pdevs == NULL)
1249 		return -ENOMEM;
1250 
1251 	ret = platform_driver_register(&vhci_driver);
1252 	if (ret)
1253 		goto err_driver_register;
1254 
1255 	for (i = 0; i < vhci_num_controllers; i++) {
1256 		ret = add_platform_device(i);
1257 		if (ret)
1258 			goto err_platform_device_register;
1259 	}
1260 
1261 	pr_info(DRIVER_DESC " v" USBIP_VERSION "\n");
1262 	return ret;
1263 
1264 err_platform_device_register:
1265 	del_platform_devices();
1266 	platform_driver_unregister(&vhci_driver);
1267 err_driver_register:
1268 	kfree(vhci_pdevs);
1269 	return ret;
1270 }
1271 
1272 static void __exit vhci_hcd_exit(void)
1273 {
1274 	del_platform_devices();
1275 	platform_driver_unregister(&vhci_driver);
1276 	kfree(vhci_pdevs);
1277 }
1278 
1279 module_init(vhci_hcd_init);
1280 module_exit(vhci_hcd_exit);
1281 
1282 MODULE_AUTHOR(DRIVER_AUTHOR);
1283 MODULE_DESCRIPTION(DRIVER_DESC);
1284 MODULE_LICENSE("GPL");
1285 MODULE_VERSION(USBIP_VERSION);
1286