2011-05-14 10:55:07 +00:00
|
|
|
.TH USBIP "8" "February 2009" "usbip" "System Administration Utilities"
|
|
|
|
.SH NAME
|
|
|
|
usbip \- manage USB/IP devices
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B usbip
|
2013-09-09 14:13:15 +00:00
|
|
|
[\fIoptions\fR] <\fIcommand\fR> <\fIargs\fR>
|
2011-05-14 10:55:07 +00:00
|
|
|
|
|
|
|
.SH DESCRIPTION
|
2012-08-17 10:49:37 +00:00
|
|
|
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.
|
2011-05-14 10:55:07 +00:00
|
|
|
|
|
|
|
.SH OPTIONS
|
|
|
|
.HP
|
2012-08-17 10:49:37 +00:00
|
|
|
\fB\-\-debug\fR
|
2011-05-14 10:55:07 +00:00
|
|
|
.IP
|
2012-08-17 10:49:37 +00:00
|
|
|
Print debugging information.
|
|
|
|
.PP
|
|
|
|
|
|
|
|
.HP
|
|
|
|
\fB\-\-log\fR
|
|
|
|
.IP
|
|
|
|
Log to syslog.
|
|
|
|
.PP
|
|
|
|
|
2013-09-09 14:13:15 +00:00
|
|
|
.HP
|
|
|
|
\fB\-\-tcp-port PORT\fR
|
|
|
|
.IP
|
|
|
|
Connect to PORT on remote host (used for attach and list --remote).
|
|
|
|
.PP
|
|
|
|
|
2012-08-17 10:49:37 +00:00
|
|
|
.SH COMMANDS
|
|
|
|
.HP
|
|
|
|
\fBversion\fR
|
|
|
|
.IP
|
|
|
|
Show version and exit.
|
2011-05-14 10:55:07 +00:00
|
|
|
.PP
|
|
|
|
|
|
|
|
.HP
|
2012-08-17 10:49:37 +00:00
|
|
|
\fBhelp\fR [\fIcommand\fR]
|
2011-05-14 10:55:07 +00:00
|
|
|
.IP
|
2012-08-17 10:49:37 +00:00
|
|
|
Print the program help message, or help on a specific command, and
|
|
|
|
then exit.
|
2011-05-14 10:55:07 +00:00
|
|
|
.PP
|
|
|
|
|
|
|
|
.HP
|
2013-04-04 14:03:15 +00:00
|
|
|
\fBattach\fR \-\-remote=<\fIhost\fR> \-\-busid=<\fIbus_id\fR>
|
2012-08-17 10:49:37 +00:00
|
|
|
.IP
|
|
|
|
Attach a remote USB device.
|
|
|
|
.PP
|
|
|
|
|
|
|
|
.HP
|
|
|
|
\fBdetach\fR \-\-port=<\fIport\fR>
|
2011-05-14 10:55:07 +00:00
|
|
|
.IP
|
|
|
|
Detach an imported USB device.
|
|
|
|
.PP
|
|
|
|
|
|
|
|
.HP
|
2012-08-17 10:49:37 +00:00
|
|
|
\fBbind\fR \-\-busid=<\fIbusid\fR>
|
2011-05-14 10:55:07 +00:00
|
|
|
.IP
|
2012-08-17 10:49:37 +00:00
|
|
|
Make a device exportable.
|
2011-05-14 10:55:07 +00:00
|
|
|
.PP
|
|
|
|
|
|
|
|
.HP
|
2012-08-17 10:49:37 +00:00
|
|
|
\fBunbind\fR \-\-busid=<\fIbusid\fR>
|
2011-05-14 10:55:07 +00:00
|
|
|
.IP
|
2012-08-17 10:49:37 +00:00
|
|
|
Stop exporting a device so it can be used by a local driver.
|
2011-05-14 10:55:07 +00:00
|
|
|
.PP
|
|
|
|
|
|
|
|
.HP
|
2012-08-17 10:49:37 +00:00
|
|
|
\fBlist\fR \-\-remote=<\fIhost\fR>
|
2011-05-14 10:55:07 +00:00
|
|
|
.IP
|
2012-08-17 10:49:37 +00:00
|
|
|
List USB devices exported by a remote host.
|
2011-05-14 10:55:07 +00:00
|
|
|
.PP
|
|
|
|
|
|
|
|
.HP
|
2012-08-17 10:49:37 +00:00
|
|
|
\fBlist\fR \-\-local
|
2011-05-14 10:55:07 +00:00
|
|
|
.IP
|
2012-08-17 10:49:37 +00:00
|
|
|
List local USB devices.
|
2011-05-14 10:55:07 +00:00
|
|
|
.PP
|
|
|
|
|
2012-08-17 10:49:37 +00:00
|
|
|
|
2011-05-14 10:55:07 +00:00
|
|
|
.SH EXAMPLES
|
|
|
|
|
2012-08-17 10:49:37 +00:00
|
|
|
client:# usbip list --remote=server
|
2011-05-14 10:55:07 +00:00
|
|
|
- List exportable usb devices on the server.
|
|
|
|
|
2013-04-04 14:03:15 +00:00
|
|
|
client:# usbip attach --remote=server --busid=1-2
|
2011-05-14 10:55:07 +00:00
|
|
|
- Connect the remote USB device.
|
|
|
|
|
2012-08-17 10:49:37 +00:00
|
|
|
client:# usbip detach --port=0
|
2011-05-14 10:55:07 +00:00
|
|
|
- Detach the usb device.
|
|
|
|
|
|
|
|
.SH "SEE ALSO"
|
2012-08-17 10:49:37 +00:00
|
|
|
\fBusbipd\fP\fB(8)\fB\fP
|