dwww Home | Manual pages | Find package

USBIP(8)                System Administration Utilities               USBIP(8)

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 ex-
       porting 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)

usbip                            February 2009                        USBIP(8)

Generated by dwww version 1.14 on Fri Jan 24 14:22:09 CET 2025.