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)