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