usbip8
Manage usb/ip devices
Usage
usbip [options]
<command>
<args>
Overview
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.
attach --remote=<host> --device=<dev_id>
-
Attach a remote USB gadget. Only used when the remote usbipd is in device mode.
detach --port=<port>
-
Detach an imported USB device/gadget.
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 --device
-
List USB gadgets of local usbip-vudc. Only used when the local usbipd is in device mode. Note that this can not list usbip-vudc USB gadgets of the remote device mode usbipd.
list --local
-
List local USB devices.
port
-
List imported devices/gadgets.
Examples
client:# usbip list --remote=server
- List devices exported by remote server.
client:# modprobe vhci-hcd
client:# usbip attach --remote=server --busid=1-2
- Connect the remote USB device.
client:# usbip port
- List imported devices/gadgets.
client:# usbip detach --port=0
- Detach the usb device.
The following example shows the usage of device mode
server:# usbip list --device
- List gadgets exported by local usbipd server.
client:# modprobe vhci-hcd
client:# usbip attach --remote=server --device=usbip-vudc.0
- Connect the remote USB gadget.
client:# usbip port
- List imported devices/gadgets.
client:# usbip detach --port=0
- Detach the usb gadget.
Releases
9 releases since Debian 6.0 (Squeeze); the text changed 4 times.