xref: /openbmc/linux/drivers/usb/usbip/stub.h (revision ea44d190)
1 // SPDX-License-Identifier: GPL-2.0+
2 /*
3  * Copyright (C) 2003-2008 Takahiro Hirofuchi
4  */
5 
6 #ifndef __USBIP_STUB_H
7 #define __USBIP_STUB_H
8 
9 #include <linux/list.h>
10 #include <linux/slab.h>
11 #include <linux/spinlock.h>
12 #include <linux/types.h>
13 #include <linux/usb.h>
14 #include <linux/wait.h>
15 
16 #define STUB_BUSID_OTHER 0
17 #define STUB_BUSID_REMOV 1
18 #define STUB_BUSID_ADDED 2
19 #define STUB_BUSID_ALLOC 3
20 
21 struct stub_device {
22 	struct usb_device *udev;
23 
24 	struct usbip_device ud;
25 	__u32 devid;
26 
27 	/*
28 	 * stub_priv preserves private data of each urb.
29 	 * It is allocated as stub_priv_cache and assigned to urb->context.
30 	 *
31 	 * stub_priv is always linked to any one of 3 lists;
32 	 *	priv_init: linked to this until the comletion of a urb.
33 	 *	priv_tx  : linked to this after the completion of a urb.
34 	 *	priv_free: linked to this after the sending of the result.
35 	 *
36 	 * Any of these list operations should be locked by priv_lock.
37 	 */
38 	spinlock_t priv_lock;
39 	struct list_head priv_init;
40 	struct list_head priv_tx;
41 	struct list_head priv_free;
42 
43 	/* see comments for unlinking in stub_rx.c */
44 	struct list_head unlink_tx;
45 	struct list_head unlink_free;
46 
47 	wait_queue_head_t tx_waitq;
48 };
49 
50 /* private data into urb->priv */
51 struct stub_priv {
52 	unsigned long seqnum;
53 	struct list_head list;
54 	struct stub_device *sdev;
55 	struct urb **urbs;
56 	struct scatterlist *sgl;
57 	int num_urbs;
58 	int completed_urbs;
59 	int urb_status;
60 
61 	int unlinking;
62 };
63 
64 struct stub_unlink {
65 	unsigned long seqnum;
66 	struct list_head list;
67 	__u32 status;
68 };
69 
70 /* same as SYSFS_BUS_ID_SIZE */
71 #define BUSID_SIZE 32
72 
73 struct bus_id_priv {
74 	char name[BUSID_SIZE];
75 	char status;
76 	int interf_count;
77 	struct stub_device *sdev;
78 	struct usb_device *udev;
79 	char shutdown_busid;
80 	spinlock_t busid_lock;
81 };
82 
83 /* stub_priv is allocated from stub_priv_cache */
84 extern struct kmem_cache *stub_priv_cache;
85 
86 /* stub_dev.c */
87 extern struct usb_device_driver stub_driver;
88 
89 /* stub_main.c */
90 struct bus_id_priv *get_busid_priv(const char *busid);
91 void put_busid_priv(struct bus_id_priv *bid);
92 int del_match_busid(char *busid);
93 void stub_free_priv_and_urb(struct stub_priv *priv);
94 void stub_device_cleanup_urbs(struct stub_device *sdev);
95 
96 /* stub_rx.c */
97 int stub_rx_loop(void *data);
98 
99 /* stub_tx.c */
100 void stub_enqueue_ret_unlink(struct stub_device *sdev, __u32 seqnum,
101 			     __u32 status);
102 void stub_complete(struct urb *urb);
103 int stub_tx_loop(void *data);
104 
105 #endif /* __USBIP_STUB_H */
106