USBIP(8)

✨ USBIP(8) — usbip 💖

Okay so, usbip is the manage-USB/IP-devices tool, and it is literally the thing you reach for to manage USB/IP devices 🧚.

💅 NAME

usbip — manage USB/IP devices 🎀

🦋 SYNOPSIS

usbip [options] <command> <args>

🌸 DESCRIPTION

Okay bestie, listen up 👑. On a USB/IP server, you can list, bind, and unbind devices with this program. On a USB/IP client, you can list, attach, and detach devices that USB/IP servers are exporting. It's giving full control ✨.

🍓 OPTIONS

• --debug — Prints debugging info 🙈.
• --log — Logs to syslog 📝.
• --tcp-port PORT — Connects to PORT on the remote host. This is used for attach and list --remote 🔌.

🔥 COMMANDS

• version — Shows the version and exits 💜.
• help [command] — Prints the program help message, or help for one specific command, then exits 🫶.
• attach --remote=<host> --busid=<bus_id> — Attaches a remote USB device 🦋.
• attach --remote=<host> --device=<dev_id> — Attaches a remote USB gadget. Only works when the remote usbipd is in device mode 🧚.
• detach --port=<port> — Detaches an imported USB device/gadget 💀.
• bind --busid=<busid> — Makes a device exportable 🌈.
• unbind --busid=<busid> — Stops exporting a device so a local driver can use it 🍓.
• list --remote=<host> — Lists USB devices exported by a remote host 👀.
• list --device — Lists USB gadgets of the local usbip-vudc. Only used when the local usbipd is in device mode. Heads up: this can NOT list usbip-vudc USB gadgets of a remote device-mode usbipd 🙅‍♀️.
• list --local — Lists local USB devices 🌸.
• port — Lists imported devices/gadgets ✨.

⚠️ Heads up: list --device can't see gadgets on a remote device-mode usbipd. Only the local one, periodt 💀.

🎀 EXAMPLES

Okay, here's the basic vibe:

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 how device mode works 🧚

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) — check it out, bestie 👑

Source: usbip, Sys Admin Utilities, February 2009 🌈 Stay iconic, bestie 💖✨