From: Lorenzo Pieralisi <lorenzo.pieralisi@arm.com>
To: Zhou Wang <wangzhou1@hisilicon.com>
Cc: Bjorn Helgaas <bhelgaas@google.com>,
Jingoo Han <jg1.han@samsung.com>,
Pratyush Anand <pratyush.anand@gmail.com>,
Arnd Bergmann <arnd@arndb.de>,
"gabriele.paoloni@huawei.com" <gabriele.paoloni@huawei.com>,
James Morse <James.Morse@arm.com>,
Liviu Dudau <Liviu.Dudau@arm.com>,
"thomas.petazzoni@free-electrons.com"
<thomas.petazzoni@free-electrons.com>,
Jason Cooper <jason@lakedaemon.net>,
"robh@kernel.org" <robh@kernel.org>,
"linux-pci@vger.kernel.org" <linux-pci@vger.kernel.org>,
"linux-arm-kernel@lists.infradead.org"
<linux-arm-kernel@lists.infradead.org>,
"devicetree@vger.kernel.org" <devicetree@vger.kernel.org>,
"yuanzhichang@hisilicon.com" <yuanzhichang@hisilicon.com>,
"zhudacai@hisilicon.com" <zhudacai@hisilicon.com>,
"zhangjukuo@huawei.com" <zhangjukuo@huawei.com>,
"qiuzhenfa@hisilicon.com" <qiuzhenfa@hisilicon.com>,
"liudongdong3@huawei.com" <liudongdong3@huawei.com>,
"qiujiang@huawei.com" <qiujiang@huawei.com>,
"kangfenglong@huawei.com" <kangfenglong@huawei.com>,
"liguozhu@hisilicon.com" <liguozhu@hisilicon.com>,
linux@arm.linux.org.uk
Subject: Re: [PATCH v5 1/5] ARM/PCI: remove align_resource in pci_sys_data
Date: Tue, 28 Jul 2015 18:44:06 +0100 [thread overview]
Message-ID: <20150728174406.GB19909@red-moon> (raw)
In-Reply-To: <55B72C7E.1020102@hisilicon.com>
[CC'ing RMK]
On Tue, Jul 28, 2015 at 08:17:18AM +0100, Zhou Wang wrote:
> On 2015/7/25 11:21, Zhou Wang wrote:
> > From: Gabriele Paoloni <gabriele.paoloni@huawei.com>
> >
> > This patch is needed in order to unify the PCIe designware framework for ARM and
> > ARM64 architectures. In the PCIe designware unification process we are calling
> > pci_create_root_bus() passing a "sysdata" parameter that is the same for both
> > ARM and ARM64 and is of type "struct pcie_port*". In the ARM case this will
> > cause a problem with the function pcibios_align_resource(); in fact this will
> > cast "dev->sysdata" to "struct pci_sys_data*", whereas designware had passed a
> > "struct pcie_port*" pointer.
> >
> > This patch solves the issue by removing "align_resource" from "pci_sys_data"
> > struct and defining a static global function pointer in "bios32.c"
> >
> > Signed-off-by: Gabriele Paoloni <gabriele.paoloni@huawei.com>
>
> Hi Arnd and Rob,
>
> What is your opinion about this patch? Gabriele adds a global pointer in bios32.c
> to store align_resource, so we could remove sys->align_resource in pcibios_align_resource.
>
> As Lorenzo mentioned in v4 series, this is a temporary solution before moving
> align_resource to host bridge structure.
>
> Any comments welcome.
The align_resource() pointer is just used in drivers/pci/host/pci-mvebu.c,
I would like the pci-mvebu.c maintainers to comment on this and test it, I
do not expect it to create any issue and might be a temporary solution to
make progress on ARM/ARM64 consolidation, it is a blocking point.
It would be good if Russell can have a look too, I do not see what
issue this can trigger given that is just used in:
drivers/pci/host/pci-mvebu.c
and a global pointer (not saying it is elegant, but it should work)
might be ok.
So yes, comments very welcome.
Thanks,
Lorenzo
>
> Thanks,
> Zhou
>
> > ---
> > arch/arm/include/asm/mach/pci.h | 5 -----
> > arch/arm/kernel/bios32.c | 12 ++++++++----
> > 2 files changed, 8 insertions(+), 9 deletions(-)
> >
> > diff --git a/arch/arm/include/asm/mach/pci.h b/arch/arm/include/asm/mach/pci.h
> > index 28b9bb3..8a4e4de 100644
> > --- a/arch/arm/include/asm/mach/pci.h
> > +++ b/arch/arm/include/asm/mach/pci.h
> > @@ -58,11 +58,6 @@ struct pci_sys_data {
> > /* IRQ mapping */
> > int (*map_irq)(const struct pci_dev *, u8, u8);
> > /* Resource alignement requirements */
> > - resource_size_t (*align_resource)(struct pci_dev *dev,
> > - const struct resource *res,
> > - resource_size_t start,
> > - resource_size_t size,
> > - resource_size_t align);
> > void *private_data; /* platform controller private data */
> > };
> >
> > diff --git a/arch/arm/kernel/bios32.c b/arch/arm/kernel/bios32.c
> > index fcbbbb1..4cdc64d 100644
> > --- a/arch/arm/kernel/bios32.c
> > +++ b/arch/arm/kernel/bios32.c
> > @@ -17,6 +17,11 @@
> > #include <asm/mach/pci.h>
> >
> > static int debug_pci;
> > +static resource_size_t (*align_resource)(struct pci_dev *dev,
> > + const struct resource *res,
> > + resource_size_t start,
> > + resource_size_t size,
> > + resource_size_t align) = NULL;
> >
> > #ifdef CONFIG_PCI_MSI
> > struct msi_controller *pcibios_msi_controller(struct pci_dev *dev)
> > @@ -468,7 +473,7 @@ static void pcibios_init_hw(struct device *parent, struct hw_pci *hw,
> > sys->busnr = busnr;
> > sys->swizzle = hw->swizzle;
> > sys->map_irq = hw->map_irq;
> > - sys->align_resource = hw->align_resource;
> > + align_resource = hw->align_resource;
> > INIT_LIST_HEAD(&sys->resources);
> >
> > if (hw->private_data)
> > @@ -589,7 +594,6 @@ resource_size_t pcibios_align_resource(void *data, const struct resource *res,
> > resource_size_t size, resource_size_t align)
> > {
> > struct pci_dev *dev = data;
> > - struct pci_sys_data *sys = dev->sysdata;
> > resource_size_t start = res->start;
> >
> > if (res->flags & IORESOURCE_IO && start & 0x300)
> > @@ -597,8 +601,8 @@ resource_size_t pcibios_align_resource(void *data, const struct resource *res,
> >
> > start = (start + align - 1) & ~(align - 1);
> >
> > - if (sys->align_resource)
> > - return sys->align_resource(dev, res, start, size, align);
> > + if (align_resource)
> > + return align_resource(dev, res, start, size, align);
> >
> > return start;
> > }
> >
>
>
> --
> To unsubscribe from this list: send the line "unsubscribe devicetree" in
> the body of a message to majordomo@vger.kernel.org
> More majordomo info at http://vger.kernel.org/majordomo-info.html
>
WARNING: multiple messages have this Message-ID (diff)
From: lorenzo.pieralisi@arm.com (Lorenzo Pieralisi)
To: linux-arm-kernel@lists.infradead.org
Subject: [PATCH v5 1/5] ARM/PCI: remove align_resource in pci_sys_data
Date: Tue, 28 Jul 2015 18:44:06 +0100 [thread overview]
Message-ID: <20150728174406.GB19909@red-moon> (raw)
In-Reply-To: <55B72C7E.1020102@hisilicon.com>
[CC'ing RMK]
On Tue, Jul 28, 2015 at 08:17:18AM +0100, Zhou Wang wrote:
> On 2015/7/25 11:21, Zhou Wang wrote:
> > From: Gabriele Paoloni <gabriele.paoloni@huawei.com>
> >
> > This patch is needed in order to unify the PCIe designware framework for ARM and
> > ARM64 architectures. In the PCIe designware unification process we are calling
> > pci_create_root_bus() passing a "sysdata" parameter that is the same for both
> > ARM and ARM64 and is of type "struct pcie_port*". In the ARM case this will
> > cause a problem with the function pcibios_align_resource(); in fact this will
> > cast "dev->sysdata" to "struct pci_sys_data*", whereas designware had passed a
> > "struct pcie_port*" pointer.
> >
> > This patch solves the issue by removing "align_resource" from "pci_sys_data"
> > struct and defining a static global function pointer in "bios32.c"
> >
> > Signed-off-by: Gabriele Paoloni <gabriele.paoloni@huawei.com>
>
> Hi Arnd and Rob,
>
> What is your opinion about this patch? Gabriele adds a global pointer in bios32.c
> to store align_resource, so we could remove sys->align_resource in pcibios_align_resource.
>
> As Lorenzo mentioned in v4 series, this is a temporary solution before moving
> align_resource to host bridge structure.
>
> Any comments welcome.
The align_resource() pointer is just used in drivers/pci/host/pci-mvebu.c,
I would like the pci-mvebu.c maintainers to comment on this and test it, I
do not expect it to create any issue and might be a temporary solution to
make progress on ARM/ARM64 consolidation, it is a blocking point.
It would be good if Russell can have a look too, I do not see what
issue this can trigger given that is just used in:
drivers/pci/host/pci-mvebu.c
and a global pointer (not saying it is elegant, but it should work)
might be ok.
So yes, comments very welcome.
Thanks,
Lorenzo
>
> Thanks,
> Zhou
>
> > ---
> > arch/arm/include/asm/mach/pci.h | 5 -----
> > arch/arm/kernel/bios32.c | 12 ++++++++----
> > 2 files changed, 8 insertions(+), 9 deletions(-)
> >
> > diff --git a/arch/arm/include/asm/mach/pci.h b/arch/arm/include/asm/mach/pci.h
> > index 28b9bb3..8a4e4de 100644
> > --- a/arch/arm/include/asm/mach/pci.h
> > +++ b/arch/arm/include/asm/mach/pci.h
> > @@ -58,11 +58,6 @@ struct pci_sys_data {
> > /* IRQ mapping */
> > int (*map_irq)(const struct pci_dev *, u8, u8);
> > /* Resource alignement requirements */
> > - resource_size_t (*align_resource)(struct pci_dev *dev,
> > - const struct resource *res,
> > - resource_size_t start,
> > - resource_size_t size,
> > - resource_size_t align);
> > void *private_data; /* platform controller private data */
> > };
> >
> > diff --git a/arch/arm/kernel/bios32.c b/arch/arm/kernel/bios32.c
> > index fcbbbb1..4cdc64d 100644
> > --- a/arch/arm/kernel/bios32.c
> > +++ b/arch/arm/kernel/bios32.c
> > @@ -17,6 +17,11 @@
> > #include <asm/mach/pci.h>
> >
> > static int debug_pci;
> > +static resource_size_t (*align_resource)(struct pci_dev *dev,
> > + const struct resource *res,
> > + resource_size_t start,
> > + resource_size_t size,
> > + resource_size_t align) = NULL;
> >
> > #ifdef CONFIG_PCI_MSI
> > struct msi_controller *pcibios_msi_controller(struct pci_dev *dev)
> > @@ -468,7 +473,7 @@ static void pcibios_init_hw(struct device *parent, struct hw_pci *hw,
> > sys->busnr = busnr;
> > sys->swizzle = hw->swizzle;
> > sys->map_irq = hw->map_irq;
> > - sys->align_resource = hw->align_resource;
> > + align_resource = hw->align_resource;
> > INIT_LIST_HEAD(&sys->resources);
> >
> > if (hw->private_data)
> > @@ -589,7 +594,6 @@ resource_size_t pcibios_align_resource(void *data, const struct resource *res,
> > resource_size_t size, resource_size_t align)
> > {
> > struct pci_dev *dev = data;
> > - struct pci_sys_data *sys = dev->sysdata;
> > resource_size_t start = res->start;
> >
> > if (res->flags & IORESOURCE_IO && start & 0x300)
> > @@ -597,8 +601,8 @@ resource_size_t pcibios_align_resource(void *data, const struct resource *res,
> >
> > start = (start + align - 1) & ~(align - 1);
> >
> > - if (sys->align_resource)
> > - return sys->align_resource(dev, res, start, size, align);
> > + if (align_resource)
> > + return align_resource(dev, res, start, size, align);
> >
> > return start;
> > }
> >
>
>
> --
> To unsubscribe from this list: send the line "unsubscribe devicetree" in
> the body of a message to majordomo at vger.kernel.org
> More majordomo info at http://vger.kernel.org/majordomo-info.html
>
WARNING: multiple messages have this Message-ID (diff)
From: Lorenzo Pieralisi <lorenzo.pieralisi@arm.com>
To: Zhou Wang <wangzhou1@hisilicon.com>
Cc: Bjorn Helgaas <bhelgaas@google.com>,
Jingoo Han <jg1.han@samsung.com>,
Pratyush Anand <pratyush.anand@gmail.com>,
Arnd Bergmann <arnd@arndb.de>,
"gabriele.paoloni@huawei.com" <gabriele.paoloni@huawei.com>,
James Morse <James.Morse@arm.com>,
Liviu Dudau <Liviu.Dudau@arm.com>,
"thomas.petazzoni@free-electrons.com"
<thomas.petazzoni@free-electrons.com>,
Jason Cooper <jason@lakedaemon.net>,
"robh@kernel.org" <robh@kernel.org>,
"linux-pci@vger.kernel.org" <linux-pci@vger.kernel.org>,
"linux-arm-kernel@lists.infradead.org"
<linux-arm-kernel@lists.infradead.org>,
"devicetree@vger.kernel.org" <devicetree@vger.kernel.org>,
"yuanzhichang@hisilicon.com" <yuanzhichang@hisilicon.com>,
"zhudacai@hisilicon.com" <zhudacai@hisilicon.com>,
"zhangjukuo@huawei.com" <zhangjukuo@huawei.com>,
"qiuzhenfa@hisilicon.com" <qiuzhenfa@hisilicon.com>,
"liudongdong3@huawei.com" <liudongdong3@h>
Subject: Re: [PATCH v5 1/5] ARM/PCI: remove align_resource in pci_sys_data
Date: Tue, 28 Jul 2015 18:44:06 +0100 [thread overview]
Message-ID: <20150728174406.GB19909@red-moon> (raw)
In-Reply-To: <55B72C7E.1020102@hisilicon.com>
[CC'ing RMK]
On Tue, Jul 28, 2015 at 08:17:18AM +0100, Zhou Wang wrote:
> On 2015/7/25 11:21, Zhou Wang wrote:
> > From: Gabriele Paoloni <gabriele.paoloni@huawei.com>
> >
> > This patch is needed in order to unify the PCIe designware framework for ARM and
> > ARM64 architectures. In the PCIe designware unification process we are calling
> > pci_create_root_bus() passing a "sysdata" parameter that is the same for both
> > ARM and ARM64 and is of type "struct pcie_port*". In the ARM case this will
> > cause a problem with the function pcibios_align_resource(); in fact this will
> > cast "dev->sysdata" to "struct pci_sys_data*", whereas designware had passed a
> > "struct pcie_port*" pointer.
> >
> > This patch solves the issue by removing "align_resource" from "pci_sys_data"
> > struct and defining a static global function pointer in "bios32.c"
> >
> > Signed-off-by: Gabriele Paoloni <gabriele.paoloni@huawei.com>
>
> Hi Arnd and Rob,
>
> What is your opinion about this patch? Gabriele adds a global pointer in bios32.c
> to store align_resource, so we could remove sys->align_resource in pcibios_align_resource.
>
> As Lorenzo mentioned in v4 series, this is a temporary solution before moving
> align_resource to host bridge structure.
>
> Any comments welcome.
The align_resource() pointer is just used in drivers/pci/host/pci-mvebu.c,
I would like the pci-mvebu.c maintainers to comment on this and test it, I
do not expect it to create any issue and might be a temporary solution to
make progress on ARM/ARM64 consolidation, it is a blocking point.
It would be good if Russell can have a look too, I do not see what
issue this can trigger given that is just used in:
drivers/pci/host/pci-mvebu.c
and a global pointer (not saying it is elegant, but it should work)
might be ok.
So yes, comments very welcome.
Thanks,
Lorenzo
>
> Thanks,
> Zhou
>
> > ---
> > arch/arm/include/asm/mach/pci.h | 5 -----
> > arch/arm/kernel/bios32.c | 12 ++++++++----
> > 2 files changed, 8 insertions(+), 9 deletions(-)
> >
> > diff --git a/arch/arm/include/asm/mach/pci.h b/arch/arm/include/asm/mach/pci.h
> > index 28b9bb3..8a4e4de 100644
> > --- a/arch/arm/include/asm/mach/pci.h
> > +++ b/arch/arm/include/asm/mach/pci.h
> > @@ -58,11 +58,6 @@ struct pci_sys_data {
> > /* IRQ mapping */
> > int (*map_irq)(const struct pci_dev *, u8, u8);
> > /* Resource alignement requirements */
> > - resource_size_t (*align_resource)(struct pci_dev *dev,
> > - const struct resource *res,
> > - resource_size_t start,
> > - resource_size_t size,
> > - resource_size_t align);
> > void *private_data; /* platform controller private data */
> > };
> >
> > diff --git a/arch/arm/kernel/bios32.c b/arch/arm/kernel/bios32.c
> > index fcbbbb1..4cdc64d 100644
> > --- a/arch/arm/kernel/bios32.c
> > +++ b/arch/arm/kernel/bios32.c
> > @@ -17,6 +17,11 @@
> > #include <asm/mach/pci.h>
> >
> > static int debug_pci;
> > +static resource_size_t (*align_resource)(struct pci_dev *dev,
> > + const struct resource *res,
> > + resource_size_t start,
> > + resource_size_t size,
> > + resource_size_t align) = NULL;
> >
> > #ifdef CONFIG_PCI_MSI
> > struct msi_controller *pcibios_msi_controller(struct pci_dev *dev)
> > @@ -468,7 +473,7 @@ static void pcibios_init_hw(struct device *parent, struct hw_pci *hw,
> > sys->busnr = busnr;
> > sys->swizzle = hw->swizzle;
> > sys->map_irq = hw->map_irq;
> > - sys->align_resource = hw->align_resource;
> > + align_resource = hw->align_resource;
> > INIT_LIST_HEAD(&sys->resources);
> >
> > if (hw->private_data)
> > @@ -589,7 +594,6 @@ resource_size_t pcibios_align_resource(void *data, const struct resource *res,
> > resource_size_t size, resource_size_t align)
> > {
> > struct pci_dev *dev = data;
> > - struct pci_sys_data *sys = dev->sysdata;
> > resource_size_t start = res->start;
> >
> > if (res->flags & IORESOURCE_IO && start & 0x300)
> > @@ -597,8 +601,8 @@ resource_size_t pcibios_align_resource(void *data, const struct resource *res,
> >
> > start = (start + align - 1) & ~(align - 1);
> >
> > - if (sys->align_resource)
> > - return sys->align_resource(dev, res, start, size, align);
> > + if (align_resource)
> > + return align_resource(dev, res, start, size, align);
> >
> > return start;
> > }
> >
>
>
> --
> To unsubscribe from this list: send the line "unsubscribe devicetree" in
> the body of a message to majordomo@vger.kernel.org
> More majordomo info at http://vger.kernel.org/majordomo-info.html
>
next prev parent reply other threads:[~2015-07-28 17:43 UTC|newest]
Thread overview: 57+ messages / expand[flat|nested] mbox.gz Atom feed top
2015-07-25 3:21 [PATCH v5 0/5] PCI: hisi: Add PCIe host support for HiSilicon SoC Hip05 Zhou Wang
2015-07-25 3:21 ` Zhou Wang
2015-07-25 3:21 ` Zhou Wang
2015-07-25 3:21 ` [PATCH v5 1/5] ARM/PCI: remove align_resource in pci_sys_data Zhou Wang
2015-07-25 3:21 ` Zhou Wang
2015-07-25 3:21 ` Zhou Wang
2015-07-28 7:17 ` Zhou Wang
2015-07-28 7:17 ` Zhou Wang
2015-07-28 7:17 ` Zhou Wang
2015-07-28 17:44 ` Lorenzo Pieralisi [this message]
2015-07-28 17:44 ` Lorenzo Pieralisi
2015-07-28 17:44 ` Lorenzo Pieralisi
2015-07-30 22:48 ` Rob Herring
2015-07-30 22:48 ` Rob Herring
2015-07-30 22:48 ` Rob Herring
2015-07-31 7:57 ` Gabriele Paoloni
2015-07-31 7:57 ` Gabriele Paoloni
2015-07-31 7:57 ` Gabriele Paoloni
2015-07-25 3:21 ` [PATCH v5 2/5] PCI: designware: Add ARM64 support Zhou Wang
2015-07-25 3:21 ` Zhou Wang
2015-07-25 3:21 ` Zhou Wang
2015-07-28 6:21 ` Zhou Wang
2015-07-28 6:21 ` Zhou Wang
2015-07-28 6:21 ` Zhou Wang
2015-08-04 9:34 ` James Morse
2015-08-04 9:34 ` James Morse
2015-08-04 9:34 ` James Morse
2015-08-04 10:23 ` Gabriele Paoloni
2015-08-04 10:23 ` Gabriele Paoloni
2015-08-04 10:23 ` Gabriele Paoloni
2015-08-04 10:40 ` James Morse
2015-08-04 10:40 ` James Morse
2015-08-04 10:40 ` James Morse
2015-08-04 10:43 ` Gabriele Paoloni
2015-08-04 10:43 ` Gabriele Paoloni
2015-08-04 10:43 ` Gabriele Paoloni
2015-08-05 1:40 ` Zhou Wang
2015-08-05 1:40 ` Zhou Wang
2015-08-05 1:40 ` Zhou Wang
2015-07-29 17:24 ` Lorenzo Pieralisi
2015-07-29 17:24 ` Lorenzo Pieralisi
2015-07-29 17:24 ` Lorenzo Pieralisi
2015-07-30 3:17 ` Zhou Wang
2015-07-30 3:17 ` Zhou Wang
2015-07-30 3:17 ` Zhou Wang
2015-07-25 3:21 ` [PATCH v5 3/5] PCI: hisi: Add PCIe host support for HiSilicon SoC Hip05 Zhou Wang
2015-07-25 3:21 ` Zhou Wang
2015-07-25 3:21 ` Zhou Wang
2015-07-25 3:21 ` [PATCH v5 4/5] Documentation: DT: Add HiSilicon PCIe host binding Zhou Wang
2015-07-25 3:21 ` Zhou Wang
2015-07-25 3:21 ` Zhou Wang
2015-07-28 7:28 ` Zhou Wang
2015-07-28 7:28 ` Zhou Wang
2015-07-28 7:28 ` Zhou Wang
2015-07-25 3:21 ` [PATCH v5 5/5] MAINTAINERS: Add pcie-hisi maintainer Zhou Wang
2015-07-25 3:21 ` Zhou Wang
2015-07-25 3:21 ` Zhou Wang
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=20150728174406.GB19909@red-moon \
--to=lorenzo.pieralisi@arm.com \
--cc=James.Morse@arm.com \
--cc=Liviu.Dudau@arm.com \
--cc=arnd@arndb.de \
--cc=bhelgaas@google.com \
--cc=devicetree@vger.kernel.org \
--cc=gabriele.paoloni@huawei.com \
--cc=jason@lakedaemon.net \
--cc=jg1.han@samsung.com \
--cc=kangfenglong@huawei.com \
--cc=liguozhu@hisilicon.com \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-pci@vger.kernel.org \
--cc=linux@arm.linux.org.uk \
--cc=liudongdong3@huawei.com \
--cc=pratyush.anand@gmail.com \
--cc=qiujiang@huawei.com \
--cc=qiuzhenfa@hisilicon.com \
--cc=robh@kernel.org \
--cc=thomas.petazzoni@free-electrons.com \
--cc=wangzhou1@hisilicon.com \
--cc=yuanzhichang@hisilicon.com \
--cc=zhangjukuo@huawei.com \
--cc=zhudacai@hisilicon.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.