From: Matthias Maennich <maennich@google.com>
To: Christoph Hellwig <hch@infradead.org>
Cc: linux-kernel@vger.kernel.org, kernel-team@android.com,
arnd@arndb.de, geert@linux-m68k.org, gregkh@linuxfoundation.org,
hpa@zytor.com, jeyu@kernel.org, joel@joelfernandes.org,
kstewart@linuxfoundation.org, linux-arch@vger.kernel.org,
linux-kbuild@vger.kernel.org, linux-m68k@lists.linux-m68k.org,
linux-modules@vger.kernel.org, linux-scsi@vger.kernel.org,
linux-usb@vger.kernel.org, lucas.de.marchi@gmail.com,
maco@android.com, maco@google.com, michal.lkml@markovi.net,
mingo@redhat.com, oneukum@suse.com, pombredanne@nexb.com,
sam@ravnborg.org, sspatil@google.com, stern@rowland.harvard.edu,
tglx@linutronix.de, usb-storage@lists.one-eyed-alien.net,
x86@kernel.org, yamada.masahiro@socionext.com
Subject: Re: [PATCH v3 10/11] RFC: usb-storage: export symbols in USB_STORAGE namespace
Date: Thu, 22 Aug 2019 09:32:23 +0100 [thread overview]
Message-ID: <20190822083223.GA15709@google.com> (raw)
In-Reply-To: <20190821231329.GA369@infradead.org>
On Wed, Aug 21, 2019 at 04:13:29PM -0700, Christoph Hellwig wrote:
>On Wed, Aug 21, 2019 at 12:49:25PM +0100, Matthias Maennich wrote:
>> Modules using these symbols are required to explicitly import the
>> namespace. This patch was generated with the following steps and serves
>> as a reference to use the symbol namespace feature:
>>
>> 1) Define DEFAULT_SYMBOL_NAMESPACE in the corresponding Makefile
>> 2) make (see warnings during modpost about missing imports)
>> 3) make nsdeps
>>
>> Instead of a DEFAULT_SYMBOL_NAMESPACE definition, the EXPORT_SYMBOL_NS
>> variants can be used to explicitly specify the namespace. The advantage
>> of the method used here is that newly added symbols are automatically
>> exported and existing ones are exported without touching their
>> respective EXPORT_SYMBOL macro expansion.
>
>So what is USB_STORAGE here? It isn't a C string, so where does it
>come from? To me using a C string would seem like the nicer interface
>vs a random cpp symbol that gets injected somewhere.
To be honest, I would also prefer an interface that uses C strings or
literals for the new EXPORT_SYMBOLS* macros:
EXPORT_SYMBOL_NS(mysym, "USB_STORAGE");
or
const char USB_STORAGE_NS[] = "USB_STORAGE";
EXPORT_SYMBOL_NS(mysym, USB_STORAGE_NS);
The DEFAULT_SYMBOL_NAMESPACE define within Makefiles would get a bit
more verbose in that case to express the literal:
ccflags-y += -DDEFAULT_SYMBOL_NAMESPACE="\"USB_STORAGE\""
The main reason against that, is, that in the expansion of
EXPORT_SYMBOL_NS, we define the ksymtab entry, which name is
constructed partly by the name of the namespace:
static const struct kernel_symbol __ksymtab_##sym##__##ns ...
^^^^
For that we depend on a cpp symbol to construct the name. I am not sure
there is a reasonable way of getting rid of that without ending up
constructing the ksymtab entries completely in asm as it is already done
in case of PREL32_RELOCATIONS. But I am happy to be corrected.
For reference that is done in patch 03/11 of this series:
https://lore.kernel.org/lkml/20190821114955.12788-4-maennich@google.com/
Cheers,
Matthias
next prev parent reply other threads:[~2019-08-22 8:32 UTC|newest]
Thread overview: 265+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-07-16 12:21 [PATCH 0/6] Symbol namespaces Martijn Coenen
2018-07-16 12:21 ` Martijn Coenen
2018-07-16 12:21 ` [PATCH 1/6] export: explicitly align struct kernel_symbol Martijn Coenen
2018-07-16 12:21 ` [1/6] " Martijn Coenen
2018-07-16 12:21 ` [PATCH 1/6] " Martijn Coenen
2018-07-16 12:21 ` [PATCH 2/6] module: add support for symbol namespaces Martijn Coenen
2018-07-16 12:21 ` [2/6] " Martijn Coenen
2018-07-16 12:21 ` [PATCH 2/6] " Martijn Coenen
2018-07-19 16:32 ` Jessica Yu
2018-07-19 16:32 ` [2/6] " Jessica Yu
2018-07-19 16:32 ` [PATCH 2/6] " Jessica Yu
2018-07-20 7:54 ` Martijn Coenen
2018-07-20 7:54 ` [2/6] " Martijn Coenen
2018-07-20 7:54 ` [PATCH 2/6] " Martijn Coenen
2018-07-20 14:49 ` Jessica Yu
2018-07-20 14:49 ` [2/6] " Jessica Yu
2018-07-20 14:49 ` [PATCH 2/6] " Jessica Yu
2018-07-20 15:42 ` Martijn Coenen
2018-07-20 15:42 ` [2/6] " Martijn Coenen
2018-07-20 15:42 ` [PATCH 2/6] " Martijn Coenen
2018-07-23 11:12 ` Jessica Yu
2018-07-23 11:12 ` [2/6] " Jessica Yu
2018-07-23 11:12 ` [PATCH 2/6] " Jessica Yu
2018-07-24 7:44 ` Martijn Coenen
2018-07-24 7:44 ` [2/6] " Martijn Coenen
2018-07-24 7:44 ` [PATCH 2/6] " Martijn Coenen
2018-07-24 7:56 ` Martijn Coenen
2018-07-24 7:56 ` [2/6] " Martijn Coenen
2018-07-24 7:56 ` [PATCH 2/6] " Martijn Coenen
2018-07-25 15:55 ` Jessica Yu
2018-07-25 15:55 ` [2/6] " Jessica Yu
2018-07-25 15:55 ` [PATCH 2/6] " Jessica Yu
2018-07-25 16:48 ` Lucas De Marchi
2018-07-25 16:48 ` [2/6] " Lucas De Marchi
2018-07-26 7:44 ` [PATCH 2/6] " Martijn Coenen
2018-07-26 7:44 ` [2/6] " Martijn Coenen
2018-07-26 7:44 ` [PATCH 2/6] " Martijn Coenen
2018-07-16 12:21 ` [PATCH 3/6] modpost: add support for checking " Martijn Coenen
2018-07-16 12:21 ` [3/6] " Martijn Coenen
2018-07-16 12:21 ` [PATCH 3/6] " Martijn Coenen
2018-07-16 12:21 ` [PATCH 4/6] modpost: add support for generating namespace dependencies Martijn Coenen
2018-07-16 12:21 ` [4/6] " Martijn Coenen
2018-07-16 12:21 ` [PATCH 4/6] " Martijn Coenen
2018-07-23 6:49 ` Jessica Yu
2018-07-23 6:49 ` [4/6] " Jessica Yu
2018-07-23 6:49 ` [PATCH 4/6] " Jessica Yu
2018-07-16 12:21 ` [PATCH 5/6] scripts: Coccinelle script for " Martijn Coenen
2018-07-16 12:21 ` [5/6] " Martijn Coenen
2018-07-16 12:21 ` [PATCH 5/6] " Martijn Coenen
2018-07-16 12:21 ` [PATCH 6/6] RFC: USB: storage: move symbols into USB_STORAGE namespace Martijn Coenen
2018-07-16 12:21 ` [6/6] " Martijn Coenen
2018-07-16 12:21 ` [PATCH 6/6] " Martijn Coenen
2018-07-16 15:33 ` [PATCH 0/6] Symbol namespaces Greg Kroah-Hartman
2018-07-16 15:33 ` Greg Kroah-Hartman
2018-07-23 14:28 ` Arnd Bergmann
2018-07-23 14:28 ` Arnd Bergmann
2018-07-24 8:09 ` Martijn Coenen
2018-07-24 8:09 ` Martijn Coenen
2018-07-24 9:08 ` Arnd Bergmann
2018-07-24 9:08 ` Arnd Bergmann
2019-08-13 12:16 ` [Cocci] [PATCH v2 0/10] Symbol namespaces - RFC Matthias Maennich
2019-08-13 12:16 ` Matthias Maennich
2019-08-13 12:16 ` Matthias Maennich
2019-08-13 12:16 ` [PATCH v2 01/10] module: support reading multiple values per modinfo tag Matthias Maennich
2019-08-13 12:40 ` Greg KH
2019-08-13 12:16 ` [PATCH v2 02/10] export: explicitly align struct kernel_symbol Matthias Maennich
2019-08-13 12:16 ` Matthias Maennich
2019-08-13 12:41 ` Greg KH
2019-08-13 12:41 ` Greg KH
2019-08-13 12:17 ` [PATCH v2 03/10] module: add support for symbol namespaces Matthias Maennich
2019-08-13 12:17 ` Matthias Maennich
2019-08-13 15:26 ` Greg KH
2019-08-13 15:26 ` Greg KH
2019-08-13 12:17 ` [PATCH v2 04/10] modpost: " Matthias Maennich
2019-08-13 15:27 ` Greg KH
2019-08-13 12:17 ` [PATCH v2 05/10] module: add config option MODULE_ALLOW_MISSING_NAMESPACE_IMPORTS Matthias Maennich
2019-08-13 12:17 ` Matthias Maennich
2019-08-13 18:17 ` Greg KH
2019-08-13 18:17 ` Greg KH
2019-08-13 20:15 ` Saravana Kannan
2019-08-13 20:15 ` Saravana Kannan
2019-08-14 12:54 ` Matthias Maennich
2019-08-14 12:54 ` Matthias Maennich
2019-08-14 17:34 ` Saravana Kannan
2019-08-14 17:34 ` Saravana Kannan
2019-08-13 12:17 ` [PATCH v2 06/10] export: allow definition default namespaces in Makefiles or sources Matthias Maennich
2019-08-13 18:16 ` Greg KH
2019-08-13 18:16 ` Greg KH
2019-08-13 12:17 ` [PATCH v2 07/10] modpost: add support for generating namespace dependencies Matthias Maennich
2019-08-13 18:21 ` Greg KH
2019-08-13 12:17 ` [Cocci] [PATCH v2 08/10] scripts: Coccinelle script for " Matthias Maennich
2019-08-13 12:17 ` Matthias Maennich
2019-08-13 12:17 ` Matthias Maennich
2019-08-13 12:31 ` [Cocci] " Julia Lawall
2019-08-13 12:31 ` Julia Lawall
2019-08-13 12:31 ` Julia Lawall
2019-08-13 12:44 ` [Cocci] " Greg KH
2019-08-13 12:44 ` Greg KH
2019-08-13 12:44 ` Greg KH
2019-08-14 6:36 ` [Cocci] " Himanshu Jha
2019-08-14 6:36 ` Himanshu Jha
2019-08-14 6:36 ` Himanshu Jha
2019-08-14 8:03 ` Matthias Maennich
2019-08-14 8:03 ` Matthias Maennich
2019-08-14 8:03 ` Matthias Maennich
2019-08-14 12:00 ` [Cocci] [v2 " Markus Elfring
2019-08-14 12:00 ` Markus Elfring
2019-08-14 12:00 ` Markus Elfring
2019-08-14 12:00 ` Markus Elfring
2019-08-14 12:20 ` [Cocci] " Matthias Maennich
2019-08-14 12:20 ` Matthias Maennich
2019-08-15 13:50 ` Markus Elfring
2019-08-15 13:50 ` Markus Elfring
2019-08-15 13:50 ` Markus Elfring
2019-08-22 9:18 ` Matthias Maennich
2019-08-22 9:18 ` Matthias Maennich
2019-08-22 9:18 ` Matthias Maennich
2019-08-22 11:00 ` Markus Elfring
2019-08-22 11:00 ` Markus Elfring
2019-08-22 11:00 ` Markus Elfring
2019-08-13 12:17 ` [PATCH v2 09/10] usb-storage: remove single-use define for debugging Matthias Maennich
2019-08-13 12:42 ` Greg KH
2019-08-13 13:12 ` Greg KH
2019-08-13 12:17 ` [PATCH v2 10/10] RFC: usb-storage: export symbols in USB_STORAGE namespace Matthias Maennich
2019-08-13 12:45 ` Greg KH
2019-08-13 12:47 ` Greg KH
2019-08-13 15:02 ` Matthias Maennich
2019-08-21 11:49 ` [PATCH v3 00/11] Symbol Namespaces Matthias Maennich
2019-08-21 11:49 ` Matthias Maennich
2019-08-21 11:49 ` Matthias Maennich
2019-08-21 11:49 ` Matthias Maennich
2019-08-21 11:49 ` [PATCH v3 01/11] module: support reading multiple values per modinfo tag Matthias Maennich
2019-08-21 11:49 ` [PATCH v3 02/11] export: explicitly align struct kernel_symbol Matthias Maennich
2019-08-21 11:49 ` Matthias Maennich
2019-08-21 11:49 ` [PATCH v3 03/11] module: add support for symbol namespaces Matthias Maennich
2019-08-21 11:49 ` Matthias Maennich
2019-08-27 15:37 ` Jessica Yu
2019-08-27 15:37 ` Jessica Yu
2019-08-27 16:04 ` Matthias Maennich
2019-08-27 16:04 ` Matthias Maennich
2019-08-21 11:49 ` [PATCH v3 04/11] modpost: " Matthias Maennich
2019-08-26 16:21 ` Jessica Yu
2019-08-27 14:41 ` Matthias Maennich
2019-08-28 9:43 ` Jessica Yu
2019-08-28 9:55 ` Matthias Maennich
2019-08-28 10:16 ` Jessica Yu
2019-08-21 11:49 ` [PATCH v3 05/11] module: add config option MODULE_ALLOW_MISSING_NAMESPACE_IMPORTS Matthias Maennich
2019-08-21 11:49 ` Matthias Maennich
2019-08-21 11:49 ` [PATCH v3 06/11] export: allow definition default namespaces in Makefiles or sources Matthias Maennich
2019-08-21 11:49 ` Matthias Maennich
2019-08-28 10:49 ` Jessica Yu
2019-08-28 10:49 ` Jessica Yu
2019-08-28 10:56 ` Matthias Maennich
2019-08-28 10:56 ` Matthias Maennich
2019-08-21 11:49 ` [PATCH v3 07/11] modpost: add support for generating namespace dependencies Matthias Maennich
2019-08-21 11:49 ` Matthias Maennich
2019-08-21 11:49 ` [PATCH v3 08/11] scripts: Coccinelle script for " Matthias Maennich
2019-08-21 11:49 ` Matthias Maennich
2019-08-22 6:09 ` [v3 " Markus Elfring
2019-08-22 6:09 ` Markus Elfring
2019-08-22 6:09 ` Markus Elfring
2019-08-29 12:13 ` [Cocci] [PATCH v3 " Jessica Yu
2019-08-29 12:13 ` Jessica Yu
2019-08-29 12:13 ` Jessica Yu
2019-08-21 11:49 ` [PATCH v3 09/11] usb-storage: remove single-use define for debugging Matthias Maennich
2019-08-21 12:37 ` Greg KH
2019-08-21 13:21 ` Thomas Gleixner
2019-08-21 13:32 ` Greg KH
2019-08-21 11:49 ` [PATCH v3 10/11] RFC: usb-storage: export symbols in USB_STORAGE namespace Matthias Maennich
2019-08-21 12:38 ` Greg KH
2019-08-21 14:36 ` Jessica Yu
2019-08-21 23:13 ` Christoph Hellwig
2019-08-22 8:32 ` Matthias Maennich [this message]
2019-08-21 11:49 ` [PATCH v3 11/11] RFC: watchdog: export core symbols in WATCHDOG_CORE namespace Matthias Maennich
2019-08-21 11:49 ` Matthias Maennich
2019-08-21 11:49 ` Matthias Maennich
2019-08-21 11:49 ` Matthias Maennich
2019-08-21 12:39 ` Greg KH
2019-08-21 12:39 ` Greg KH
2019-08-21 12:39 ` Greg KH
2019-08-21 12:39 ` Greg KH
2019-08-21 14:59 ` Guenter Roeck
2019-08-21 14:59 ` Guenter Roeck
2019-08-21 14:59 ` Guenter Roeck
2019-08-21 14:59 ` Guenter Roeck
2019-08-21 16:28 ` Matthias Maennich
2019-08-21 16:28 ` Matthias Maennich
2019-08-21 16:28 ` Matthias Maennich
2019-08-21 16:28 ` Matthias Maennich
2019-08-21 12:46 ` [PATCH v3 00/11] Symbol Namespaces Nicolas Pitre
2019-08-21 12:46 ` Nicolas Pitre
2019-08-21 12:46 ` Nicolas Pitre
2019-08-21 12:46 ` Nicolas Pitre
2019-08-21 13:37 ` Greg KH
2019-08-21 13:37 ` Greg KH
2019-08-21 13:37 ` Greg KH
2019-08-21 13:37 ` Greg KH
2019-08-21 20:48 ` Nicolas Pitre
2019-08-21 20:48 ` Nicolas Pitre
2019-08-21 20:48 ` Nicolas Pitre
2019-08-21 20:48 ` Nicolas Pitre
2019-08-21 13:11 ` Peter Zijlstra
2019-08-21 13:11 ` Peter Zijlstra
2019-08-21 13:11 ` Peter Zijlstra
2019-08-21 13:11 ` Peter Zijlstra
2019-08-21 13:38 ` Greg KH
2019-08-21 13:38 ` Greg KH
2019-08-21 13:38 ` Greg KH
2019-08-21 13:38 ` Greg KH
2019-08-21 14:03 ` Matthias Maennich
2019-08-21 14:03 ` Matthias Maennich
2019-08-21 14:03 ` Matthias Maennich
2019-08-21 14:03 ` Matthias Maennich
2019-09-03 15:06 ` [PATCH v4 00/12] " Matthias Maennich
2019-09-03 15:06 ` [PATCH v4 01/12] module: support reading multiple values per modinfo tag Matthias Maennich
2019-09-03 15:06 ` [PATCH v4 02/12] export: explicitly align struct kernel_symbol Matthias Maennich
2019-09-03 15:06 ` [PATCH v4 03/12] module: add support for symbol namespaces Matthias Maennich
2019-09-03 15:06 ` [PATCH v4 04/12] modpost: " Matthias Maennich
2019-09-03 15:06 ` [PATCH v4 05/12] module: add config option MODULE_ALLOW_MISSING_NAMESPACE_IMPORTS Matthias Maennich
2019-09-03 15:06 ` [PATCH v4 06/12] export: allow definition default namespaces in Makefiles or sources Matthias Maennich
2019-09-03 15:06 ` [PATCH v4 07/12] modpost: add support for generating namespace dependencies Matthias Maennich
2019-09-03 15:06 ` [PATCH v4 08/12] scripts: Coccinelle script for " Matthias Maennich
2019-09-04 9:53 ` Masahiro Yamada
2019-09-05 14:46 ` Matthias Maennich
2019-09-03 15:06 ` [PATCH v4 09/12] docs: Add documentation for Symbol Namespaces Matthias Maennich
2019-09-04 7:16 ` Greg KH
2019-09-03 15:06 ` [PATCH v4 10/12] usb-storage: remove single-use define for debugging Matthias Maennich
2019-09-03 15:06 ` [PATCH v4 11/12] RFC: usb-storage: export symbols in USB_STORAGE namespace Matthias Maennich
2019-09-03 15:06 ` [PATCH v4 12/12] RFC: watchdog: export core symbols in WATCHDOG_CORE namespace Matthias Maennich
2019-09-03 16:10 ` Guenter Roeck
2019-09-04 8:45 ` Masahiro Yamada
2019-09-04 12:12 ` Guenter Roeck
2019-09-04 16:16 ` [usb-storage] " Matthew Dharm
2019-09-05 10:41 ` Jessica Yu
2019-09-05 10:52 ` Arnd Bergmann
2019-09-05 11:16 ` Jessica Yu
2019-09-05 11:25 ` Masahiro Yamada
2019-09-05 12:00 ` Greg Kroah-Hartman
2019-09-05 11:25 ` Matthias Maennich
2019-09-04 9:37 ` [PATCH v4 00/12] Symbol Namespaces Masahiro Yamada
2019-09-06 10:32 ` [PATCH v5 00/11] " Matthias Maennich
2019-09-06 10:32 ` [PATCH v5 01/11] module: support reading multiple values per modinfo tag Matthias Maennich
2019-09-06 10:32 ` [PATCH v5 02/11] export: explicitly align struct kernel_symbol Matthias Maennich
2019-09-06 10:32 ` [PATCH v5 03/11] module: add support for symbol namespaces Matthias Maennich
2019-09-06 10:32 ` [PATCH v5 04/11] modpost: " Matthias Maennich
2019-09-26 22:24 ` [PATCH] modpost: Copy namespace string into 'struct symbol' Shaun Ruffell
2019-09-27 5:31 ` Greg Kroah-Hartman
2019-09-27 8:03 ` Matthias Maennich
2019-09-30 21:20 ` Shaun Ruffell
2019-10-01 16:19 ` Matthias Maennich
2019-10-01 19:37 ` Shaun Ruffell
2019-09-06 10:32 ` [PATCH v5 05/11] module: add config option MODULE_ALLOW_MISSING_NAMESPACE_IMPORTS Matthias Maennich
2019-09-06 10:32 ` [PATCH v5 06/11] export: allow definition default namespaces in Makefiles or sources Matthias Maennich
2019-09-06 10:32 ` [PATCH v5 07/11] modpost: add support for generating namespace dependencies Matthias Maennich
2019-09-06 10:32 ` [PATCH v5 08/11] scripts: Coccinelle script for " Matthias Maennich
2019-09-06 10:32 ` [PATCH v5 09/11] docs: Add documentation for Symbol Namespaces Matthias Maennich
2019-09-06 10:32 ` [PATCH v5 10/11] usb-storage: remove single-use define for debugging Matthias Maennich
2019-09-06 12:59 ` Jessica Yu
2019-09-06 13:22 ` Greg KH
2019-09-06 10:32 ` [PATCH v5 11/11] usb-storage: export symbols in USB_STORAGE namespace Matthias Maennich
2019-09-09 8:35 ` [PATCH v5 00/11] Symbol Namespaces Jessica Yu
-- strict thread matches above, loose matches on Subject: below --
2018-07-17 15:04 [6/6] RFC: USB: storage: move symbols into USB_STORAGE namespace Alan Stern
2018-07-17 15:04 ` [PATCH 6/6] " Alan Stern
2018-07-18 13:28 [6/6] " Martijn Coenen
2018-07-18 13:28 ` [PATCH 6/6] " Martijn Coenen
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20190822083223.GA15709@google.com \
--to=maennich@google.com \
--cc=arnd@arndb.de \
--cc=geert@linux-m68k.org \
--cc=gregkh@linuxfoundation.org \
--cc=hch@infradead.org \
--cc=hpa@zytor.com \
--cc=jeyu@kernel.org \
--cc=joel@joelfernandes.org \
--cc=kernel-team@android.com \
--cc=kstewart@linuxfoundation.org \
--cc=linux-arch@vger.kernel.org \
--cc=linux-kbuild@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-m68k@lists.linux-m68k.org \
--cc=linux-modules@vger.kernel.org \
--cc=linux-scsi@vger.kernel.org \
--cc=linux-usb@vger.kernel.org \
--cc=lucas.de.marchi@gmail.com \
--cc=maco@android.com \
--cc=maco@google.com \
--cc=michal.lkml@markovi.net \
--cc=mingo@redhat.com \
--cc=oneukum@suse.com \
--cc=pombredanne@nexb.com \
--cc=sam@ravnborg.org \
--cc=sspatil@google.com \
--cc=stern@rowland.harvard.edu \
--cc=tglx@linutronix.de \
--cc=usb-storage@lists.one-eyed-alien.net \
--cc=x86@kernel.org \
--cc=yamada.masahiro@socionext.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.