usbip.8 2.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137
  1. .TH USBIP "8" "February 2009" "usbip" "System Administration Utilities"
  2. .SH NAME
  3. usbip \- manage USB/IP devices
  4. .SH SYNOPSIS
  5. .B usbip
  6. [\fIoptions\fR] <\fIcommand\fR> <\fIargs\fR>
  7. .SH DESCRIPTION
  8. On a USB/IP server, devices can be listed, bound, and unbound using
  9. this program. On a USB/IP client, devices exported by USB/IP servers
  10. can be listed, attached and detached.
  11. .SH OPTIONS
  12. .HP
  13. \fB\-\-debug\fR
  14. .IP
  15. Print debugging information.
  16. .PP
  17. .HP
  18. \fB\-\-log\fR
  19. .IP
  20. Log to syslog.
  21. .PP
  22. .HP
  23. \fB\-\-tcp-port PORT\fR
  24. .IP
  25. Connect to PORT on remote host (used for attach and list --remote).
  26. .PP
  27. .SH COMMANDS
  28. .HP
  29. \fBversion\fR
  30. .IP
  31. Show version and exit.
  32. .PP
  33. .HP
  34. \fBhelp\fR [\fIcommand\fR]
  35. .IP
  36. Print the program help message, or help on a specific command, and
  37. then exit.
  38. .PP
  39. .HP
  40. \fBattach\fR \-\-remote=<\fIhost\fR> \-\-busid=<\fIbus_id\fR>
  41. .IP
  42. Attach a remote USB device.
  43. .PP
  44. .HP
  45. \fBattach\fR \-\-remote=<\fIhost\fR> \-\-device=<\fIdev_id\fR>
  46. .IP
  47. Attach a remote USB gadget.
  48. Only used when the remote usbipd is in device mode.
  49. .PP
  50. .HP
  51. \fBdetach\fR \-\-port=<\fIport\fR>
  52. .IP
  53. Detach an imported USB device/gadget.
  54. .PP
  55. .HP
  56. \fBbind\fR \-\-busid=<\fIbusid\fR>
  57. .IP
  58. Make a device exportable.
  59. .PP
  60. .HP
  61. \fBunbind\fR \-\-busid=<\fIbusid\fR>
  62. .IP
  63. Stop exporting a device so it can be used by a local driver.
  64. .PP
  65. .HP
  66. \fBlist\fR \-\-remote=<\fIhost\fR>
  67. .IP
  68. List USB devices exported by a remote host.
  69. .PP
  70. .HP
  71. \fBlist\fR \-\-device
  72. .IP
  73. List USB gadgets of local usbip-vudc.
  74. Only used when the local usbipd is in device mode.
  75. Note that this can not list usbip-vudc USB gadgets of the remote device mode usbipd.
  76. .PP
  77. .HP
  78. \fBlist\fR \-\-local
  79. .IP
  80. List local USB devices.
  81. .PP
  82. .HP
  83. \fBport\fR
  84. .IP
  85. List imported devices/gadgets.
  86. .PP
  87. .SH EXAMPLES
  88. client:# usbip list --remote=server
  89. - List devices exported by remote server.
  90. client:# modprobe vhci-hcd
  91. client:# usbip attach --remote=server --busid=1-2
  92. - Connect the remote USB device.
  93. client:# usbip port
  94. - List imported devices/gadgets.
  95. client:# usbip detach --port=0
  96. - Detach the usb device.
  97. The following example shows the usage of device mode
  98. server:# usbip list --device
  99. - List gadgets exported by local usbipd server.
  100. client:# modprobe vhci-hcd
  101. client:# usbip attach --remote=server --device=usbip-vudc.0
  102. - Connect the remote USB gadget.
  103. client:# usbip port
  104. - List imported devices/gadgets.
  105. client:# usbip detach --port=0
  106. - Detach the usb gadget.
  107. .SH "SEE ALSO"
  108. \fBusbipd\fP\fB(8)\fB\fP