xref: /openbmc/linux/tools/usb/usbip/doc/usbipd.8 (revision 710b797c)
USBIP "8" "February 2009" "usbip" "System Administration Utilities"
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.
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 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.
"SEE ALSO"
usbip(8)