Commit a5262dcf authored by David Brownell's avatar David Brownell Committed by Greg Kroah-Hartman
Browse files

USB: export <linux/usb_gadgetfs> as <linux/usb/gadgetfs.h> 



Make sure gadgetfs userspace interface is properly exported:

 - Move <linux/usb_gadgetfs.h> to <linux/usb/gadgetfs.h>;
 - Export it using Kbuild;
 - Add an #include guard;
 - Correct some internal documentation;
 - Update struct layout so it's the same on 32/64 bit kernels.

Signed-off-by: default avatarDavid Brownell <dbrownell@users.sourceforge.net>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@suse.de>
parent 8234509c

drivers/usb/gadget/inode.c

+1 −1
Original line number Diff line number Diff line
@@ -37,7 +37,7 @@ 
#include <linux/device.h>

#include <linux/moduleparam.h>



#include <linux/usb_gadgetfs.h>

#include <linux/usb/gadgetfs.h>

#include <linux/usb_gadget.h>

include/linux/usb/Kbuild

+1 −0
Original line number Diff line number Diff line 
unifdef-y += audio.h

unifdef-y += cdc.h

unifdef-y += ch9.h

unifdef-y += gadgetfs.h

unifdef-y += midi.h

include/linux/usb_gadgetfs.h→include/linux/usb/gadgetfs.h

+15 −9
Original line number Diff line number Diff line 
#ifndef __LINUX_USB_GADGETFS_H

#define __LINUX_USB_GADGETFS_H



#include <asm/types.h>

#include <asm/ioctl.h>
@@ -7,11 +9,12 @@ 
/*

 * Filesystem based user-mode API to USB Gadget controller hardware

 *

 * Almost everything can be done with only read and write operations,

 * Other than ep0 operations, most things are done by read() and write()

 * on endpoint files found in one directory.  They are configured by

 * writing descriptors, and then may be used for normal stream style

 * i/o requests.  When ep0 is configured, the device can enumerate;

 * when it's closed, the device disconnects from usb.

 * when it's closed, the device disconnects from usb.  Operations on

 * ep0 require ioctl() operations.

 *

 * Configuration and device descriptors get written to /dev/gadget/$CHIP,

 * which may then be used to read usb_gadgetfs_event structs.  The driver
@@ -21,9 +24,9 @@ 
 */



/*

 * Events are delivered on the ep0 file descriptor, if the user mode driver

 * Events are delivered on the ep0 file descriptor, when the user mode driver

 * reads from this file descriptor after writing the descriptors.  Don't

 * stop polling this descriptor, if you write that kind of driver.

 * stop polling this descriptor.

 */



enum usb_gadgetfs_event_type {
@@ -36,8 +39,10 @@ enum usb_gadgetfs_event_type { 
	// and likely more !

};



/* NOTE:  this structure must stay the same size and layout on

 * both 32-bit and 64-bit kernels.

 */

struct usb_gadgetfs_event {

	enum usb_gadgetfs_event_type	type;

	union {

		// NOP, DISCONNECT, SUSPEND: nothing

		// ... some hardware can't report disconnection
@@ -50,6 +55,7 @@ struct usb_gadgetfs_event { 
		// ... includes SET_CONFIGURATION, SET_INTERFACE

		struct usb_ctrlrequest	setup;

	} u;

	enum usb_gadgetfs_event_type	type;

};
@@ -72,4 +78,4 @@ struct usb_gadgetfs_event { 
 */

#define	GADGETFS_CLEAR_HALT	_IO('g',3)



#endif /* __LINUX_USB_GADGETFS_H */

CRA Git | Maintained and supported by SUSTech CRA and CCSE