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

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
422 * Allocated per bus (tree of devices) we have:422 * Allocated per bus (tree of devices) we have:
423 */423 */
424struct usb_bus {424struct usb_bus {
425 struct device *controller; /* host/master side hardware */425 struct device *controller; /* host side hardware */
426 struct device *sysdev; /* as seen from firmware or bus */426 struct device *sysdev; /* as seen from firmware or bus */
427 int busnum; /* Bus number (in order of reg) */427 int busnum; /* Bus number (in order of reg) */
428 const char *bus_name; /* stable id (PCI slot_name etc) */428 const char *bus_name; /* stable id (PCI slot_name etc) */
include/linux/usb/ch9.h+4−4
@@ -6,13 +6,13 @@ · 5 unmodified lines
6 * Wireless USB 1.0 (spread around). Linux has several APIs in C that6 * Wireless USB 1.0 (spread around). Linux has several APIs in C that
7 * need these:7 * need these:
8 *8 *
9 * - the master/host side Linux-USB kernel driver API;9 * - the host side Linux-USB kernel driver API;
10 * - the "usbfs" user space API; and10 * - 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.
12 *12 *
13 * USB 2.0 adds an additional "On The Go" (OTG) mode, which lets systems13 * 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 means14 * act either as a USB host or as a USB device. That means the host and
15 * the master and slave side APIs benefit from working well together.15 * device side APIs benefit from working well together.
16 *16 *
17 * There's also "Wireless USB", using low power short range radios for17 * There's also "Wireless USB", using low power short range radios for
18 * peripheral interconnection but otherwise building on the USB framework.18 * peripheral interconnection but otherwise building on the USB framework.
include/linux/usb/gadget.h+4−3
@@ -4,7 +4,8 @@ · 3 unmodified lines
4 *4 *
5 * We call the USB code inside a Linux-based peripheral device a "gadget"5 * We call the USB code inside a Linux-based peripheral device a "gadget"
6 * driver, except for the hardware-specific bus glue. One USB host can6 * 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.
8 *9 *
9 *10 *
10 * (C) Copyright 2002-2004 by David Brownell11 * (C) Copyright 2002-2004 by David Brownell
@@ -328,7 +329,7 @@ struct usb_gadget_ops { · 317 unmodified lines
328};329};
329 330
330/**331/**
331 * struct usb_gadget - represents a usb slave device332 * struct usb_gadget - represents a usb device
332 * @work: (internal use) Workqueue to be used for sysfs_notify()333 * @work: (internal use) Workqueue to be used for sysfs_notify()
333 * @udc: struct usb_udc pointer for this gadget334 * @udc: struct usb_udc pointer for this gadget
334 * @ops: Function pointers used to access hardware-specific operations.335 * @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
602/*-------------------------------------------------------------------------*/603/*-------------------------------------------------------------------------*/
603 604
604/**605/**
605 * struct usb_gadget_driver - driver for usb 'slave' devices606 * struct usb_gadget_driver - driver for usb gadget devices
606 * @function: String describing the gadget's function607 * @function: String describing the gadget's function
607 * @max_speed: Highest speed the driver handles.608 * @max_speed: Highest speed the driver handles.
608 * @setup: Invoked for ep0 control requests that aren't handled by609 * @setup: Invoked for ep0 control requests that aren't handled by