xref: /openbmc/linux/tools/usb/usbip/doc/usbip.8 (revision 3cf3cdea)
USBIP "8" "February 2009" "usbip" "System Administration Utilities"
NAME
usbip - manage USB/IP devices
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.

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.
"SEE ALSO"
usbipd(8)