Commit efc9052e authored by David Brownell's avatar David Brownell Committed by Greg Kroah-Hartman

USB: usb_gadget.h whitespace fixes

This just fixes some whitespace bugs in <linux/usb_gadget.h>,
mostly extraneous spaces where a single tab suffices.
Signed-off-by: default avatarDavid Brownell <dbrownell@users.sourceforge.net>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@suse.de>
parent 9f705bde
...@@ -22,10 +22,10 @@ struct usb_ep; ...@@ -22,10 +22,10 @@ struct usb_ep;
/** /**
* struct usb_request - describes one i/o request * struct usb_request - describes one i/o request
* @buf: Buffer used for data. Always provide this; some controllers * @buf: Buffer used for data. Always provide this; some controllers
* only use PIO, or don't use DMA for some endpoints. * only use PIO, or don't use DMA for some endpoints.
* @dma: DMA address corresponding to 'buf'. If you don't set this * @dma: DMA address corresponding to 'buf'. If you don't set this
* field, and the usb controller needs one, it is responsible * field, and the usb controller needs one, it is responsible
* for mapping and unmapping the buffer. * for mapping and unmapping the buffer.
* @length: Length of that data * @length: Length of that data
* @no_interrupt: If true, hints that no completion irq is needed. * @no_interrupt: If true, hints that no completion irq is needed.
* Helpful sometimes with deep request queues that are handled * Helpful sometimes with deep request queues that are handled
...@@ -45,16 +45,16 @@ struct usb_ep; ...@@ -45,16 +45,16 @@ struct usb_ep;
* @context: For use by the completion callback * @context: For use by the completion callback
* @list: For use by the gadget driver. * @list: For use by the gadget driver.
* @status: Reports completion code, zero or a negative errno. * @status: Reports completion code, zero or a negative errno.
* Normally, faults block the transfer queue from advancing until * Normally, faults block the transfer queue from advancing until
* the completion callback returns. * the completion callback returns.
* Code "-ESHUTDOWN" indicates completion caused by device disconnect, * Code "-ESHUTDOWN" indicates completion caused by device disconnect,
* or when the driver disabled the endpoint. * or when the driver disabled the endpoint.
* @actual: Reports bytes transferred to/from the buffer. For reads (OUT * @actual: Reports bytes transferred to/from the buffer. For reads (OUT
* transfers) this may be less than the requested length. If the * transfers) this may be less than the requested length. If the
* short_not_ok flag is set, short reads are treated as errors * short_not_ok flag is set, short reads are treated as errors
* even when status otherwise indicates successful completion. * even when status otherwise indicates successful completion.
* Note that for writes (IN transfers) some data bytes may still * Note that for writes (IN transfers) some data bytes may still
* reside in a device-side FIFO when the request is reported as * reside in a device-side FIFO when the request is reported as
* complete. * complete.
* *
* These are allocated/freed through the endpoint they're used with. The * These are allocated/freed through the endpoint they're used with. The
...@@ -128,7 +128,7 @@ struct usb_ep_ops { ...@@ -128,7 +128,7 @@ struct usb_ep_ops {
* value can sometimes be reduced (hardware allowing), according to * value can sometimes be reduced (hardware allowing), according to
* the endpoint descriptor used to configure the endpoint. * the endpoint descriptor used to configure the endpoint.
* @driver_data:for use by the gadget driver. all other fields are * @driver_data:for use by the gadget driver. all other fields are
* read-only to gadget drivers. * read-only to gadget drivers.
* *
* the bus controller driver lists all the general purpose endpoints in * the bus controller driver lists all the general purpose endpoints in
* gadget->ep_list. the control endpoint (gadget->ep0) is not in that list, * gadget->ep_list. the control endpoint (gadget->ep0) is not in that list,
...@@ -148,10 +148,10 @@ struct usb_ep { ...@@ -148,10 +148,10 @@ struct usb_ep {
/** /**
* usb_ep_enable - configure endpoint, making it usable * usb_ep_enable - configure endpoint, making it usable
* @ep:the endpoint being configured. may not be the endpoint named "ep0". * @ep:the endpoint being configured. may not be the endpoint named "ep0".
* drivers discover endpoints through the ep_list of a usb_gadget. * drivers discover endpoints through the ep_list of a usb_gadget.
* @desc:descriptor for desired behavior. caller guarantees this pointer * @desc:descriptor for desired behavior. caller guarantees this pointer
* remains valid until the endpoint is disabled; the data byte order * remains valid until the endpoint is disabled; the data byte order
* is little-endian (usb-standard). * is little-endian (usb-standard).
* *
* when configurations are set, or when interface settings change, the driver * when configurations are set, or when interface settings change, the driver
* will enable or disable the relevant endpoints. while it is enabled, an * will enable or disable the relevant endpoints. while it is enabled, an
...@@ -232,7 +232,7 @@ usb_ep_free_request (struct usb_ep *ep, struct usb_request *req) ...@@ -232,7 +232,7 @@ usb_ep_free_request (struct usb_ep *ep, struct usb_request *req)
* @ep:the endpoint associated with the request * @ep:the endpoint associated with the request
* @req:the request being submitted * @req:the request being submitted
* @gfp_flags: GFP_* flags to use in case the lower level driver couldn't * @gfp_flags: GFP_* flags to use in case the lower level driver couldn't
* pre-allocate all necessary memory with the request. * pre-allocate all necessary memory with the request.
* *
* This tells the device controller to perform the specified request through * This tells the device controller to perform the specified request through
* that endpoint (reading or writing a buffer). When the request completes, * that endpoint (reading or writing a buffer). When the request completes,
...@@ -415,7 +415,7 @@ struct usb_gadget_ops { ...@@ -415,7 +415,7 @@ struct usb_gadget_ops {
* struct usb_gadget - represents a usb slave device * struct usb_gadget - represents a usb slave device
* @ops: Function pointers used to access hardware-specific operations. * @ops: Function pointers used to access hardware-specific operations.
* @ep0: Endpoint zero, used when reading or writing responses to * @ep0: Endpoint zero, used when reading or writing responses to
* driver setup() requests * driver setup() requests
* @ep_list: List of other endpoints supported by the device. * @ep_list: List of other endpoints supported by the device.
* @speed: Speed of current connection to USB host. * @speed: Speed of current connection to USB host.
* @is_dualspeed: True if the controller supports both high and full speed * @is_dualspeed: True if the controller supports both high and full speed
...@@ -432,7 +432,7 @@ struct usb_gadget_ops { ...@@ -432,7 +432,7 @@ struct usb_gadget_ops {
* @b_hnp_enable: OTG device feature flag, indicating that the A-Host * @b_hnp_enable: OTG device feature flag, indicating that the A-Host
* enabled HNP support. * enabled HNP support.
* @name: Identifies the controller hardware type. Used in diagnostics * @name: Identifies the controller hardware type. Used in diagnostics
* and sometimes configuration. * and sometimes configuration.
* @dev: Driver model state for this abstract device. * @dev: Driver model state for this abstract device.
* *
* Gadgets have a mostly-portable "gadget driver" implementing device * Gadgets have a mostly-portable "gadget driver" implementing device
...@@ -655,23 +655,23 @@ usb_gadget_disconnect (struct usb_gadget *gadget) ...@@ -655,23 +655,23 @@ usb_gadget_disconnect (struct usb_gadget *gadget)
* @function: String describing the gadget's function * @function: String describing the gadget's function
* @speed: Highest speed the driver handles. * @speed: Highest speed the driver handles.
* @bind: Invoked when the driver is bound to a gadget, usually * @bind: Invoked when the driver is bound to a gadget, usually
* after registering the driver. * after registering the driver.
* At that point, ep0 is fully initialized, and ep_list holds * At that point, ep0 is fully initialized, and ep_list holds
* the currently-available endpoints. * the currently-available endpoints.
* Called in a context that permits sleeping. * Called in a context that permits sleeping.
* @setup: Invoked for ep0 control requests that aren't handled by * @setup: Invoked for ep0 control requests that aren't handled by
* the hardware level driver. Most calls must be handled by * the hardware level driver. Most calls must be handled by
* the gadget driver, including descriptor and configuration * the gadget driver, including descriptor and configuration
* management. The 16 bit members of the setup data are in * management. The 16 bit members of the setup data are in
* USB byte order. Called in_interrupt; this may not sleep. Driver * USB byte order. Called in_interrupt; this may not sleep. Driver
* queues a response to ep0, or returns negative to stall. * queues a response to ep0, or returns negative to stall.
* @disconnect: Invoked after all transfers have been stopped, * @disconnect: Invoked after all transfers have been stopped,
* when the host is disconnected. May be called in_interrupt; this * when the host is disconnected. May be called in_interrupt; this
* may not sleep. Some devices can't detect disconnect, so this might * may not sleep. Some devices can't detect disconnect, so this might
* not be called except as part of controller shutdown. * not be called except as part of controller shutdown.
* @unbind: Invoked when the driver is unbound from a gadget, * @unbind: Invoked when the driver is unbound from a gadget,
* usually from rmmod (after a disconnect is reported). * usually from rmmod (after a disconnect is reported).
* Called in a context that permits sleeping. * Called in a context that permits sleeping.
* @suspend: Invoked on USB suspend. May be called in_interrupt. * @suspend: Invoked on USB suspend. May be called in_interrupt.
* @resume: Invoked on USB resume. May be called in_interrupt. * @resume: Invoked on USB resume. May be called in_interrupt.
* @driver: Driver model state for this driver. * @driver: Driver model state for this driver.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment