Composite framework: Add suspended sysfs entry
PATCH RESEND 1/2 Composite framework: Add suspended sysfs entry
From: Fabien Chouteau <[email protected]>
This patch adds a sysfs entry (/sys/devices/platform/_UDC_/gadget/suspended) to show the suspend state of an USB composite gadget.
--- .../testing/sysfs-devices-platform-_UDC_-gadget | 9 ++++++++ drivers/usb/gadget/composite.c | 21 ++++++++++++++++++++ include/linux/usb/composite.h | 1 + include/linux/usb/gadget.h | 4 +++ 4 files changed, 35 insertions(+), 0 deletions(-) create mode 100644 Documentation/ABI/testing/sysfs-devices-platform-_UDC_-gadget
Documentation/ABI/testing/sysfs-devices-platform-_UDC_-gadget new file +9 -0
@@ -0,0 +1,9 @@ +What: /sys/devices/platform/_UDC_/gadget/suspended +Date: April 2010 +Contact: Fabien Chouteau <[email protected]> +Description: + Show the suspend state of an USB composite gadget. + 1 -> suspended + 0 -> resumed + + (_UDC_ is the name of the USB Device Controller driver)
drivers/usb/gadget/composite.c +21 -0
@@ -898,6 +898,18 @@ static void composite_disconnect(struct usb_gadget *gadget)/*-------------------------------------------------------------------------*/ +static ssize_t composite_show_suspended (struct device *dev, +struct device_attribute *attr, +char *buf) +{ +struct usb_gadget *gadget =dev_to_usb_gadget (dev); +struct usb_composite_dev *cdev =get_gadget_data (gadget); + +return sprintf (buf,"%d\n" , cdev->suspended); +} + +static DEVICE_ATTR(suspended, 0444, composite_show_suspended, NULL); +static void /* __init_or_exit */ composite_unbind (struct usb_gadget *gadget) {
@@ -944,6 +956,7 @@ composite_unbind(struct usb_gadget *gadget) }kfree (cdev);set_gadget_data (gadget,NULL ); +device_remove_file (&gadget->dev, &dev_attr_suspended); composite =NULL ; }
@@ -1036,6 +1049,10 @@ static int __init composite_bind(struct usb_gadget *gadget)string_override (composite->strings, cdev->desc.iSerialNumber, iSerialNumber); + status =device_create_file (&gadget->dev, &dev_attr_suspended); +if (status) + goto fail; +INFO (cdev,"%s ready\n" , composite->name);return 0 ;
@@ -1064,6 +1081,8 @@ composite_suspend(struct usb_gadget *gadget) }if (composite->suspend) composite->suspend (cdev); + + cdev->suspended =1 ; } static void
@@ -1084,6 +1103,8 @@ composite_resume(struct usb_gadget *gadget) f->resume (f); } } + + cdev->suspended =0 ; }/*-------------------------------------------------------------------------*/
include/linux/usb/composite.h +1 -0
@@ -326,6 +326,7 @@ struct usb_composite_dev {/* private: */ /* internals */ + unsigned int suspended:1;struct usb_device_descriptor desc;struct list_head configs;struct usb_composite_driver *driver;
include/linux/usb/gadget.h +4 -0
@@ -494,6 +494,10 @@ static inline void set_gadget_data(struct usb_gadget *gadget, void *data) {dev_set_drvdata (&gadget->dev, data); }static inline void *get_gadget_data (struct usb_gadget *gadget) {return dev_get_drvdata (&gadget->dev); } +static inline struct usb_gadget *dev_to_usb_gadget (struct device *dev) +{ + return container_of(dev, struct usb_gadget, dev); +}/* iterates the non-control endpoints; 'tmp' is a struct usb_ep pointer */ #define gadget_for_each_ep (tmp,gadget) \
Signature · 1 line
1.7.0.5
PATCH RESEND 2/2 Mass storage gadget: Handle eject request
From: Fabien Chouteau <[email protected]>
This patch adds handling of the "Start/Stop Unit" SCSI request to simulate media ejection. A sysfs entry to get the "eject" state of a LUN is also added.
--- drivers/usb/gadget/f_mass_storage.c | 57 +++++++++++++++++++++++++++++++++-- drivers/usb/gadget/storage_common.c | 11 +++++++ 2 files changed, 65 insertions(+), 3 deletions(-)
drivers/usb/gadget/f_mass_storage.c +54 -3
@@ -163,6 +163,13 @@* ro setting are not allowed when the medium is loaded or if CD-ROM * emulation is being used. * +* When a LUN receive an "eject" SCSI request (Start/Stop Unit), +* if the LUN is removable, the backing file is released to simulate +* ejection. +* The "eject" state of a LUN is available in the "ejected" file of the +* LUN's sysfs directory (see above). The "eject" state is only updated +* by SCSI request, not by user ejection. +* * * This function is heavily based on "File-backed Storage Gadget" by * Alan Stern which in turn is heavily based on "Gadget Zero" by David
@@ -1385,12 +1392,51 @@ static int do_mode_sense(struct fsg_common *common, struct fsg_buffhd *bh)static int do_start_stop (struct fsg_common *common) { -if (!common->curlun) { +struct fsg_lun *curlun = common->curlun; +int loej, start; + +if (!curlun) {return -EINVAL ; - }else if (!common->curlun->removable) { - common->curlun->sense_data =SS_INVALID_COMMAND ; + }else if (!curlun->removable) { + curlun->sense_data =SS_INVALID_COMMAND ; +return -EINVAL ; + } + + loej = common->cmnd[4 ] &0x02 ; + start = common->cmnd[4 ] &0x01 ; + +/* eject code from file_storage.c:do_start_stop() */ + +if ((common->cmnd[1 ] & ~0x01 ) !=0 ||/* Mask away Immed */ + (common->cmnd[4 ] & ~0x03 ) !=0 ) {/* Mask LoEj, Start */ + curlun->sense_data =SS_INVALID_FIELD_IN_CDB ;return -EINVAL ; } + +if (!start) { +/* Are we allowed to unload the media? */ +if (curlun->prevent_medium_removal) { +LDBG (curlun,"unload attempt prevented\n" ); + curlun->sense_data =SS_MEDIUM_REMOVAL_PREVENTED ; +return -EINVAL ; + } +if (loej) {/* Simulate an unload/eject */ +up_read (&common->filesem); +down_write (&common->filesem); +fsg_lun_close (curlun); + curlun->ejected =1 ; +up_write (&common->filesem); +down_read (&common->filesem); + } + }else { + +/* Our emulation doesn't support mounting; the medium is +* available for use as soon as it is loaded. */ +if (!fsg_lun_is_open (curlun)) { + curlun->sense_data =SS_MEDIUM_NOT_PRESENT ; +return -EINVAL ; + } + }return 0 ; }
@@ -2641,6 +2687,7 @@ static int fsg_main_thread(void *common_)/* Write permission is checked per LUN in store_*() functions. */ static DEVICE_ATTR(ro, 0644, fsg_show_ro, fsg_store_ro); static DEVICE_ATTR(file, 0644, fsg_show_file, fsg_store_file); +static DEVICE_ATTR(ejected, 0444, fsg_show_ejected, NULL);/****************************** FSG COMMON ******************************/
@@ -2747,6 +2794,9 @@ static struct fsg_common *fsg_common_init(struct fsg_common *common, rc =device_create_file (&curlun->dev, &dev_attr_file);if (rc) goto error_luns; + rc =device_create_file (&curlun->dev, &dev_attr_ejected); +if (rc) + goto error_luns;if (lcfg->filename) { rc =fsg_lun_open (curlun, lcfg->filename);
@@ -2887,6 +2937,7 @@ static void fsg_common_release(struct kref *ref)for (; i; --i, ++lun) {device_remove_file (&lun->dev, &dev_attr_ro);device_remove_file (&lun->dev, &dev_attr_file); +device_remove_file (&lun->dev, &dev_attr_ejected);fsg_lun_close (lun);device_unregister (&lun->dev); }
drivers/usb/gadget/storage_common.c +11 -0
@@ -267,6 +267,7 @@ struct fsg_lun { unsigned int removable:1; unsigned int cdrom:1; unsigned int prevent_medium_removal:1; + unsigned int ejected:1; unsigned int registered:1; unsigned int info_valid:1;
@@ -625,6 +626,7 @@ static int fsg_lun_open(struct fsg_lun *curlun, const char *filename) curlun->filp = filp; curlun->file_length = size; curlun->num_sectors = num_sectors; + curlun->ejected =0 ;LDBG (curlun,"open backing file: %s\n" , filename); rc =0 ;
@@ -776,3 +778,12 @@ static ssize_t fsg_store_file(struct device *dev, struct device_attribute *attr,up_write (filesem);return (rc <0 ? rc : count); } + +static ssize_t fsg_show_ejected (struct device *dev, +struct device_attribute *attr,char *buf) +{ +struct fsg_lun *curlun =fsg_lun_from_dev (dev); + +return sprintf (buf,"%d\n" , curlun->ejected); +} +
Signature · 1 line
1.7.0.5
Re: [PATCH RESEND 2/2] Mass storage gadget: Handle eject request
Quoted 4 lines · On Fri, 23 Apr 2010 [email protected] wrote:
From: Fabien Chouteau <[email protected]>
This patch adds handling of the "Start/Stop Unit" SCSI request to simulate media ejection. A sysfs entry to get the "eject" state of a LUN is also added.
Sorry I didn't notice this earlier...
drivers/usb/gadget/f_mass_storage.c line 171
Quoted 12 lines
drivers/usb/gadget/f_mass_storage.c +6
-0@@ -163,6 +163,13 @@* ro setting are not allowed when the medium is loaded or if CD-ROM * emulation is being used. * +* When a LUN receive an "eject" SCSI request (Start/Stop Unit), +* if the LUN is removable, the backing file is released to simulate +* ejection. +* The "eject" state of a LUN is available in the "ejected" file of the +* LUN's sysfs directory (see above). The "eject" state is only updated +* by SCSI request, not by user ejection.
What's the reason for that? With a real removable device, like a CD player, it doesn't make any difference whether the medium was ejected because of a SCSI command or because I pressed the "eject" button.
I just don't see any point in keeping track of the two actions separately, since they end up having the same final result.
Alan Stern
Re: [PATCH RESEND 2/2] Mass storage gadget: Handle eject request
Quoted 27 lines · Alan Stern
Quoted 4 lines · On Fri, 23 Apr 2010 [email protected] wrote:
From: Fabien Chouteau <[email protected]>
This patch adds handling of the "Start/Stop Unit" SCSI request to simulate media ejection. A sysfs entry to get the "eject" state of a LUN is also added.
Sorry I didn't notice this earlier...
drivers/usb/gadget/f_mass_storage.c line 171
Quoted 12 lines
drivers/usb/gadget/f_mass_storage.c +6
-0@@ -163,6 +163,13 @@ * ro setting are not allowed when the medium is loaded or if CD-ROM * emulation is being used. * + * When a LUN receive an "eject" SCSI request (Start/Stop Unit), + * if the LUN is removable, the backing file is released to simulate + * ejection. + * The"eject" state of aLUN is available in the"ejected" file of the + * LUN's sysfs directory (see above). The "eject" state is only updated + * by SCSI request, not by user ejection.What's the reason for that? With a real removable device, like a CD player, it doesn't make any difference whether the medium was ejected because of a SCSI command or because I pressed the "eject" button.
Quoted 3 lines
I just don't see any point in keeping track of the two actions separately, since they end up having the same final result.
By user ejection, I mean send an empty line in the "file" sysfs entry. The Start/Stop request is an action from the USB host side, user ejection is from the USB device side, for me it's two different events.
Maybe my comment is not clear about this point.
I use a FAT disk image as LUN file, users can put some files in the "fake" disk and then eject it. When I get the ejected signal, I mount the disk image on loop device and perform operations on the user's files.
So I want to know when users eject the disk and only when users do.
I still can use the LUN ejection from device side to disable the mass storage device, and in this case I don't want to mount the disk and search for user's files.
--
Fabien Chouteau
EPITA GISTR 2010
Re: [PATCH RESEND 2/2] Mass storage gadget: Handle eject request
Quoted 15 lines · Chouteau Fabien
Quoted 7 lines
Quoted 6 lines
+ * When a LUN receive an "eject" SCSI request (Start/Stop Unit),
+ * if the LUN is removable, the backing file is released to simulate
+ * ejection.
+ * The "eject" state of a LUN is available in the "ejected" file of the
+ * LUN's sysfs directory (see above). The "eject" state is only updated
+ * by SCSI request, not by user ejection.Quoted 7 lines
What's the reason for that? With a real removable device, like a CD player, it doesn't make any difference whether the medium was ejected because of a SCSI command or because I pressed the "eject" button.
I just don't see any point in keeping track of the two actions separately, since they end up having the same final result.
Quoted 5 lines
By user ejection, I mean send an empty line in the "file" sysfs entry. The Start/Stop request is an action from the USB host side, user ejection is from the USB device side, for me it's two different events.
Maybe my comment is not clear about this point.
No; it's clear enough and I understood what you meant. It's true that they are two different events, but they have the same end result.
Quoted 9 lines
I use a FAT disk image as LUN file, users can put some files in the "fake" disk and then eject it. When I get the ejected signal, I mount the disk image on loop device and perform operations on the user's files.
So I want to know when users eject the disk and only when users do.I still can use the LUN ejection from device side to disable the mass storage device, and in this case I don't want to mount the disk and search for user's files.
Why not? Isn't it possible that the user put some files there before the device-side eject happened?
What happens if the user and the device both try to eject the medium at approximately the same time? Which event occurs first will be purely random chance. That means there's a 50% probability you will end up doing the wrong thing.
No, I think you need to do the same thing whenever an eject occurs, or else find a better criterion for deciding what to do.
Alan Stern
Re: [PATCH RESEND 2/2] Mass storage gadget: Handle eject request
Quoted 40 lines · Alan Stern
Quoted 15 lines · Chouteau Fabien
Quoted 7 lines
Quoted 6 lines
+ * When a LUN receive an "eject" SCSI request (Start/Stop Unit),
+ * if the LUN is removable, the backing file is released to simulate
+ * ejection.
+ * The "eject" state of a LUN is available in the "ejected" file of the
+ * LUN's sysfs directory (see above). The "eject" state is only updated
+ * by SCSI request, not by user ejection.Quoted 7 lines
What's the reason for that? With a real removable device, like a CD player, it doesn't make any difference whether the medium was ejected because of a SCSI command or because I pressed the "eject" button.
I just don't see any point in keeping track of the two actions separately, since they end up having the same final result.
Quoted 5 lines
By user ejection, I mean send an empty line in the "file" sysfs entry. The Start/Stop request is an action from the USB host side, user ejection is from the USB device side, for me it's two different events.
Maybe my comment is not clear about this point.No; it's clear enough and I understood what you meant. It's true that they are two different events, but they have the same end result.
Quoted 9 lines
I use a FAT disk image as LUN file, users can put some files in the "fake" disk and then eject it. When I get the ejected signal, I mount the disk image on loop device and perform operations on the user's files.
So I want to know when users eject the disk and only when users do.I still can use the LUN ejection from device side to disable the mass storage device, and in this case I don't want to mount the disk and search for user's files.
Why not? Isn't it possible that the user put some files there before the device-side eject happened?
Quoted 7 lines
What happens if the user and the device both try to eject the medium at approximately the same time? Which event occurs first will be purely random chance. That means there's a 50% probability you will end up doing the wrong thing.
No, I think you need to do the same thing whenever an eject occurs, or else find a better criterion for deciding what to do.
You're right, I can do the same thing for both ejection. I'm going to resend the patch without the "eject" sysfs entry.
--
Fabien Chouteau
EPITA GISTR 2010