mirror of
https://github.com/jiegec/usbip.git
synced 2026-11-12 22:39:18 -05:00
ecc2154444
This also fixes the following: - Use consistent `path`/`busid` format for both default device and server - `debug_assert` that `path`/`busid` lengths don't overflow - Throw proper error message on old USB/IP version - Send proper USB/IP error on `USBIP_CMD_SUBMIT` with invalid `ep` - Flip wrongly placed traces for in/out transfer on `USBIP_CMD_SUBMIT` - Send proper USB/IP error on `USBIP_CMD_UNLINK` with no attached device - Handle `iso_packet_descriptor`s properly - Multiple `debug_assert`s during de/serialization to ensure sane behaviour
usbip
A Rust library to run a USB/IP server to simulate USB devices.
It also enables sharing devices from an OS supporting libusb(libusb claims that it supports Linux, macOS, Windows, OpenBSD/NetBSD, Haiku and Solaris) to another OS supporting USB/IP(Linux, Windows). Sharing an CCID SmartCard from macOS to Linux is tested by running gpg --card-status.
How to use
See examples directory. Three examples are provided:
- hid_keyboard: Simulate a hid keyboard that types something every second.
- cdc_acm_serial: Simulate a serial that gets a character every second.
- host: Act like original usb/ip sharing server, sharing one device from one machine to another. Also supports sharing from macOS to Linux!
To run example, run:
$ env RUST_LOG=info cargo run --example hid_keyboard
Then, in a USB/IP client environment:
$ usbip list -r $remote_ip
$ usbip attach -r $remote_ip -b $bus_id
Then, you can inspect the simulated USB device behavior in both sides.
API
See code comments. Not finalized yet, so get prepared for api breaking changes.