History

USB: Fix up terminology in include files

USB is a HOST/DEVICE protocol, as per the specification and all documentation. Fix up terms that are not applicable to make things match up with the terms used through the rest of the USB stack.

Greg Kroah-Hartman committed 6 years ago

Commit c8d141c1 parent f3c1c413 files · +9 −8Browse files

Showing the changes to include/linux (3 of 3 files). Show all

Unified · Split

3 files
  1. include/linux/usb.h +1 −1
  2. include/linux/usb/ch9.h +4 −4
  3. include/linux/usb/gadget.h +4 −3
include/linux/usb.h+1−1
@@ -422,7 +422,7 @@ struct usb_devmap { · 421 unmodified lines
422422 * Allocated per bus (tree of devices) we have:
423423 */
424424 struct usb_bus {
425− struct device *controller; /* host/master side hardware */
425+ struct device *controller; /* host side hardware */
426426 struct device *sysdev; /* as seen from firmware or bus */
427427 int busnum; /* Bus number (in order of reg) */
428428 const char *bus_name; /* stable id (PCI slot_name etc) */
include/linux/usb/ch9.h+4−4
@@ -6,13 +6,13 @@ · 5 unmodified lines
66 * Wireless USB 1.0 (spread around). Linux has several APIs in C that
77 * need these:
88 *
9− * - the master/host side Linux-USB kernel driver API;
9+ * - the host side Linux-USB kernel driver API;
1010 * - the "usbfs" user space API; and
11− * - the Linux "gadget" slave/device/peripheral side driver API.
11+ * - the Linux "gadget" device/peripheral side driver API.
1212 *
1313 * USB 2.0 adds an additional "On The Go" (OTG) mode, which lets systems
14− * act either as a USB master/host or as a USB slave/device. That means
15− * the master and slave side APIs benefit from working well together.
14+ * act either as a USB host or as a USB device. That means the host and
15+ * device side APIs benefit from working well together.
1616 *
1717 * There's also "Wireless USB", using low power short range radios for
1818 * peripheral interconnection but otherwise building on the USB framework.
include/linux/usb/gadget.h+4−3
@@ -4,7 +4,8 @@ · 3 unmodified lines
44 *
55 * We call the USB code inside a Linux-based peripheral device a "gadget"
66 * driver, except for the hardware-specific bus glue. One USB host can
7− * master many USB gadgets, but the gadgets are only slaved to one host.
7+ * talk to many USB gadgets, but the gadgets are only able to communicate
8+ * to one host.
89 *
910 *
1011 * (C) Copyright 2002-2004 by David Brownell
@@ -328,7 +329,7 @@ struct usb_gadget_ops { · 317 unmodified lines
328329 };
329330
330331 /**
331− * struct usb_gadget - represents a usb slave device
332+ * struct usb_gadget - represents a usb device
332333 * @work: (internal use) Workqueue to be used for sysfs_notify()
333334 * @udc: struct usb_udc pointer for this gadget
334335 * @ops: Function pointers used to access hardware-specific operations.
@@ -602,7 +603,7 @@ static inline int usb_gadget_activate(struct usb_gadget *gadget) · 267 unmodified lines
602603 /*-------------------------------------------------------------------------*/
603604
604605 /**
605− * struct usb_gadget_driver - driver for usb 'slave' devices
606+ * struct usb_gadget_driver - driver for usb gadget devices
606607 * @function: String describing the gadget's function
607608 * @max_speed: Highest speed the driver handles.
608609 * @setup: Invoked for ep0 control requests that aren't handled by