Linux Audio

Check our new training course

Loading...
v6.8
  1// SPDX-License-Identifier: GPL-2.0+
  2/*
  3 * Copyright (C) 2003-2008 Takahiro Hirofuchi
  4 * Copyright (C) 2015-2016 Samsung Electronics
  5 *               Krzysztof Opasiak <k.opasiak@samsung.com>
  6 */
  7
  8#ifndef __USBIP_COMMON_H
  9#define __USBIP_COMMON_H
 10
 11#include <linux/compiler.h>
 12#include <linux/device.h>
 13#include <linux/interrupt.h>
 14#include <linux/net.h>
 15#include <linux/printk.h>
 16#include <linux/spinlock.h>
 17#include <linux/types.h>
 18#include <linux/usb.h>
 19#include <linux/wait.h>
 20#include <linux/sched/task.h>
 21#include <linux/kcov.h>
 22#include <uapi/linux/usbip.h>
 23
 24#undef pr_fmt
 25
 26#ifdef DEBUG
 27#define pr_fmt(fmt)     KBUILD_MODNAME ": %s:%d: " fmt, __func__, __LINE__
 28#else
 29#define pr_fmt(fmt)     KBUILD_MODNAME ": " fmt
 30#endif
 31
 32enum {
 33	usbip_debug_xmit	= (1 << 0),
 34	usbip_debug_sysfs	= (1 << 1),
 35	usbip_debug_urb		= (1 << 2),
 36	usbip_debug_eh		= (1 << 3),
 37
 38	usbip_debug_stub_cmp	= (1 << 8),
 39	usbip_debug_stub_dev	= (1 << 9),
 40	usbip_debug_stub_rx	= (1 << 10),
 41	usbip_debug_stub_tx	= (1 << 11),
 42
 43	usbip_debug_vhci_rh	= (1 << 8),
 44	usbip_debug_vhci_hc	= (1 << 9),
 45	usbip_debug_vhci_rx	= (1 << 10),
 46	usbip_debug_vhci_tx	= (1 << 11),
 47	usbip_debug_vhci_sysfs  = (1 << 12)
 48};
 49
 50#define usbip_dbg_flag_xmit	(usbip_debug_flag & usbip_debug_xmit)
 51#define usbip_dbg_flag_vhci_rh	(usbip_debug_flag & usbip_debug_vhci_rh)
 52#define usbip_dbg_flag_vhci_hc	(usbip_debug_flag & usbip_debug_vhci_hc)
 53#define usbip_dbg_flag_vhci_rx	(usbip_debug_flag & usbip_debug_vhci_rx)
 54#define usbip_dbg_flag_vhci_tx	(usbip_debug_flag & usbip_debug_vhci_tx)
 55#define usbip_dbg_flag_stub_rx	(usbip_debug_flag & usbip_debug_stub_rx)
 56#define usbip_dbg_flag_stub_tx	(usbip_debug_flag & usbip_debug_stub_tx)
 57#define usbip_dbg_flag_vhci_sysfs  (usbip_debug_flag & usbip_debug_vhci_sysfs)
 58
 59extern unsigned long usbip_debug_flag;
 60extern struct device_attribute dev_attr_usbip_debug;
 61
 62#define usbip_dbg_with_flag(flag, fmt, args...)		\
 63	do {						\
 64		if (flag & usbip_debug_flag)		\
 65			pr_debug(fmt, ##args);		\
 66	} while (0)
 67
 68#define usbip_dbg_sysfs(fmt, args...) \
 69	usbip_dbg_with_flag(usbip_debug_sysfs, fmt , ##args)
 70#define usbip_dbg_xmit(fmt, args...) \
 71	usbip_dbg_with_flag(usbip_debug_xmit, fmt , ##args)
 72#define usbip_dbg_urb(fmt, args...) \
 73	usbip_dbg_with_flag(usbip_debug_urb, fmt , ##args)
 74#define usbip_dbg_eh(fmt, args...) \
 75	usbip_dbg_with_flag(usbip_debug_eh, fmt , ##args)
 76
 77#define usbip_dbg_vhci_rh(fmt, args...)	\
 78	usbip_dbg_with_flag(usbip_debug_vhci_rh, fmt , ##args)
 79#define usbip_dbg_vhci_hc(fmt, args...)	\
 80	usbip_dbg_with_flag(usbip_debug_vhci_hc, fmt , ##args)
 81#define usbip_dbg_vhci_rx(fmt, args...)	\
 82	usbip_dbg_with_flag(usbip_debug_vhci_rx, fmt , ##args)
 83#define usbip_dbg_vhci_tx(fmt, args...)	\
 84	usbip_dbg_with_flag(usbip_debug_vhci_tx, fmt , ##args)
 85#define usbip_dbg_vhci_sysfs(fmt, args...) \
 86	usbip_dbg_with_flag(usbip_debug_vhci_sysfs, fmt , ##args)
 87
 88#define usbip_dbg_stub_cmp(fmt, args...) \
 89	usbip_dbg_with_flag(usbip_debug_stub_cmp, fmt , ##args)
 90#define usbip_dbg_stub_rx(fmt, args...) \
 91	usbip_dbg_with_flag(usbip_debug_stub_rx, fmt , ##args)
 92#define usbip_dbg_stub_tx(fmt, args...) \
 93	usbip_dbg_with_flag(usbip_debug_stub_tx, fmt , ##args)
 94
 95/*
 96 * USB/IP request headers
 97 *
 98 * Each request is transferred across the network to its counterpart, which
 99 * facilitates the normal USB communication. The values contained in the headers
100 * are basically the same as in a URB. Currently, four request types are
101 * defined:
102 *
103 *  - USBIP_CMD_SUBMIT: a USB request block, corresponds to usb_submit_urb()
104 *    (client to server)
105 *
106 *  - USBIP_RET_SUBMIT: the result of USBIP_CMD_SUBMIT
107 *    (server to client)
108 *
109 *  - USBIP_CMD_UNLINK: an unlink request of a pending USBIP_CMD_SUBMIT,
110 *    corresponds to usb_unlink_urb()
111 *    (client to server)
112 *
113 *  - USBIP_RET_UNLINK: the result of USBIP_CMD_UNLINK
114 *    (server to client)
115 *
116 */
117#define USBIP_CMD_SUBMIT	0x0001
118#define USBIP_CMD_UNLINK	0x0002
119#define USBIP_RET_SUBMIT	0x0003
120#define USBIP_RET_UNLINK	0x0004
121
122#define USBIP_DIR_OUT	0x00
123#define USBIP_DIR_IN	0x01
124
125/*
126 * Arbitrary limit for the maximum number of isochronous packets in an URB,
127 * compare for example the uhci_submit_isochronous function in
128 * drivers/usb/host/uhci-q.c
129 */
130#define USBIP_MAX_ISO_PACKETS 1024
131
132/**
133 * struct usbip_header_basic - data pertinent to every request
134 * @command: the usbip request type
135 * @seqnum: sequential number that identifies requests; incremented per
136 *	    connection
137 * @devid: specifies a remote USB device uniquely instead of busnum and devnum;
138 *	   in the stub driver, this value is ((busnum << 16) | devnum)
139 * @direction: direction of the transfer
140 * @ep: endpoint number
141 */
142struct usbip_header_basic {
143	__u32 command;
144	__u32 seqnum;
145	__u32 devid;
146	__u32 direction;
147	__u32 ep;
148} __packed;
149
150/**
151 * struct usbip_header_cmd_submit - USBIP_CMD_SUBMIT packet header
152 * @transfer_flags: URB flags
153 * @transfer_buffer_length: the data size for (in) or (out) transfer
154 * @start_frame: initial frame for isochronous or interrupt transfers
155 * @number_of_packets: number of isochronous packets
156 * @interval: maximum time for the request on the server-side host controller
157 * @setup: setup data for a control request
158 */
159struct usbip_header_cmd_submit {
160	__u32 transfer_flags;
161	__s32 transfer_buffer_length;
162
163	/* it is difficult for usbip to sync frames (reserved only?) */
164	__s32 start_frame;
165	__s32 number_of_packets;
166	__s32 interval;
167
168	unsigned char setup[8];
169} __packed;
170
171/**
172 * struct usbip_header_ret_submit - USBIP_RET_SUBMIT packet header
173 * @status: return status of a non-iso request
174 * @actual_length: number of bytes transferred
175 * @start_frame: initial frame for isochronous or interrupt transfers
176 * @number_of_packets: number of isochronous packets
177 * @error_count: number of errors for isochronous transfers
178 */
179struct usbip_header_ret_submit {
180	__s32 status;
181	__s32 actual_length;
182	__s32 start_frame;
183	__s32 number_of_packets;
184	__s32 error_count;
185} __packed;
186
187/**
188 * struct usbip_header_cmd_unlink - USBIP_CMD_UNLINK packet header
189 * @seqnum: the URB seqnum to unlink
190 */
191struct usbip_header_cmd_unlink {
192	__u32 seqnum;
193} __packed;
194
195/**
196 * struct usbip_header_ret_unlink - USBIP_RET_UNLINK packet header
197 * @status: return status of the request
198 */
199struct usbip_header_ret_unlink {
200	__s32 status;
201} __packed;
202
203/**
204 * struct usbip_header - common header for all usbip packets
205 * @base: the basic header
206 * @u: packet type dependent header
207 */
208struct usbip_header {
209	struct usbip_header_basic base;
210
211	union {
212		struct usbip_header_cmd_submit	cmd_submit;
213		struct usbip_header_ret_submit	ret_submit;
214		struct usbip_header_cmd_unlink	cmd_unlink;
215		struct usbip_header_ret_unlink	ret_unlink;
216	} u;
217} __packed;
218
219/*
220 * This is the same as usb_iso_packet_descriptor but packed for pdu.
221 */
222struct usbip_iso_packet_descriptor {
223	__u32 offset;
224	__u32 length;			/* expected length */
225	__u32 actual_length;
226	__u32 status;
227} __packed;
228
229enum usbip_side {
230	USBIP_VHCI,
231	USBIP_STUB,
232	USBIP_VUDC,
233};
234
235/* event handler */
236#define USBIP_EH_SHUTDOWN	(1 << 0)
237#define USBIP_EH_BYE		(1 << 1)
238#define USBIP_EH_RESET		(1 << 2)
239#define USBIP_EH_UNUSABLE	(1 << 3)
240
241#define	SDEV_EVENT_REMOVED	(USBIP_EH_SHUTDOWN | USBIP_EH_BYE)
242#define	SDEV_EVENT_DOWN		(USBIP_EH_SHUTDOWN | USBIP_EH_RESET)
243#define	SDEV_EVENT_ERROR_TCP	(USBIP_EH_SHUTDOWN | USBIP_EH_RESET)
244#define	SDEV_EVENT_ERROR_SUBMIT	(USBIP_EH_SHUTDOWN | USBIP_EH_RESET)
245#define	SDEV_EVENT_ERROR_MALLOC	(USBIP_EH_SHUTDOWN | USBIP_EH_UNUSABLE)
246
247#define VUDC_EVENT_REMOVED   (USBIP_EH_SHUTDOWN | USBIP_EH_RESET | USBIP_EH_BYE)
248#define	VUDC_EVENT_DOWN		(USBIP_EH_SHUTDOWN | USBIP_EH_RESET)
249#define	VUDC_EVENT_ERROR_TCP	(USBIP_EH_SHUTDOWN | USBIP_EH_RESET)
250/* catastrophic emulated usb error */
251#define	VUDC_EVENT_ERROR_USB	(USBIP_EH_SHUTDOWN | USBIP_EH_UNUSABLE)
252#define	VUDC_EVENT_ERROR_MALLOC	(USBIP_EH_SHUTDOWN | USBIP_EH_UNUSABLE)
253
254#define	VDEV_EVENT_REMOVED (USBIP_EH_SHUTDOWN | USBIP_EH_RESET | USBIP_EH_BYE)
255#define	VDEV_EVENT_DOWN		(USBIP_EH_SHUTDOWN | USBIP_EH_RESET)
256#define	VDEV_EVENT_ERROR_TCP	(USBIP_EH_SHUTDOWN | USBIP_EH_RESET)
257#define	VDEV_EVENT_ERROR_MALLOC	(USBIP_EH_SHUTDOWN | USBIP_EH_UNUSABLE)
258
259/* a common structure for stub_device and vhci_device */
260struct usbip_device {
261	enum usbip_side side;
262	enum usbip_device_status status;
263
264	/* lock for status */
265	spinlock_t lock;
266
267	/* mutex for synchronizing sysfs store paths */
268	struct mutex sysfs_lock;
269
270	int sockfd;
271	struct socket *tcp_socket;
272
273	struct task_struct *tcp_rx;
274	struct task_struct *tcp_tx;
275
276	unsigned long event;
277	wait_queue_head_t eh_waitq;
278
279	struct eh_ops {
280		void (*shutdown)(struct usbip_device *);
281		void (*reset)(struct usbip_device *);
282		void (*unusable)(struct usbip_device *);
283	} eh_ops;
284
285#ifdef CONFIG_KCOV
286	u64 kcov_handle;
287#endif
288};
289
290#define kthread_get_run(threadfn, data, namefmt, ...)			   \
291({									   \
292	struct task_struct *__k						   \
293		= kthread_create(threadfn, data, namefmt, ## __VA_ARGS__); \
294	if (!IS_ERR(__k)) {						   \
295		get_task_struct(__k);					   \
296		wake_up_process(__k);					   \
297	}								   \
298	__k;								   \
299})
300
 
 
 
 
 
 
301/* usbip_common.c */
302void usbip_dump_urb(struct urb *purb);
303void usbip_dump_header(struct usbip_header *pdu);
304
305int usbip_recv(struct socket *sock, void *buf, int size);
306
307void usbip_pack_pdu(struct usbip_header *pdu, struct urb *urb, int cmd,
308		    int pack);
309void usbip_header_correct_endian(struct usbip_header *pdu, int send);
310
311struct usbip_iso_packet_descriptor*
312usbip_alloc_iso_desc_pdu(struct urb *urb, ssize_t *bufflen);
313
314/* some members of urb must be substituted before. */
315int usbip_recv_iso(struct usbip_device *ud, struct urb *urb);
316void usbip_pad_iso(struct usbip_device *ud, struct urb *urb);
317int usbip_recv_xbuff(struct usbip_device *ud, struct urb *urb);
318
319/* usbip_event.c */
320int usbip_init_eh(void);
321void usbip_finish_eh(void);
322int usbip_start_eh(struct usbip_device *ud);
323void usbip_stop_eh(struct usbip_device *ud);
324void usbip_event_add(struct usbip_device *ud, unsigned long event);
325int usbip_event_happened(struct usbip_device *ud);
326int usbip_in_eh(struct task_struct *task);
327
328static inline int interface_to_busnum(struct usb_interface *interface)
329{
330	struct usb_device *udev = interface_to_usbdev(interface);
331
332	return udev->bus->busnum;
333}
334
335static inline int interface_to_devnum(struct usb_interface *interface)
336{
337	struct usb_device *udev = interface_to_usbdev(interface);
338
339	return udev->devnum;
340}
341
342#ifdef CONFIG_KCOV
343
344static inline void usbip_kcov_handle_init(struct usbip_device *ud)
345{
346	ud->kcov_handle = kcov_common_handle();
347}
348
349static inline void usbip_kcov_remote_start(struct usbip_device *ud)
350{
351	kcov_remote_start_common(ud->kcov_handle);
352}
353
354static inline void usbip_kcov_remote_stop(void)
355{
356	kcov_remote_stop();
357}
358
359#else /* CONFIG_KCOV */
360
361static inline void usbip_kcov_handle_init(struct usbip_device *ud) { }
362static inline void usbip_kcov_remote_start(struct usbip_device *ud) { }
363static inline void usbip_kcov_remote_stop(void) { }
364
365#endif /* CONFIG_KCOV */
366
367#endif /* __USBIP_COMMON_H */
v4.17
  1// SPDX-License-Identifier: GPL-2.0+
  2/*
  3 * Copyright (C) 2003-2008 Takahiro Hirofuchi
  4 * Copyright (C) 2015-2016 Samsung Electronics
  5 *               Krzysztof Opasiak <k.opasiak@samsung.com>
  6 */
  7
  8#ifndef __USBIP_COMMON_H
  9#define __USBIP_COMMON_H
 10
 11#include <linux/compiler.h>
 12#include <linux/device.h>
 13#include <linux/interrupt.h>
 14#include <linux/net.h>
 15#include <linux/printk.h>
 16#include <linux/spinlock.h>
 17#include <linux/types.h>
 18#include <linux/usb.h>
 19#include <linux/wait.h>
 20#include <linux/sched/task.h>
 
 21#include <uapi/linux/usbip.h>
 22
 23#undef pr_fmt
 24
 25#ifdef DEBUG
 26#define pr_fmt(fmt)     KBUILD_MODNAME ": %s:%d: " fmt, __func__, __LINE__
 27#else
 28#define pr_fmt(fmt)     KBUILD_MODNAME ": " fmt
 29#endif
 30
 31enum {
 32	usbip_debug_xmit	= (1 << 0),
 33	usbip_debug_sysfs	= (1 << 1),
 34	usbip_debug_urb		= (1 << 2),
 35	usbip_debug_eh		= (1 << 3),
 36
 37	usbip_debug_stub_cmp	= (1 << 8),
 38	usbip_debug_stub_dev	= (1 << 9),
 39	usbip_debug_stub_rx	= (1 << 10),
 40	usbip_debug_stub_tx	= (1 << 11),
 41
 42	usbip_debug_vhci_rh	= (1 << 8),
 43	usbip_debug_vhci_hc	= (1 << 9),
 44	usbip_debug_vhci_rx	= (1 << 10),
 45	usbip_debug_vhci_tx	= (1 << 11),
 46	usbip_debug_vhci_sysfs  = (1 << 12)
 47};
 48
 49#define usbip_dbg_flag_xmit	(usbip_debug_flag & usbip_debug_xmit)
 50#define usbip_dbg_flag_vhci_rh	(usbip_debug_flag & usbip_debug_vhci_rh)
 51#define usbip_dbg_flag_vhci_hc	(usbip_debug_flag & usbip_debug_vhci_hc)
 52#define usbip_dbg_flag_vhci_rx	(usbip_debug_flag & usbip_debug_vhci_rx)
 53#define usbip_dbg_flag_vhci_tx	(usbip_debug_flag & usbip_debug_vhci_tx)
 54#define usbip_dbg_flag_stub_rx	(usbip_debug_flag & usbip_debug_stub_rx)
 55#define usbip_dbg_flag_stub_tx	(usbip_debug_flag & usbip_debug_stub_tx)
 56#define usbip_dbg_flag_vhci_sysfs  (usbip_debug_flag & usbip_debug_vhci_sysfs)
 57
 58extern unsigned long usbip_debug_flag;
 59extern struct device_attribute dev_attr_usbip_debug;
 60
 61#define usbip_dbg_with_flag(flag, fmt, args...)		\
 62	do {						\
 63		if (flag & usbip_debug_flag)		\
 64			pr_debug(fmt, ##args);		\
 65	} while (0)
 66
 67#define usbip_dbg_sysfs(fmt, args...) \
 68	usbip_dbg_with_flag(usbip_debug_sysfs, fmt , ##args)
 69#define usbip_dbg_xmit(fmt, args...) \
 70	usbip_dbg_with_flag(usbip_debug_xmit, fmt , ##args)
 71#define usbip_dbg_urb(fmt, args...) \
 72	usbip_dbg_with_flag(usbip_debug_urb, fmt , ##args)
 73#define usbip_dbg_eh(fmt, args...) \
 74	usbip_dbg_with_flag(usbip_debug_eh, fmt , ##args)
 75
 76#define usbip_dbg_vhci_rh(fmt, args...)	\
 77	usbip_dbg_with_flag(usbip_debug_vhci_rh, fmt , ##args)
 78#define usbip_dbg_vhci_hc(fmt, args...)	\
 79	usbip_dbg_with_flag(usbip_debug_vhci_hc, fmt , ##args)
 80#define usbip_dbg_vhci_rx(fmt, args...)	\
 81	usbip_dbg_with_flag(usbip_debug_vhci_rx, fmt , ##args)
 82#define usbip_dbg_vhci_tx(fmt, args...)	\
 83	usbip_dbg_with_flag(usbip_debug_vhci_tx, fmt , ##args)
 84#define usbip_dbg_vhci_sysfs(fmt, args...) \
 85	usbip_dbg_with_flag(usbip_debug_vhci_sysfs, fmt , ##args)
 86
 87#define usbip_dbg_stub_cmp(fmt, args...) \
 88	usbip_dbg_with_flag(usbip_debug_stub_cmp, fmt , ##args)
 89#define usbip_dbg_stub_rx(fmt, args...) \
 90	usbip_dbg_with_flag(usbip_debug_stub_rx, fmt , ##args)
 91#define usbip_dbg_stub_tx(fmt, args...) \
 92	usbip_dbg_with_flag(usbip_debug_stub_tx, fmt , ##args)
 93
 94/*
 95 * USB/IP request headers
 96 *
 97 * Each request is transferred across the network to its counterpart, which
 98 * facilitates the normal USB communication. The values contained in the headers
 99 * are basically the same as in a URB. Currently, four request types are
100 * defined:
101 *
102 *  - USBIP_CMD_SUBMIT: a USB request block, corresponds to usb_submit_urb()
103 *    (client to server)
104 *
105 *  - USBIP_RET_SUBMIT: the result of USBIP_CMD_SUBMIT
106 *    (server to client)
107 *
108 *  - USBIP_CMD_UNLINK: an unlink request of a pending USBIP_CMD_SUBMIT,
109 *    corresponds to usb_unlink_urb()
110 *    (client to server)
111 *
112 *  - USBIP_RET_UNLINK: the result of USBIP_CMD_UNLINK
113 *    (server to client)
114 *
115 */
116#define USBIP_CMD_SUBMIT	0x0001
117#define USBIP_CMD_UNLINK	0x0002
118#define USBIP_RET_SUBMIT	0x0003
119#define USBIP_RET_UNLINK	0x0004
120
121#define USBIP_DIR_OUT	0x00
122#define USBIP_DIR_IN	0x01
123
 
 
 
 
 
 
 
124/**
125 * struct usbip_header_basic - data pertinent to every request
126 * @command: the usbip request type
127 * @seqnum: sequential number that identifies requests; incremented per
128 *	    connection
129 * @devid: specifies a remote USB device uniquely instead of busnum and devnum;
130 *	   in the stub driver, this value is ((busnum << 16) | devnum)
131 * @direction: direction of the transfer
132 * @ep: endpoint number
133 */
134struct usbip_header_basic {
135	__u32 command;
136	__u32 seqnum;
137	__u32 devid;
138	__u32 direction;
139	__u32 ep;
140} __packed;
141
142/**
143 * struct usbip_header_cmd_submit - USBIP_CMD_SUBMIT packet header
144 * @transfer_flags: URB flags
145 * @transfer_buffer_length: the data size for (in) or (out) transfer
146 * @start_frame: initial frame for isochronous or interrupt transfers
147 * @number_of_packets: number of isochronous packets
148 * @interval: maximum time for the request on the server-side host controller
149 * @setup: setup data for a control request
150 */
151struct usbip_header_cmd_submit {
152	__u32 transfer_flags;
153	__s32 transfer_buffer_length;
154
155	/* it is difficult for usbip to sync frames (reserved only?) */
156	__s32 start_frame;
157	__s32 number_of_packets;
158	__s32 interval;
159
160	unsigned char setup[8];
161} __packed;
162
163/**
164 * struct usbip_header_ret_submit - USBIP_RET_SUBMIT packet header
165 * @status: return status of a non-iso request
166 * @actual_length: number of bytes transferred
167 * @start_frame: initial frame for isochronous or interrupt transfers
168 * @number_of_packets: number of isochronous packets
169 * @error_count: number of errors for isochronous transfers
170 */
171struct usbip_header_ret_submit {
172	__s32 status;
173	__s32 actual_length;
174	__s32 start_frame;
175	__s32 number_of_packets;
176	__s32 error_count;
177} __packed;
178
179/**
180 * struct usbip_header_cmd_unlink - USBIP_CMD_UNLINK packet header
181 * @seqnum: the URB seqnum to unlink
182 */
183struct usbip_header_cmd_unlink {
184	__u32 seqnum;
185} __packed;
186
187/**
188 * struct usbip_header_ret_unlink - USBIP_RET_UNLINK packet header
189 * @status: return status of the request
190 */
191struct usbip_header_ret_unlink {
192	__s32 status;
193} __packed;
194
195/**
196 * struct usbip_header - common header for all usbip packets
197 * @base: the basic header
198 * @u: packet type dependent header
199 */
200struct usbip_header {
201	struct usbip_header_basic base;
202
203	union {
204		struct usbip_header_cmd_submit	cmd_submit;
205		struct usbip_header_ret_submit	ret_submit;
206		struct usbip_header_cmd_unlink	cmd_unlink;
207		struct usbip_header_ret_unlink	ret_unlink;
208	} u;
209} __packed;
210
211/*
212 * This is the same as usb_iso_packet_descriptor but packed for pdu.
213 */
214struct usbip_iso_packet_descriptor {
215	__u32 offset;
216	__u32 length;			/* expected length */
217	__u32 actual_length;
218	__u32 status;
219} __packed;
220
221enum usbip_side {
222	USBIP_VHCI,
223	USBIP_STUB,
224	USBIP_VUDC,
225};
226
227/* event handler */
228#define USBIP_EH_SHUTDOWN	(1 << 0)
229#define USBIP_EH_BYE		(1 << 1)
230#define USBIP_EH_RESET		(1 << 2)
231#define USBIP_EH_UNUSABLE	(1 << 3)
232
233#define	SDEV_EVENT_REMOVED	(USBIP_EH_SHUTDOWN | USBIP_EH_BYE)
234#define	SDEV_EVENT_DOWN		(USBIP_EH_SHUTDOWN | USBIP_EH_RESET)
235#define	SDEV_EVENT_ERROR_TCP	(USBIP_EH_SHUTDOWN | USBIP_EH_RESET)
236#define	SDEV_EVENT_ERROR_SUBMIT	(USBIP_EH_SHUTDOWN | USBIP_EH_RESET)
237#define	SDEV_EVENT_ERROR_MALLOC	(USBIP_EH_SHUTDOWN | USBIP_EH_UNUSABLE)
238
239#define VUDC_EVENT_REMOVED   (USBIP_EH_SHUTDOWN | USBIP_EH_RESET | USBIP_EH_BYE)
240#define	VUDC_EVENT_DOWN		(USBIP_EH_SHUTDOWN | USBIP_EH_RESET)
241#define	VUDC_EVENT_ERROR_TCP	(USBIP_EH_SHUTDOWN | USBIP_EH_RESET)
242/* catastrophic emulated usb error */
243#define	VUDC_EVENT_ERROR_USB	(USBIP_EH_SHUTDOWN | USBIP_EH_UNUSABLE)
244#define	VUDC_EVENT_ERROR_MALLOC	(USBIP_EH_SHUTDOWN | USBIP_EH_UNUSABLE)
245
246#define	VDEV_EVENT_REMOVED (USBIP_EH_SHUTDOWN | USBIP_EH_RESET | USBIP_EH_BYE)
247#define	VDEV_EVENT_DOWN		(USBIP_EH_SHUTDOWN | USBIP_EH_RESET)
248#define	VDEV_EVENT_ERROR_TCP	(USBIP_EH_SHUTDOWN | USBIP_EH_RESET)
249#define	VDEV_EVENT_ERROR_MALLOC	(USBIP_EH_SHUTDOWN | USBIP_EH_UNUSABLE)
250
251/* a common structure for stub_device and vhci_device */
252struct usbip_device {
253	enum usbip_side side;
254	enum usbip_device_status status;
255
256	/* lock for status */
257	spinlock_t lock;
258
 
 
 
259	int sockfd;
260	struct socket *tcp_socket;
261
262	struct task_struct *tcp_rx;
263	struct task_struct *tcp_tx;
264
265	unsigned long event;
266	wait_queue_head_t eh_waitq;
267
268	struct eh_ops {
269		void (*shutdown)(struct usbip_device *);
270		void (*reset)(struct usbip_device *);
271		void (*unusable)(struct usbip_device *);
272	} eh_ops;
 
 
 
 
273};
274
275#define kthread_get_run(threadfn, data, namefmt, ...)			   \
276({									   \
277	struct task_struct *__k						   \
278		= kthread_create(threadfn, data, namefmt, ## __VA_ARGS__); \
279	if (!IS_ERR(__k)) {						   \
280		get_task_struct(__k);					   \
281		wake_up_process(__k);					   \
282	}								   \
283	__k;								   \
284})
285
286#define kthread_stop_put(k)		\
287	do {				\
288		kthread_stop(k);	\
289		put_task_struct(k);	\
290	} while (0)
291
292/* usbip_common.c */
293void usbip_dump_urb(struct urb *purb);
294void usbip_dump_header(struct usbip_header *pdu);
295
296int usbip_recv(struct socket *sock, void *buf, int size);
297
298void usbip_pack_pdu(struct usbip_header *pdu, struct urb *urb, int cmd,
299		    int pack);
300void usbip_header_correct_endian(struct usbip_header *pdu, int send);
301
302struct usbip_iso_packet_descriptor*
303usbip_alloc_iso_desc_pdu(struct urb *urb, ssize_t *bufflen);
304
305/* some members of urb must be substituted before. */
306int usbip_recv_iso(struct usbip_device *ud, struct urb *urb);
307void usbip_pad_iso(struct usbip_device *ud, struct urb *urb);
308int usbip_recv_xbuff(struct usbip_device *ud, struct urb *urb);
309
310/* usbip_event.c */
311int usbip_init_eh(void);
312void usbip_finish_eh(void);
313int usbip_start_eh(struct usbip_device *ud);
314void usbip_stop_eh(struct usbip_device *ud);
315void usbip_event_add(struct usbip_device *ud, unsigned long event);
316int usbip_event_happened(struct usbip_device *ud);
317int usbip_in_eh(struct task_struct *task);
318
319static inline int interface_to_busnum(struct usb_interface *interface)
320{
321	struct usb_device *udev = interface_to_usbdev(interface);
322
323	return udev->bus->busnum;
324}
325
326static inline int interface_to_devnum(struct usb_interface *interface)
327{
328	struct usb_device *udev = interface_to_usbdev(interface);
329
330	return udev->devnum;
331}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
332
333#endif /* __USBIP_COMMON_H */