From: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
To: Marek Szyprowski <m.szyprowski@samsung.com>
Cc: linux-arm-kernel@lists.infradead.org,
linaro-mm-sig@lists.linaro.org, linux-mm@kvack.org,
linux-arch@vger.kernel.org, linux-samsung-soc@vger.kernel.org,
iommu@lists.linux-foundation.org,
Shariq Hasnain <shariq.hasnain@linaro.org>,
Arnd Bergmann <arnd@arndb.de>,
Benjamin Herrenschmidt <benh@kernel.crashing.org>,
Krishna Reddy <vdumpa@nvidia.com>,
Kyungmin Park <kyungmin.park@samsung.com>,
Andrzej Pietrasiewicz <andrzej.p@samsung.com>,
Russell King - ARM Linux <linux@arm.linux.org.uk>,
KyongHo Cho <pullip.cho@samsung.com>,
Chunsang Jeong <chunsang.jeong@linaro.org>
Subject: Re: [PATCHv6 3/7] ARM: dma-mapping: implement dma sg methods on top of any generic dma ops
Date: Tue, 14 Feb 2012 10:02:55 -0500 [thread overview]
Message-ID: <20120214150255.GC18359@phenom.dumpdata.com> (raw)
In-Reply-To: <1328900324-20946-4-git-send-email-m.szyprowski@samsung.com>
On Fri, Feb 10, 2012 at 07:58:40PM +0100, Marek Szyprowski wrote:
> This patch converts all dma_sg methods to be generic (independent of the
> current DMA mapping implementation for ARM architecture). All dma sg
> operations are now implemented on top of respective
> dma_map_page/dma_sync_single_for* operations from dma_map_ops structure.
Looks good, except the worry I've that the DMA debug API calls are now
lost.
>
> Signed-off-by: Marek Szyprowski <m.szyprowski@samsung.com>
> Signed-off-by: Kyungmin Park <kyungmin.park@samsung.com>
> ---
> arch/arm/mm/dma-mapping.c | 35 +++++++++++++++--------------------
> 1 files changed, 15 insertions(+), 20 deletions(-)
>
> diff --git a/arch/arm/mm/dma-mapping.c b/arch/arm/mm/dma-mapping.c
> index 91fe436..31ff699 100644
> --- a/arch/arm/mm/dma-mapping.c
> +++ b/arch/arm/mm/dma-mapping.c
> @@ -635,12 +635,13 @@ EXPORT_SYMBOL(___dma_page_dev_to_cpu);
> int arm_dma_map_sg(struct device *dev, struct scatterlist *sg, int nents,
> enum dma_data_direction dir, struct dma_attrs *attrs)
> {
> + struct dma_map_ops *ops = get_dma_ops(dev);
> struct scatterlist *s;
> int i, j;
>
> for_each_sg(sg, s, nents, i) {
> - s->dma_address = __dma_map_page(dev, sg_page(s), s->offset,
> - s->length, dir);
> + s->dma_address = ops->map_page(dev, sg_page(s), s->offset,
> + s->length, dir, attrs);
> if (dma_mapping_error(dev, s->dma_address))
> goto bad_mapping;
> }
> @@ -648,7 +649,7 @@ int arm_dma_map_sg(struct device *dev, struct scatterlist *sg, int nents,
>
> bad_mapping:
> for_each_sg(sg, s, i, j)
> - __dma_unmap_page(dev, sg_dma_address(s), sg_dma_len(s), dir);
> + ops->unmap_page(dev, sg_dma_address(s), sg_dma_len(s), dir, attrs);
> return 0;
> }
>
> @@ -665,11 +666,13 @@ int arm_dma_map_sg(struct device *dev, struct scatterlist *sg, int nents,
> void arm_dma_unmap_sg(struct device *dev, struct scatterlist *sg, int nents,
> enum dma_data_direction dir, struct dma_attrs *attrs)
> {
> + struct dma_map_ops *ops = get_dma_ops(dev);
> struct scatterlist *s;
> +
> int i;
>
> for_each_sg(sg, s, nents, i)
> - __dma_unmap_page(dev, sg_dma_address(s), sg_dma_len(s), dir);
> + ops->unmap_page(dev, sg_dma_address(s), sg_dma_len(s), dir, attrs);
> }
>
> /**
> @@ -682,17 +685,13 @@ void arm_dma_unmap_sg(struct device *dev, struct scatterlist *sg, int nents,
> void arm_dma_sync_sg_for_cpu(struct device *dev, struct scatterlist *sg,
> int nents, enum dma_data_direction dir)
> {
> + struct dma_map_ops *ops = get_dma_ops(dev);
> struct scatterlist *s;
> int i;
>
> - for_each_sg(sg, s, nents, i) {
> - if (!dmabounce_sync_for_cpu(dev, sg_dma_address(s),
> - sg_dma_len(s), dir))
> - continue;
> -
> - __dma_page_dev_to_cpu(sg_page(s), s->offset,
> - s->length, dir);
> - }
> + for_each_sg(sg, s, nents, i)
> + ops->sync_single_for_cpu(dev, sg_dma_address(s), s->length,
> + dir);
> }
>
> /**
> @@ -705,17 +704,13 @@ void arm_dma_sync_sg_for_cpu(struct device *dev, struct scatterlist *sg,
> void arm_dma_sync_sg_for_device(struct device *dev, struct scatterlist *sg,
> int nents, enum dma_data_direction dir)
> {
> + struct dma_map_ops *ops = get_dma_ops(dev);
> struct scatterlist *s;
> int i;
>
> - for_each_sg(sg, s, nents, i) {
> - if (!dmabounce_sync_for_device(dev, sg_dma_address(s),
> - sg_dma_len(s), dir))
> - continue;
> -
> - __dma_page_cpu_to_dev(sg_page(s), s->offset,
> - s->length, dir);
> - }
> + for_each_sg(sg, s, nents, i)
> + ops->sync_single_for_device(dev, sg_dma_address(s), s->length,
> + dir);
> }
>
> /*
> --
> 1.7.1.569.g6f426
>
> _______________________________________________
> iommu mailing list
> iommu@lists.linux-foundation.org
> https://lists.linuxfoundation.org/mailman/listinfo/iommu
--
To unsubscribe, send a message with 'unsubscribe linux-mm' in
the body to majordomo@kvack.org. For more info on Linux MM,
see: http://www.linux-mm.org/ .
Fight unfair telecom internet charges in Canada: sign http://stopthemeter.ca/
Don't email: <a href=mailto:"dont@kvack.org"> email@kvack.org </a>
WARNING: multiple messages have this Message-ID (diff)
From: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
To: Marek Szyprowski <m.szyprowski@samsung.com>
Cc: linux-arm-kernel@lists.infradead.org,
linaro-mm-sig@lists.linaro.org, linux-mm@kvack.org,
linux-arch@vger.kernel.org, linux-samsung-soc@vger.kernel.org,
iommu@lists.linux-foundation.org,
Shariq Hasnain <shariq.hasnain@linaro.org>,
Arnd Bergmann <arnd@arndb.de>,
Benjamin Herrenschmidt <benh@kernel.crashing.org>,
Krishna Reddy <vdumpa@nvidia.com>,
Kyungmin Park <kyungmin.park@samsung.com>,
Andrzej Pietrasiewicz <andrzej.p@samsung.com>,
Russell King - ARM Linux <linux@arm.linux.org.uk>,
KyongHo Cho <pullip.cho@samsung.com>,
Chunsang Jeong <chunsang.jeong@linaro.org>
Subject: Re: [PATCHv6 3/7] ARM: dma-mapping: implement dma sg methods on top of any generic dma ops
Date: Tue, 14 Feb 2012 10:02:55 -0500 [thread overview]
Message-ID: <20120214150255.GC18359@phenom.dumpdata.com> (raw)
Message-ID: <20120214150255.zyXwdE18CXbk8JKbin2FlTNkMXcoRBfUezxZgeTW18E@z> (raw)
In-Reply-To: <1328900324-20946-4-git-send-email-m.szyprowski@samsung.com>
On Fri, Feb 10, 2012 at 07:58:40PM +0100, Marek Szyprowski wrote:
> This patch converts all dma_sg methods to be generic (independent of the
> current DMA mapping implementation for ARM architecture). All dma sg
> operations are now implemented on top of respective
> dma_map_page/dma_sync_single_for* operations from dma_map_ops structure.
Looks good, except the worry I've that the DMA debug API calls are now
lost.
>
> Signed-off-by: Marek Szyprowski <m.szyprowski@samsung.com>
> Signed-off-by: Kyungmin Park <kyungmin.park@samsung.com>
> ---
> arch/arm/mm/dma-mapping.c | 35 +++++++++++++++--------------------
> 1 files changed, 15 insertions(+), 20 deletions(-)
>
> diff --git a/arch/arm/mm/dma-mapping.c b/arch/arm/mm/dma-mapping.c
> index 91fe436..31ff699 100644
> --- a/arch/arm/mm/dma-mapping.c
> +++ b/arch/arm/mm/dma-mapping.c
> @@ -635,12 +635,13 @@ EXPORT_SYMBOL(___dma_page_dev_to_cpu);
> int arm_dma_map_sg(struct device *dev, struct scatterlist *sg, int nents,
> enum dma_data_direction dir, struct dma_attrs *attrs)
> {
> + struct dma_map_ops *ops = get_dma_ops(dev);
> struct scatterlist *s;
> int i, j;
>
> for_each_sg(sg, s, nents, i) {
> - s->dma_address = __dma_map_page(dev, sg_page(s), s->offset,
> - s->length, dir);
> + s->dma_address = ops->map_page(dev, sg_page(s), s->offset,
> + s->length, dir, attrs);
> if (dma_mapping_error(dev, s->dma_address))
> goto bad_mapping;
> }
> @@ -648,7 +649,7 @@ int arm_dma_map_sg(struct device *dev, struct scatterlist *sg, int nents,
>
> bad_mapping:
> for_each_sg(sg, s, i, j)
> - __dma_unmap_page(dev, sg_dma_address(s), sg_dma_len(s), dir);
> + ops->unmap_page(dev, sg_dma_address(s), sg_dma_len(s), dir, attrs);
> return 0;
> }
>
> @@ -665,11 +666,13 @@ int arm_dma_map_sg(struct device *dev, struct scatterlist *sg, int nents,
> void arm_dma_unmap_sg(struct device *dev, struct scatterlist *sg, int nents,
> enum dma_data_direction dir, struct dma_attrs *attrs)
> {
> + struct dma_map_ops *ops = get_dma_ops(dev);
> struct scatterlist *s;
> +
> int i;
>
> for_each_sg(sg, s, nents, i)
> - __dma_unmap_page(dev, sg_dma_address(s), sg_dma_len(s), dir);
> + ops->unmap_page(dev, sg_dma_address(s), sg_dma_len(s), dir, attrs);
> }
>
> /**
> @@ -682,17 +685,13 @@ void arm_dma_unmap_sg(struct device *dev, struct scatterlist *sg, int nents,
> void arm_dma_sync_sg_for_cpu(struct device *dev, struct scatterlist *sg,
> int nents, enum dma_data_direction dir)
> {
> + struct dma_map_ops *ops = get_dma_ops(dev);
> struct scatterlist *s;
> int i;
>
> - for_each_sg(sg, s, nents, i) {
> - if (!dmabounce_sync_for_cpu(dev, sg_dma_address(s),
> - sg_dma_len(s), dir))
> - continue;
> -
> - __dma_page_dev_to_cpu(sg_page(s), s->offset,
> - s->length, dir);
> - }
> + for_each_sg(sg, s, nents, i)
> + ops->sync_single_for_cpu(dev, sg_dma_address(s), s->length,
> + dir);
> }
>
> /**
> @@ -705,17 +704,13 @@ void arm_dma_sync_sg_for_cpu(struct device *dev, struct scatterlist *sg,
> void arm_dma_sync_sg_for_device(struct device *dev, struct scatterlist *sg,
> int nents, enum dma_data_direction dir)
> {
> + struct dma_map_ops *ops = get_dma_ops(dev);
> struct scatterlist *s;
> int i;
>
> - for_each_sg(sg, s, nents, i) {
> - if (!dmabounce_sync_for_device(dev, sg_dma_address(s),
> - sg_dma_len(s), dir))
> - continue;
> -
> - __dma_page_cpu_to_dev(sg_page(s), s->offset,
> - s->length, dir);
> - }
> + for_each_sg(sg, s, nents, i)
> + ops->sync_single_for_device(dev, sg_dma_address(s), s->length,
> + dir);
> }
>
> /*
> --
> 1.7.1.569.g6f426
>
> _______________________________________________
> iommu mailing list
> iommu@lists.linux-foundation.org
> https://lists.linuxfoundation.org/mailman/listinfo/iommu
WARNING: multiple messages have this Message-ID (diff)
From: konrad.wilk@oracle.com (Konrad Rzeszutek Wilk)
To: linux-arm-kernel@lists.infradead.org
Subject: [PATCHv6 3/7] ARM: dma-mapping: implement dma sg methods on top of any generic dma ops
Date: Tue, 14 Feb 2012 10:02:55 -0500 [thread overview]
Message-ID: <20120214150255.GC18359@phenom.dumpdata.com> (raw)
In-Reply-To: <1328900324-20946-4-git-send-email-m.szyprowski@samsung.com>
On Fri, Feb 10, 2012 at 07:58:40PM +0100, Marek Szyprowski wrote:
> This patch converts all dma_sg methods to be generic (independent of the
> current DMA mapping implementation for ARM architecture). All dma sg
> operations are now implemented on top of respective
> dma_map_page/dma_sync_single_for* operations from dma_map_ops structure.
Looks good, except the worry I've that the DMA debug API calls are now
lost.
>
> Signed-off-by: Marek Szyprowski <m.szyprowski@samsung.com>
> Signed-off-by: Kyungmin Park <kyungmin.park@samsung.com>
> ---
> arch/arm/mm/dma-mapping.c | 35 +++++++++++++++--------------------
> 1 files changed, 15 insertions(+), 20 deletions(-)
>
> diff --git a/arch/arm/mm/dma-mapping.c b/arch/arm/mm/dma-mapping.c
> index 91fe436..31ff699 100644
> --- a/arch/arm/mm/dma-mapping.c
> +++ b/arch/arm/mm/dma-mapping.c
> @@ -635,12 +635,13 @@ EXPORT_SYMBOL(___dma_page_dev_to_cpu);
> int arm_dma_map_sg(struct device *dev, struct scatterlist *sg, int nents,
> enum dma_data_direction dir, struct dma_attrs *attrs)
> {
> + struct dma_map_ops *ops = get_dma_ops(dev);
> struct scatterlist *s;
> int i, j;
>
> for_each_sg(sg, s, nents, i) {
> - s->dma_address = __dma_map_page(dev, sg_page(s), s->offset,
> - s->length, dir);
> + s->dma_address = ops->map_page(dev, sg_page(s), s->offset,
> + s->length, dir, attrs);
> if (dma_mapping_error(dev, s->dma_address))
> goto bad_mapping;
> }
> @@ -648,7 +649,7 @@ int arm_dma_map_sg(struct device *dev, struct scatterlist *sg, int nents,
>
> bad_mapping:
> for_each_sg(sg, s, i, j)
> - __dma_unmap_page(dev, sg_dma_address(s), sg_dma_len(s), dir);
> + ops->unmap_page(dev, sg_dma_address(s), sg_dma_len(s), dir, attrs);
> return 0;
> }
>
> @@ -665,11 +666,13 @@ int arm_dma_map_sg(struct device *dev, struct scatterlist *sg, int nents,
> void arm_dma_unmap_sg(struct device *dev, struct scatterlist *sg, int nents,
> enum dma_data_direction dir, struct dma_attrs *attrs)
> {
> + struct dma_map_ops *ops = get_dma_ops(dev);
> struct scatterlist *s;
> +
> int i;
>
> for_each_sg(sg, s, nents, i)
> - __dma_unmap_page(dev, sg_dma_address(s), sg_dma_len(s), dir);
> + ops->unmap_page(dev, sg_dma_address(s), sg_dma_len(s), dir, attrs);
> }
>
> /**
> @@ -682,17 +685,13 @@ void arm_dma_unmap_sg(struct device *dev, struct scatterlist *sg, int nents,
> void arm_dma_sync_sg_for_cpu(struct device *dev, struct scatterlist *sg,
> int nents, enum dma_data_direction dir)
> {
> + struct dma_map_ops *ops = get_dma_ops(dev);
> struct scatterlist *s;
> int i;
>
> - for_each_sg(sg, s, nents, i) {
> - if (!dmabounce_sync_for_cpu(dev, sg_dma_address(s),
> - sg_dma_len(s), dir))
> - continue;
> -
> - __dma_page_dev_to_cpu(sg_page(s), s->offset,
> - s->length, dir);
> - }
> + for_each_sg(sg, s, nents, i)
> + ops->sync_single_for_cpu(dev, sg_dma_address(s), s->length,
> + dir);
> }
>
> /**
> @@ -705,17 +704,13 @@ void arm_dma_sync_sg_for_cpu(struct device *dev, struct scatterlist *sg,
> void arm_dma_sync_sg_for_device(struct device *dev, struct scatterlist *sg,
> int nents, enum dma_data_direction dir)
> {
> + struct dma_map_ops *ops = get_dma_ops(dev);
> struct scatterlist *s;
> int i;
>
> - for_each_sg(sg, s, nents, i) {
> - if (!dmabounce_sync_for_device(dev, sg_dma_address(s),
> - sg_dma_len(s), dir))
> - continue;
> -
> - __dma_page_cpu_to_dev(sg_page(s), s->offset,
> - s->length, dir);
> - }
> + for_each_sg(sg, s, nents, i)
> + ops->sync_single_for_device(dev, sg_dma_address(s), s->length,
> + dir);
> }
>
> /*
> --
> 1.7.1.569.g6f426
>
> _______________________________________________
> iommu mailing list
> iommu at lists.linux-foundation.org
> https://lists.linuxfoundation.org/mailman/listinfo/iommu
next prev parent reply other threads:[~2012-02-14 15:02 UTC|newest]
Thread overview: 68+ messages / expand[flat|nested] mbox.gz Atom feed top
2012-02-10 18:58 [PATCHv6 0/7] ARM: DMA-mapping framework redesign Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` [PATCHv6 3/7] ARM: dma-mapping: implement dma sg methods on top of any generic dma ops Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-14 15:02 ` Konrad Rzeszutek Wilk [this message]
2012-02-14 15:02 ` Konrad Rzeszutek Wilk
2012-02-14 15:02 ` Konrad Rzeszutek Wilk
2012-02-24 13:24 ` Marek Szyprowski
2012-02-24 13:24 ` Marek Szyprowski
2012-02-24 13:24 ` Marek Szyprowski
[not found] ` <1328900324-20946-1-git-send-email-m.szyprowski-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>
2012-02-10 18:58 ` [PATCHv6 1/7] ARM: dma-mapping: remove offset parameter to prepare for generic dma_ops Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` [PATCHv6 2/7] ARM: dma-mapping: use asm-generic/dma-mapping-common.h Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-14 15:01 ` Konrad Rzeszutek Wilk
2012-02-14 15:01 ` Konrad Rzeszutek Wilk
2012-02-14 15:01 ` Konrad Rzeszutek Wilk
2012-02-10 18:58 ` [PATCHv6 4/7] ARM: dma-mapping: move all dma bounce code to separate dma ops structure Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` [PATCHv6 5/7] ARM: dma-mapping: remove redundant code and cleanup Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` [PATCHv6 6/7] ARM: dma-mapping: use alloc, mmap, free from dma_ops Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` [PATCHv6 7/7] ARM: dma-mapping: add support for IOMMU mapper Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-10 18:58 ` Marek Szyprowski
2012-02-13 18:18 ` Krishna Reddy
2012-02-13 18:18 ` Krishna Reddy
2012-02-13 18:18 ` Krishna Reddy
2012-02-13 19:58 ` Krishna Reddy
2012-02-13 19:58 ` Krishna Reddy
2012-02-13 19:58 ` Krishna Reddy
[not found] ` <401E54CE964CD94BAE1EB4A729C7087E378E42AE18-wAPRp6hVlRhDw2glCA4ptUEOCMrvLtNR@public.gmane.org>
2012-02-24 9:35 ` Marek Szyprowski
2012-02-24 9:35 ` Marek Szyprowski
2012-02-24 9:35 ` Marek Szyprowski
2012-02-24 9:35 ` Marek Szyprowski
2012-02-24 12:49 ` Arnd Bergmann
2012-02-24 12:49 ` Arnd Bergmann
2012-02-24 12:49 ` Arnd Bergmann
2012-02-24 13:18 ` Marek Szyprowski
2012-02-24 13:18 ` Marek Szyprowski
2012-02-24 13:18 ` Marek Szyprowski
2012-02-24 14:31 ` Arnd Bergmann
2012-02-24 14:31 ` Arnd Bergmann
2012-02-24 14:31 ` Arnd Bergmann
[not found] ` <201202241431.02170.arnd-r2nGTMty4D4@public.gmane.org>
2012-02-24 15:30 ` Marek Szyprowski
2012-02-24 15:30 ` Marek Szyprowski
2012-02-24 15:30 ` Marek Szyprowski
2012-02-24 15:30 ` Marek Szyprowski
2012-02-14 14:55 ` Konrad Rzeszutek Wilk
2012-02-14 14:55 ` Konrad Rzeszutek Wilk
2012-02-14 14:55 ` Konrad Rzeszutek Wilk
2012-02-24 13:12 ` Marek Szyprowski
2012-02-24 13:12 ` Marek Szyprowski
2012-02-24 13:12 ` Marek Szyprowski
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=20120214150255.GC18359@phenom.dumpdata.com \
--to=konrad.wilk@oracle.com \
--cc=andrzej.p@samsung.com \
--cc=arnd@arndb.de \
--cc=benh@kernel.crashing.org \
--cc=chunsang.jeong@linaro.org \
--cc=iommu@lists.linux-foundation.org \
--cc=kyungmin.park@samsung.com \
--cc=linaro-mm-sig@lists.linaro.org \
--cc=linux-arch@vger.kernel.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-mm@kvack.org \
--cc=linux-samsung-soc@vger.kernel.org \
--cc=linux@arm.linux.org.uk \
--cc=m.szyprowski@samsung.com \
--cc=pullip.cho@samsung.com \
--cc=shariq.hasnain@linaro.org \
--cc=vdumpa@nvidia.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.