public inbox for devel@edk2.groups.io
 help / color / mirror / Atom feed
* [edk2][PATCH v2 0/2] ACPI table defailt for Aarch64
@ 2020-04-10 15:29 Samer El-Haj-Mahmoud
  2020-04-10 15:29 ` [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms Samer El-Haj-Mahmoud
  2020-04-10 15:29 ` [edk2][PATCH v2 2/2] Revert "ArmVirtPkg/ArmVirtQemu: limit ACPI support to v5.0 and higher" Samer El-Haj-Mahmoud
  0 siblings, 2 replies; 13+ messages in thread
From: Samer El-Haj-Mahmoud @ 2020-04-10 15:29 UTC (permalink / raw)
  To: devel

Set the default value of PcdAcpiExposedTableVersions for Aarch64
platforms to 0x20 to indicate ACPI 5.0.

Samer El-Haj-Mahmoud (2):
  MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms
  Revert "ArmVirtPkg/ArmVirtQemu: limit ACPI support to v5.0 and higher"

 MdeModulePkg/MdeModulePkg.dec | 3 +++
 ArmVirtPkg/ArmVirtQemu.dsc    | 4 ----
 2 files changed, 3 insertions(+), 4 deletions(-)

-- 
2.17.1


^ permalink raw reply	[flat|nested] 13+ messages in thread

* [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms
  2020-04-10 15:29 [edk2][PATCH v2 0/2] ACPI table defailt for Aarch64 Samer El-Haj-Mahmoud
@ 2020-04-10 15:29 ` Samer El-Haj-Mahmoud
  2020-04-14  9:45   ` [edk2-devel] " Sami Mujawar
                     ` (2 more replies)
  2020-04-10 15:29 ` [edk2][PATCH v2 2/2] Revert "ArmVirtPkg/ArmVirtQemu: limit ACPI support to v5.0 and higher" Samer El-Haj-Mahmoud
  1 sibling, 3 replies; 13+ messages in thread
From: Samer El-Haj-Mahmoud @ 2020-04-10 15:29 UTC (permalink / raw)
  To: devel
  Cc: Dandan Bi, Liming Gao, Jian J Wang, Hao A Wu, Leif Lindholm,
	Ard Biesheuvel

Set the default value of PcdAcpiExposedTableVersions for Aarch64
platforms to 0x20. Previously, the default was set to 0x3E for all
platforms. The new value removes ACPI 1.0b compatability, which forces
the use of XSDT 64-bit pointer, as required by Arm SBBR specification.
This also resolves an error reported by acpiview command, as seen on
the RPi (see https://github.com/pftf/RPi4/issues/25).

Cc: Dandan Bi <dandan.bi@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Jian J Wang <jian.j.wang@intel.com>
Cc: Hao A Wu <hao.a.wu@intel.com>
Cc: Leif Lindholm <leif@nuviainc.com>
Cc: Ard Biesheuvel <ard.biesheuvel@arm.com>

Signed-off-by: Samer El-Haj-Mahmoud <samer@elhajmahmoud.com>
Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Dandan Bi <dandan.bi@intel.com>
---
 MdeModulePkg/MdeModulePkg.dec | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/MdeModulePkg/MdeModulePkg.dec b/MdeModulePkg/MdeModulePkg.dec
index 497574cb0870..fac16f262cf8 100644
--- a/MdeModulePkg/MdeModulePkg.dec
+++ b/MdeModulePkg/MdeModulePkg.dec
@@ -1548,6 +1548,9 @@
   # @Prompt Console Output Row of Text Setup
   gEfiMdeModulePkgTokenSpaceGuid.PcdSetupConOutRow|25|UINT32|0x4000000e
 
+[PcdsFixedAtBuild.AARCH64, PcdsPatchableInModule.AARCH64]
+  gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiExposedTableVersions|0x20|UINT32|0x0001004c
+
 [PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
   ## UART clock frequency is for the baud rate configuration.
   # @Prompt Serial Port Clock Rate.
-- 
2.17.1


^ permalink raw reply related	[flat|nested] 13+ messages in thread

* [edk2][PATCH v2 2/2] Revert "ArmVirtPkg/ArmVirtQemu: limit ACPI support to v5.0 and higher"
  2020-04-10 15:29 [edk2][PATCH v2 0/2] ACPI table defailt for Aarch64 Samer El-Haj-Mahmoud
  2020-04-10 15:29 ` [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms Samer El-Haj-Mahmoud
@ 2020-04-10 15:29 ` Samer El-Haj-Mahmoud
  2020-04-14 12:19   ` [edk2-devel] " Laszlo Ersek
  1 sibling, 1 reply; 13+ messages in thread
From: Samer El-Haj-Mahmoud @ 2020-04-10 15:29 UTC (permalink / raw)
  To: devel; +Cc: Laszlo Ersek, Leif Lindholm, Ard Biesheuvel

This reverts commit e0692789058ee2c0099f88852503c16dbb0bae4e.

The default value for PcdAcpiExposedTableVersions is now set to 0x20
for Aarch64 systems. Setting this PCD in ArmVirtPkg/ArmVirtQemu.dsc
is no longer necessary.

Cc: Laszlo Ersek <lersek@redhat.com>
Cc: Leif Lindholm <leif@nuviainc.com>
Cc: Ard Biesheuvel <ard.biesheuvel@arm.com>

Signed-off-by: Samer El-Haj-Mahmoud <samer@elhajmahmoud.com>
Acked-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
---
 ArmVirtPkg/ArmVirtQemu.dsc | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/ArmVirtPkg/ArmVirtQemu.dsc b/ArmVirtPkg/ArmVirtQemu.dsc
index 5a210a0bac72..1233f1ece484 100644
--- a/ArmVirtPkg/ArmVirtQemu.dsc
+++ b/ArmVirtPkg/ArmVirtQemu.dsc
@@ -209,10 +209,6 @@
   # point only, for entry point versions >= 3.0.
   gEfiMdeModulePkgTokenSpaceGuid.PcdSmbiosEntryPointProvideMethod|0x2
 
-  # ACPI predates the AARCH64 architecture by 5 versions, so
-  # we only target OSes that support ACPI v5.0 or later
-  gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiExposedTableVersions|0x20
-
 [PcdsDynamicDefault.common]
   gEfiMdePkgTokenSpaceGuid.PcdPlatformBootTimeOut|3
 
-- 
2.17.1


^ permalink raw reply related	[flat|nested] 13+ messages in thread

* Re: [edk2-devel] [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms
  2020-04-10 15:29 ` [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms Samer El-Haj-Mahmoud
@ 2020-04-14  9:45   ` Sami Mujawar
  2020-04-14 13:33     ` Samer El-Haj-Mahmoud
  2020-04-18 15:14   ` Samer El-Haj-Mahmoud
  2020-04-21  8:54   ` Wu, Hao A
  2 siblings, 1 reply; 13+ messages in thread
From: Sami Mujawar @ 2020-04-14  9:45 UTC (permalink / raw)
  To: Samer El-Haj-Mahmoud, devel

[-- Attachment #1: Type: text/plain, Size: 78 bytes --]

Reviewed-by: Sami Mujawar <sami.mujawar@arm.com>

Regards,

Sami Mujawar

[-- Attachment #2: Type: text/html, Size: 100 bytes --]

^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: [edk2-devel] [edk2][PATCH v2 2/2] Revert "ArmVirtPkg/ArmVirtQemu: limit ACPI support to v5.0 and higher"
  2020-04-10 15:29 ` [edk2][PATCH v2 2/2] Revert "ArmVirtPkg/ArmVirtQemu: limit ACPI support to v5.0 and higher" Samer El-Haj-Mahmoud
@ 2020-04-14 12:19   ` Laszlo Ersek
  0 siblings, 0 replies; 13+ messages in thread
From: Laszlo Ersek @ 2020-04-14 12:19 UTC (permalink / raw)
  To: devel, samer; +Cc: Leif Lindholm, Ard Biesheuvel

On 04/10/20 17:29, Samer El-Haj-Mahmoud wrote:
> This reverts commit e0692789058ee2c0099f88852503c16dbb0bae4e.
> 
> The default value for PcdAcpiExposedTableVersions is now set to 0x20
> for Aarch64 systems. Setting this PCD in ArmVirtPkg/ArmVirtQemu.dsc
> is no longer necessary.
> 
> Cc: Laszlo Ersek <lersek@redhat.com>
> Cc: Leif Lindholm <leif@nuviainc.com>
> Cc: Ard Biesheuvel <ard.biesheuvel@arm.com>
> 
> Signed-off-by: Samer El-Haj-Mahmoud <samer@elhajmahmoud.com>
> Acked-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
> ---
>  ArmVirtPkg/ArmVirtQemu.dsc | 4 ----
>  1 file changed, 4 deletions(-)
> 
> diff --git a/ArmVirtPkg/ArmVirtQemu.dsc b/ArmVirtPkg/ArmVirtQemu.dsc
> index 5a210a0bac72..1233f1ece484 100644
> --- a/ArmVirtPkg/ArmVirtQemu.dsc
> +++ b/ArmVirtPkg/ArmVirtQemu.dsc
> @@ -209,10 +209,6 @@
>    # point only, for entry point versions >= 3.0.
>    gEfiMdeModulePkgTokenSpaceGuid.PcdSmbiosEntryPointProvideMethod|0x2
>  
> -  # ACPI predates the AARCH64 architecture by 5 versions, so
> -  # we only target OSes that support ACPI v5.0 or later
> -  gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiExposedTableVersions|0x20
> -
>  [PcdsDynamicDefault.common]
>    gEfiMdePkgTokenSpaceGuid.PcdPlatformBootTimeOut|3
>  
> 

Reviewed-by: Laszlo Ersek <lersek@redhat.com>


^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: [edk2-devel] [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms
  2020-04-14  9:45   ` [edk2-devel] " Sami Mujawar
@ 2020-04-14 13:33     ` Samer El-Haj-Mahmoud
  0 siblings, 0 replies; 13+ messages in thread
From: Samer El-Haj-Mahmoud @ 2020-04-14 13:33 UTC (permalink / raw)
  To: devel@edk2.groups.io, Sami Mujawar, Samer El-Haj-Mahmoud,
	Jian J Wang, Hao A Wu
  Cc: nd

[-- Attachment #1: Type: text/plain, Size: 578 bytes --]

Thanks Sami for the review

Jian,

Can we get this patch pushed please? It has been reviewed by Sami, Ard, and Dandan.

Thanks,
--Samer

From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of Sami Mujawar via groups.io
Sent: Tuesday, April 14, 2020 5:45 AM
To: Samer El-Haj-Mahmoud <samer@elhajmahmoud.com>; devel@edk2.groups.io
Subject: Re: [edk2-devel] [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms

Reviewed-by: Sami Mujawar <sami.mujawar@arm.com<mailto:sami.mujawar@arm.com>>

Regards,

Sami Mujawar


[-- Attachment #2: Type: text/html, Size: 3090 bytes --]

^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: [edk2-devel] [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms
  2020-04-10 15:29 ` [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms Samer El-Haj-Mahmoud
  2020-04-14  9:45   ` [edk2-devel] " Sami Mujawar
@ 2020-04-18 15:14   ` Samer El-Haj-Mahmoud
  2020-04-20 12:15     ` Laszlo Ersek
  2020-04-21  8:54   ` Wu, Hao A
  2 siblings, 1 reply; 13+ messages in thread
From: Samer El-Haj-Mahmoud @ 2020-04-18 15:14 UTC (permalink / raw)
  To: devel@edk2.groups.io, Jian J Wang, Hao A Wu
  Cc: Dandan Bi, Liming Gao, Leif Lindholm, Ard Biesheuvel, nd,
	samer@elhajmahmoud.com

Jian, Hao,

Can you please push this simple patch? It has been reviewed a while ago and ready to be committed.

Thanks,
--Samer

> -----Original Message-----
> From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of Samer El-
> Haj-Mahmoud via groups.io
> Sent: Friday, April 10, 2020 11:29 AM
> To: devel@edk2.groups.io
> Cc: Dandan Bi <dandan.bi@intel.com>; Liming Gao <liming.gao@intel.com>;
> Jian J Wang <jian.j.wang@intel.com>; Hao A Wu <hao.a.wu@intel.com>; Leif
> Lindholm <leif@nuviainc.com>; Ard Biesheuvel <Ard.Biesheuvel@arm.com>
> Subject: [edk2-devel] [edk2][PATCH v2 1/2] MdeModulePkg:
> PcdAcpiExposedTableVersions default for Arm64 platforms
> 
> Set the default value of PcdAcpiExposedTableVersions for Aarch64 platforms to
> 0x20. Previously, the default was set to 0x3E for all platforms. The new value
> removes ACPI 1.0b compatability, which forces the use of XSDT 64-bit pointer,
> as required by Arm SBBR specification.
> This also resolves an error reported by acpiview command, as seen on the RPi
> (see https://github.com/pftf/RPi4/issues/25).
> 
> Cc: Dandan Bi <dandan.bi@intel.com>
> Cc: Liming Gao <liming.gao@intel.com>
> Cc: Jian J Wang <jian.j.wang@intel.com>
> Cc: Hao A Wu <hao.a.wu@intel.com>
> Cc: Leif Lindholm <leif@nuviainc.com>
> Cc: Ard Biesheuvel <ard.biesheuvel@arm.com>
> 
> Signed-off-by: Samer El-Haj-Mahmoud <samer@elhajmahmoud.com>
> Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
> Reviewed-by: Dandan Bi <dandan.bi@intel.com>
> ---
>  MdeModulePkg/MdeModulePkg.dec | 3 +++
>  1 file changed, 3 insertions(+)
> 
> diff --git a/MdeModulePkg/MdeModulePkg.dec
> b/MdeModulePkg/MdeModulePkg.dec index 497574cb0870..fac16f262cf8
> 100644
> --- a/MdeModulePkg/MdeModulePkg.dec
> +++ b/MdeModulePkg/MdeModulePkg.dec
> @@ -1548,6 +1548,9 @@
>    # @Prompt Console Output Row of Text Setup
> 
> gEfiMdeModulePkgTokenSpaceGuid.PcdSetupConOutRow|25|UINT32|0x40000
> 00e
> 
> +[PcdsFixedAtBuild.AARCH64, PcdsPatchableInModule.AARCH64]
> +
> +gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiExposedTableVersions|0x20|UINT
> 32|
> +0x0001004c
> +
>  [PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
>    ## UART clock frequency is for the baud rate configuration.
>    # @Prompt Serial Port Clock Rate.
> --
> 2.17.1
> 
> 
> 


^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: [edk2-devel] [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms
  2020-04-18 15:14   ` Samer El-Haj-Mahmoud
@ 2020-04-20 12:15     ` Laszlo Ersek
  2020-04-21  4:56       ` Dandan Bi
  0 siblings, 1 reply; 13+ messages in thread
From: Laszlo Ersek @ 2020-04-20 12:15 UTC (permalink / raw)
  To: Dandan Bi
  Cc: devel, samer.el-haj-mahmoud, Jian J Wang, Hao A Wu, Liming Gao,
	Leif Lindholm, Ard Biesheuvel, nd, samer@elhajmahmoud.com

Dandan,

On 04/18/20 17:14, Samer El-Haj-Mahmoud wrote:
> Jian, Hao,
> 
> Can you please push this simple patch? It has been reviewed a while ago and ready to be committed.

should we consider your R-b on the first patch sufficient for pushing?

You are marked as "R" for "MdeModulePkg: ACPI modules", but technically
speaking, "MdeModulePkg.dec" needs an ACK from either Jian or Hao.

Content-wise, your approval looks sufficient, but I don't want to
assume. Please confirm.

Thank
Laszlo

>> -----Original Message-----
>> From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of Samer El-
>> Haj-Mahmoud via groups.io
>> Sent: Friday, April 10, 2020 11:29 AM
>> To: devel@edk2.groups.io
>> Cc: Dandan Bi <dandan.bi@intel.com>; Liming Gao <liming.gao@intel.com>;
>> Jian J Wang <jian.j.wang@intel.com>; Hao A Wu <hao.a.wu@intel.com>; Leif
>> Lindholm <leif@nuviainc.com>; Ard Biesheuvel <Ard.Biesheuvel@arm.com>
>> Subject: [edk2-devel] [edk2][PATCH v2 1/2] MdeModulePkg:
>> PcdAcpiExposedTableVersions default for Arm64 platforms
>>
>> Set the default value of PcdAcpiExposedTableVersions for Aarch64 platforms to
>> 0x20. Previously, the default was set to 0x3E for all platforms. The new value
>> removes ACPI 1.0b compatability, which forces the use of XSDT 64-bit pointer,
>> as required by Arm SBBR specification.
>> This also resolves an error reported by acpiview command, as seen on the RPi
>> (see https://github.com/pftf/RPi4/issues/25).
>>
>> Cc: Dandan Bi <dandan.bi@intel.com>
>> Cc: Liming Gao <liming.gao@intel.com>
>> Cc: Jian J Wang <jian.j.wang@intel.com>
>> Cc: Hao A Wu <hao.a.wu@intel.com>
>> Cc: Leif Lindholm <leif@nuviainc.com>
>> Cc: Ard Biesheuvel <ard.biesheuvel@arm.com>
>>
>> Signed-off-by: Samer El-Haj-Mahmoud <samer@elhajmahmoud.com>
>> Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
>> Reviewed-by: Dandan Bi <dandan.bi@intel.com>
>> ---
>>  MdeModulePkg/MdeModulePkg.dec | 3 +++
>>  1 file changed, 3 insertions(+)
>>
>> diff --git a/MdeModulePkg/MdeModulePkg.dec
>> b/MdeModulePkg/MdeModulePkg.dec index 497574cb0870..fac16f262cf8
>> 100644
>> --- a/MdeModulePkg/MdeModulePkg.dec
>> +++ b/MdeModulePkg/MdeModulePkg.dec
>> @@ -1548,6 +1548,9 @@
>>    # @Prompt Console Output Row of Text Setup
>>
>> gEfiMdeModulePkgTokenSpaceGuid.PcdSetupConOutRow|25|UINT32|0x40000
>> 00e
>>
>> +[PcdsFixedAtBuild.AARCH64, PcdsPatchableInModule.AARCH64]
>> +
>> +gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiExposedTableVersions|0x20|UINT
>> 32|
>> +0x0001004c
>> +
>>  [PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
>>    ## UART clock frequency is for the baud rate configuration.
>>    # @Prompt Serial Port Clock Rate.
>> --
>> 2.17.1
>>
>>
>>
> 
> 
> 
> 


^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: [edk2-devel] [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms
  2020-04-20 12:15     ` Laszlo Ersek
@ 2020-04-21  4:56       ` Dandan Bi
  2020-04-21  8:41         ` Laszlo Ersek
  0 siblings, 1 reply; 13+ messages in thread
From: Dandan Bi @ 2020-04-21  4:56 UTC (permalink / raw)
  To: Laszlo Ersek
  Cc: devel@edk2.groups.io, samer.el-haj-mahmoud@arm.com, Wang, Jian J,
	Wu, Hao A, Gao, Liming, Leif Lindholm, Ard Biesheuvel, nd,
	samer@elhajmahmoud.com

Hi Laszlo,

I think it should be Ok.
But if can get ACK/R-B from the maintainer of MdeModulePkg, that would be better, which follows process more.


Thanks,
Dandan
> -----Original Message-----
> From: Laszlo Ersek [mailto:lersek@redhat.com]
> Sent: Monday, April 20, 2020 8:15 PM
> To: Bi, Dandan <dandan.bi@intel.com>
> Cc: devel@edk2.groups.io; samer.el-haj-mahmoud@arm.com; Wang, Jian J
> <jian.j.wang@intel.com>; Wu, Hao A <hao.a.wu@intel.com>; Gao, Liming
> <liming.gao@intel.com>; Leif Lindholm <leif@nuviainc.com>; Ard Biesheuvel
> <Ard.Biesheuvel@arm.com>; nd <nd@arm.com>;
> samer@elhajmahmoud.com
> Subject: Re: [edk2-devel] [edk2][PATCH v2 1/2] MdeModulePkg:
> PcdAcpiExposedTableVersions default for Arm64 platforms
> 
> Dandan,
> 
> On 04/18/20 17:14, Samer El-Haj-Mahmoud wrote:
> > Jian, Hao,
> >
> > Can you please push this simple patch? It has been reviewed a while ago
> and ready to be committed.
> 
> should we consider your R-b on the first patch sufficient for pushing?
> 
> You are marked as "R" for "MdeModulePkg: ACPI modules", but technically
> speaking, "MdeModulePkg.dec" needs an ACK from either Jian or Hao.
> 
> Content-wise, your approval looks sufficient, but I don't want to assume.
> Please confirm.
> 
> Thank
> Laszlo
> 
> >> -----Original Message-----
> >> From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of
> Samer
> >> El- Haj-Mahmoud via groups.io
> >> Sent: Friday, April 10, 2020 11:29 AM
> >> To: devel@edk2.groups.io
> >> Cc: Dandan Bi <dandan.bi@intel.com>; Liming Gao
> >> <liming.gao@intel.com>; Jian J Wang <jian.j.wang@intel.com>; Hao A Wu
> >> <hao.a.wu@intel.com>; Leif Lindholm <leif@nuviainc.com>; Ard
> >> Biesheuvel <Ard.Biesheuvel@arm.com>
> >> Subject: [edk2-devel] [edk2][PATCH v2 1/2] MdeModulePkg:
> >> PcdAcpiExposedTableVersions default for Arm64 platforms
> >>
> >> Set the default value of PcdAcpiExposedTableVersions for Aarch64
> >> platforms to 0x20. Previously, the default was set to 0x3E for all
> >> platforms. The new value removes ACPI 1.0b compatability, which
> >> forces the use of XSDT 64-bit pointer, as required by Arm SBBR
> specification.
> >> This also resolves an error reported by acpiview command, as seen on
> >> the RPi (see https://github.com/pftf/RPi4/issues/25).
> >>
> >> Cc: Dandan Bi <dandan.bi@intel.com>
> >> Cc: Liming Gao <liming.gao@intel.com>
> >> Cc: Jian J Wang <jian.j.wang@intel.com>
> >> Cc: Hao A Wu <hao.a.wu@intel.com>
> >> Cc: Leif Lindholm <leif@nuviainc.com>
> >> Cc: Ard Biesheuvel <ard.biesheuvel@arm.com>
> >>
> >> Signed-off-by: Samer El-Haj-Mahmoud <samer@elhajmahmoud.com>
> >> Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
> >> Reviewed-by: Dandan Bi <dandan.bi@intel.com>
> >> ---
> >>  MdeModulePkg/MdeModulePkg.dec | 3 +++
> >>  1 file changed, 3 insertions(+)
> >>
> >> diff --git a/MdeModulePkg/MdeModulePkg.dec
> >> b/MdeModulePkg/MdeModulePkg.dec index
> 497574cb0870..fac16f262cf8
> >> 100644
> >> --- a/MdeModulePkg/MdeModulePkg.dec
> >> +++ b/MdeModulePkg/MdeModulePkg.dec
> >> @@ -1548,6 +1548,9 @@
> >>    # @Prompt Console Output Row of Text Setup
> >>
> >>
> gEfiMdeModulePkgTokenSpaceGuid.PcdSetupConOutRow|25|UINT32|0x40
> 000
> >> 00e
> >>
> >> +[PcdsFixedAtBuild.AARCH64, PcdsPatchableInModule.AARCH64]
> >> +
> >>
> +gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiExposedTableVersions|0x20|
> UINT
> >> 32|
> >> +0x0001004c
> >> +
> >>  [PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic,
> PcdsDynamicEx]
> >>    ## UART clock frequency is for the baud rate configuration.
> >>    # @Prompt Serial Port Clock Rate.
> >> --
> >> 2.17.1
> >>
> >>
> >>
> >
> >
> > 
> >


^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: [edk2-devel] [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms
  2020-04-21  4:56       ` Dandan Bi
@ 2020-04-21  8:41         ` Laszlo Ersek
  2020-04-21  8:46           ` Liming Gao
  0 siblings, 1 reply; 13+ messages in thread
From: Laszlo Ersek @ 2020-04-21  8:41 UTC (permalink / raw)
  To: Bi, Dandan
  Cc: devel@edk2.groups.io, samer.el-haj-mahmoud@arm.com, Wang, Jian J,
	Wu, Hao A, Gao, Liming, Leif Lindholm, Ard Biesheuvel, nd,
	samer@elhajmahmoud.com

On 04/21/20 06:56, Bi, Dandan wrote:
> Hi Laszlo,
> 
> I think it should be Ok.
> But if can get ACK/R-B from the maintainer of MdeModulePkg, that would be better, which follows process more.

Yes, I agree, but Jian and Hao are not responding. Could you poke them
internally at Intel, please?

Thanks
Laszlo

> 
> 
> Thanks,
> Dandan
>> -----Original Message-----
>> From: Laszlo Ersek [mailto:lersek@redhat.com]
>> Sent: Monday, April 20, 2020 8:15 PM
>> To: Bi, Dandan <dandan.bi@intel.com>
>> Cc: devel@edk2.groups.io; samer.el-haj-mahmoud@arm.com; Wang, Jian J
>> <jian.j.wang@intel.com>; Wu, Hao A <hao.a.wu@intel.com>; Gao, Liming
>> <liming.gao@intel.com>; Leif Lindholm <leif@nuviainc.com>; Ard Biesheuvel
>> <Ard.Biesheuvel@arm.com>; nd <nd@arm.com>;
>> samer@elhajmahmoud.com
>> Subject: Re: [edk2-devel] [edk2][PATCH v2 1/2] MdeModulePkg:
>> PcdAcpiExposedTableVersions default for Arm64 platforms
>>
>> Dandan,
>>
>> On 04/18/20 17:14, Samer El-Haj-Mahmoud wrote:
>>> Jian, Hao,
>>>
>>> Can you please push this simple patch? It has been reviewed a while ago
>> and ready to be committed.
>>
>> should we consider your R-b on the first patch sufficient for pushing?
>>
>> You are marked as "R" for "MdeModulePkg: ACPI modules", but technically
>> speaking, "MdeModulePkg.dec" needs an ACK from either Jian or Hao.
>>
>> Content-wise, your approval looks sufficient, but I don't want to assume.
>> Please confirm.
>>
>> Thank
>> Laszlo
>>
>>>> -----Original Message-----
>>>> From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of
>> Samer
>>>> El- Haj-Mahmoud via groups.io
>>>> Sent: Friday, April 10, 2020 11:29 AM
>>>> To: devel@edk2.groups.io
>>>> Cc: Dandan Bi <dandan.bi@intel.com>; Liming Gao
>>>> <liming.gao@intel.com>; Jian J Wang <jian.j.wang@intel.com>; Hao A Wu
>>>> <hao.a.wu@intel.com>; Leif Lindholm <leif@nuviainc.com>; Ard
>>>> Biesheuvel <Ard.Biesheuvel@arm.com>
>>>> Subject: [edk2-devel] [edk2][PATCH v2 1/2] MdeModulePkg:
>>>> PcdAcpiExposedTableVersions default for Arm64 platforms
>>>>
>>>> Set the default value of PcdAcpiExposedTableVersions for Aarch64
>>>> platforms to 0x20. Previously, the default was set to 0x3E for all
>>>> platforms. The new value removes ACPI 1.0b compatability, which
>>>> forces the use of XSDT 64-bit pointer, as required by Arm SBBR
>> specification.
>>>> This also resolves an error reported by acpiview command, as seen on
>>>> the RPi (see https://github.com/pftf/RPi4/issues/25).
>>>>
>>>> Cc: Dandan Bi <dandan.bi@intel.com>
>>>> Cc: Liming Gao <liming.gao@intel.com>
>>>> Cc: Jian J Wang <jian.j.wang@intel.com>
>>>> Cc: Hao A Wu <hao.a.wu@intel.com>
>>>> Cc: Leif Lindholm <leif@nuviainc.com>
>>>> Cc: Ard Biesheuvel <ard.biesheuvel@arm.com>
>>>>
>>>> Signed-off-by: Samer El-Haj-Mahmoud <samer@elhajmahmoud.com>
>>>> Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
>>>> Reviewed-by: Dandan Bi <dandan.bi@intel.com>
>>>> ---
>>>>  MdeModulePkg/MdeModulePkg.dec | 3 +++
>>>>  1 file changed, 3 insertions(+)
>>>>
>>>> diff --git a/MdeModulePkg/MdeModulePkg.dec
>>>> b/MdeModulePkg/MdeModulePkg.dec index
>> 497574cb0870..fac16f262cf8
>>>> 100644
>>>> --- a/MdeModulePkg/MdeModulePkg.dec
>>>> +++ b/MdeModulePkg/MdeModulePkg.dec
>>>> @@ -1548,6 +1548,9 @@
>>>>    # @Prompt Console Output Row of Text Setup
>>>>
>>>>
>> gEfiMdeModulePkgTokenSpaceGuid.PcdSetupConOutRow|25|UINT32|0x40
>> 000
>>>> 00e
>>>>
>>>> +[PcdsFixedAtBuild.AARCH64, PcdsPatchableInModule.AARCH64]
>>>> +
>>>>
>> +gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiExposedTableVersions|0x20|
>> UINT
>>>> 32|
>>>> +0x0001004c
>>>> +
>>>>  [PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic,
>> PcdsDynamicEx]
>>>>    ## UART clock frequency is for the baud rate configuration.
>>>>    # @Prompt Serial Port Clock Rate.
>>>> --
>>>> 2.17.1
>>>>
>>>>
>>>>
>>>
>>>
>>> 
>>>
> 


^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: [edk2-devel] [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms
  2020-04-21  8:41         ` Laszlo Ersek
@ 2020-04-21  8:46           ` Liming Gao
  0 siblings, 0 replies; 13+ messages in thread
From: Liming Gao @ 2020-04-21  8:46 UTC (permalink / raw)
  To: Laszlo Ersek, Bi, Dandan
  Cc: devel@edk2.groups.io, samer.el-haj-mahmoud@arm.com, Wang, Jian J,
	Wu, Hao A, Leif Lindholm, Ard Biesheuvel, nd,
	samer@elhajmahmoud.com

Laszlo:
  I understand Module reviewer R-B is enough for the patch.

  R: Package Reviewer: Cc address for patches and questions. Reviewers help
     maintainers review code, but don't have push access. A designated Package
     Reviewer is reasonably familiar with the Package (or some modules
     thereof), and/or provides testing or regression testing for the Package
     (or some modules thereof), in certain platforms and environments.

Thanks
Liming
-----Original Message-----
From: Laszlo Ersek <lersek@redhat.com> 
Sent: 2020年4月21日 16:42
To: Bi, Dandan <dandan.bi@intel.com>
Cc: devel@edk2.groups.io; samer.el-haj-mahmoud@arm.com; Wang, Jian J <jian.j.wang@intel.com>; Wu, Hao A <hao.a.wu@intel.com>; Gao, Liming <liming.gao@intel.com>; Leif Lindholm <leif@nuviainc.com>; Ard Biesheuvel <Ard.Biesheuvel@arm.com>; nd <nd@arm.com>; samer@elhajmahmoud.com
Subject: Re: [edk2-devel] [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms

On 04/21/20 06:56, Bi, Dandan wrote:
> Hi Laszlo,
> 
> I think it should be Ok.
> But if can get ACK/R-B from the maintainer of MdeModulePkg, that would be better, which follows process more.

Yes, I agree, but Jian and Hao are not responding. Could you poke them internally at Intel, please?

Thanks
Laszlo

> 
> 
> Thanks,
> Dandan
>> -----Original Message-----
>> From: Laszlo Ersek [mailto:lersek@redhat.com]
>> Sent: Monday, April 20, 2020 8:15 PM
>> To: Bi, Dandan <dandan.bi@intel.com>
>> Cc: devel@edk2.groups.io; samer.el-haj-mahmoud@arm.com; Wang, Jian J 
>> <jian.j.wang@intel.com>; Wu, Hao A <hao.a.wu@intel.com>; Gao, Liming 
>> <liming.gao@intel.com>; Leif Lindholm <leif@nuviainc.com>; Ard 
>> Biesheuvel <Ard.Biesheuvel@arm.com>; nd <nd@arm.com>; 
>> samer@elhajmahmoud.com
>> Subject: Re: [edk2-devel] [edk2][PATCH v2 1/2] MdeModulePkg:
>> PcdAcpiExposedTableVersions default for Arm64 platforms
>>
>> Dandan,
>>
>> On 04/18/20 17:14, Samer El-Haj-Mahmoud wrote:
>>> Jian, Hao,
>>>
>>> Can you please push this simple patch? It has been reviewed a while 
>>> ago
>> and ready to be committed.
>>
>> should we consider your R-b on the first patch sufficient for pushing?
>>
>> You are marked as "R" for "MdeModulePkg: ACPI modules", but 
>> technically speaking, "MdeModulePkg.dec" needs an ACK from either Jian or Hao.
>>
>> Content-wise, your approval looks sufficient, but I don't want to assume.
>> Please confirm.
>>
>> Thank
>> Laszlo
>>
>>>> -----Original Message-----
>>>> From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of
>> Samer
>>>> El- Haj-Mahmoud via groups.io
>>>> Sent: Friday, April 10, 2020 11:29 AM
>>>> To: devel@edk2.groups.io
>>>> Cc: Dandan Bi <dandan.bi@intel.com>; Liming Gao 
>>>> <liming.gao@intel.com>; Jian J Wang <jian.j.wang@intel.com>; Hao A 
>>>> Wu <hao.a.wu@intel.com>; Leif Lindholm <leif@nuviainc.com>; Ard 
>>>> Biesheuvel <Ard.Biesheuvel@arm.com>
>>>> Subject: [edk2-devel] [edk2][PATCH v2 1/2] MdeModulePkg:
>>>> PcdAcpiExposedTableVersions default for Arm64 platforms
>>>>
>>>> Set the default value of PcdAcpiExposedTableVersions for Aarch64 
>>>> platforms to 0x20. Previously, the default was set to 0x3E for all 
>>>> platforms. The new value removes ACPI 1.0b compatability, which 
>>>> forces the use of XSDT 64-bit pointer, as required by Arm SBBR
>> specification.
>>>> This also resolves an error reported by acpiview command, as seen 
>>>> on the RPi (see https://github.com/pftf/RPi4/issues/25).
>>>>
>>>> Cc: Dandan Bi <dandan.bi@intel.com>
>>>> Cc: Liming Gao <liming.gao@intel.com>
>>>> Cc: Jian J Wang <jian.j.wang@intel.com>
>>>> Cc: Hao A Wu <hao.a.wu@intel.com>
>>>> Cc: Leif Lindholm <leif@nuviainc.com>
>>>> Cc: Ard Biesheuvel <ard.biesheuvel@arm.com>
>>>>
>>>> Signed-off-by: Samer El-Haj-Mahmoud <samer@elhajmahmoud.com>
>>>> Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
>>>> Reviewed-by: Dandan Bi <dandan.bi@intel.com>
>>>> ---
>>>>  MdeModulePkg/MdeModulePkg.dec | 3 +++
>>>>  1 file changed, 3 insertions(+)
>>>>
>>>> diff --git a/MdeModulePkg/MdeModulePkg.dec 
>>>> b/MdeModulePkg/MdeModulePkg.dec index
>> 497574cb0870..fac16f262cf8
>>>> 100644
>>>> --- a/MdeModulePkg/MdeModulePkg.dec
>>>> +++ b/MdeModulePkg/MdeModulePkg.dec
>>>> @@ -1548,6 +1548,9 @@
>>>>    # @Prompt Console Output Row of Text Setup
>>>>
>>>>
>> gEfiMdeModulePkgTokenSpaceGuid.PcdSetupConOutRow|25|UINT32|0x40
>> 000
>>>> 00e
>>>>
>>>> +[PcdsFixedAtBuild.AARCH64, PcdsPatchableInModule.AARCH64]
>>>> +
>>>>
>> +gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiExposedTableVersions|0x20|
>> UINT
>>>> 32|
>>>> +0x0001004c
>>>> +
>>>>  [PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic,
>> PcdsDynamicEx]
>>>>    ## UART clock frequency is for the baud rate configuration.
>>>>    # @Prompt Serial Port Clock Rate.
>>>> --
>>>> 2.17.1
>>>>
>>>>
>>>>
>>>
>>>
>>> 
>>>
> 


^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms
  2020-04-10 15:29 ` [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms Samer El-Haj-Mahmoud
  2020-04-14  9:45   ` [edk2-devel] " Sami Mujawar
  2020-04-18 15:14   ` Samer El-Haj-Mahmoud
@ 2020-04-21  8:54   ` Wu, Hao A
  2020-04-21 17:06     ` Ard Biesheuvel
  2 siblings, 1 reply; 13+ messages in thread
From: Wu, Hao A @ 2020-04-21  8:54 UTC (permalink / raw)
  To: Samer El-Haj-Mahmoud, devel@edk2.groups.io, Laszlo Ersek,
	Bi, Dandan, Gao, Liming
  Cc: Wang, Jian J, Leif Lindholm, Ard Biesheuvel

> -----Original Message-----
> From: Samer El-Haj-Mahmoud [mailto:samer@elhajmahmoud.com]
> Sent: Friday, April 10, 2020 11:29 PM
> To: devel@edk2.groups.io
> Cc: Bi, Dandan; Gao, Liming; Wang, Jian J; Wu, Hao A; Leif Lindholm; Ard
> Biesheuvel
> Subject: [edk2][PATCH v2 1/2] MdeModulePkg:
> PcdAcpiExposedTableVersions default for Arm64 platforms
> 
> Set the default value of PcdAcpiExposedTableVersions for Aarch64
> platforms to 0x20. Previously, the default was set to 0x3E for all
> platforms. The new value removes ACPI 1.0b compatability, which forces
> the use of XSDT 64-bit pointer, as required by Arm SBBR specification.
> This also resolves an error reported by acpiview command, as seen on
> the RPi (see https://github.com/pftf/RPi4/issues/25).
> 
> Cc: Dandan Bi <dandan.bi@intel.com>
> Cc: Liming Gao <liming.gao@intel.com>
> Cc: Jian J Wang <jian.j.wang@intel.com>
> Cc: Hao A Wu <hao.a.wu@intel.com>
> Cc: Leif Lindholm <leif@nuviainc.com>
> Cc: Ard Biesheuvel <ard.biesheuvel@arm.com>
> 
> Signed-off-by: Samer El-Haj-Mahmoud <samer@elhajmahmoud.com>
> Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
> Reviewed-by: Dandan Bi <dandan.bi@intel.com>
> ---
>  MdeModulePkg/MdeModulePkg.dec | 3 +++
>  1 file changed, 3 insertions(+)
> 
> diff --git a/MdeModulePkg/MdeModulePkg.dec
> b/MdeModulePkg/MdeModulePkg.dec
> index 497574cb0870..fac16f262cf8 100644
> --- a/MdeModulePkg/MdeModulePkg.dec
> +++ b/MdeModulePkg/MdeModulePkg.dec
> @@ -1548,6 +1548,9 @@
>    # @Prompt Console Output Row of Text Setup
> 
> gEfiMdeModulePkgTokenSpaceGuid.PcdSetupConOutRow|25|UINT32|0x40
> 00000e
> 
> +[PcdsFixedAtBuild.AARCH64, PcdsPatchableInModule.AARCH64]
> +
> gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiExposedTableVersions|0x20|UI
> NT32|0x0001004c
> +


Sorry for the slow response.
Acked-by: Hao A Wu <hao.a.wu@intel.com>

Best Regards,
Hao Wu


>  [PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
>    ## UART clock frequency is for the baud rate configuration.
>    # @Prompt Serial Port Clock Rate.
> --
> 2.17.1


^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms
  2020-04-21  8:54   ` Wu, Hao A
@ 2020-04-21 17:06     ` Ard Biesheuvel
  0 siblings, 0 replies; 13+ messages in thread
From: Ard Biesheuvel @ 2020-04-21 17:06 UTC (permalink / raw)
  To: Wu, Hao A, Samer El-Haj-Mahmoud, devel@edk2.groups.io,
	Laszlo Ersek, Bi, Dandan, Gao, Liming
  Cc: Wang, Jian J, Leif Lindholm

On 4/21/20 10:54 AM, Wu, Hao A wrote:
>> -----Original Message-----
>> From: Samer El-Haj-Mahmoud [mailto:samer@elhajmahmoud.com]
>> Sent: Friday, April 10, 2020 11:29 PM
>> To: devel@edk2.groups.io
>> Cc: Bi, Dandan; Gao, Liming; Wang, Jian J; Wu, Hao A; Leif Lindholm; Ard
>> Biesheuvel
>> Subject: [edk2][PATCH v2 1/2] MdeModulePkg:
>> PcdAcpiExposedTableVersions default for Arm64 platforms
>>
>> Set the default value of PcdAcpiExposedTableVersions for Aarch64
>> platforms to 0x20. Previously, the default was set to 0x3E for all
>> platforms. The new value removes ACPI 1.0b compatability, which forces
>> the use of XSDT 64-bit pointer, as required by Arm SBBR specification.
>> This also resolves an error reported by acpiview command, as seen on
>> the RPi (see https://github.com/pftf/RPi4/issues/25).
>>
>> Cc: Dandan Bi <dandan.bi@intel.com>
>> Cc: Liming Gao <liming.gao@intel.com>
>> Cc: Jian J Wang <jian.j.wang@intel.com>
>> Cc: Hao A Wu <hao.a.wu@intel.com>
>> Cc: Leif Lindholm <leif@nuviainc.com>
>> Cc: Ard Biesheuvel <ard.biesheuvel@arm.com>
>>
>> Signed-off-by: Samer El-Haj-Mahmoud <samer@elhajmahmoud.com>
>> Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
>> Reviewed-by: Dandan Bi <dandan.bi@intel.com>
>> ---
>>   MdeModulePkg/MdeModulePkg.dec | 3 +++
>>   1 file changed, 3 insertions(+)
>>
>> diff --git a/MdeModulePkg/MdeModulePkg.dec
>> b/MdeModulePkg/MdeModulePkg.dec
>> index 497574cb0870..fac16f262cf8 100644
>> --- a/MdeModulePkg/MdeModulePkg.dec
>> +++ b/MdeModulePkg/MdeModulePkg.dec
>> @@ -1548,6 +1548,9 @@
>>     # @Prompt Console Output Row of Text Setup
>>
>> gEfiMdeModulePkgTokenSpaceGuid.PcdSetupConOutRow|25|UINT32|0x40
>> 00000e
>>
>> +[PcdsFixedAtBuild.AARCH64, PcdsPatchableInModule.AARCH64]
>> +
>> gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiExposedTableVersions|0x20|UI
>> NT32|0x0001004c
>> +
> 
> 
> Sorry for the slow response.
> Acked-by: Hao A Wu <hao.a.wu@intel.com>
> 

Series pushed and merged as #535

Thanks all

^ permalink raw reply	[flat|nested] 13+ messages in thread

end of thread, other threads:[~2020-04-21 17:06 UTC | newest]

Thread overview: 13+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2020-04-10 15:29 [edk2][PATCH v2 0/2] ACPI table defailt for Aarch64 Samer El-Haj-Mahmoud
2020-04-10 15:29 ` [edk2][PATCH v2 1/2] MdeModulePkg: PcdAcpiExposedTableVersions default for Arm64 platforms Samer El-Haj-Mahmoud
2020-04-14  9:45   ` [edk2-devel] " Sami Mujawar
2020-04-14 13:33     ` Samer El-Haj-Mahmoud
2020-04-18 15:14   ` Samer El-Haj-Mahmoud
2020-04-20 12:15     ` Laszlo Ersek
2020-04-21  4:56       ` Dandan Bi
2020-04-21  8:41         ` Laszlo Ersek
2020-04-21  8:46           ` Liming Gao
2020-04-21  8:54   ` Wu, Hao A
2020-04-21 17:06     ` Ard Biesheuvel
2020-04-10 15:29 ` [edk2][PATCH v2 2/2] Revert "ArmVirtPkg/ArmVirtQemu: limit ACPI support to v5.0 and higher" Samer El-Haj-Mahmoud
2020-04-14 12:19   ` [edk2-devel] " Laszlo Ersek

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox