€•xg      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”(hhŒparent”hubaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ./translations/zh_CN/core-api/symbol-namespaces”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”(hhhh2ubah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/zh_TW/core-api/symbol-namespaces”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”(hhhhFubah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/it_IT/core-api/symbol-namespaces”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”(hhhhZubah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/ja_JP/core-api/symbol-namespaces”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”(hhhhnubah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/ko_KR/core-api/symbol-namespaces”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”(hhhh‚ubah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/sp_SP/core-api/symbol-namespaces”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒSymbol Namespaces”h]”hŒSymbol Namespaces”…””}”(hhªhh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒH/var/lib/git/docbuild/linux/Documentation/core-api/symbol-namespaces.rst”h KubhŒ	paragraph”“”)”}”(hŒ©The following document describes how to use Symbol Namespaces to structure the
export surface of in-kernel symbols exported through the family of
EXPORT_SYMBOL() macros.”h]”hŒ©The following document describes how to use Symbol Namespaces to structure the
export surface of in-kernel symbols exported through the family of
EXPORT_SYMBOL() macros.”…””}”(hh»hh¹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubhŒcomment”“”)”}”(hXE  Table of Contents

=== 1 Introduction
=== 2 How to define Symbol Namespaces
   --- 2.1 Using the EXPORT_SYMBOL macros
   --- 2.2 Using the DEFAULT_SYMBOL_NAMESPACE define
=== 3 How to use Symbols exported in Namespaces
=== 4 Loading Modules that use namespaced Symbols
=== 5 Automatically creating MODULE_IMPORT_NS statements”h]”hXE  Table of Contents

=== 1 Introduction
=== 2 How to define Symbol Namespaces
   --- 2.1 Using the EXPORT_SYMBOL macros
   --- 2.2 Using the DEFAULT_SYMBOL_NAMESPACE define
=== 3 How to use Symbols exported in Namespaces
=== 4 Loading Modules that use namespaced Symbols
=== 5 Automatically creating MODULE_IMPORT_NS statements”…””}”(hhhhÉubah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1hÇhh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒ1. Introduction”h]”hŒ1. Introduction”…””}”(hhÞhhÜhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hhÙhžhhŸh¶h Kubh¸)”}”(hX^  Symbol Namespaces have been introduced as a means to structure the export
surface of the in-kernel API. It allows subsystem maintainers to partition
their exported symbols into separate namespaces. That is useful for
documentation purposes (think of the SUBSYSTEM_DEBUG namespace) as well as for
limiting the availability of a set of symbols for use in other parts of the
kernel. As of today, modules that make use of symbols exported into namespaces,
are required to import the namespace. Otherwise the kernel will, depending on
its configuration, reject loading the module or warn about a missing import.”h]”hX^  Symbol Namespaces have been introduced as a means to structure the export
surface of the in-kernel API. It allows subsystem maintainers to partition
their exported symbols into separate namespaces. That is useful for
documentation purposes (think of the SUBSYSTEM_DEBUG namespace) as well as for
limiting the availability of a set of symbols for use in other parts of the
kernel. As of today, modules that make use of symbols exported into namespaces,
are required to import the namespace. Otherwise the kernel will, depending on
its configuration, reject loading the module or warn about a missing import.”…””}”(hhìhhêhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KhhÙhžhubeh}”(h]”Œintroduction”ah ]”h"]”Œ1. introduction”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒ"2. How to define Symbol Namespaces”h]”hŒ"2. How to define Symbol Namespaces”…””}”(hj  hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj   hžhhŸh¶h K ubh¸)”}”(hŒ¦Symbols can be exported into namespace using different methods. All of them are
changing the way EXPORT_SYMBOL and friends are instrumented to create ksymtab
entries.”h]”hŒ¦Symbols can be exported into namespace using different methods. All of them are
changing the way EXPORT_SYMBOL and friends are instrumented to create ksymtab
entries.”…””}”(hj  hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K"hj   hžhubeh}”(h]”Œhow-to-define-symbol-namespaces”ah ]”h"]”Œ"2. how to define symbol namespaces”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K ubh¢)”}”(hhh]”(h§)”}”(hŒ"2.1 Using the EXPORT_SYMBOL macros”h]”hŒ"2.1 Using the EXPORT_SYMBOL macros”…””}”(hj,  hj*  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj'  hžhhŸh¶h K'ubh¸)”}”(hXä  In addition to the macros EXPORT_SYMBOL() and EXPORT_SYMBOL_GPL(), that allow
exporting of kernel symbols to the kernel symbol table, variants of these are
available to export symbols into a certain namespace: EXPORT_SYMBOL_NS() and
EXPORT_SYMBOL_NS_GPL(). They take one additional argument: the namespace.
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::”h]”(hX¦  In addition to the macros EXPORT_SYMBOL() and EXPORT_SYMBOL_GPL(), that allow
exporting of kernel symbols to the kernel symbol table, variants of these are
available to export symbols into a certain namespace: EXPORT_SYMBOL_NS() and
EXPORT_SYMBOL_NS_GPL(). They take one additional argument: the namespace.
Please note that due to macro expansion that argument needs to be a
preprocessor symbol. E.g. to export the symbol ”…””}”(hX¦  In addition to the macros EXPORT_SYMBOL() and EXPORT_SYMBOL_GPL(), that allow
exporting of kernel symbols to the kernel symbol table, variants of these are
available to export symbols into a certain namespace: EXPORT_SYMBOL_NS() and
EXPORT_SYMBOL_NS_GPL(). They take one additional argument: the namespace.
Please note that due to macro expansion that argument needs to be a
preprocessor symbol. E.g. to export the symbol ”hj8  hžhhŸNh NubhŒliteral”“”)”}”(hŒ``usb_stor_suspend``”h]”hŒusb_stor_suspend”…””}”(hhhjC  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jA  hj8  ubhŒ into the
namespace ”…””}”(hŒ into the
namespace ”hj8  hžhhŸNh NubjB  )”}”(hŒ``USB_STORAGE``”h]”hŒUSB_STORAGE”…””}”(hhhjV  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jA  hj8  ubhŒ, use:”…””}”(hŒ, use:”hj8  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K)hj'  hžhubhŒliteral_block”“”)”}”(hŒ0EXPORT_SYMBOL_NS(usb_stor_suspend, USB_STORAGE);”h]”hŒ0EXPORT_SYMBOL_NS(usb_stor_suspend, USB_STORAGE);”…””}”(hhhjq  ubah}”(h]”h ]”h"]”h$]”h&]”h×hØuh1jo  hŸh¶h K1hj'  hžhubh¸)”}”(hXQ  The corresponding ksymtab entry struct ``kernel_symbol`` will have the member
``namespace`` set accordingly. A symbol that is exported without a namespace will
refer to ``NULL``. There is no default namespace if none is defined. ``modpost``
and kernel/module/main.c make use the namespace at build time or module load
time, respectively.”h]”(hŒ'The corresponding ksymtab entry struct ”…””}”(hŒ'The corresponding ksymtab entry struct ”hj  hžhhŸNh NubjB  )”}”(hŒ``kernel_symbol``”h]”hŒkernel_symbol”…””}”(hhhjˆ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jA  hj  ubhŒ will have the member
”…””}”(hŒ will have the member
”hj  hžhhŸNh NubjB  )”}”(hŒ``namespace``”h]”hŒ	namespace”…””}”(hhhj›  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jA  hj  ubhŒN set accordingly. A symbol that is exported without a namespace will
refer to ”…””}”(hŒN set accordingly. A symbol that is exported without a namespace will
refer to ”hj  hžhhŸNh NubjB  )”}”(hŒ``NULL``”h]”hŒNULL”…””}”(hhhj®  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jA  hj  ubhŒ4. There is no default namespace if none is defined. ”…””}”(hŒ4. There is no default namespace if none is defined. ”hj  hžhhŸNh NubjB  )”}”(hŒ``modpost``”h]”hŒmodpost”…””}”(hhhjÁ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jA  hj  ubhŒa
and kernel/module/main.c make use the namespace at build time or module load
time, respectively.”…””}”(hŒa
and kernel/module/main.c make use the namespace at build time or module load
time, respectively.”hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K3hj'  hžhubeh}”(h]”Œusing-the-export-symbol-macros”ah ]”h"]”Œ"2.1 using the export_symbol macros”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K'ubh¢)”}”(hhh]”(h§)”}”(hŒ-2.2 Using the DEFAULT_SYMBOL_NAMESPACE define”h]”hŒ-2.2 Using the DEFAULT_SYMBOL_NAMESPACE define”…””}”(hjç  hjå  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjâ  hžhhŸh¶h K:ubh¸)”}”(hX7  Defining namespaces for all symbols of a subsystem can be very verbose and may
become hard to maintain. Therefore a default define (DEFAULT_SYMBOL_NAMESPACE)
is been provided, that, if set, will become the default for all EXPORT_SYMBOL()
and EXPORT_SYMBOL_GPL() macro expansions that do not specify a namespace.”h]”hX7  Defining namespaces for all symbols of a subsystem can be very verbose and may
become hard to maintain. Therefore a default define (DEFAULT_SYMBOL_NAMESPACE)
is been provided, that, if set, will become the default for all EXPORT_SYMBOL()
and EXPORT_SYMBOL_GPL() macro expansions that do not specify a namespace.”…””}”(hjõ  hjó  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K<hjâ  hžhubh¸)”}”(hXd  There are multiple ways of specifying this define and it depends on the
subsystem and the maintainer's preference, which one to use. The first option
is to define the default namespace in the ``Makefile`` of the subsystem. E.g. to
export all symbols defined in usb-common into the namespace USB_COMMON, add a
line like this to drivers/usb/common/Makefile::”h]”(hŒÂThere are multiple ways of specifying this define and it depends on the
subsystem and the maintainerâ€™s preference, which one to use. The first option
is to define the default namespace in the ”…””}”(hŒÀThere are multiple ways of specifying this define and it depends on the
subsystem and the maintainer's preference, which one to use. The first option
is to define the default namespace in the ”hj  hžhhŸNh NubjB  )”}”(hŒ``Makefile``”h]”hŒMakefile”…””}”(hhhj
  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jA  hj  ubhŒ— of the subsystem. E.g. to
export all symbols defined in usb-common into the namespace USB_COMMON, add a
line like this to drivers/usb/common/Makefile:”…””}”(hŒ— of the subsystem. E.g. to
export all symbols defined in usb-common into the namespace USB_COMMON, add a
line like this to drivers/usb/common/Makefile:”hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KAhjâ  hžhubjp  )”}”(hŒ2ccflags-y += -DDEFAULT_SYMBOL_NAMESPACE=USB_COMMON”h]”hŒ2ccflags-y += -DDEFAULT_SYMBOL_NAMESPACE=USB_COMMON”…””}”(hhhj#  ubah}”(h]”h ]”h"]”h$]”h&]”h×hØuh1jo  hŸh¶h KGhjâ  hžhubh¸)”}”(hX(  That will affect all EXPORT_SYMBOL() and EXPORT_SYMBOL_GPL() statements. A
symbol exported with EXPORT_SYMBOL_NS() while this definition is present, will
still be exported into the namespace that is passed as the namespace argument
as this argument has preference over a default symbol namespace.”h]”hX(  That will affect all EXPORT_SYMBOL() and EXPORT_SYMBOL_GPL() statements. A
symbol exported with EXPORT_SYMBOL_NS() while this definition is present, will
still be exported into the namespace that is passed as the namespace argument
as this argument has preference over a default symbol namespace.”…””}”(hj3  hj1  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KIhjâ  hžhubh¸)”}”(hŒ’A second option to define the default namespace is directly in the compilation
unit as preprocessor statement. The above example would then read::”h]”hŒ‘A second option to define the default namespace is directly in the compilation
unit as preprocessor statement. The above example would then read:”…””}”(hŒ‘A second option to define the default namespace is directly in the compilation
unit as preprocessor statement. The above example would then read:”hj?  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KNhjâ  hžhubjp  )”}”(hŒL#undef  DEFAULT_SYMBOL_NAMESPACE
#define DEFAULT_SYMBOL_NAMESPACE USB_COMMON”h]”hŒL#undef  DEFAULT_SYMBOL_NAMESPACE
#define DEFAULT_SYMBOL_NAMESPACE USB_COMMON”…””}”(hhhjN  ubah}”(h]”h ]”h"]”h$]”h&]”h×hØuh1jo  hŸh¶h KQhjâ  hžhubh¸)”}”(hŒQwithin the corresponding compilation unit before any EXPORT_SYMBOL macro is
used.”h]”hŒQwithin the corresponding compilation unit before any EXPORT_SYMBOL macro is
used.”…””}”(hj^  hj\  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KThjâ  hžhubeh}”(h]”Œ)using-the-default-symbol-namespace-define”ah ]”h"]”Œ-2.2 using the default_symbol_namespace define”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K:ubh¢)”}”(hhh]”(h§)”}”(hŒ,3. How to use Symbols exported in Namespaces”h]”hŒ,3. How to use Symbols exported in Namespaces”…””}”(hjw  hju  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjr  hžhhŸh¶h KXubh¸)”}”(hX‘  In order to use symbols that are exported into namespaces, kernel modules need
to explicitly import these namespaces. Otherwise the kernel might reject to
load the module. The module code is required to use the macro MODULE_IMPORT_NS
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::”h]”hX  In order to use symbols that are exported into namespaces, kernel modules need
to explicitly import these namespaces. Otherwise the kernel might reject to
load the module. The module code is required to use the macro MODULE_IMPORT_NS
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:”…””}”(hX  In order to use symbols that are exported into namespaces, kernel modules need
to explicitly import these namespaces. Otherwise the kernel might reject to
load the module. The module code is required to use the macro MODULE_IMPORT_NS
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:”hjƒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KZhjr  hžhubjp  )”}”(hŒMODULE_IMPORT_NS(USB_STORAGE);”h]”hŒMODULE_IMPORT_NS(USB_STORAGE);”…””}”(hhhj’  ubah}”(h]”h ]”h"]”h$]”h&]”h×hØuh1jo  hŸh¶h Kahjr  hžhubh¸)”}”(hŒ°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
inspected with modinfo::”h]”(hŒThis will create a ”…””}”(hŒThis will create a ”hj   hžhhŸNh NubjB  )”}”(hŒ``modinfo``”h]”hŒmodinfo”…””}”(hhhj©  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jA  hj   ubhŒ‘ tag in the module for each imported namespace.
This has the side effect, that the imported namespaces of a module can be
inspected with modinfo:”…””}”(hŒ‘ tag in the module for each imported namespace.
This has the side effect, that the imported namespaces of a module can be
inspected with modinfo:”hj   hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kchjr  hžhubjp  )”}”(hŒR$ modinfo drivers/usb/storage/ums-karma.ko
[...]
import_ns:      USB_STORAGE
[...]”h]”hŒR$ modinfo drivers/usb/storage/ums-karma.ko
[...]
import_ns:      USB_STORAGE
[...]”…””}”(hhhjÂ  ubah}”(h]”h ]”h"]”h$]”h&]”h×hØuh1jo  hŸh¶h Kghjr  hžhubh¸)”}”(hŒÝ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.”h]”hŒÝ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.”…””}”(hjÒ  hjÐ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kmhjr  hžhubeh}”(h]”Œ)how-to-use-symbols-exported-in-namespaces”ah ]”h"]”Œ,3. how to use symbols exported in namespaces”ah$]”h&]”uh1h¡hh£hžhhŸh¶h KXubh¢)”}”(hhh]”(h§)”}”(hŒ.4. Loading Modules that use namespaced Symbols”h]”hŒ.4. Loading Modules that use namespaced Symbols”…””}”(hjë  hjé  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjæ  hžhhŸh¶h Krubh¸)”}”(hXP  At module loading time (e.g. ``insmod``), the kernel will check each symbol
referenced from the module for its availability and whether the namespace it
might be exported to has been imported by the module. The default behaviour of
the kernel is to reject loading modules that don't specify sufficient imports.
An error will be logged and loading will be failed with EINVAL. In order to
allow loading of modules that don't satisfy this precondition, a configuration
option is available: Setting MODULE_ALLOW_MISSING_NAMESPACE_IMPORTS=y will
enable loading regardless, but will emit a warning.”h]”(hŒAt module loading time (e.g. ”…””}”(hŒAt module loading time (e.g. ”hj÷  hžhhŸNh NubjB  )”}”(hŒ
``insmod``”h]”hŒinsmod”…””}”(hhhj   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jA  hj÷  ubhX-  ), the kernel will check each symbol
referenced from the module for its availability and whether the namespace it
might be exported to has been imported by the module. The default behaviour of
the kernel is to reject loading modules that donâ€™t specify sufficient imports.
An error will be logged and loading will be failed with EINVAL. In order to
allow loading of modules that donâ€™t satisfy this precondition, a configuration
option is available: Setting MODULE_ALLOW_MISSING_NAMESPACE_IMPORTS=y will
enable loading regardless, but will emit a warning.”…””}”(hX)  ), the kernel will check each symbol
referenced from the module for its availability and whether the namespace it
might be exported to has been imported by the module. The default behaviour of
the kernel is to reject loading modules that don't specify sufficient imports.
An error will be logged and loading will be failed with EINVAL. In order to
allow loading of modules that don't satisfy this precondition, a configuration
option is available: Setting MODULE_ALLOW_MISSING_NAMESPACE_IMPORTS=y will
enable loading regardless, but will emit a warning.”hj÷  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kthjæ  hžhubeh}”(h]”Œ+loading-modules-that-use-namespaced-symbols”ah ]”h"]”Œ.4. loading modules that use namespaced symbols”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Krubh¢)”}”(hhh]”(h§)”}”(hŒ55. Automatically creating MODULE_IMPORT_NS statements”h]”hŒ55. Automatically creating MODULE_IMPORT_NS statements”…””}”(hj&  hj$  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj!  hžhhŸh¶h K~ubh¸)”}”(hXÇ  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
(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::”h]”hXÆ  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
(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:”…””}”(hXÆ  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
(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:”hj2  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K€hj!  hžhubjp  )”}”(hŒ$ make nsdeps”h]”hŒ$ make nsdeps”…””}”(hhhjA  ubah}”(h]”h ]”h"]”h$]”h&]”h×hØuh1jo  hŸh¶h Kˆhj!  hžhubh¸)”}”(hŒ0A typical scenario for module authors would be::”h]”hŒ/A typical scenario for module authors would be:”…””}”(hŒ/A typical scenario for module authors would be:”hjO  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KŠhj!  hžhubjp  )”}”(hŒÒ- write code that depends on a symbol from a not imported namespace
- ``make``
- notice the warning of modpost telling about a missing import
- run ``make nsdeps`` to add the import to the correct code location”h]”hŒÒ- write code that depends on a symbol from a not imported namespace
- ``make``
- notice the warning of modpost telling about a missing import
- run ``make nsdeps`` to add the import to the correct code location”…””}”(hhhj^  ubah}”(h]”h ]”h"]”h$]”h&]”h×hØuh1jo  hŸh¶h KŒhj!  hžhubh¸)”}”(hŒ­For subsystem maintainers introducing a namespace, the steps are very similar.
Again, ``make nsdeps`` will eventually add the missing namespace imports for
in-tree modules::”h]”(hŒVFor subsystem maintainers introducing a namespace, the steps are very similar.
Again, ”…””}”(hŒVFor subsystem maintainers introducing a namespace, the steps are very similar.
Again, ”hjl  hžhhŸNh NubjB  )”}”(hŒ``make nsdeps``”h]”hŒmake nsdeps”…””}”(hhhju  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jA  hjl  ubhŒG will eventually add the missing namespace imports for
in-tree modules:”…””}”(hŒG will eventually add the missing namespace imports for
in-tree modules:”hjl  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K‘hj!  hžhubjp  )”}”(hX  - move or add symbols to a namespace (e.g. with EXPORT_SYMBOL_NS())
- ``make`` (preferably with an allmodconfig to cover all in-kernel
  modules)
- notice the warning of modpost telling about a missing import
- run ``make nsdeps`` to add the import to the correct code location”h]”hX  - move or add symbols to a namespace (e.g. with EXPORT_SYMBOL_NS())
- ``make`` (preferably with an allmodconfig to cover all in-kernel
  modules)
- notice the warning of modpost telling about a missing import
- run ``make nsdeps`` to add the import to the correct code location”…””}”(hhhjŽ  ubah}”(h]”h ]”h"]”h$]”h&]”h×hØuh1jo  hŸh¶h K•hj!  hžhubh¸)”}”(hŒHYou can also run nsdeps for external module builds. A typical usage is::”h]”hŒGYou can also run nsdeps for external module builds. A typical usage is:”…””}”(hŒGYou can also run nsdeps for external module builds. A typical usage is:”hjœ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K›hj!  hžhubjp  )”}”(hŒ,$ make -C <path_to_kernel_src> M=$PWD nsdeps”h]”hŒ,$ make -C <path_to_kernel_src> M=$PWD nsdeps”…””}”(hhhj«  ubah}”(h]”h ]”h"]”h$]”h&]”h×hØuh1jo  hŸh¶h Khj!  hžhubeh}”(h]”Œ2automatically-creating-module-import-ns-statements”ah ]”h"]”Œ55. automatically creating module_import_ns statements”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K~ubeh}”(h]”Œsymbol-namespaces”ah ]”h"]”Œsymbol namespaces”ah$]”h&]”uh1h¡hhhžhhŸh¶h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h¶uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¦NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jì  Œerror_encoding”ŒUTF-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h¶Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œembed_images”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jÆ  jÃ  hýhúj$  j!  jß  jÜ  jo  jl  jã  jà  j  j  j¾  j»  uŒ	nametypes”}”(jÆ  NhýNj$  Njß  Njo  Njã  Nj  Nj¾  Nuh}”(jÃ  h£húhÙj!  j   jÜ  j'  jl  jâ  jà  jr  j  jæ  j»  j!  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.