118 lines · plain
1.TH USBIP "8" "February 2009" "usbip" "System Administration Utilities"2.SH NAME3usbipd \- USB/IP server daemon4.SH SYNOPSIS5.B usbipd6[\fIoptions\fR]7 8.SH DESCRIPTION9.B usbipd10provides USB/IP clients access to exported USB devices.11 12Devices have to explicitly be exported using13.B usbip bind14before usbipd makes them available to other hosts.15 16The daemon accepts connections from USB/IP clients17on TCP port 3240 by default.18 19.SH OPTIONS20.HP21\fB\-4\fR, \fB\-\-ipv4\fR22.IP23Bind to IPv4. Default is both.24.PP25 26.HP27\fB\-6\fR, \fB\-\-ipv6\fR28.IP29Bind to IPv6. Default is both.30.PP31 32.HP33\fB\-e\fR, \fB\-\-device\fR34.IP35Run in device mode. Rather than drive an attached device, create a virtual UDC to bind gadgets to.36.PP37 38.HP39\fB\-D\fR, \fB\-\-daemon\fR40.IP41Run as a daemon process.42.PP43 44.HP45\fB\-d\fR, \fB\-\-debug\fR46.IP47Print debugging information.48.PP49 50.HP51\fB\-PFILE\fR, \fB\-\-pid FILE\fR52.IP53Write process id to FILE.54.br55If no FILE specified, use /var/run/usbipd.pid56.PP57 58\fB\-tPORT\fR, \fB\-\-tcp\-port PORT\fR59.IP60Listen on TCP/IP port PORT.61.PP62 63\fB\-h\fR, \fB\-\-help\fR64.IP65Print the program help message and exit.66.PP67 68.HP69\fB\-v\fR, \fB\-\-version\fR70.IP71Show version.72.PP73 74.SH LIMITATIONS75 76.B usbipd77offers no authentication or authorization for USB/IP. Any78USB/IP client can connect and use exported devices.79 80.SH EXAMPLES81 82 server:# modprobe usbip-host83 84 server:# usbipd -D85 - Start usbip daemon.86 87 server:# usbip list --local88 - List driver assignments for usb devices.89 90 server:# usbip bind --busid=1-291 - Bind usbip-host.ko to the device of busid 1-2.92 - A usb device 1-2 is now exportable to other hosts!93 - Use 'usbip unbind --busid=1-2' when you want to shutdown exporting and use the device locally.94 95The following example shows the usage of device mode96 97 server:# modprobe usbip-vudc98 - Use /sys/class/udc/ interface.99 - usbip-host is independent of this module.100 101 server:# usbipd -e -D102 - Start usbip daemon in device mode.103 104 server:# modprobe g_mass_storage file=/tmp/tmp.img105 - Bind a gadget to usbip-vudc.106 - in this example, a mass storage gadget is bound.107 108 server:# usbip list --device109 - List gadgets exported by local usbipd server.110 111 server:# modprobe -r g_mass_storage112 - Unbind a gadget from usbip-vudc.113 - in this example, the previous mass storage gadget is unbound.114 115.SH "SEE ALSO"116\fBusbip\fP\fB(8)\fB\fP117 118