Unverified Commit c41da3a6 authored by Mark Brown's avatar Mark Brown
Browse files

ASoC: Merge up origin to resolve interaction with manline symbol changes 



Commit cdd30ebb ("module: Convert symbol namespace to string
literal") changes the arguments for various module symbol macros
including some that we've aded new uses for.  Merge the commit up to
avoid problems in -next.

Signed-off-by: default avatarMark Brown <broonie@kernel.org>
parents 31823f27 cdd30ebb

Documentation/core-api/symbol-namespaces.rst

+4 −4
Original line number Diff line number Diff line
@@ -46,7 +46,7 @@ Please note that due to macro expansion that argument needs to be a 
preprocessor symbol. E.g. to export the symbol ``usb_stor_suspend`` into the

namespace ``USB_STORAGE``, use::



	EXPORT_SYMBOL_NS(usb_stor_suspend, USB_STORAGE);

	EXPORT_SYMBOL_NS(usb_stor_suspend, "USB_STORAGE");



The corresponding ksymtab entry struct ``kernel_symbol`` will have the member

``namespace`` set accordingly. A symbol that is exported without a namespace will
@@ -94,7 +94,7 @@ for the namespaces it uses symbols from. E.g. a module using the 
usb_stor_suspend symbol from above, needs to import the namespace USB_STORAGE

using a statement like::



	MODULE_IMPORT_NS(USB_STORAGE);

	MODULE_IMPORT_NS("USB_STORAGE");



This will create a ``modinfo`` tag in the module for each imported namespace.

This has the side effect, that the imported namespaces of a module can be
@@ -106,7 +106,7 @@ inspected with modinfo:: 
	[...]





It is advisable to add the MODULE_IMPORT_NS() statement close to other module

It is advisable to add the MODULE_IMPORT_NS("") statement close to other module

metadata definitions like MODULE_AUTHOR() or MODULE_LICENSE(). Refer to section

5. for a way to create missing import statements automatically.
@@ -128,7 +128,7 @@ enable loading regardless, but will emit a warning. 
Missing namespaces imports can easily be detected at build time. In fact,

modpost will emit a warning if a module uses a symbol from a namespace

without importing it.

MODULE_IMPORT_NS() statements will usually be added at a definite location

MODULE_IMPORT_NS("") statements will usually be added at a definite location

(along with other module meta data). To make the life of module authors (and

subsystem maintainers) easier, a script and make target is available to fixup

missing imports. Fixing missing imports can be done with::

Documentation/translations/it_IT/core-api/symbol-namespaces.rst

+4 −4
Original line number Diff line number Diff line
@@ -43,7 +43,7 @@ Tenete presente che per via dell'espansione delle macro questo argomento deve 
essere un simbolo di preprocessore. Per esempio per esportare il

simbolo ``usb_stor_suspend`` nello spazio dei nomi ``USB_STORAGE`` usate::



	EXPORT_SYMBOL_NS(usb_stor_suspend, USB_STORAGE);

	EXPORT_SYMBOL_NS(usb_stor_suspend, "USB_STORAGE");



Di conseguenza, nella tabella dei simboli del kernel ci sarà una voce

rappresentata dalla struttura ``kernel_symbol`` che avrà il campo
@@ -94,7 +94,7 @@ dei nomi che contiene i simboli desiderati. Per esempio un modulo che 
usa il simbolo usb_stor_suspend deve importare lo spazio dei nomi

USB_STORAGE usando la seguente dichiarazione::



	MODULE_IMPORT_NS(USB_STORAGE);

	MODULE_IMPORT_NS("USB_STORAGE");



Questo creerà un'etichetta ``modinfo`` per ogni spazio dei nomi

importato. Un risvolto di questo fatto è che gli spazi dei
@@ -107,7 +107,7 @@ modinfo:: 
	[...]





Si consiglia di posizionare la dichiarazione MODULE_IMPORT_NS() vicino

Si consiglia di posizionare la dichiarazione MODULE_IMPORT_NS("") vicino

ai metadati del modulo come MODULE_AUTHOR() o MODULE_LICENSE(). Fate

riferimento alla sezione 5. per creare automaticamente le importazioni

mancanti.
@@ -131,7 +131,7 @@ emetterà un avviso. 
La mancanza di un'importazione può essere individuata facilmente al momento

della compilazione. Infatti, modpost emetterà un avviso se il modulo usa

un simbolo da uno spazio dei nomi che non è stato importato.

La dichiarazione MODULE_IMPORT_NS() viene solitamente aggiunta in un posto

La dichiarazione MODULE_IMPORT_NS("") viene solitamente aggiunta in un posto

ben definito (assieme agli altri metadati del modulo). Per facilitare

la vita di chi scrive moduli (e i manutentori di sottosistemi), esistono uno

script e un target make per correggere le importazioni mancanti. Questo può

Documentation/translations/zh_CN/core-api/symbol-namespaces.rst

+4 −4
Original line number Diff line number Diff line
@@ -48,7 +48,7 @@ 
要是一个预处理器符号。例如，要把符号 ``usb_stor_suspend`` 导出到命名空间 ``USB_STORAGE``，

请使用::



       EXPORT_SYMBOL_NS(usb_stor_suspend, USB_STORAGE);

       EXPORT_SYMBOL_NS(usb_stor_suspend, "USB_STORAGE");



相应的 ksymtab 条目结构体 ``kernel_symbol`` 将有相应的成员 ``命名空间`` 集。

导出时未指明命名空间的符号将指向 ``NULL`` 。如果没有定义命名空间，则默认没有。
@@ -88,7 +88,7 @@ 
表示它所使用的命名空间的符号。例如，一个使用usb_stor_suspend符号的

模块，需要使用如下语句导入命名空间USB_STORAGE::



       MODULE_IMPORT_NS(USB_STORAGE);

       MODULE_IMPORT_NS("USB_STORAGE");



这将在模块中为每个导入的命名空间创建一个 ``modinfo`` 标签。这也顺带

使得可以用modinfo检查模块已导入的命名空间::
@@ -99,7 +99,7 @@ 
       [...]





建议将 MODULE_IMPORT_NS() 语句添加到靠近其他模块元数据定义的地方，

建议将 MODULE_IMPORT_NS("") 语句添加到靠近其他模块元数据定义的地方，

如 MODULE_AUTHOR() 或 MODULE_LICENSE() 。关于自动创建缺失的导入

语句的方法，请参考第5节。
@@ -118,7 +118,7 @@ EINVAL方式失败。要允许加载不满足这个前提条件的模块，可 


缺少命名空间的导入可以在构建时很容易被检测到。事实上，如果一个模块

使用了一个命名空间的符号而没有导入它，modpost会发出警告。

MODULE_IMPORT_NS()语句通常会被添加到一个明确的位置（和其他模块元

MODULE_IMPORT_NS("")语句通常会被添加到一个明确的位置（和其他模块元

数据一起）。为了使模块作者（和子系统维护者）的生活更加轻松，我们提

供了一个脚本和make目标来修复丢失的导入。修复丢失的导入可以用::

arch/arm/common/locomo.c

+1 −1
Original line number Diff line number Diff line
@@ -516,7 +516,7 @@ static void locomo_remove(struct platform_device *dev) 
 */

static struct platform_driver locomo_device_driver = {

	.probe		= locomo_probe,

	.remove_new	= locomo_remove,

	.remove		= locomo_remove,

#ifdef CONFIG_PM

	.suspend	= locomo_suspend,

	.resume		= locomo_resume,

arch/arm/common/sa1111.c

+1 −1
Original line number Diff line number Diff line
@@ -1154,7 +1154,7 @@ static struct dev_pm_ops sa1111_pm_ops = { 
 */

static struct platform_driver sa1111_device_driver = {

	.probe		= sa1111_probe,

	.remove_new	= sa1111_remove,

	.remove		= sa1111_remove,

	.driver		= {

		.name	= "sa1111",

		.pm	= &sa1111_pm_ops,