usb_gstrings_attach(9) [centos man page]

USB_GSTRINGS_ATTACH(9)					      Kernel Mode Gadget API					    USB_GSTRINGS_ATTACH(9)

NAME

       usb_gstrings_attach - attach gadget strings to a cdev and assign ids

SYNOPSIS

       struct usb_string * usb_gstrings_attach(struct usb_composite_dev * cdev, struct usb_gadget_strings ** sp, unsigned n_strings);

ARGUMENTS

       cdev
	   the device whose string descriptor IDs are being allocated and attached.

       sp
	   an array of usb_gadget_strings to attach.

       n_strings
	   number of entries in each usb_strings array (sp[]->strings)

DESCRIPTION

       This function will create a deep copy of usb_gadget_strings and usb_string and attach it to the cdev. The actual string (usb_string.s) will
       not be copied but only a referenced will be made. The struct usb_gadget_strings array may contain multiple languges and should be NULL
       terminated. The ->language pointer of each struct usb_gadget_strings has to contain the same amount of entries.

FOR INSTANCE

       sp[0] is en-US, sp[1] is es-ES. It is expected that the first usb_string entry of es-ES containts the translation of the first usb_string
       entry of en-US. Therefore both entries become the same id assign.

AUTHOR

       David Brownell <dbrownell@users.sourceforge.net>
	   Author.

COPYRIGHT

Kernel Hackers Manual 3.10					     June 2014						    USB_GSTRINGS_ATTACH(9)

USB_INTERFACE_ID(9)					      Kernel Mode Gadget API					       USB_INTERFACE_ID(9)

NAME

       usb_interface_id - allocate an unused interface ID

SYNOPSIS

       int usb_interface_id(struct usb_configuration * config, struct usb_function * function);

ARGUMENTS

       config
	   configuration associated with the interface

       function
	   function handling the interface

CONTEXT

       single threaded during gadget setup

DESCRIPTION

       usb_interface_id is called from usb_function.bind callbacks to allocate new interface IDs. The function driver will then store that ID in
       interface, association, CDC union, and other descriptors. It will also handle any control requests targeted at that interface, particularly
       changing its altsetting via set_alt. There may also be class-specific or vendor-specific requests to handle.

       All interface identifier should be allocated using this routine, to ensure that for example different functions don't wrongly assign
       different meanings to the same identifier. Note that since interface identifiers are configuration-specific, functions used in more than
       one configuration (or more than once in a given configuration) need multiple versions of the relevant descriptors.

       Returns the interface ID which was allocated; or -ENODEV if no more interface IDs can be allocated.

AUTHOR

       David Brownell <dbrownell@users.sourceforge.net>
	   Author.

COPYRIGHT

Kernel Hackers Manual 3.10					     June 2014						       USB_INTERFACE_ID(9)