* [Buildroot] [PATCH v3 1/2] linux: add support for device tree overlays
@ 2024-12-13 8:34 Niklas Cassel via buildroot
2024-12-13 8:34 ` [Buildroot] [PATCH v3 2/2] configs/rock5b: build and install rock5b " Niklas Cassel via buildroot
` (2 more replies)
0 siblings, 3 replies; 10+ messages in thread
From: Niklas Cassel via buildroot @ 2024-12-13 8:34 UTC (permalink / raw)
To: buildroot
Cc: Kilian Zinnecker, Damien Le Moal, Thomas Petazzoni, Michael Walle,
Niklas Cassel
From: Michael Walle <michael@walle.cc>
The linux kernel can build device tree overlays (.dtbo) itself. Add
support to build and copy them along with the actual device trees.
These can only be in-tree device tree overlays.
Signed-off-by: Michael Walle <michael@walle.cc>
Signed-off-by: Niklas Cassel <cassel@kernel.org>
---
Changes since v2:
-Dropped support for out-of-tree device tree overlays, as Linux 6.12 no
longer supports building an out-of-tree device tree by simply copying
it to the kernel source directory (without also modifying the Makefile).
linux/Config.in | 7 +++++++
linux/linux.mk | 3 ++-
2 files changed, 9 insertions(+), 1 deletion(-)
diff --git a/linux/Config.in b/linux/Config.in
index f537dd7adf..c59b56786f 100644
--- a/linux/Config.in
+++ b/linux/Config.in
@@ -417,6 +417,13 @@ config BR2_LINUX_KERNEL_INTREE_DTS_NAME
the trailing .dts. You can provide a list of
dts files to build, separated by spaces.
+config BR2_LINUX_KERNEL_INTREE_DTSO_NAMES
+ string "In-tree Device Tree Overlay file names"
+ help
+ Names of in-tree device tree overlay, without the trailing
+ .dtso which should be built and installed into the target
+ system, separated by spaces.
+
config BR2_LINUX_KERNEL_CUSTOM_DTS_PATH
string "Out-of-tree Device Tree Source file paths"
help
diff --git a/linux/linux.mk b/linux/linux.mk
index 1d3d8fffa6..54b34d8281 100644
--- a/linux/linux.mk
+++ b/linux/linux.mk
@@ -203,6 +203,7 @@ endif
LINUX_VERSION_PROBED = `MAKEFLAGS='$(filter-out w,$(MAKEFLAGS))' $(BR2_MAKE) $(LINUX_MAKE_FLAGS) -C $(LINUX_DIR) --no-print-directory -s kernelrelease 2>/dev/null`
LINUX_DTS_NAME += $(call qstrip,$(BR2_LINUX_KERNEL_INTREE_DTS_NAME))
+LINUX_DTSO_NAMES += $(call qstrip,$(BR2_LINUX_KERNEL_INTREE_DTSO_NAMES))
# We keep only the .dts files, so that the user can specify both .dts
# and .dtsi files in BR2_LINUX_KERNEL_CUSTOM_DTS_PATH. Both will be
@@ -210,7 +211,7 @@ LINUX_DTS_NAME += $(call qstrip,$(BR2_LINUX_KERNEL_INTREE_DTS_NAME))
# actually be generated as .dtb.
LINUX_DTS_NAME += $(basename $(filter %.dts,$(notdir $(call qstrip,$(BR2_LINUX_KERNEL_CUSTOM_DTS_PATH)))))
-LINUX_DTBS = $(addsuffix .dtb,$(LINUX_DTS_NAME))
+LINUX_DTBS = $(addsuffix .dtb,$(LINUX_DTS_NAME)) $(addsuffix .dtbo,$(LINUX_DTSO_NAMES))
ifeq ($(BR2_LINUX_KERNEL_IMAGE_TARGET_CUSTOM),y)
LINUX_IMAGE_NAME = $(call qstrip,$(BR2_LINUX_KERNEL_IMAGE_NAME))
--
2.47.1
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot
^ permalink raw reply related [flat|nested] 10+ messages in thread* [Buildroot] [PATCH v3 2/2] configs/rock5b: build and install rock5b device tree overlays
2024-12-13 8:34 [Buildroot] [PATCH v3 1/2] linux: add support for device tree overlays Niklas Cassel via buildroot
@ 2024-12-13 8:34 ` Niklas Cassel via buildroot
2024-12-13 8:53 ` [Buildroot] [PATCH v3 1/2] linux: add support for " Michael Walle via buildroot
2024-12-20 10:06 ` Niklas Cassel via buildroot
2 siblings, 0 replies; 10+ messages in thread
From: Niklas Cassel via buildroot @ 2024-12-13 8:34 UTC (permalink / raw)
To: buildroot
Cc: Kilian Zinnecker, Damien Le Moal, Thomas Petazzoni, Michael Walle,
Niklas Cassel
From: Niklas Cassel <cassel@kernel.org>
Build and install all in-tree rock5b device tree overlays.
The device tree overlays will be available in /boot, such that it is
possible for u-boot to apply one (or many) of them before booting Linux.
Signed-off-by: Niklas Cassel <cassel@kernel.org>
---
Changes since v2:
-New patch.
configs/rock5b_defconfig | 1 +
1 file changed, 1 insertion(+)
diff --git a/configs/rock5b_defconfig b/configs/rock5b_defconfig
index 38b5aad206..ea0ca26d97 100644
--- a/configs/rock5b_defconfig
+++ b/configs/rock5b_defconfig
@@ -17,6 +17,7 @@ BR2_LINUX_KERNEL_USE_ARCH_DEFAULT_CONFIG=y
BR2_LINUX_KERNEL_CONFIG_FRAGMENT_FILES="board/radxa/rock5b/linux.fragment"
BR2_LINUX_KERNEL_DTS_SUPPORT=y
BR2_LINUX_KERNEL_INTREE_DTS_NAME="rockchip/rk3588-rock-5b"
+BR2_LINUX_KERNEL_INTREE_DTSO_NAMES="rockchip/rk3588-rock-5b-pcie-srns rockchip/rk3588-rock-5b-pcie-ep"
BR2_LINUX_KERNEL_DTB_OVERLAY_SUPPORT=y
BR2_LINUX_KERNEL_INSTALL_TARGET=y
BR2_LINUX_KERNEL_NEEDS_HOST_OPENSSL=y
--
2.47.1
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot
^ permalink raw reply related [flat|nested] 10+ messages in thread
* Re: [Buildroot] [PATCH v3 1/2] linux: add support for device tree overlays
2024-12-13 8:34 [Buildroot] [PATCH v3 1/2] linux: add support for device tree overlays Niklas Cassel via buildroot
2024-12-13 8:34 ` [Buildroot] [PATCH v3 2/2] configs/rock5b: build and install rock5b " Niklas Cassel via buildroot
@ 2024-12-13 8:53 ` Michael Walle via buildroot
2024-12-13 9:09 ` Niklas Cassel via buildroot
2024-12-20 10:06 ` Niklas Cassel via buildroot
2 siblings, 1 reply; 10+ messages in thread
From: Michael Walle via buildroot @ 2024-12-13 8:53 UTC (permalink / raw)
To: Niklas Cassel, buildroot
Cc: Kilian Zinnecker, Damien Le Moal, Thomas Petazzoni, Niklas Cassel
[-- Attachment #1.1: Type: text/plain, Size: 869 bytes --]
Hi Niklas,
> -Dropped support for out-of-tree device tree overlays, as Linux 6.12 no
> longer supports building an out-of-tree device tree by simply copying
> it to the kernel source directory (without also modifying the Makefile).
Why is that? As it seems, it is not possible to compile it by simply
copying to arch/<arch>/dts (which is buildroot doing currently)
anymore. But copying it to arch/<arch>/dts/<vendor>/ is working.
Correct?
In that case, we should work on getting support for that in
buildroot as well. Esp. buildroot is really lacking copying an
actual device tree into that subdir too and currently it's a PITA to
include a soc.dtsi for example. If you're using a device tree in
buildroot you'd have to use '#include "vendor/soc.dtsi"' while in
the kernel (as well as in yocto) you'll just use '#include
"soc.dtsi"'.
-michael
[-- Attachment #1.2: signature.asc --]
[-- Type: application/pgp-signature, Size: 297 bytes --]
[-- Attachment #2: Type: text/plain, Size: 150 bytes --]
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [Buildroot] [PATCH v3 1/2] linux: add support for device tree overlays
2024-12-13 8:53 ` [Buildroot] [PATCH v3 1/2] linux: add support for " Michael Walle via buildroot
@ 2024-12-13 9:09 ` Niklas Cassel via buildroot
2024-12-13 9:35 ` Michael Walle via buildroot
0 siblings, 1 reply; 10+ messages in thread
From: Niklas Cassel via buildroot @ 2024-12-13 9:09 UTC (permalink / raw)
To: Michael Walle
Cc: buildroot@buildroot.org, Kilian Zinnecker, Damien Le Moal,
Thomas Petazzoni, Niklas Cassel
[replying from an email address that is subscribed this time...]
On Fri, Dec 13, 2024 at 09:53:27AM +0100, Michael Walle wrote:
> Hi Niklas,
>
> > -Dropped support for out-of-tree device tree overlays, as Linux 6.12 no
> > longer supports building an out-of-tree device tree by simply copying
> > it to the kernel source directory (without also modifying the Makefile).
>
> Why is that? As it seems, it is not possible to compile it by simply
> copying to arch/<arch>/dts (which is buildroot doing currently)
> anymore. But copying it to arch/<arch>/dts/<vendor>/ is working.
> Correct?
I'm assuming that neither works anymore, see:
https://lore.kernel.org/buildroot/CAFOYHZDQmMRuK76TpOSAOFPdqAb4gpw=LNKfmpu=sqAD1EMhFg@mail.gmail.com/T/#u
https://lore.kernel.org/all/CAK7LNAR4h6NZ+D0BK+q4VQBeHWpjzRBQFQ9ovBrftM=6dHRcUg@mail.gmail.com/
https://lore.kernel.org/buildroot/Z1nq_gneO4ORw3EG@curiosity/T/#t
>
> In that case, we should work on getting support for that in
> buildroot as well. Esp. buildroot is really lacking copying an
> actual device tree into that subdir too and currently it's a PITA to
> include a soc.dtsi for example. If you're using a device tree in
> buildroot you'd have to use '#include "vendor/soc.dtsi"' while in
> the kernel (as well as in yocto) you'll just use '#include
> "soc.dtsi"'.
Yes, it appears that buildroot folks have an idea that it should be possible to
restore BR2_LINUX_KERNEL_CUSTOM_DTS_PATH in newer kernels by sed:ing the
Makefile.
However, I don't see any reason to defer this patch until then.
Once someone has written a patch that restores BR2_LINUX_KERNEL_CUSTOM_DTS_PATH
support for recent kernels, you can submit an incremental path on top of this
that adds support for out-of-tree device tree overlays, if you so wish.
But honestly, considering that the only buildroot configurations that make use of
BR2_LINUX_KERNEL_CUSTOM_DTS_PATH are:
- acmesystems_acqua_a5_256mb_defconfig (v6.6)
- acmesystems_acqua_a5_512mb_defconfig (v6.6)
- octavo_osd32mp1_brk_defconfig (v5.10)
- octavo_osd32mp1_red_defconfig (v5.10)
- s6lx9_microboard_defconfig (v4.4.7)
are using really old kernel versions, nothing is broken in upstream buildroot,
so I expect that it might take quite a long time before anyone bothers to
restore BR2_LINUX_KERNEL_CUSTOM_DTS_PATH support in newer kernels.
Kind regards,
Niklas
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [Buildroot] [PATCH v3 1/2] linux: add support for device tree overlays
2024-12-13 9:09 ` Niklas Cassel via buildroot
@ 2024-12-13 9:35 ` Michael Walle via buildroot
2024-12-13 9:48 ` Niklas Cassel
0 siblings, 1 reply; 10+ messages in thread
From: Michael Walle via buildroot @ 2024-12-13 9:35 UTC (permalink / raw)
To: Niklas Cassel
Cc: buildroot@buildroot.org, Kilian Zinnecker, Damien Le Moal,
Thomas Petazzoni, Niklas Cassel
[-- Attachment #1.1: Type: text/plain, Size: 2636 bytes --]
Hi Niklas,
> > > -Dropped support for out-of-tree device tree overlays, as Linux 6.12 no
> > > longer supports building an out-of-tree device tree by simply copying
> > > it to the kernel source directory (without also modifying the Makefile).
> >
> > Why is that? As it seems, it is not possible to compile it by simply
> > copying to arch/<arch>/dts (which is buildroot doing currently)
> > anymore. But copying it to arch/<arch>/dts/<vendor>/ is working.
> > Correct?
>
> I'm assuming that neither works anymore, see:
> https://lore.kernel.org/buildroot/CAFOYHZDQmMRuK76TpOSAOFPdqAb4gpw=LNKfmpu=sqAD1EMhFg@mail.gmail.com/T/#u
> https://lore.kernel.org/all/CAK7LNAR4h6NZ+D0BK+q4VQBeHWpjzRBQFQ9ovBrftM=6dHRcUg@mail.gmail.com/
> https://lore.kernel.org/buildroot/Z1nq_gneO4ORw3EG@curiosity/T/#t
Thanks for the pointers.
But I've just tested both compiling .dts and .dtso from within a
vendor directory and it seems to be working on next-20241213 (?).
> > In that case, we should work on getting support for that in
> > buildroot as well. Esp. buildroot is really lacking copying an
> > actual device tree into that subdir too and currently it's a PITA to
> > include a soc.dtsi for example. If you're using a device tree in
> > buildroot you'd have to use '#include "vendor/soc.dtsi"' while in
> > the kernel (as well as in yocto) you'll just use '#include
> > "soc.dtsi"'.
>
> Yes, it appears that buildroot folks have an idea that it should be possible to
> restore BR2_LINUX_KERNEL_CUSTOM_DTS_PATH in newer kernels by sed:ing the
> Makefile.
>
> However, I don't see any reason to defer this patch until then.
>
>
> Once someone has written a patch that restores BR2_LINUX_KERNEL_CUSTOM_DTS_PATH
> support for recent kernels, you can submit an incremental path on top of this
> that adds support for out-of-tree device tree overlays, if you so wish.
>
> But honestly, considering that the only buildroot configurations that make use of
> BR2_LINUX_KERNEL_CUSTOM_DTS_PATH are:
> - acmesystems_acqua_a5_256mb_defconfig (v6.6)
> - acmesystems_acqua_a5_512mb_defconfig (v6.6)
> - octavo_osd32mp1_brk_defconfig (v5.10)
> - octavo_osd32mp1_red_defconfig (v5.10)
> - s6lx9_microboard_defconfig (v4.4.7)
>
> are using really old kernel versions, nothing is broken in upstream buildroot,
> so I expect that it might take quite a long time before anyone bothers to
> restore BR2_LINUX_KERNEL_CUSTOM_DTS_PATH support in newer kernels.
This is most useful for buildroot externals which you cannot grep
that easily :) Thus I'd imagine it is more common than you think.
-michael
[-- Attachment #1.2: signature.asc --]
[-- Type: application/pgp-signature, Size: 297 bytes --]
[-- Attachment #2: Type: text/plain, Size: 150 bytes --]
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [Buildroot] [PATCH v3 1/2] linux: add support for device tree overlays
2024-12-13 9:35 ` Michael Walle via buildroot
@ 2024-12-13 9:48 ` Niklas Cassel
2024-12-13 10:03 ` Michael Walle via buildroot
0 siblings, 1 reply; 10+ messages in thread
From: Niklas Cassel @ 2024-12-13 9:48 UTC (permalink / raw)
To: Michael Walle
Cc: buildroot@buildroot.org, Kilian Zinnecker, Damien Le Moal,
Thomas Petazzoni, Niklas Cassel
Hello Michael,
On Fri, Dec 13, 2024 at 10:35:37AM +0100, Michael Walle wrote:
> Hi Niklas,
>
> > > > -Dropped support for out-of-tree device tree overlays, as Linux 6.12 no
> > > > longer supports building an out-of-tree device tree by simply copying
> > > > it to the kernel source directory (without also modifying the Makefile).
> > >
> > > Why is that? As it seems, it is not possible to compile it by simply
> > > copying to arch/<arch>/dts (which is buildroot doing currently)
> > > anymore. But copying it to arch/<arch>/dts/<vendor>/ is working.
> > > Correct?
> >
> > I'm assuming that neither works anymore, see:
> > https://lore.kernel.org/buildroot/CAFOYHZDQmMRuK76TpOSAOFPdqAb4gpw=LNKfmpu=sqAD1EMhFg@mail.gmail.com/T/#u
> > https://lore.kernel.org/all/CAK7LNAR4h6NZ+D0BK+q4VQBeHWpjzRBQFQ9ovBrftM=6dHRcUg@mail.gmail.com/
> > https://lore.kernel.org/buildroot/Z1nq_gneO4ORw3EG@curiosity/T/#t
>
> Thanks for the pointers.
>
> But I've just tested both compiling .dts and .dtso from within a
> vendor directory and it seems to be working on next-20241213 (?).
If you say that copying to arch/<arch>/dts/<vendor>/ is still working, then
most likely it is only copying to arch/<arch>/dts that is no longer working.
I still think that this patch can be merged as is.
Once the BR2_LINUX_KERNEL_CUSTOM_DTS_PATH mess has been sorted, someone could
add support for out-of-tree device tree overlays, if anyone wants/needs that.
Adding support for in-tree device tree overlays now, does not make life harder
for anyone if they want to add support for out-of-tree device tree overlays in
the future.
Kind regards,
Niklas
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [Buildroot] [PATCH v3 1/2] linux: add support for device tree overlays
2024-12-13 9:48 ` Niklas Cassel
@ 2024-12-13 10:03 ` Michael Walle via buildroot
2025-02-04 16:36 ` Romain Naour via buildroot
0 siblings, 1 reply; 10+ messages in thread
From: Michael Walle via buildroot @ 2024-12-13 10:03 UTC (permalink / raw)
To: Niklas Cassel
Cc: buildroot@buildroot.org, Kilian Zinnecker, Damien Le Moal,
Thomas Petazzoni, Niklas Cassel
[-- Attachment #1.1: Type: text/plain, Size: 882 bytes --]
Hi Niklas,
> > But I've just tested both compiling .dts and .dtso from within a
> > vendor directory and it seems to be working on next-20241213 (?).
>
> If you say that copying to arch/<arch>/dts/<vendor>/ is still working, then
> most likely it is only copying to arch/<arch>/dts that is no longer working.
Copying it to dts/ was wrong for arch's which had a subdir structure
anyway.
>
> I still think that this patch can be merged as is.
>
> Once the BR2_LINUX_KERNEL_CUSTOM_DTS_PATH mess has been sorted, someone could
> add support for out-of-tree device tree overlays, if anyone wants/needs that.
Well, that was actually the intention of my patch :)
> Adding support for in-tree device tree overlays now, does not make life harder
> for anyone if they want to add support for out-of-tree device tree overlays in
> the future.
Agreed.
-michael
[-- Attachment #1.2: signature.asc --]
[-- Type: application/pgp-signature, Size: 297 bytes --]
[-- Attachment #2: Type: text/plain, Size: 150 bytes --]
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [Buildroot] [PATCH v3 1/2] linux: add support for device tree overlays
2024-12-13 10:03 ` Michael Walle via buildroot
@ 2025-02-04 16:36 ` Romain Naour via buildroot
0 siblings, 0 replies; 10+ messages in thread
From: Romain Naour via buildroot @ 2025-02-04 16:36 UTC (permalink / raw)
To: Michael Walle, Niklas Cassel
Cc: buildroot@buildroot.org, Kilian Zinnecker, Damien Le Moal,
Thomas Petazzoni, Niklas Cassel, Gaël PORTAY
Hello Niklas, Michael, All,
Le 13/12/2024 à 11:03, Michael Walle via buildroot a écrit :
> Hi Niklas,
>
>>> But I've just tested both compiling .dts and .dtso from within a
>>> vendor directory and it seems to be working on next-20241213 (?).
>>
>> If you say that copying to arch/<arch>/dts/<vendor>/ is still working, then
>> most likely it is only copying to arch/<arch>/dts that is no longer working.
>
> Copying it to dts/ was wrong for arch's which had a subdir structure
> anyway.
>
>>
>> I still think that this patch can be merged as is.
>>
>> Once the BR2_LINUX_KERNEL_CUSTOM_DTS_PATH mess has been sorted, someone could
>> add support for out-of-tree device tree overlays, if anyone wants/needs that.
>
> Well, that was actually the intention of my patch :)
>
>> Adding support for in-tree device tree overlays now, does not make life harder
>> for anyone if they want to add support for out-of-tree device tree overlays in
>> the future.
>
> Agreed.
Actually the v2 from Micheal was ok even if the (intree/external) devicetree
overlays support is limited to kernel before 6.12 release.
I added all contributed patches related to devicetree overlays and external dts
handling with the latest kernel.
I'll post is soon.
Best regards,
Romain
>
> -michael
>
>
> _______________________________________________
> buildroot mailing list
> buildroot@buildroot.org
> https://lists.buildroot.org/mailman/listinfo/buildroot
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [Buildroot] [PATCH v3 1/2] linux: add support for device tree overlays
2024-12-13 8:34 [Buildroot] [PATCH v3 1/2] linux: add support for device tree overlays Niklas Cassel via buildroot
2024-12-13 8:34 ` [Buildroot] [PATCH v3 2/2] configs/rock5b: build and install rock5b " Niklas Cassel via buildroot
2024-12-13 8:53 ` [Buildroot] [PATCH v3 1/2] linux: add support for " Michael Walle via buildroot
@ 2024-12-20 10:06 ` Niklas Cassel via buildroot
2025-01-02 11:48 ` Niklas Cassel via buildroot
2 siblings, 1 reply; 10+ messages in thread
From: Niklas Cassel via buildroot @ 2024-12-20 10:06 UTC (permalink / raw)
To: Thomas Petazzoni
Cc: buildroot@buildroot.org, Kilian Zinnecker, Damien Le Moal,
Michael Walle, Niklas Cassel
Hello Thomas,
Any chance of this series getting picked up?
Kind regards,
Niklas
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot
^ permalink raw reply [flat|nested] 10+ messages in thread
end of thread, other threads:[~2025-02-04 16:36 UTC | newest]
Thread overview: 10+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2024-12-13 8:34 [Buildroot] [PATCH v3 1/2] linux: add support for device tree overlays Niklas Cassel via buildroot
2024-12-13 8:34 ` [Buildroot] [PATCH v3 2/2] configs/rock5b: build and install rock5b " Niklas Cassel via buildroot
2024-12-13 8:53 ` [Buildroot] [PATCH v3 1/2] linux: add support for " Michael Walle via buildroot
2024-12-13 9:09 ` Niklas Cassel via buildroot
2024-12-13 9:35 ` Michael Walle via buildroot
2024-12-13 9:48 ` Niklas Cassel
2024-12-13 10:03 ` Michael Walle via buildroot
2025-02-04 16:36 ` Romain Naour via buildroot
2024-12-20 10:06 ` Niklas Cassel via buildroot
2025-01-02 11:48 ` Niklas Cassel via buildroot
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox