From: Anthony PERARD <anthony.perard@citrix.com> To: edk2-devel@lists.01.org Cc: Ard Biesheuvel <ard.biesheuvel@linaro.org>, Jordan Justen <jordan.l.justen@intel.com>, Julien Grall <julien.grall@arm.com>, Anthony PERARD <anthony.perard@citrix.com>, xen-devel@lists.xenproject.org, Laszlo Ersek <lersek@redhat.com> Subject: [PATCH v2 03/31] OvmfPkg: Introduce XenResetVector Date: Mon, 8 Apr 2019 15:23:40 +0100 [thread overview] Message-ID: <20190408142408.30419-4-anthony.perard@citrix.com> (raw) In-Reply-To: <20190408142408.30419-1-anthony.perard@citrix.com> Copy of OvmfPkg/ResetVector, with one changes: - SEC_DEFAULT_CR0: enable cache (bit 30 or CD set to 0) Xen copies the OVMF code to RAM, there is no need to disable cache. This new module will later be modified to add a new entry point, more detail in a following commit "OvmfPkg/XenResetVector: Add new entry point for Xen PVH" Value FILE_GUID of XenResetVector have not changed compare to ResetVector because it is a special value. Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Anthony PERARD <anthony.perard@citrix.com> --- OvmfPkg/XenOvmf.dsc | 2 +- OvmfPkg/XenOvmf.fdf | 2 +- OvmfPkg/{ResetVector/ResetVector.inf => XenResetVector/XenResetVector.inf} | 5 +++-- {UefiCpuPkg/ResetVector/Vtf0 => OvmfPkg/XenResetVector}/Ia16/Real16ToFlat32.asm | 4 +++- OvmfPkg/{ResetVector => XenResetVector}/Ia32/PageTables64.asm | 2 ++ OvmfPkg/{ResetVector/ResetVector.nasmb => XenResetVector/XenResetVector.nasmb} | 2 ++ 6 files changed, 12 insertions(+), 5 deletions(-) diff --git a/OvmfPkg/XenOvmf.dsc b/OvmfPkg/XenOvmf.dsc index bfe9190735..6161133fa8 100644 --- a/OvmfPkg/XenOvmf.dsc +++ b/OvmfPkg/XenOvmf.dsc @@ -503,7 +503,7 @@ [PcdsDynamicDefault] # ################################################################################ [Components] - OvmfPkg/ResetVector/ResetVector.inf + OvmfPkg/XenResetVector/XenResetVector.inf # # SEC Phase modules diff --git a/OvmfPkg/XenOvmf.fdf b/OvmfPkg/XenOvmf.fdf index 612ffb2e01..292cf4b492 100644 --- a/OvmfPkg/XenOvmf.fdf +++ b/OvmfPkg/XenOvmf.fdf @@ -124,7 +124,7 @@ [FV.SECFV] # INF OvmfPkg/Sec/SecMain.inf -INF RuleOverride=RESET_VECTOR OvmfPkg/ResetVector/ResetVector.inf +INF RuleOverride=RESET_VECTOR OvmfPkg/XenResetVector/XenResetVector.inf ################################################################################ [FV.PEIFV] diff --git a/OvmfPkg/ResetVector/ResetVector.inf b/OvmfPkg/XenResetVector/XenResetVector.inf similarity index 88% copy from OvmfPkg/ResetVector/ResetVector.inf copy to OvmfPkg/XenResetVector/XenResetVector.inf index d1e5d4d9bd..5c05f02285 100644 --- a/OvmfPkg/ResetVector/ResetVector.inf +++ b/OvmfPkg/XenResetVector/XenResetVector.inf @@ -2,6 +2,7 @@ # Reset Vector # # Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR> +# Copyright (c) 2019, Citrix Systems, Inc. # # This program and the accompanying materials # are licensed and made available under the terms and conditions of the BSD License @@ -14,7 +15,7 @@ [Defines] INF_VERSION = 0x00010005 - BASE_NAME = ResetVector + BASE_NAME = XenResetVector FILE_GUID = 1BA0062E-C779-4582-8566-336AE8F78F09 MODULE_TYPE = SEC VERSION_STRING = 1.1 @@ -26,7 +27,7 @@ [Defines] # [Sources] - ResetVector.nasmb + XenResetVector.nasmb [Packages] OvmfPkg/OvmfPkg.dec diff --git a/UefiCpuPkg/ResetVector/Vtf0/Ia16/Real16ToFlat32.asm b/OvmfPkg/XenResetVector/Ia16/Real16ToFlat32.asm similarity index 94% copy from UefiCpuPkg/ResetVector/Vtf0/Ia16/Real16ToFlat32.asm copy to OvmfPkg/XenResetVector/Ia16/Real16ToFlat32.asm index bc68c8dd74..e22e92c8a6 100644 --- a/UefiCpuPkg/ResetVector/Vtf0/Ia16/Real16ToFlat32.asm +++ b/OvmfPkg/XenResetVector/Ia16/Real16ToFlat32.asm @@ -3,6 +3,8 @@ ; Transition from 16 bit real mode into 32 bit flat protected mode ; ; Copyright (c) 2008 - 2010, Intel Corporation. All rights reserved.<BR> +; Copyright (c) 2019, Citrix Systems, Inc. +; ; This program and the accompanying materials ; are licensed and made available under the terms and conditions of the BSD License ; which accompanies this distribution. The full text of the license may be found at @@ -13,7 +15,7 @@ ; ;------------------------------------------------------------------------------ -%define SEC_DEFAULT_CR0 0x40000023 +%define SEC_DEFAULT_CR0 0x00000023 %define SEC_DEFAULT_CR4 0x640 BITS 16 diff --git a/OvmfPkg/ResetVector/Ia32/PageTables64.asm b/OvmfPkg/XenResetVector/Ia32/PageTables64.asm similarity index 95% copy from OvmfPkg/ResetVector/Ia32/PageTables64.asm copy to OvmfPkg/XenResetVector/Ia32/PageTables64.asm index db1590aedd..ded466031b 100644 --- a/OvmfPkg/ResetVector/Ia32/PageTables64.asm +++ b/OvmfPkg/XenResetVector/Ia32/PageTables64.asm @@ -3,6 +3,8 @@ ; Sets the CR3 register for 64-bit paging ; ; Copyright (c) 2008 - 2013, Intel Corporation. All rights reserved.<BR> +; Copyright (c) 2019, Citrix Systems, Inc. +; ; This program and the accompanying materials ; are licensed and made available under the terms and conditions of the BSD License ; which accompanies this distribution. The full text of the license may be found at diff --git a/OvmfPkg/ResetVector/ResetVector.nasmb b/OvmfPkg/XenResetVector/XenResetVector.nasmb similarity index 94% copy from OvmfPkg/ResetVector/ResetVector.nasmb copy to OvmfPkg/XenResetVector/XenResetVector.nasmb index 29cbad3677..49f2bab001 100644 --- a/OvmfPkg/ResetVector/ResetVector.nasmb +++ b/OvmfPkg/XenResetVector/XenResetVector.nasmb @@ -3,6 +3,8 @@ ; This file includes all other code files to assemble the reset vector code ; ; Copyright (c) 2008 - 2013, Intel Corporation. All rights reserved.<BR> +; Copyright (c) 2019, Citrix Systems, Inc. +; ; This program and the accompanying materials ; are licensed and made available under the terms and conditions of the BSD License ; which accompanies this distribution. The full text of the license may be found at -- Anthony PERARD _______________________________________________ Xen-devel mailing list Xen-devel@lists.xenproject.org https://lists.xenproject.org/mailman/listinfo/xen-devel
WARNING: multiple messages have this Message-ID (diff)
From: Anthony PERARD <anthony.perard@citrix.com> To: <edk2-devel@lists.01.org> Cc: Ard Biesheuvel <ard.biesheuvel@linaro.org>, Jordan Justen <jordan.l.justen@intel.com>, Julien Grall <julien.grall@arm.com>, Anthony PERARD <anthony.perard@citrix.com>, xen-devel@lists.xenproject.org, Laszlo Ersek <lersek@redhat.com> Subject: [Xen-devel] [PATCH v2 03/31] OvmfPkg: Introduce XenResetVector Date: Mon, 8 Apr 2019 15:23:40 +0100 [thread overview] Message-ID: <20190408142408.30419-4-anthony.perard@citrix.com> (raw) Message-ID: <20190408142340.Y4A6xrfO5ebs7M2SeXcMiNYPskxvkiuBTs6nCF7i0G8@z> (raw) In-Reply-To: <20190408142408.30419-1-anthony.perard@citrix.com> Copy of OvmfPkg/ResetVector, with one changes: - SEC_DEFAULT_CR0: enable cache (bit 30 or CD set to 0) Xen copies the OVMF code to RAM, there is no need to disable cache. This new module will later be modified to add a new entry point, more detail in a following commit "OvmfPkg/XenResetVector: Add new entry point for Xen PVH" Value FILE_GUID of XenResetVector have not changed compare to ResetVector because it is a special value. Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Anthony PERARD <anthony.perard@citrix.com> --- OvmfPkg/XenOvmf.dsc | 2 +- OvmfPkg/XenOvmf.fdf | 2 +- OvmfPkg/{ResetVector/ResetVector.inf => XenResetVector/XenResetVector.inf} | 5 +++-- {UefiCpuPkg/ResetVector/Vtf0 => OvmfPkg/XenResetVector}/Ia16/Real16ToFlat32.asm | 4 +++- OvmfPkg/{ResetVector => XenResetVector}/Ia32/PageTables64.asm | 2 ++ OvmfPkg/{ResetVector/ResetVector.nasmb => XenResetVector/XenResetVector.nasmb} | 2 ++ 6 files changed, 12 insertions(+), 5 deletions(-) diff --git a/OvmfPkg/XenOvmf.dsc b/OvmfPkg/XenOvmf.dsc index bfe9190735..6161133fa8 100644 --- a/OvmfPkg/XenOvmf.dsc +++ b/OvmfPkg/XenOvmf.dsc @@ -503,7 +503,7 @@ [PcdsDynamicDefault] # ################################################################################ [Components] - OvmfPkg/ResetVector/ResetVector.inf + OvmfPkg/XenResetVector/XenResetVector.inf # # SEC Phase modules diff --git a/OvmfPkg/XenOvmf.fdf b/OvmfPkg/XenOvmf.fdf index 612ffb2e01..292cf4b492 100644 --- a/OvmfPkg/XenOvmf.fdf +++ b/OvmfPkg/XenOvmf.fdf @@ -124,7 +124,7 @@ [FV.SECFV] # INF OvmfPkg/Sec/SecMain.inf -INF RuleOverride=RESET_VECTOR OvmfPkg/ResetVector/ResetVector.inf +INF RuleOverride=RESET_VECTOR OvmfPkg/XenResetVector/XenResetVector.inf ################################################################################ [FV.PEIFV] diff --git a/OvmfPkg/ResetVector/ResetVector.inf b/OvmfPkg/XenResetVector/XenResetVector.inf similarity index 88% copy from OvmfPkg/ResetVector/ResetVector.inf copy to OvmfPkg/XenResetVector/XenResetVector.inf index d1e5d4d9bd..5c05f02285 100644 --- a/OvmfPkg/ResetVector/ResetVector.inf +++ b/OvmfPkg/XenResetVector/XenResetVector.inf @@ -2,6 +2,7 @@ # Reset Vector # # Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR> +# Copyright (c) 2019, Citrix Systems, Inc. # # This program and the accompanying materials # are licensed and made available under the terms and conditions of the BSD License @@ -14,7 +15,7 @@ [Defines] INF_VERSION = 0x00010005 - BASE_NAME = ResetVector + BASE_NAME = XenResetVector FILE_GUID = 1BA0062E-C779-4582-8566-336AE8F78F09 MODULE_TYPE = SEC VERSION_STRING = 1.1 @@ -26,7 +27,7 @@ [Defines] # [Sources] - ResetVector.nasmb + XenResetVector.nasmb [Packages] OvmfPkg/OvmfPkg.dec diff --git a/UefiCpuPkg/ResetVector/Vtf0/Ia16/Real16ToFlat32.asm b/OvmfPkg/XenResetVector/Ia16/Real16ToFlat32.asm similarity index 94% copy from UefiCpuPkg/ResetVector/Vtf0/Ia16/Real16ToFlat32.asm copy to OvmfPkg/XenResetVector/Ia16/Real16ToFlat32.asm index bc68c8dd74..e22e92c8a6 100644 --- a/UefiCpuPkg/ResetVector/Vtf0/Ia16/Real16ToFlat32.asm +++ b/OvmfPkg/XenResetVector/Ia16/Real16ToFlat32.asm @@ -3,6 +3,8 @@ ; Transition from 16 bit real mode into 32 bit flat protected mode ; ; Copyright (c) 2008 - 2010, Intel Corporation. All rights reserved.<BR> +; Copyright (c) 2019, Citrix Systems, Inc. +; ; This program and the accompanying materials ; are licensed and made available under the terms and conditions of the BSD License ; which accompanies this distribution. The full text of the license may be found at @@ -13,7 +15,7 @@ ; ;------------------------------------------------------------------------------ -%define SEC_DEFAULT_CR0 0x40000023 +%define SEC_DEFAULT_CR0 0x00000023 %define SEC_DEFAULT_CR4 0x640 BITS 16 diff --git a/OvmfPkg/ResetVector/Ia32/PageTables64.asm b/OvmfPkg/XenResetVector/Ia32/PageTables64.asm similarity index 95% copy from OvmfPkg/ResetVector/Ia32/PageTables64.asm copy to OvmfPkg/XenResetVector/Ia32/PageTables64.asm index db1590aedd..ded466031b 100644 --- a/OvmfPkg/ResetVector/Ia32/PageTables64.asm +++ b/OvmfPkg/XenResetVector/Ia32/PageTables64.asm @@ -3,6 +3,8 @@ ; Sets the CR3 register for 64-bit paging ; ; Copyright (c) 2008 - 2013, Intel Corporation. All rights reserved.<BR> +; Copyright (c) 2019, Citrix Systems, Inc. +; ; This program and the accompanying materials ; are licensed and made available under the terms and conditions of the BSD License ; which accompanies this distribution. The full text of the license may be found at diff --git a/OvmfPkg/ResetVector/ResetVector.nasmb b/OvmfPkg/XenResetVector/XenResetVector.nasmb similarity index 94% copy from OvmfPkg/ResetVector/ResetVector.nasmb copy to OvmfPkg/XenResetVector/XenResetVector.nasmb index 29cbad3677..49f2bab001 100644 --- a/OvmfPkg/ResetVector/ResetVector.nasmb +++ b/OvmfPkg/XenResetVector/XenResetVector.nasmb @@ -3,6 +3,8 @@ ; This file includes all other code files to assemble the reset vector code ; ; Copyright (c) 2008 - 2013, Intel Corporation. All rights reserved.<BR> +; Copyright (c) 2019, Citrix Systems, Inc. +; ; This program and the accompanying materials ; are licensed and made available under the terms and conditions of the BSD License ; which accompanies this distribution. The full text of the license may be found at -- Anthony PERARD _______________________________________________ Xen-devel mailing list Xen-devel@lists.xenproject.org https://lists.xenproject.org/mailman/listinfo/xen-devel
next prev parent reply other threads:[~2019-04-08 14:24 UTC|newest] Thread overview: 73+ messages / expand[flat|nested] mbox.gz Atom feed top 2019-04-08 14:23 [PATCH v2 00/31] Specific platform to run OVMF in Xen PVH and HVM guests Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 01/31] OvmfPkg/ResetSystemLib: Add missing dependency on PciLib Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 02/31] OvmfPkg: Create platform XenOvmf Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` Anthony PERARD [this message] 2019-04-08 14:23 ` [Xen-devel] [PATCH v2 03/31] OvmfPkg: Introduce XenResetVector Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 04/31] OvmfPkg: Introduce XenPlatformPei Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 05/31] OvmfPkg/XenOvmf: Creating an ELF header Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 06/31] OvmfPkg/XenResetVector: Add new entry point for Xen PVH Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 07/31] OvmfPkg/XenResetVector: Saving start of day pointer for PVH guests Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 08/31] OvmfPkg/XenResetVector: Allow to jumpstart from either hvmloader or PVH Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 09/31] OvmfPkg/XenOvmf: use a TimerLib instance that depends only on the CPU Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 10/31] OvmfPkg/XenPlatformPei: Detect OVMF_INFO from hvmloader Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 11/31] OvmfPkg/XenPlatformPei: Use mXenHvmloaderInfo to get E820 Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 12/31] OvmfPkg/XenPlatformPei: Grab RSDP from PVH guest start of day struct Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 13/31] OvmfPkg/Library/XenPlatformLib: New library Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 14/31] OvmfPkg/AcpiPlatformDxe: Use PVH RSDP if exist Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 15/31] OvmfPkg/XenHypercallLib: Enable it in PEIM Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 16/31] OvmfPkg/XenPlatformPei: Introduce XenHvmloaderDetected Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 17/31] OvmfPkg/XenPlatformPei: Reserve hvmloader's memory only when it as runned Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 18/31] OvmfPkg/XenPlatformPei: Setup HyperPages earlier Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 19/31] OvmfPkg/XenPlatformPei: Introduce XenPvhDetected Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 20/31] OvmfPkg: Import XENMEM_memory_map hypercall to Xen/memory.h Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 21/31] OvmfPkg/XenPlatformPei: Get E820 table via hypercall Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:23 ` [PATCH v2 22/31] OvmfPkg/XenPlatformPei: Rework memory detection Anthony PERARD 2019-04-08 14:23 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:24 ` [PATCH v2 23/31] OvmfPkg/XenPlatformPei: Reserve VGA memory region, to boot Linux Anthony PERARD 2019-04-08 14:24 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:24 ` [PATCH v2 24/31] OvmfPkg/XenPlatformPei: Ignore missing PCI Host Bridge on Xen PVH Anthony PERARD 2019-04-08 14:24 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:24 ` [PATCH v2 25/31] OvmfPkg/PlatformBootManagerLib: Handle the absence of PCI bus " Anthony PERARD 2019-04-08 14:24 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:24 ` [PATCH v2 26/31] OvmfPkg/XenOvmf: Override PcdFSBClock to Xen vLAPIC timer frequency Anthony PERARD 2019-04-08 14:24 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:24 ` [PATCH v2 27/31] OvmfPkg/XenOvmf: Introduce XenTimerDxe Anthony PERARD 2019-04-08 14:24 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:24 ` [PATCH v2 28/31] OvmfPkg/PlatformBootManagerLib: Use a Xen console for ConOut/ConIn Anthony PERARD 2019-04-08 14:24 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:24 ` [PATCH v2 29/31] OvmfPkg: Introduce XenIoPvhDxe to initialize Grant Tables Anthony PERARD 2019-04-08 14:24 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:24 ` [PATCH v2 30/31] OvmfPkg: Move XenRealTimeClockLib from ArmVirtPkg Anthony PERARD 2019-04-08 14:24 ` [Xen-devel] " Anthony PERARD 2019-04-08 14:24 ` [PATCH v2 31/31] OvmfPkg/XenOvmf: use RealTimeClockRuntimeDxe from EmbeddedPkg Anthony PERARD 2019-04-08 14:24 ` [Xen-devel] " Anthony PERARD 2019-04-08 15:50 ` [PATCH v2 00/31] Specific platform to run OVMF in Xen PVH and HVM guests Laszlo Ersek 2019-04-08 15:50 ` [Xen-devel] " Laszlo Ersek 2019-04-09 8:09 ` Laszlo Ersek 2019-04-09 8:09 ` [Xen-devel] " Laszlo Ersek 2019-04-09 11:15 ` [edk2-devel] " Philippe Mathieu-Daudé 2019-04-09 11:15 ` [Xen-devel] " Philippe Mathieu-Daudé 2019-04-09 10:50 ` Anthony PERARD 2019-04-09 10:50 ` [Xen-devel] " Anthony PERARD 2019-04-09 11:08 Anthony PERARD 2019-04-09 11:08 ` [PATCH v2 03/31] OvmfPkg: Introduce XenResetVector Anthony PERARD
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=20190408142408.30419-4-anthony.perard@citrix.com \ --to=anthony.perard@citrix.com \ --cc=ard.biesheuvel@linaro.org \ --cc=edk2-devel@lists.01.org \ --cc=jordan.l.justen@intel.com \ --cc=julien.grall@arm.com \ --cc=lersek@redhat.com \ --cc=xen-devel@lists.xenproject.org \ /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: linkBe 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.