linux/Documentation/usb
Shuah Khan 8f36b3b4e1 usbip: add USBIP_URB_* URB transfer flags
USBIP driver packs URB transfer flags in network packets that are
exchanged between Server (usbip_host) and Client (vhci_hcd).

URB_* flags are internal to kernel and could change. Where as USBIP
URB flags exchanged in network packets are USBIP user API must not
change.

Add USBIP_URB* flags to make this an explicit API and change the
client and server to map them. Details as follows:

Client tx path (USBIP_CMD_SUBMIT):
- Maps URB_* to USBIP_URB_* when it sends USBIP_CMD_SUBMIT packet.

Server rx path (USBIP_CMD_SUBMIT):
- Maps USBIP_URB_* to URB_* when it receives USBIP_CMD_SUBMIT packet.

Flags aren't included in USBIP_CMD_UNLINK and USBIP_RET_SUBMIT packets
and no special handling is needed for them in the following cases:

- Server rx path (USBIP_CMD_UNLINK)
- Client rx path & Server tx path (USBIP_RET_SUBMIT)

Update protocol documentation to reflect the change.

Suggested-by: Hongren Zenithal Zheng <i@zenithal.me>
Suggested-by: Alan Stern <stern@rowland.harvard.edu>
Signed-off-by: Shuah Khan <skhan@linuxfoundation.org>
Link: https://lore.kernel.org/r/20220824002456.94605-1-skhan@linuxfoundation.org
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
2022-08-31 09:07:53 +02:00
..
acm.rst docs: usb: rename files to .rst and add them to drivers-api 2019-06-20 14:28:36 +02:00
authorization.rst docs: usb: rename files to .rst and add them to drivers-api 2019-06-20 14:28:36 +02:00
chipidea.rst docs: usb: rename files to .rst and add them to drivers-api 2019-06-20 14:28:36 +02:00
CREDITS
dwc3.rst docs: usb: rename files to .rst and add them to drivers-api 2019-06-20 14:28:36 +02:00
ehci.rst docs: usb: replace some characters 2021-06-17 13:22:33 -06:00
functionfs.rst docs: usb: rename files to .rst and add them to drivers-api 2019-06-20 14:28:36 +02:00
gadget_configfs.rst docs: usb: function: Modify path name 2021-05-13 10:14:18 -06:00
gadget_hid.rst USB: Replace HTTP links with HTTPS ones 2020-07-21 13:41:57 +02:00
gadget_multi.rst USB: Replace HTTP links with HTTPS ones 2020-07-21 13:41:57 +02:00
gadget_printer.rst docs: usb: replace some characters 2021-06-17 13:22:33 -06:00
gadget_serial.rst docs: usb: rename files to .rst and add them to drivers-api 2019-06-20 14:28:36 +02:00
gadget-testing.rst usb: gadget: f_mass_storage: forced_eject attribute 2022-07-14 16:06:42 +02:00
index.rst usb: gadget: add raw-gadget interface 2020-03-15 11:34:48 +02:00
iuu_phoenix.rst docs: usb: rename files to .rst and add them to drivers-api 2019-06-20 14:28:36 +02:00
linux-cdc-acm.inf
linux.inf USB: Replace HTTP links with HTTPS ones 2020-07-21 13:41:57 +02:00
mass-storage.rst usb: gadget: f_mass_storage: forced_eject attribute 2022-07-14 16:06:42 +02:00
misc_usbsevseg.rst docs: usb: rename files to .rst and add them to drivers-api 2019-06-20 14:28:36 +02:00
mtouchusb.rst Documentation: drop optional BOMs 2021-05-10 15:17:34 -06:00
ohci.rst docs: usb: rename files to .rst and add them to drivers-api 2019-06-20 14:28:36 +02:00
raw-gadget.rst usb: raw-gadget: update documentation and Kconfig 2021-01-26 18:38:45 +01:00
text_files.rst docs: usb: remove some broken references 2020-01-28 13:41:22 -07:00
usb-help.rst docs: usb: rename files to .rst and add them to drivers-api 2019-06-20 14:28:36 +02:00
usb-serial.rst Documentation: drop optional BOMs 2021-05-10 15:17:34 -06:00
usbdevfs-drop-permissions.c
usbip_protocol.rst usbip: add USBIP_URB_* URB transfer flags 2022-08-31 09:07:53 +02:00
usbmon.rst docs: usb: fix literal block marker in usbmon verification example 2022-06-09 09:50:03 -06:00