usb: gadget: configfs: allow setting function instance's name
authorAndrzej Pietrasiewicz <andrzej.p@samsung.com>
Tue, 3 Dec 2013 14:15:21 +0000 (15:15 +0100)
committerFelipe Balbi <balbi@ti.com>
Thu, 12 Dec 2013 19:43:35 +0000 (13:43 -0600)
USB function's configfs config group is created in a generic way in
usb/gadget/configfs.c:function_make(), which in turn delegates actual
allocation and setup of the USB function instance to a particular
implementation, e.g. in f_acm.c. The said implementation does its job
in a parameter-less function e.g. acm_alloc_instance(), which results
in creating an unnamed config group, whose name is set later in
function_make(). function_make() creates the name by parsing a string
of the form:

<function name>.<instance name>

which comes from userspace as a parameter to mkdir invocation.

Up to now only <function name> has been used, while <instance name>
has been ignored. This patch adds a set_inst_name() operation to
struct usb_function_instance which allows passing the <instance name>
from function_make() so that it is not ignored. It is entirely up to the
implementor of set_inst_name() what to do with the <instance name>.

In a typical case, the struct usb_function_instance is embedded in a
larger struct which is retrieved in set_inst_name() with container_of(),
and the larger struct contains a field to store the <instance name>.

Signed-off-by: Andrzej Pietrasiewicz <andrzej.p@samsung.com>
Signed-off-by: Kyungmin Park <kyungmin.park@samsung.com>
Acked-by: Michal Nazarewicz <mina86@mina86.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>
drivers/usb/gadget/configfs.c
include/linux/usb/composite.h

index 25885112fa35b0cc5b0b25733c91d91365606fb8..d6c8ab4a5327922e65dbb29bdade3a56f429df04 100644 (file)
@@ -564,6 +564,13 @@ static struct config_group *function_make(
                usb_put_function_instance(fi);
                return ERR_PTR(ret);
        }
+       if (fi->set_inst_name) {
+               ret = fi->set_inst_name(fi, instance_name);
+               if (ret) {
+                       usb_put_function_instance(fi);
+                       return ERR_PTR(ret);
+               }
+       }
 
        gi = container_of(group, struct gadget_info, functions_group);
 
index 5e61589fc1669234e716b313e1b74090d9b192f6..dba63f53906c9ddb1b43ef36ef0822b554a8a3ff 100644 (file)
@@ -468,6 +468,8 @@ struct usb_function_instance {
        struct config_group group;
        struct list_head cfs_list;
        struct usb_function_driver *fd;
+       int (*set_inst_name)(struct usb_function_instance *inst,
+                             const char *name);
        void (*free_func_inst)(struct usb_function_instance *inst);
 };