All of lore.kernel.org
 help / color / mirror / Atom feed
From: Jon Hunter <jon-hunter@ti.com>
To: Kevin Hilman <khilman@ti.com>
Cc: "Cousson, Benoit" <b-cousson@ti.com>,
	Paul Walmsley <paul@pwsan.com>, Ming Lei <ming.lei@canonical.com>,
	Will Deacon <will.deacon@arm.com>,
	Jean Pihet <jean.pihet@newoldbits.com>,
	Maynard Johnson <maynardj@us.ibm.com>,
	"Shilimkar, Santosh" <santosh.shilimkar@ti.com>,
	"oprofile-list@lists.sourceforge.net"
	<oprofile-list@lists.sourceforge.net>,
	Lik Lik <lik88888@gmail.com>,
	"eranian@gmail.com" <eranian@gmail.com>,
	"linux-omap@vger.kernel.org" <linux-omap@vger.kernel.org>,
	"linux-arm-kernel@lists.infradead.org"
	<linux-arm-kernel@lists.infradead.org>
Subject: Re: oprofile and ARM A9 hardware counter
Date: Tue, 8 May 2012 14:51:38 -0500	[thread overview]
Message-ID: <4FA9794A.7030607@ti.com> (raw)
In-Reply-To: <87wr4mr6io.fsf@ti.com>


On 05/08/2012 11:18 AM, Kevin Hilman wrote:
> "Cousson, Benoit" <b-cousson@ti.com> writes:
> 
>> On 5/8/2012 4:00 PM, Kevin Hilman wrote:
>>> Jean Pihet<jean.pihet@newoldbits.com>  writes:
>>>
>>> [...]
>>>
>>>>>>> Yes, indeed, we should not hack the flags to fix that kind of issue. The
>>>>>>> flags describe what the HW is capable of, and the EMU CD can support
>>>>>>> HW_AUTO
>>>>>>> and SW_WAKEUP. AFAIK, the issue with that EMU CD is that the only valid
>>>>>>> next
>>>>>>> power state is OFF, meaning that no retention mode is supported. So any
>>>>>>> transition to idle will go to OFF and lead to a reset upon wakeup.
>>>>>>>
>>>>>>> That being said, being able to transition to OFF during idle is a
>>>>>>> perfectly
>>>>>>> valid state for most powerdomain in OMAP anyway, so we should be able to
>>>>>>> restore from OFF mode smoothly.
>>>>>>>
>>>>>>> It looks to me that what is missing here is *just* a restore path in the
>>>>>>> PMU/CTI code. But I'm probably missing some nasty details in this issue
>>>>>>> :-)
>>>>>>
>>>>>> Although it is perfectly feasible to have a seamless transition of the
>>>>>> EMU power domain, I think the PMU counters will not be accurate
>>>>>> anymore since they stop counting events when going to OFF and re-start
>>>>>> after the state restore.
>>>>>
>>>>>
>>>>> Good point, but I think the PMU might still works fine because located
>>>>> inside the MPU domain. AFAIR, only the path to access the PMU and the CTI is
>>>>> going to OFF and thus will be reset.
>>>>
>>>> Ever better point ;p Thanks for the precision.
>>>> In any case my point was: can we allow the EMU CD to go OFF or prevent
>>>> it from doing so? We need to answer that question first.
>>>>
>>>
>>> The idea I've suggested is to use runtime PM for this.  As long as the
>>> PMU is in use, it will be runtime PM enabled (and not allowed to go into
>>> HWSUP idle.)  When it is not used, it will be allowed to HWSUP idle, and
>>> then be reset.  The next time it is needed, the runtime resume will need
>>> to do a full re-init.
>>
>> Oh, but does that mean that this driver is not pm_runtime adapted yet?
>>
> 
> Actually, it is.  Ming Lei has done it.
> 
> Currently, Will has collected this[1] and is waiting (patiently) for us
> to produce a real fix that doesn't kill PM in the process.

I had to make a couple mods to Ming's patches but I do have something
working now that _should_ not break PM. However, per my previous email
(in response to Benoit's) I am struggling with the definition of the
CLKDM_CAN_XXXXXX_AUTO flags to know the correct way to fix this.

I was going to send out my patches, but I wanted to get some more
feedback on this first.

Cheers
Jon




WARNING: multiple messages have this Message-ID (diff)
From: jon-hunter@ti.com (Jon Hunter)
To: linux-arm-kernel@lists.infradead.org
Subject: oprofile and ARM A9 hardware counter
Date: Tue, 8 May 2012 14:51:38 -0500	[thread overview]
Message-ID: <4FA9794A.7030607@ti.com> (raw)
In-Reply-To: <87wr4mr6io.fsf@ti.com>


On 05/08/2012 11:18 AM, Kevin Hilman wrote:
> "Cousson, Benoit" <b-cousson@ti.com> writes:
> 
>> On 5/8/2012 4:00 PM, Kevin Hilman wrote:
>>> Jean Pihet<jean.pihet@newoldbits.com>  writes:
>>>
>>> [...]
>>>
>>>>>>> Yes, indeed, we should not hack the flags to fix that kind of issue. The
>>>>>>> flags describe what the HW is capable of, and the EMU CD can support
>>>>>>> HW_AUTO
>>>>>>> and SW_WAKEUP. AFAIK, the issue with that EMU CD is that the only valid
>>>>>>> next
>>>>>>> power state is OFF, meaning that no retention mode is supported. So any
>>>>>>> transition to idle will go to OFF and lead to a reset upon wakeup.
>>>>>>>
>>>>>>> That being said, being able to transition to OFF during idle is a
>>>>>>> perfectly
>>>>>>> valid state for most powerdomain in OMAP anyway, so we should be able to
>>>>>>> restore from OFF mode smoothly.
>>>>>>>
>>>>>>> It looks to me that what is missing here is *just* a restore path in the
>>>>>>> PMU/CTI code. But I'm probably missing some nasty details in this issue
>>>>>>> :-)
>>>>>>
>>>>>> Although it is perfectly feasible to have a seamless transition of the
>>>>>> EMU power domain, I think the PMU counters will not be accurate
>>>>>> anymore since they stop counting events when going to OFF and re-start
>>>>>> after the state restore.
>>>>>
>>>>>
>>>>> Good point, but I think the PMU might still works fine because located
>>>>> inside the MPU domain. AFAIR, only the path to access the PMU and the CTI is
>>>>> going to OFF and thus will be reset.
>>>>
>>>> Ever better point ;p Thanks for the precision.
>>>> In any case my point was: can we allow the EMU CD to go OFF or prevent
>>>> it from doing so? We need to answer that question first.
>>>>
>>>
>>> The idea I've suggested is to use runtime PM for this.  As long as the
>>> PMU is in use, it will be runtime PM enabled (and not allowed to go into
>>> HWSUP idle.)  When it is not used, it will be allowed to HWSUP idle, and
>>> then be reset.  The next time it is needed, the runtime resume will need
>>> to do a full re-init.
>>
>> Oh, but does that mean that this driver is not pm_runtime adapted yet?
>>
> 
> Actually, it is.  Ming Lei has done it.
> 
> Currently, Will has collected this[1] and is waiting (patiently) for us
> to produce a real fix that doesn't kill PM in the process.

I had to make a couple mods to Ming's patches but I do have something
working now that _should_ not break PM. However, per my previous email
(in response to Benoit's) I am struggling with the definition of the
CLKDM_CAN_XXXXXX_AUTO flags to know the correct way to fix this.

I was going to send out my patches, but I wanted to get some more
feedback on this first.

Cheers
Jon

  reply	other threads:[~2012-05-08 19:52 UTC|newest]

Thread overview: 257+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <CAAO=S0+L2Q1YZC-pfm2Lz8jPooTeHYOMaZbtRgHYFoL_m7rvhA@mail.gmail.com>
     [not found] ` <4F0B182D.7060507@us.ibm.com>
2012-01-09 22:49   ` oprofile and ARM A9 hardware counter Will Deacon
2012-01-09 22:49     ` Will Deacon
2012-01-09 23:30     ` Ming Lei
2012-01-09 23:30       ` Ming Lei
2012-01-10  0:46       ` stephane eranian
2012-01-10  0:46         ` stephane eranian
2012-01-18  4:18         ` Ming Lei
2012-01-18  4:18           ` Ming Lei
2012-01-18  9:33           ` Ming Lei
2012-01-18  9:33             ` Ming Lei
2012-01-18 11:39             ` Shilimkar, Santosh
2012-01-18 11:39               ` Shilimkar, Santosh
2012-01-18 12:24               ` Ming Lei
2012-01-18 12:24                 ` Ming Lei
2012-01-18 12:33                 ` Shilimkar, Santosh
2012-01-18 12:33                   ` Shilimkar, Santosh
2012-04-03  9:25                   ` Will Deacon
2012-04-03  9:25                     ` Will Deacon
2012-04-03  9:42                     ` Shilimkar, Santosh
2012-04-03  9:42                       ` Shilimkar, Santosh
2012-04-03  9:47                       ` Will Deacon
2012-04-03  9:47                         ` Will Deacon
2012-04-03 10:01                         ` Shilimkar, Santosh
2012-04-03 10:01                           ` Shilimkar, Santosh
2012-04-03 12:34                           ` Will Deacon
2012-04-03 12:34                             ` Will Deacon
2012-04-03 12:41                             ` Shilimkar, Santosh
2012-04-03 12:41                               ` Shilimkar, Santosh
2012-04-03 14:27                             ` Kevin Hilman
2012-04-03 14:27                               ` Kevin Hilman
2012-04-03 16:07                               ` Will Deacon
2012-04-03 16:07                                 ` Will Deacon
2012-04-03 23:14                                 ` Kevin Hilman
2012-04-03 23:14                                   ` Kevin Hilman
2012-04-03 23:29                                   ` Paul Walmsley
2012-04-03 23:29                                     ` Paul Walmsley
2012-04-04  3:42                                     ` Ming Lei
2012-04-04  3:42                                       ` Ming Lei
2012-04-04 11:15                                     ` Will Deacon
2012-04-04 11:15                                       ` Will Deacon
2012-04-26 18:07                                       ` Will Deacon
2012-04-26 18:07                                         ` Will Deacon
2012-04-30 22:25                                         ` Kevin Hilman
2012-04-30 22:25                                           ` Kevin Hilman
2012-05-07 17:27                                           ` Ming Lei
2012-05-07 17:27                                             ` Ming Lei
2012-05-04 22:17                                         ` Jon Hunter
2012-05-04 22:17                                           ` Jon Hunter
2012-05-07 17:15                                           ` Kevin Hilman
2012-05-07 17:15                                             ` Kevin Hilman
2012-05-07 19:53                                             ` Jon Hunter
2012-05-07 19:53                                               ` Jon Hunter
2012-05-07 23:28                                               ` Kevin Hilman
2012-05-07 23:28                                                 ` Kevin Hilman
2012-05-08 11:01                                                 ` Cousson, Benoit
2012-05-08 11:01                                                   ` Cousson, Benoit
2012-05-08 11:23                                                   ` Jean Pihet
2012-05-08 11:23                                                     ` Jean Pihet
2012-05-08 12:37                                                     ` Cousson, Benoit
2012-05-08 12:37                                                       ` Cousson, Benoit
2012-05-08 13:18                                                       ` Jean Pihet
2012-05-08 13:18                                                         ` Jean Pihet
2012-05-08 14:00                                                         ` Kevin Hilman
2012-05-08 14:00                                                           ` Kevin Hilman
2012-05-08 14:03                                                           ` Cousson, Benoit
2012-05-08 14:03                                                             ` Cousson, Benoit
2012-05-08 16:18                                                             ` Kevin Hilman
2012-05-08 16:18                                                               ` Kevin Hilman
2012-05-08 19:51                                                               ` Jon Hunter [this message]
2012-05-08 19:51                                                                 ` Jon Hunter
2012-05-08 21:28                                                                 ` Kevin Hilman
2012-05-08 21:28                                                                   ` Kevin Hilman
2012-05-08 22:20                                                                   ` Jon Hunter
2012-05-08 22:20                                                                     ` Jon Hunter
2012-05-08 22:12                                                                 ` Ming Lei
2012-05-08 22:12                                                                   ` Ming Lei
2012-05-08 17:31                                                   ` Jon Hunter
2012-05-08 17:31                                                     ` Jon Hunter
2012-05-08 21:22                                                     ` Kevin Hilman
2012-05-08 21:22                                                       ` Kevin Hilman
2012-05-08 23:59                                                       ` Jon Hunter
2012-05-08 23:59                                                         ` Jon Hunter
2012-05-09 10:58                                                       ` Cousson, Benoit
2012-05-09 10:58                                                         ` Cousson, Benoit
2012-05-09 18:04                                                         ` Jon Hunter
2012-05-09 18:04                                                           ` Jon Hunter
2012-05-09 19:28                                                           ` Jon Hunter
2012-05-09 19:28                                                             ` Jon Hunter
2012-05-09 21:45                                                             ` Jon Hunter
2012-05-09 21:45                                                               ` Jon Hunter
2012-05-10  8:44                                                               ` Will Deacon
2012-05-10  8:44                                                                 ` Will Deacon
2012-05-10  9:12                                                                 ` stephane eranian
2012-05-10  9:12                                                                   ` stephane eranian
2012-05-10 18:55                                                                 ` Jon Hunter
2012-05-10 18:55                                                                   ` Jon Hunter
2012-05-11 12:25                                                                   ` Will Deacon
2012-05-11 12:25                                                                     ` Will Deacon
2012-05-11 13:47                                                                     ` Jon Hunter
2012-05-11 13:47                                                                       ` Jon Hunter
2012-05-11 13:49                                                                       ` Will Deacon
2012-05-11 13:49                                                                         ` Will Deacon
2012-05-11 14:52                                                                         ` Jon Hunter
2012-05-11 14:52                                                                           ` Jon Hunter
2012-05-11 15:02                                                                           ` Will Deacon
2012-05-11 15:02                                                                             ` Will Deacon
2012-05-11 16:31                                                                             ` Jon Hunter
2012-05-11 16:31                                                                               ` Jon Hunter
2012-05-11 16:38                                                                               ` Will Deacon
2012-05-11 16:38                                                                                 ` Will Deacon
2012-05-11 23:51                                                                                 ` Jon Hunter
2012-05-11 23:51                                                                                   ` Jon Hunter
2012-05-15 13:52                                                                                   ` Will Deacon
2012-05-15 13:52                                                                                     ` Will Deacon
2012-05-10 14:12                                                               ` Kevin Hilman
2012-05-10 14:12                                                                 ` Kevin Hilman
2012-05-10 19:05                                                                 ` Jon Hunter
2012-05-10 19:05                                                                   ` Jon Hunter
2012-05-10  6:59                                                         ` Santosh Shilimkar
2012-05-10  6:59                                                           ` Santosh Shilimkar
2012-05-08 21:50                                                 ` Paul Walmsley
2012-05-08 21:50                                                   ` Paul Walmsley
2012-04-04  0:00                             ` Paul Walmsley
2012-04-04  0:00                               ` Paul Walmsley
2012-04-04 11:07                               ` Will Deacon
2012-04-04 11:07                                 ` Will Deacon
2012-01-18  9:54           ` stephane eranian
2012-01-18  9:54             ` stephane eranian
2012-01-18 10:07             ` Ming Lei
2012-01-18 10:07               ` Ming Lei
2012-01-18 21:58               ` stephane eranian
2012-01-18 21:58                 ` stephane eranian
2012-01-19  1:21                 ` Ming Lei
2012-01-19  1:21                   ` Ming Lei
2012-01-19 11:34                   ` stephane eranian
2012-01-19 11:34                     ` stephane eranian
2012-01-19 12:45                     ` Ming Lei
2012-01-19 12:45                       ` Ming Lei
2012-01-19 12:51                       ` stephane eranian
2012-01-19 12:51                         ` stephane eranian
2012-01-19 12:55                         ` stephane eranian
2012-01-19 12:55                           ` stephane eranian
2012-01-19 13:14                         ` Ming Lei
2012-01-19 13:14                           ` Ming Lei
2012-01-19 13:26                           ` Ming Lei
2012-01-19 13:26                             ` Ming Lei
2012-01-19 13:32                             ` stephane eranian
2012-01-19 13:32                               ` stephane eranian
2012-01-19 13:51                               ` Ming Lei
2012-01-19 13:51                                 ` Ming Lei
2012-01-19 17:07                                 ` stephane eranian
2012-01-19 17:07                                   ` stephane eranian
2012-01-20 13:47                                   ` stephane eranian
2012-01-20 13:47                                     ` stephane eranian
2012-01-21  3:25                                     ` Ming Lei
2012-01-21  3:25                                       ` Ming Lei
2012-01-21  9:16                                       ` stephane eranian
2012-01-21  9:16                                         ` stephane eranian
2012-01-27 12:13                                         ` Will Deacon
2012-01-27 12:13                                           ` Will Deacon
2012-01-27 12:45                                           ` stephane eranian
2012-01-27 12:45                                             ` stephane eranian
2012-01-27 12:56                                           ` Måns Rullgård
2012-01-27 12:56                                             ` Måns Rullgård
2012-01-27 13:28                                             ` Will Deacon
2012-01-27 13:28                                               ` Will Deacon
2012-01-27 13:32                                               ` stephane eranian
2012-01-27 13:32                                                 ` stephane eranian
2012-01-27 13:47                                               ` Måns Rullgård
2012-01-27 13:47                                                 ` Måns Rullgård
2012-01-27 13:56                                                 ` Will Deacon
2012-01-27 13:56                                                   ` Will Deacon
2012-01-27 14:05                                                   ` Måns Rullgård
2012-01-27 14:05                                                     ` Måns Rullgård
2012-01-27 14:09                                               ` Ming Lei
2012-01-27 14:09                                                 ` Ming Lei
2012-01-27 15:45                                                 ` stephane eranian
2012-01-27 15:45                                                   ` stephane eranian
2012-01-27 15:54                                                   ` Will Deacon
2012-01-27 15:54                                                     ` Will Deacon
2012-01-27 15:57                                                     ` stephane eranian
2012-01-27 15:57                                                       ` stephane eranian
2012-01-27 16:59                                                       ` Will Deacon
2012-01-27 16:59                                                         ` Will Deacon
2012-01-27 17:03                                                         ` stephane eranian
2012-01-27 17:03                                                           ` stephane eranian
2012-01-27 17:10                                                           ` Will Deacon
2012-01-27 17:10                                                             ` Will Deacon
2012-01-27 17:16                                                             ` stephane eranian
2012-01-27 17:16                                                               ` stephane eranian
2012-01-29 17:36                                                               ` stephane eranian
2012-01-29 17:36                                                                 ` stephane eranian
2012-01-30  9:40                                                                 ` Ming Lei
2012-01-30  9:40                                                                   ` Ming Lei
2012-01-30 10:24                                                                   ` stephane eranian
2012-01-30 10:24                                                                     ` stephane eranian
2012-01-30 13:43                                                                     ` stephane eranian
2012-01-30 13:43                                                                       ` stephane eranian
2012-01-30 14:49                                                                       ` Ming Lei
2012-01-30 14:49                                                                         ` Ming Lei
2012-01-30 16:02                                                                         ` stephane eranian
2012-01-30 16:02                                                                           ` stephane eranian
2012-01-30 16:08                                                                           ` Måns Rullgård
2012-01-30 16:08                                                                             ` Måns Rullgård
2012-01-30 17:15                                                                             ` stephane eranian
2012-01-30 17:15                                                                               ` stephane eranian
2012-01-30 17:24                                                                               ` Will Deacon
2012-01-30 17:24                                                                                 ` Will Deacon
2012-01-30 17:45                                                                                 ` stephane eranian
2012-01-30 17:45                                                                                   ` stephane eranian
2012-01-30 19:14                                                                                   ` Will Deacon
2012-01-30 19:14                                                                                     ` Will Deacon
2012-01-30 20:45                                                                                     ` stephane eranian
2012-01-30 20:45                                                                                       ` stephane eranian
2012-03-07  2:49                                                     ` Ming Lei
2012-03-07  2:49                                                       ` Ming Lei
2012-03-07  9:48                                                       ` Will Deacon
2012-03-07  9:48                                                         ` Will Deacon
2012-01-27 14:06                                           ` Ming Lei
2012-01-27 14:06                                             ` Ming Lei
2012-01-18 10:18             ` Russell King - ARM Linux
2012-01-18 10:18               ` Russell King - ARM Linux
     [not found] <1328578047.1724.17.camel@dave-Dell-System-XPS-L502X>
     [not found] ` <CAMQu2gwfo5JXAqQaLUNs7C7J3TUhEO2zOcyD0Rk-D_O61Yrfag@mail.gmail.com>
     [not found]   ` <CAMsRxfLNBbQO5XF+EHJqNsnW+s=ay3mjSV5dh=sxdwzktUu03g@mail.gmail.com>
     [not found]     ` <CAMQu2gzfNAwtf1c6jrTZpfGMSqBgBrQKmFTeCFzbvMh9ESBDUg@mail.gmail.com>
     [not found]       ` <CAMsRxfKR1ODH56BtcUT5Dv6qOVEYGVheEcW9ugXsZmLKok==bg@mail.gmail.com>
2012-02-07 10:53         ` Shilimkar, Santosh
2012-02-07 11:09           ` Shilimkar, Santosh
2012-02-07 11:25             ` stephane eranian
2012-02-07 11:39               ` Shilimkar, Santosh
2012-02-07 11:59                 ` stephane eranian
2012-02-07 15:30                   ` Will Deacon
2012-02-08  2:24                   ` Ming Lei
2012-02-08  2:24                     ` Ming Lei
2012-02-15 16:38                     ` Peter Zijlstra
2012-02-15 16:38                       ` Peter Zijlstra
2012-02-16 10:25                       ` Ming Lei
2012-02-16 10:25                         ` Ming Lei
2012-02-16 15:00                         ` Will Deacon
2012-02-16 15:00                           ` Will Deacon
2012-02-16 16:12                           ` Ming Lei
2012-02-16 16:12                             ` Ming Lei
2012-02-16 16:19                             ` Peter Zijlstra
2012-02-16 16:19                               ` Peter Zijlstra
2012-02-16 16:37                               ` Ming Lei
2012-02-16 16:37                                 ` Ming Lei
2012-02-16 18:08                                 ` Will Deacon
2012-02-16 18:08                                   ` Will Deacon
2012-02-17  5:24                                   ` Ming Lei
2012-02-17  5:24                                     ` Ming Lei
2012-02-17 10:26                                     ` Will Deacon
2012-02-17 10:26                                       ` Will Deacon
2012-02-20  3:19                                       ` Ming Lei
2012-02-20  3:19                                         ` Ming Lei
2012-02-20  9:44                                         ` Will Deacon
2012-02-20  9:44                                           ` Will Deacon
2012-02-13 13:15                   ` Will Deacon
     [not found]           ` <1329508513.1858.15.camel@dave-Dell-System-XPS-L502X>
2012-02-18  4:31             ` Shilimkar, Santosh
2012-04-03  9:44               ` Will Deacon
2012-04-03  9:47                 ` Shilimkar, Santosh
     [not found] ` <CACVXFVN0E_deS2d50mfufO5QZSwh=34BppCL++oxtc3nfN_ugA@mail.gmail.com>
     [not found]   ` <1328664644.1678.15.camel@dave-Dell-System-XPS-L502X>
2012-02-09 20:05     ` David A. Long

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=4FA9794A.7030607@ti.com \
    --to=jon-hunter@ti.com \
    --cc=b-cousson@ti.com \
    --cc=eranian@gmail.com \
    --cc=jean.pihet@newoldbits.com \
    --cc=khilman@ti.com \
    --cc=lik88888@gmail.com \
    --cc=linux-arm-kernel@lists.infradead.org \
    --cc=linux-omap@vger.kernel.org \
    --cc=maynardj@us.ibm.com \
    --cc=ming.lei@canonical.com \
    --cc=oprofile-list@lists.sourceforge.net \
    --cc=paul@pwsan.com \
    --cc=santosh.shilimkar@ti.com \
    --cc=will.deacon@arm.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.