---
name: "usbip"
section: "8"
platform: "linux"
package: "usbip"
version: "7.3.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/usbip"
---

# usbip(8)

manage USB/IP devices

## 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)](/usbipd/8.md)**