summaryrefslogtreecommitdiff
path: root/README.md
blob: 5422241222aa7f3184d1a383918fbb96ad50f680 (plain)
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
# usbredir

usbredir is a protocol for redirection USB traffic from a single USB device,
to a different (virtual) machine then the one to which the USB device is
attached. See [usb-redirection-protocol.md](docs/usb-redirection-protocol.md)
for the description / definition of this protocol.

This package contains a number of libraries to help implementing support
for usbredir and a few simple usbredir applications:

## usbredirparser

A library containing the parser for the usbredir protocol

## usbredirhost

A library implementing the usb-host side of a usbredir connection, which is the
side to which the actual USB device is attached.

All that an application wishing to implement an usb-host needs to do is:
- Provide a libusb device handle for the device
- Provide write and read callbacks for the actual transport of usbredir data
- Monitor for usbredir and libusb read/write events and call their handlers

## usbredirserver

A simple tcp server usb-host, using usbredirhost

## usbredirtestclient

A small testclient for the usbredir protocol over tcp, using usbredirparser

The upstream git repository can be found at
http://gitlab.freedesktop.org/spice/usbredir

Bug reports can be filed against the Spice/usbredir component:
https://gitlab.freedesktop.org/spice/usbredir/issues

You can also send patches to the spice-devel mailing list:
http://lists.freedesktop.org/mailman/listinfo/spice-devel