NAME
usbipd - USB/IP server daemon
SYNOPSIS
usbipd [options]
DESCRIPTION
usbipd provides USB/IP clients access to exported USB devices.
Devices have to explicitly be exported using usbip bind before usbipd makes them available to other hosts.
The daemon accepts connections from USB/IP clients on TCP port 3240 by default. The clients authorised to connect may be configured as documented in hosts_access(5).
OPTIONS
-4, --ipv4 |
Bind to IPv4. Default is both.
-6, --ipv6 |
Bind to IPv6. Default is both.
-e, --device |
Run in device mode. Rather than drive an attached device, create a virtual UDC to bind gadgets to.
-D, --daemon |
Run as a daemon process.
-d, --debug |
Print debugging information.
-PFILE, --pid FILE |
Write process
id to FILE.
If no FILE specified, use /var/run/usbipd.pid
-tPORT, --tcp-port PORT
Listen on TCP/IP port PORT.
-h, --help
Print the program help message and exit.
-v, --version |
Show version.
LIMITATIONS
usbipd offers no authentication or authorization for USB/IP. Any USB/IP client running on an authorised host can connect and use exported devices.
EXAMPLES
server:# modprobe usbip-host
server:# usbipd
-D
- Start usbip daemon.
server:# usbip
list --local
- List driver assignments for usb devices.
server:# usbip
bind --busid=1-2
- Bind usbip-host.ko to the device of busid 1-2.
- A usb device 1-2 is now exportable to other hosts!
- Use ’usbip unbind --busid=1-2’ when you want
to shutdown exporting and use the device locally.
The following example shows the usage of device mode
server:#
modprobe usbip-vudc
- Use /sys/class/udc/ interface.
- usbip-host is independent of this module.
server:# usbipd
-e -D
- Start usbip daemon in device mode.
server:#
modprobe g_mass_storage file=/tmp/tmp.img
- Bind a gadget to usbip-vudc.
- in this example, a mass storage gadget is bound.
server:# usbip
list --device
- List gadgets exported by local usbipd server.
server:#
modprobe -r g_mass_storage
- Unbind a gadget from usbip-vudc.
- in this example, the previous mass storage gadget is
unbound.