usb_string_ids_tab(9) [centos man page]

USB_STRING_IDS_TAB(9)					      Kernel Mode Gadget API					     USB_STRING_IDS_TAB(9)

NAME

       usb_string_ids_tab - allocate unused string IDs in batch

SYNOPSIS

       int usb_string_ids_tab(struct usb_composite_dev * cdev, struct usb_string * str);

ARGUMENTS

       cdev
	   the device whose string descriptor IDs are being allocated

       str
	   an array of usb_string objects to assign numbers to

CONTEXT

       single threaded during gadget setup

DESCRIPTION

       usb_string_ids() is called from bind callbacks to allocate string IDs. Drivers for functions, configurations, or gadgets will then copy IDs
       from the string table to the appropriate descriptors and string table for other languages.

       All string identifier should be allocated using this, usb_string_id() or usb_string_ids_n() routine, to ensure that for example different
       functions don't wrongly assign different meanings to the same identifier.

AUTHOR

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

COPYRIGHT

Kernel Hackers Manual 3.10					     June 2014						     USB_STRING_IDS_TAB(9)

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)