^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) .TH USBIP "8" "February 2009" "usbip" "System Administration Utilities"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) .SH NAME
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) usbip \- manage USB/IP devices
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) .SH SYNOPSIS
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) .B usbip
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) [\fIoptions\fR] <\fIcommand\fR> <\fIargs\fR>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) .SH DESCRIPTION
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) On a USB/IP server, devices can be listed, bound, and unbound using
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) this program. On a USB/IP client, devices exported by USB/IP servers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) can be listed, attached and detached.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) .SH OPTIONS
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) .HP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) \fB\-\-debug\fR
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) .IP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) Print debugging information.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) .PP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) .HP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) \fB\-\-log\fR
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) .IP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) Log to syslog.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) .PP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) .HP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) \fB\-\-tcp-port PORT\fR
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) .IP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) Connect to PORT on remote host (used for attach and list --remote).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) .PP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) .SH COMMANDS
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) .HP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) \fBversion\fR
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) .IP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) Show version and exit.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) .PP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) .HP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) \fBhelp\fR [\fIcommand\fR]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) .IP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) Print the program help message, or help on a specific command, and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) then exit.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) .PP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) .HP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) \fBattach\fR \-\-remote=<\fIhost\fR> \-\-busid=<\fIbus_id\fR>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) .IP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) Attach a remote USB device.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) .PP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) .HP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) \fBdetach\fR \-\-port=<\fIport\fR>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) .IP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) Detach an imported USB device.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) .PP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) .HP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) \fBbind\fR \-\-busid=<\fIbusid\fR>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) .IP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) Make a device exportable.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) .PP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) .HP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) \fBunbind\fR \-\-busid=<\fIbusid\fR>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) .IP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) Stop exporting a device so it can be used by a local driver.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) .PP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) .HP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) \fBlist\fR \-\-remote=<\fIhost\fR>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) .IP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) List USB devices exported by a remote host.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) .PP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) .HP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) \fBlist\fR \-\-local
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) .IP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) List local USB devices.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) .PP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) .SH EXAMPLES
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) client:# usbip list --remote=server
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) - List devices exported by remote server.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) client:# modprobe vhci-hcd
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) client:# usbip attach --remote=server --busid=1-2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) - Connect the remote USB device.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) client:# usbip detach --port=0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) - Detach the usb device.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) .SH "SEE ALSO"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) \fBusbipd\fP\fB(8)\fB\fP