usbip - Man Page
manage USB/IP devices
Examples (TL;DR)
- List all local USB devices and their bus ID's:
usbip list --local
- Start a
usbip
daemon on the server:systemctl start usbipd
- Bind a USB device to
usbip
on the server:sudo usbip bind --busid=bus_id
- Load the kernel module required by
usbip
on the client:sudo modprobe vhci-hcd
- Attach to the
usbip
device on the client (bus ID is the same as on the server):sudo usbip attach -r ip_address --busid=bus_id
- List attached devices:
usbip port
- Detach from a device:
sudo usbip detach --port=port
- Unbind a device:
usbip unbind --busid=bus_id
Synopsis
usbip [options] <command> <args>
Description
On a USB/IP server, devices can be listed, bound, and unbound using this program. On a USB/IP client, devices exported by USB/IP servers can be listed, attached and detached.
Options
- --debug
- Print debugging information.
- --log
- Log to syslog.
- --tcp-port PORT
- Connect to PORT on remote host (used for attach and list --remote).
Commands
- version
Show version and exit.
- help [command]
Print the program help message, or help on a specific command, and then exit.
- attach --remote=<host> --busid=<bus_id>
Attach a remote USB device.
- detach --port=<port>
Detach an imported USB device.
- bind --busid=<busid>
Make a device exportable.
- unbind --busid=<busid>
Stop exporting a device so it can be used by a local driver.
- list --remote=<host>
List USB devices exported by a remote host.
- list --local
List local USB devices.
Examples
client:# usbip list --remote=server
- List exportable usb devices on the server.
client:# usbip attach --remote=server --busid=1-2
- Connect the remote USB device.
client:# usbip detach --port=0
- Detach the usb device.