* [Buildroot] [PATCH 1/1] dvdrw-tools: new package
@ 2015-03-16 16:31 Steve Kenton
2015-03-16 16:31 ` Steve Kenton
2015-03-16 18:33 ` Thomas Petazzoni
0 siblings, 2 replies; 7+ messages in thread
From: Steve Kenton @ 2015-03-16 16:31 UTC (permalink / raw)
To: buildroot
The dvd+rw-tools are used to master Blu-ray Disc
and DVD Disc media, both +RW/+R and -RW/-R. Note
the +RW in the name is a historical artifact. This
package contains the widely used growisofs program.
Signed-off-by: Steve Kenton <skenton@ou.edu>
---
Thank you for all your kind feedback. I have made
all the changes you suggested. I even understood
most of them :-) so I guess I'm learning how to
fish. I also removed the LARGEFILE references to
mirror the changes going into tip.
However, the line:
$(TARGET_MAKE_ENV) $(MAKE) $(TARGET_CONFIGURE_OPTS) -C $(@D)
is still monkey see, monkey copy/paste so treat accordingly
I'm still trying
to get CDRTOOLS worked up for submission but it's
going to be a while. I'll deal with that interaction
if/when it's acceptable for inclusion.
package/Config.in | 1 +
package/dvdrw-tools/0001-limits.h.patch | 19 ++++++++++++
package/dvdrw-tools/Config.in | 54 +++++++++++++++++++++++++++++++++
package/dvdrw-tools/dvdrw-tools.hash | 3 ++
package/dvdrw-tools/dvdrw-tools.mk | 32 +++++++++++++++++++
5 files changed, 109 insertions(+)
create mode 100644 package/dvdrw-tools/0001-limits.h.patch
create mode 100644 package/dvdrw-tools/Config.in
create mode 100644 package/dvdrw-tools/dvdrw-tools.hash
create mode 100644 package/dvdrw-tools/dvdrw-tools.mk
diff --git a/package/Config.in b/package/Config.in
index c183748..96e373a 100644
--- a/package/Config.in
+++ b/package/Config.in
@@ -7,6 +7,7 @@ menu "Audio and video applications"
source "package/aumix/Config.in"
source "package/bellagio/Config.in"
source "package/dvdauthor/Config.in"
+ source "package/dvdrw-tools/Config.in"
source "package/espeak/Config.in"
source "package/faad2/Config.in"
source "package/ffmpeg/Config.in"
diff --git a/package/dvdrw-tools/0001-limits.h.patch b/package/dvdrw-tools/0001-limits.h.patch
new file mode 100644
index 0000000..a5c7484
--- /dev/null
+++ b/package/dvdrw-tools/0001-limits.h.patch
@@ -0,0 +1,19 @@
+diff -pruN dvd+rw-tools-7.1.ori/transport.hxx dvd+rw-tools-7.1/transport.hxx
+--- dvd+rw-tools-7.1.ori/transport.hxx 2008-03-01 04:34:43.000000000 -0600
++++ dvd+rw-tools-7.1/transport.hxx 2015-01-18 15:47:24.245863631 -0600
+@@ -9,6 +9,7 @@
+ #if defined(__unix) || defined(__unix__)
+ #include <stdio.h>
+ #include <stdlib.h>
++#include <limits.h>
+ #include <unistd.h>
+ #include <string.h>
+ #include <sys/types.h>
+@@ -40,6 +41,7 @@ inline long getmsecs()
+ #include <stddef.h>
+ #include <stdio.h>
+ #include <stdlib.h>
++#include <limits.h>
+ #define ssize_t LONG_PTR
+ #define off64_t __int64
+
diff --git a/package/dvdrw-tools/Config.in b/package/dvdrw-tools/Config.in
new file mode 100644
index 0000000..900b0d6
--- /dev/null
+++ b/package/dvdrw-tools/Config.in
@@ -0,0 +1,54 @@
+config BR2_PACKAGE_DVDRW_TOOLS
+ bool "dvdrw-tools"
+ depends on BR2_USE_MMU # fork()
+ depends on BR2_TOOLCHAIN_HAS_THREADS
+ depends on BR2_INSTALL_LIBSTDCPP
+ depends on BR2_USE_WCHAR
+ help
+ The dvd+rw-tools are used to master Blu-ray Disc
+ and DVD Disc media, both +RW/+R and -RW/-R. The
+ +RW in the name is a historical artifact. This
+ package contains the widely used growisofs program.
+
+ Buildroot does not support packages with a '+' sign
+ in their name, which explains why it is named
+ dvdrw-tools and not dvd+rw-tools.
+
+ Because dvd+rw-tools does not directly interact with
+ disc media it uses a separate media backend program.
+ The usual backend is mkisofs from the cdrtools package.
+ However, cdrtools is not currently part of buildroot.
+
+ The Linux From Scratch project uses uses xorriso for the
+ media backend and Ubuntu uses cdrkit for the backend.
+ Choose the one which seems most appropriate for your use.
+ NOTE: xorriso does not currently support UDF.
+
+ http://fy.chalmers.se/~appro/linux/DVD+RW/tools
+
+comment "dvdrw-tools needs a toolchain w/threads, C++, wchar"
+ depends on BR2_USE_MMU
+ depends on !BR2_TOOLCHAIN_HAS_THREADS \
+ || !BR2_INSTALL_LIBSTDCPP || !BR2_USE_WCHAR
+
+if BR2_PACKAGE_DVDRW_TOOLS
+choice
+ prompt "Media Backend"
+ default BR2_PACKAGE_DVDRW_CDRKIT_BACKEND
+ help
+ Choose which media backend program to use.
+
+config BR2_PACKAGE_DVDRW_TOOLS_CDRKIT_BACKEND
+ bool "cdrkit"
+ select BR2_PACKAGE_CDRKIT
+ help
+ Symlink mkisofs to genisoimage from the cdrkit package.
+
+config BR2_PACKAGE_DVDRW_TOOLS_XORRISO_BACKEND
+ bool "xorriso"
+ select BR2_PACKAGE_XORRISO
+ help
+ Symlink mkisofs to xorrisofs from the xorriso package.
+
+endchoice
+endif
diff --git a/package/dvdrw-tools/dvdrw-tools.hash b/package/dvdrw-tools/dvdrw-tools.hash
new file mode 100644
index 0000000..5d79709
--- /dev/null
+++ b/package/dvdrw-tools/dvdrw-tools.hash
@@ -0,0 +1,3 @@
+# Locally computed using sha256sum
+sha256 f8d60f822e914128bcbc5f64fbe3ed131cbff9045dca7e12c5b77b26edde72ca dvd+rw-tools-7.1.tar.gz
+
diff --git a/package/dvdrw-tools/dvdrw-tools.mk b/package/dvdrw-tools/dvdrw-tools.mk
new file mode 100644
index 0000000..dc69b96
--- /dev/null
+++ b/package/dvdrw-tools/dvdrw-tools.mk
@@ -0,0 +1,32 @@
+################################################################################
+#
+# dvdrw-tools
+#
+################################################################################
+
+DVDRW_TOOLS_VERSION = 7.1
+DVDRW_TOOLS_SOURCE = dvd+rw-tools-$(DVDRW_TOOLS_VERSION).tar.gz
+DVDRW_TOOLS_SITE = http://fy.chalmers.se/~appro/linux/DVD+RW/tools
+DVDRW_TOOLS_LICENSE = GPLv2
+DVDRW_TOOLS_LICENSE_FILES = LICENSE
+
+define DVDRW_TOOLS_BUILD_CMDS
+ $(TARGET_MAKE_ENV) $(MAKE) $(TARGET_CONFIGURE_OPTS) -C $(@D)
+endef
+
+ifeq ($(BR2_PACKAGE_DVDRW_TOOLS_CDRKIT_BACKEND),y)
+ DVDRW_TOOLS_BACKEND = genisoimage
+else ifeq ($(BR2_PACKAGE_DVDRW_TOOLS_XORRISO_BACKEND),y)
+ DVDRW_TOOLS_BACKEND = xorrisofs
+endif
+
+define DVDRW_TOOLS_INSTALL_TARGET_CMDS
+ $(INSTALL) -m 0755 -D $(@D)/dvd-ram-control $(TARGET_DIR)/usr/bin/dvd-ram-control
+ $(INSTALL) -m 0755 -D $(@D)/dvd+rw-booktype $(TARGET_DIR)/usr/bin/dvd+rw-booktype
+ $(INSTALL) -m 0755 -D $(@D)/dvd+rw-format $(TARGET_DIR)/usr/bin/dvd+rw-format
+ $(INSTALL) -m 0755 -D $(@D)/dvd+rw-mediainfo $(TARGET_DIR)/usr/bin/dvd+rw-mediainfo
+ $(INSTALL) -m 0755 -D $(@D)/growisofs $(TARGET_DIR)/usr/bin/growisofs
+ ln -s -f /usr/bin/$(DVDRW_TOOLS_BACKEND) $(TARGET_DIR)/usr/bin/mkisofs
+endef
+
+$(eval $(generic-package))
--
2.1.0
^ permalink raw reply related [flat|nested] 7+ messages in thread
* [Buildroot] [PATCH 1/1] dvdrw-tools: new package
2015-03-16 16:31 [Buildroot] [PATCH 1/1] dvdrw-tools: new package Steve Kenton
@ 2015-03-16 16:31 ` Steve Kenton
2015-03-16 18:33 ` Thomas Petazzoni
1 sibling, 0 replies; 7+ messages in thread
From: Steve Kenton @ 2015-03-16 16:31 UTC (permalink / raw)
To: buildroot
The dvd+rw-tools are used to master Blu-ray Disc
and DVD Disc media, both +RW/+R and -RW/-R. The
+RW in the name is a historical artifact. This
package contains the widely used growisofs program.
Signed-off-by: Steve Kenton <skenton@ou.edu>
---
package/Config.in | 1 +
package/dvdrw-tools/0001-limits.h.patch | 19 ++++++++++++
package/dvdrw-tools/Config.in | 54 +++++++++++++++++++++++++++++++++
package/dvdrw-tools/dvdrw-tools.hash | 3 ++
package/dvdrw-tools/dvdrw-tools.mk | 32 +++++++++++++++++++
5 files changed, 109 insertions(+)
create mode 100644 package/dvdrw-tools/0001-limits.h.patch
create mode 100644 package/dvdrw-tools/Config.in
create mode 100644 package/dvdrw-tools/dvdrw-tools.hash
create mode 100644 package/dvdrw-tools/dvdrw-tools.mk
diff --git a/package/Config.in b/package/Config.in
index c183748..96e373a 100644
--- a/package/Config.in
+++ b/package/Config.in
@@ -7,6 +7,7 @@ menu "Audio and video applications"
source "package/aumix/Config.in"
source "package/bellagio/Config.in"
source "package/dvdauthor/Config.in"
+ source "package/dvdrw-tools/Config.in"
source "package/espeak/Config.in"
source "package/faad2/Config.in"
source "package/ffmpeg/Config.in"
diff --git a/package/dvdrw-tools/0001-limits.h.patch b/package/dvdrw-tools/0001-limits.h.patch
new file mode 100644
index 0000000..a5c7484
--- /dev/null
+++ b/package/dvdrw-tools/0001-limits.h.patch
@@ -0,0 +1,19 @@
+diff -pruN dvd+rw-tools-7.1.ori/transport.hxx dvd+rw-tools-7.1/transport.hxx
+--- dvd+rw-tools-7.1.ori/transport.hxx 2008-03-01 04:34:43.000000000 -0600
++++ dvd+rw-tools-7.1/transport.hxx 2015-01-18 15:47:24.245863631 -0600
+@@ -9,6 +9,7 @@
+ #if defined(__unix) || defined(__unix__)
+ #include <stdio.h>
+ #include <stdlib.h>
++#include <limits.h>
+ #include <unistd.h>
+ #include <string.h>
+ #include <sys/types.h>
+@@ -40,6 +41,7 @@ inline long getmsecs()
+ #include <stddef.h>
+ #include <stdio.h>
+ #include <stdlib.h>
++#include <limits.h>
+ #define ssize_t LONG_PTR
+ #define off64_t __int64
+
diff --git a/package/dvdrw-tools/Config.in b/package/dvdrw-tools/Config.in
new file mode 100644
index 0000000..900b0d6
--- /dev/null
+++ b/package/dvdrw-tools/Config.in
@@ -0,0 +1,54 @@
+config BR2_PACKAGE_DVDRW_TOOLS
+ bool "dvdrw-tools"
+ depends on BR2_USE_MMU # fork()
+ depends on BR2_TOOLCHAIN_HAS_THREADS
+ depends on BR2_INSTALL_LIBSTDCPP
+ depends on BR2_USE_WCHAR
+ help
+ The dvd+rw-tools are used to master Blu-ray Disc
+ and DVD Disc media, both +RW/+R and -RW/-R. The
+ +RW in the name is a historical artifact. This
+ package contains the widely used growisofs program.
+
+ Buildroot does not support packages with a '+' sign
+ in their name, which explains why it is named
+ dvdrw-tools and not dvd+rw-tools.
+
+ Because dvd+rw-tools does not directly interact with
+ disc media it uses a separate media backend program.
+ The usual backend is mkisofs from the cdrtools package.
+ However, cdrtools is not currently part of buildroot.
+
+ The Linux From Scratch project uses uses xorriso for the
+ media backend and Ubuntu uses cdrkit for the backend.
+ Choose the one which seems most appropriate for your use.
+ NOTE: xorriso does not currently support UDF.
+
+ http://fy.chalmers.se/~appro/linux/DVD+RW/tools
+
+comment "dvdrw-tools needs a toolchain w/threads, C++, wchar"
+ depends on BR2_USE_MMU
+ depends on !BR2_TOOLCHAIN_HAS_THREADS \
+ || !BR2_INSTALL_LIBSTDCPP || !BR2_USE_WCHAR
+
+if BR2_PACKAGE_DVDRW_TOOLS
+choice
+ prompt "Media Backend"
+ default BR2_PACKAGE_DVDRW_CDRKIT_BACKEND
+ help
+ Choose which media backend program to use.
+
+config BR2_PACKAGE_DVDRW_TOOLS_CDRKIT_BACKEND
+ bool "cdrkit"
+ select BR2_PACKAGE_CDRKIT
+ help
+ Symlink mkisofs to genisoimage from the cdrkit package.
+
+config BR2_PACKAGE_DVDRW_TOOLS_XORRISO_BACKEND
+ bool "xorriso"
+ select BR2_PACKAGE_XORRISO
+ help
+ Symlink mkisofs to xorrisofs from the xorriso package.
+
+endchoice
+endif
diff --git a/package/dvdrw-tools/dvdrw-tools.hash b/package/dvdrw-tools/dvdrw-tools.hash
new file mode 100644
index 0000000..5d79709
--- /dev/null
+++ b/package/dvdrw-tools/dvdrw-tools.hash
@@ -0,0 +1,3 @@
+# Locally computed using sha256sum
+sha256 f8d60f822e914128bcbc5f64fbe3ed131cbff9045dca7e12c5b77b26edde72ca dvd+rw-tools-7.1.tar.gz
+
diff --git a/package/dvdrw-tools/dvdrw-tools.mk b/package/dvdrw-tools/dvdrw-tools.mk
new file mode 100644
index 0000000..dc69b96
--- /dev/null
+++ b/package/dvdrw-tools/dvdrw-tools.mk
@@ -0,0 +1,32 @@
+################################################################################
+#
+# dvdrw-tools
+#
+################################################################################
+
+DVDRW_TOOLS_VERSION = 7.1
+DVDRW_TOOLS_SOURCE = dvd+rw-tools-$(DVDRW_TOOLS_VERSION).tar.gz
+DVDRW_TOOLS_SITE = http://fy.chalmers.se/~appro/linux/DVD+RW/tools
+DVDRW_TOOLS_LICENSE = GPLv2
+DVDRW_TOOLS_LICENSE_FILES = LICENSE
+
+define DVDRW_TOOLS_BUILD_CMDS
+ $(TARGET_MAKE_ENV) $(MAKE) $(TARGET_CONFIGURE_OPTS) -C $(@D)
+endef
+
+ifeq ($(BR2_PACKAGE_DVDRW_TOOLS_CDRKIT_BACKEND),y)
+ DVDRW_TOOLS_BACKEND = genisoimage
+else ifeq ($(BR2_PACKAGE_DVDRW_TOOLS_XORRISO_BACKEND),y)
+ DVDRW_TOOLS_BACKEND = xorrisofs
+endif
+
+define DVDRW_TOOLS_INSTALL_TARGET_CMDS
+ $(INSTALL) -m 0755 -D $(@D)/dvd-ram-control $(TARGET_DIR)/usr/bin/dvd-ram-control
+ $(INSTALL) -m 0755 -D $(@D)/dvd+rw-booktype $(TARGET_DIR)/usr/bin/dvd+rw-booktype
+ $(INSTALL) -m 0755 -D $(@D)/dvd+rw-format $(TARGET_DIR)/usr/bin/dvd+rw-format
+ $(INSTALL) -m 0755 -D $(@D)/dvd+rw-mediainfo $(TARGET_DIR)/usr/bin/dvd+rw-mediainfo
+ $(INSTALL) -m 0755 -D $(@D)/growisofs $(TARGET_DIR)/usr/bin/growisofs
+ ln -s -f /usr/bin/$(DVDRW_TOOLS_BACKEND) $(TARGET_DIR)/usr/bin/mkisofs
+endef
+
+$(eval $(generic-package))
--
2.1.0
^ permalink raw reply related [flat|nested] 7+ messages in thread
* [Buildroot] [PATCH 1/1] dvdrw-tools: new package
2015-03-16 16:31 [Buildroot] [PATCH 1/1] dvdrw-tools: new package Steve Kenton
2015-03-16 16:31 ` Steve Kenton
@ 2015-03-16 18:33 ` Thomas Petazzoni
1 sibling, 0 replies; 7+ messages in thread
From: Thomas Petazzoni @ 2015-03-16 18:33 UTC (permalink / raw)
To: buildroot
Dear Steve Kenton,
On Mon, 16 Mar 2015 11:31:50 -0500, Steve Kenton wrote:
> The dvd+rw-tools are used to master Blu-ray Disc
> and DVD Disc media, both +RW/+R and -RW/-R. Note
> the +RW in the name is a historical artifact. This
> package contains the widely used growisofs program.
>
> Signed-off-by: Steve Kenton <skenton@ou.edu>
> ---
> Thank you for all your kind feedback. I have made
> all the changes you suggested. I even understood
> most of them :-) so I guess I'm learning how to
> fish. I also removed the LARGEFILE references to
> mirror the changes going into tip.
Why? Largefile support has not been changed so far. Don't confuse
patches that have been sent to the list with patches that have been
merged.
> However, the line:
> $(TARGET_MAKE_ENV) $(MAKE) $(TARGET_CONFIGURE_OPTS) -C $(@D)
> is still monkey see, monkey copy/paste so treat accordingly
Well, do a build for ARM, and make sure the executable files produced
by dvdrw-tools are properly built for ARM.
> diff --git a/package/dvdrw-tools/0001-limits.h.patch b/package/dvdrw-tools/0001-limits.h.patch
> new file mode 100644
> index 0000000..a5c7484
> --- /dev/null
> +++ b/package/dvdrw-tools/0001-limits.h.patch
This patch still needs a description + Signed-off-by line. See my
previous review.
> diff --git a/package/dvdrw-tools/dvdrw-tools.mk b/package/dvdrw-tools/dvdrw-tools.mk
> new file mode 100644
> index 0000000..dc69b96
> --- /dev/null
> +++ b/package/dvdrw-tools/dvdrw-tools.mk
> @@ -0,0 +1,32 @@
> +################################################################################
> +#
> +# dvdrw-tools
> +#
> +################################################################################
> +
> +DVDRW_TOOLS_VERSION = 7.1
> +DVDRW_TOOLS_SOURCE = dvd+rw-tools-$(DVDRW_TOOLS_VERSION).tar.gz
> +DVDRW_TOOLS_SITE = http://fy.chalmers.se/~appro/linux/DVD+RW/tools
> +DVDRW_TOOLS_LICENSE = GPLv2
> +DVDRW_TOOLS_LICENSE_FILES = LICENSE
> +
> +define DVDRW_TOOLS_BUILD_CMDS
> + $(TARGET_MAKE_ENV) $(MAKE) $(TARGET_CONFIGURE_OPTS) -C $(@D)
> +endef
> +
> +ifeq ($(BR2_PACKAGE_DVDRW_TOOLS_CDRKIT_BACKEND),y)
> + DVDRW_TOOLS_BACKEND = genisoimage
Nitpick: don't indent.
> +else ifeq ($(BR2_PACKAGE_DVDRW_TOOLS_XORRISO_BACKEND),y)
> + DVDRW_TOOLS_BACKEND = xorrisofs
Ditto.
> +endif
> +
> +define DVDRW_TOOLS_INSTALL_TARGET_CMDS
> + $(INSTALL) -m 0755 -D $(@D)/dvd-ram-control $(TARGET_DIR)/usr/bin/dvd-ram-control
> + $(INSTALL) -m 0755 -D $(@D)/dvd+rw-booktype $(TARGET_DIR)/usr/bin/dvd+rw-booktype
> + $(INSTALL) -m 0755 -D $(@D)/dvd+rw-format $(TARGET_DIR)/usr/bin/dvd+rw-format
> + $(INSTALL) -m 0755 -D $(@D)/dvd+rw-mediainfo $(TARGET_DIR)/usr/bin/dvd+rw-mediainfo
> + $(INSTALL) -m 0755 -D $(@D)/growisofs $(TARGET_DIR)/usr/bin/growisofs
> + ln -s -f /usr/bin/$(DVDRW_TOOLS_BACKEND) $(TARGET_DIR)/usr/bin/mkisofs
> +endef
> +
> +$(eval $(generic-package))
So besides the largefile stuff, and the missing patch description, I
think we're almost good to go.
Thanks,
Thomas
--
Thomas Petazzoni, CTO, Free Electrons
Embedded Linux, Kernel and Android engineering
http://free-electrons.com
^ permalink raw reply [flat|nested] 7+ messages in thread
* [Buildroot] [PATCH 1/1] dvdrw-tools: new package
@ 2015-03-17 15:07 Steve Kenton
2015-03-17 17:17 ` Yann E. MORIN
0 siblings, 1 reply; 7+ messages in thread
From: Steve Kenton @ 2015-03-17 15:07 UTC (permalink / raw)
To: buildroot
The dvd+rw-tools are used to master Blu-ray Disc
and DVD Disc media, both +RW/+R and -RW/-R. Note:
The +RW in the name is a historical artifact. This
package contains the widely used growisofs program.
Signed-off-by: Steve Kenton <skenton@ou.edu>
---
One more time. I was confusing the submission patch
with the patch to the package - Doh! But I think
I got it right this time. At least 'file' shows this
after cross compiling on an x86 system.
genisoimage: ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), dynamically linked (uses shared libs), stripped
package/Config.in | 1 +
package/dvdrw-tools/0001-limits.h.patch | 23 ++++++++++++++
package/dvdrw-tools/Config.in | 56 +++++++++++++++++++++++++++++++++
package/dvdrw-tools/dvdrw-tools.hash | 3 ++
package/dvdrw-tools/dvdrw-tools.mk | 32 +++++++++++++++++++
5 files changed, 115 insertions(+)
create mode 100644 package/dvdrw-tools/0001-limits.h.patch
create mode 100644 package/dvdrw-tools/Config.in
create mode 100644 package/dvdrw-tools/dvdrw-tools.hash
create mode 100644 package/dvdrw-tools/dvdrw-tools.mk
diff --git a/package/Config.in b/package/Config.in
index c183748..96e373a 100644
--- a/package/Config.in
+++ b/package/Config.in
@@ -7,6 +7,7 @@ menu "Audio and video applications"
source "package/aumix/Config.in"
source "package/bellagio/Config.in"
source "package/dvdauthor/Config.in"
+ source "package/dvdrw-tools/Config.in"
source "package/espeak/Config.in"
source "package/faad2/Config.in"
source "package/ffmpeg/Config.in"
diff --git a/package/dvdrw-tools/0001-limits.h.patch b/package/dvdrw-tools/0001-limits.h.patch
new file mode 100644
index 0000000..ccda8ee
--- /dev/null
+++ b/package/dvdrw-tools/0001-limits.h.patch
@@ -0,0 +1,23 @@
+transport.hxx: add limits.h include now needed because of kernel changes
+
+Signed-off-by: Steve Kenton <skenton@ou.edu>
+
+diff -pruN dvd+rw-tools-7.1.ori/transport.hxx dvd+rw-tools-7.1/transport.hxx
+--- dvd+rw-tools-7.1.ori/transport.hxx 2008-03-01 04:34:43.000000000 -0600
++++ dvd+rw-tools-7.1/transport.hxx 2015-01-18 15:47:24.245863631 -0600
+@@ -9,6 +9,7 @@
+ #if defined(__unix) || defined(__unix__)
+ #include <stdio.h>
+ #include <stdlib.h>
++#include <limits.h>
+ #include <unistd.h>
+ #include <string.h>
+ #include <sys/types.h>
+@@ -40,6 +41,7 @@ inline long getmsecs()
+ #include <stddef.h>
+ #include <stdio.h>
+ #include <stdlib.h>
++#include <limits.h>
+ #define ssize_t LONG_PTR
+ #define off64_t __int64
+
diff --git a/package/dvdrw-tools/Config.in b/package/dvdrw-tools/Config.in
new file mode 100644
index 0000000..cdcdaa3
--- /dev/null
+++ b/package/dvdrw-tools/Config.in
@@ -0,0 +1,56 @@
+config BR2_PACKAGE_DVDRW_TOOLS
+ bool "dvdrw-tools"
+ depends on BR2_USE_MMU # fork()
+ depends on BR2_TOOLCHAIN_HAS_THREADS
+ depends on BR2_INSTALL_LIBSTDCPP
+ depends on BR2_USE_WCHAR
+ depends on BR2_LARGEFILE
+ help
+ The dvd+rw-tools are used to master Blu-ray Disc
+ and DVD Disc media, both +RW/+R and -RW/-R. The
+ +RW in the name is a historical artifact. This
+ package contains the widely used growisofs program.
+
+ Buildroot does not support packages with a '+' sign
+ in their name, which explains why it is named
+ dvdrw-tools and not dvd+rw-tools.
+
+ Because dvd+rw-tools does not directly interact with
+ disc media it uses a separate media backend program.
+ The usual backend is mkisofs from the cdrtools package.
+ However, cdrtools is not currently part of buildroot.
+
+ The Linux From Scratch project uses uses xorriso for the
+ media backend and Ubuntu uses cdrkit for the backend.
+ Choose the one which seems most appropriate for your use.
+ NOTE: xorriso does not currently support UDF.
+
+ http://fy.chalmers.se/~appro/linux/DVD+RW/tools
+
+comment "dvdrw-tools needs a toolchain w/threads, C++, wchar, largefile"
+ depends on BR2_USE_MMU
+ depends on !BR2_TOOLCHAIN_HAS_THREADS \
+ || !BR2_INSTALL_LIBSTDCPP || !BR2_USE_WCHAR \
+ || !BR2_LARGEFILE
+
+if BR2_PACKAGE_DVDRW_TOOLS
+choice
+ prompt "Media Backend"
+ default BR2_PACKAGE_DVDRW_CDRKIT_BACKEND
+ help
+ Choose which media backend program to use.
+
+config BR2_PACKAGE_DVDRW_TOOLS_CDRKIT_BACKEND
+ bool "cdrkit"
+ select BR2_PACKAGE_CDRKIT
+ help
+ Symlink mkisofs to genisoimage from the cdrkit package.
+
+config BR2_PACKAGE_DVDRW_TOOLS_XORRISO_BACKEND
+ bool "xorriso"
+ select BR2_PACKAGE_XORRISO
+ help
+ Symlink mkisofs to xorrisofs from the xorriso package.
+
+endchoice
+endif
diff --git a/package/dvdrw-tools/dvdrw-tools.hash b/package/dvdrw-tools/dvdrw-tools.hash
new file mode 100644
index 0000000..5d79709
--- /dev/null
+++ b/package/dvdrw-tools/dvdrw-tools.hash
@@ -0,0 +1,3 @@
+# Locally computed using sha256sum
+sha256 f8d60f822e914128bcbc5f64fbe3ed131cbff9045dca7e12c5b77b26edde72ca dvd+rw-tools-7.1.tar.gz
+
diff --git a/package/dvdrw-tools/dvdrw-tools.mk b/package/dvdrw-tools/dvdrw-tools.mk
new file mode 100644
index 0000000..af6105d
--- /dev/null
+++ b/package/dvdrw-tools/dvdrw-tools.mk
@@ -0,0 +1,32 @@
+################################################################################
+#
+# dvdrw-tools
+#
+################################################################################
+
+DVDRW_TOOLS_VERSION = 7.1
+DVDRW_TOOLS_SOURCE = dvd+rw-tools-$(DVDRW_TOOLS_VERSION).tar.gz
+DVDRW_TOOLS_SITE = http://fy.chalmers.se/~appro/linux/DVD+RW/tools
+DVDRW_TOOLS_LICENSE = GPLv2
+DVDRW_TOOLS_LICENSE_FILES = LICENSE
+
+define DVDRW_TOOLS_BUILD_CMDS
+ $(TARGET_MAKE_ENV) $(MAKE) $(TARGET_CONFIGURE_OPTS) -C $(@D)
+endef
+
+ifeq ($(BR2_PACKAGE_DVDRW_TOOLS_CDRKIT_BACKEND),y)
+DVDRW_TOOLS_BACKEND = genisoimage
+else ifeq ($(BR2_PACKAGE_DVDRW_TOOLS_XORRISO_BACKEND),y)
+DVDRW_TOOLS_BACKEND = xorrisofs
+endif
+
+define DVDRW_TOOLS_INSTALL_TARGET_CMDS
+ $(INSTALL) -m 0755 -D $(@D)/dvd-ram-control $(TARGET_DIR)/usr/bin/dvd-ram-control
+ $(INSTALL) -m 0755 -D $(@D)/dvd+rw-booktype $(TARGET_DIR)/usr/bin/dvd+rw-booktype
+ $(INSTALL) -m 0755 -D $(@D)/dvd+rw-format $(TARGET_DIR)/usr/bin/dvd+rw-format
+ $(INSTALL) -m 0755 -D $(@D)/dvd+rw-mediainfo $(TARGET_DIR)/usr/bin/dvd+rw-mediainfo
+ $(INSTALL) -m 0755 -D $(@D)/growisofs $(TARGET_DIR)/usr/bin/growisofs
+ ln -s -f /usr/bin/$(DVDRW_TOOLS_BACKEND) $(TARGET_DIR)/usr/bin/mkisofs
+endef
+
+$(eval $(generic-package))
--
2.1.0
^ permalink raw reply related [flat|nested] 7+ messages in thread
* [Buildroot] [PATCH 1/1] dvdrw-tools: new package
2015-03-17 15:07 Steve Kenton
@ 2015-03-17 17:17 ` Yann E. MORIN
0 siblings, 0 replies; 7+ messages in thread
From: Yann E. MORIN @ 2015-03-17 17:17 UTC (permalink / raw)
To: buildroot
Steve, All,
On 2015-03-17 10:07 -0500, Steve Kenton spake thusly:
> The dvd+rw-tools are used to master Blu-ray Disc
> and DVD Disc media, both +RW/+R and -RW/-R. Note:
> The +RW in the name is a historical artifact. This
> package contains the widely used growisofs program.
Getting good! :-)
> Signed-off-by: Steve Kenton <skenton@ou.edu>
[--SNIP--]
> diff --git a/package/dvdrw-tools/Config.in b/package/dvdrw-tools/Config.in
> new file mode 100644
> index 0000000..cdcdaa3
> --- /dev/null
> +++ b/package/dvdrw-tools/Config.in
> @@ -0,0 +1,56 @@
> +config BR2_PACKAGE_DVDRW_TOOLS
> + bool "dvdrw-tools"
> + depends on BR2_USE_MMU # fork()
> + depends on BR2_TOOLCHAIN_HAS_THREADS
> + depends on BR2_INSTALL_LIBSTDCPP
> + depends on BR2_USE_WCHAR
> + depends on BR2_LARGEFILE
> + help
> + The dvd+rw-tools are used to master Blu-ray Disc
> + and DVD Disc media, both +RW/+R and -RW/-R. The
> + +RW in the name is a historical artifact. This
> + package contains the widely used growisofs program.
> +
> + Buildroot does not support packages with a '+' sign
> + in their name, which explains why it is named
> + dvdrw-tools and not dvd+rw-tools.
> +
> + Because dvd+rw-tools does not directly interact with
> + disc media it uses a separate media backend program.
> + The usual backend is mkisofs from the cdrtools package.
> + However, cdrtools is not currently part of buildroot.
> +
> + The Linux From Scratch project uses uses xorriso for the
> + media backend and Ubuntu uses cdrkit for the backend.
> + Choose the one which seems most appropriate for your use.
> + NOTE: xorriso does not currently support UDF.
> +
> + http://fy.chalmers.se/~appro/linux/DVD+RW/tools
> +
> +comment "dvdrw-tools needs a toolchain w/threads, C++, wchar, largefile"
> + depends on BR2_USE_MMU
> + depends on !BR2_TOOLCHAIN_HAS_THREADS \
> + || !BR2_INSTALL_LIBSTDCPP || !BR2_USE_WCHAR \
> + || !BR2_LARGEFILE
> +
> +if BR2_PACKAGE_DVDRW_TOOLS
> +choice
> + prompt "Media Backend"
> + default BR2_PACKAGE_DVDRW_CDRKIT_BACKEND
> + help
> + Choose which media backend program to use.
> +
> +config BR2_PACKAGE_DVDRW_TOOLS_CDRKIT_BACKEND
> + bool "cdrkit"
> + select BR2_PACKAGE_CDRKIT
cdrkit depends on BR2_TOOLCHAIN_HEADERS_AT_LEAST_3_0 so you need to
propagate this here:
config BR2_PACKAGE_DVDRW_TOOLS_CDRKIT_BACKEND
bool "cdrkit"
depends on BR2_TOOLCHAIN_HEADERS_AT_LEAST_3_0 # cdrkit
select BR2_PACKAGE_CDRKIT
help
Blabla symlink blabla...
comment "cdrkit needs a toolchain with headers >= 3.0"
depends on !BR2_TOOLCHAIN_HEADERS_AT_LEAST_3_0
You can put the comment in the choice, yes.
[--SNIP--]
> diff --git a/package/dvdrw-tools/dvdrw-tools.mk b/package/dvdrw-tools/dvdrw-tools.mk
> new file mode 100644
> index 0000000..af6105d
> --- /dev/null
> +++ b/package/dvdrw-tools/dvdrw-tools.mk
> @@ -0,0 +1,32 @@
> +################################################################################
> +#
> +# dvdrw-tools
> +#
> +################################################################################
> +
> +DVDRW_TOOLS_VERSION = 7.1
> +DVDRW_TOOLS_SOURCE = dvd+rw-tools-$(DVDRW_TOOLS_VERSION).tar.gz
> +DVDRW_TOOLS_SITE = http://fy.chalmers.se/~appro/linux/DVD+RW/tools
> +DVDRW_TOOLS_LICENSE = GPLv2
> +DVDRW_TOOLS_LICENSE_FILES = LICENSE
> +
> +define DVDRW_TOOLS_BUILD_CMDS
> + $(TARGET_MAKE_ENV) $(MAKE) $(TARGET_CONFIGURE_OPTS) -C $(@D)
> +endef
> +
> +ifeq ($(BR2_PACKAGE_DVDRW_TOOLS_CDRKIT_BACKEND),y)
> +DVDRW_TOOLS_BACKEND = genisoimage
> +else ifeq ($(BR2_PACKAGE_DVDRW_TOOLS_XORRISO_BACKEND),y)
> +DVDRW_TOOLS_BACKEND = xorrisofs
> +endif
> +
> +define DVDRW_TOOLS_INSTALL_TARGET_CMDS
> + $(INSTALL) -m 0755 -D $(@D)/dvd-ram-control $(TARGET_DIR)/usr/bin/dvd-ram-control
> + $(INSTALL) -m 0755 -D $(@D)/dvd+rw-booktype $(TARGET_DIR)/usr/bin/dvd+rw-booktype
> + $(INSTALL) -m 0755 -D $(@D)/dvd+rw-format $(TARGET_DIR)/usr/bin/dvd+rw-format
> + $(INSTALL) -m 0755 -D $(@D)/dvd+rw-mediainfo $(TARGET_DIR)/usr/bin/dvd+rw-mediainfo
> + $(INSTALL) -m 0755 -D $(@D)/growisofs $(TARGET_DIR)/usr/bin/growisofs
> + ln -s -f /usr/bin/$(DVDRW_TOOLS_BACKEND) $(TARGET_DIR)/usr/bin/mkisofs
Because you need the backend to create the symlink, you should depend on
the proper backend:
ifeq ($(BR2_PACKAGE_DVDRW_TOOLS_CDRKIT_BACKEND),y)
DVDRW_TOOLS_BACKEND = genisoimage
DVDRW_TOOLS_DEPENDENCIES = cdrkit
else ifeq ($(BR2_PACKAGE_DVDRW_TOOLS_XORRISO_BACKEND),y)
DVDRW_TOOLS_BACKEND = xorrisofs
DVDRW_TOOLS_DEPENDENCIES = xorriso
endif
Otherwise, lokks good.
Regards,
Yann E. MORIN.
> +endef
>
> +$(eval $(generic-package))
> --
> 2.1.0
>
> _______________________________________________
> buildroot mailing list
> buildroot at busybox.net
> http://lists.busybox.net/mailman/listinfo/buildroot
--
.-----------------.--------------------.------------------.--------------------.
| Yann E. MORIN | Real-Time Embedded | /"\ ASCII RIBBON | Erics' conspiracy: |
| +33 662 376 056 | Software Designer | \ / CAMPAIGN | ___ |
| +33 223 225 172 `------------.-------: X AGAINST | \e/ There is no |
| http://ymorin.is-a-geek.org/ | _/*\_ | / \ HTML MAIL | v conspiracy. |
'------------------------------^-------^------------------^--------------------'
^ permalink raw reply [flat|nested] 7+ messages in thread
* [Buildroot] [PATCH 1/1] dvdrw-tools: new package
@ 2015-03-17 18:57 Steve Kenton
2015-03-17 22:12 ` Thomas Petazzoni
0 siblings, 1 reply; 7+ messages in thread
From: Steve Kenton @ 2015-03-17 18:57 UTC (permalink / raw)
To: buildroot
The dvd+rw-tools are used to master Blu-ray Disc
and DVD Disc media, both +RW/+R and -RW/-R. Note:
The +RW in the name is a historical artifact. This
package contains the widely used growisofs program.
Signed-off-by: Steve Kenton <skenton@ou.edu>
---
Well, this has certainly been a 'learning experience'
I was happy when I thought of the alternate symlinks
as a solution to my two backends problem, I just did
not foresee all the details involved ... Let's see if
this time is the magic number.
Thanks everyone for the help
package/Config.in | 1 +
package/dvdrw-tools/0001-limits.h.patch | 23 +++++++++++++
package/dvdrw-tools/Config.in | 60 +++++++++++++++++++++++++++++++++
package/dvdrw-tools/dvdrw-tools.hash | 3 ++
package/dvdrw-tools/dvdrw-tools.mk | 34 +++++++++++++++++++
5 files changed, 121 insertions(+)
create mode 100644 package/dvdrw-tools/0001-limits.h.patch
create mode 100644 package/dvdrw-tools/Config.in
create mode 100644 package/dvdrw-tools/dvdrw-tools.hash
create mode 100644 package/dvdrw-tools/dvdrw-tools.mk
diff --git a/package/Config.in b/package/Config.in
index c183748..96e373a 100644
--- a/package/Config.in
+++ b/package/Config.in
@@ -7,6 +7,7 @@ menu "Audio and video applications"
source "package/aumix/Config.in"
source "package/bellagio/Config.in"
source "package/dvdauthor/Config.in"
+ source "package/dvdrw-tools/Config.in"
source "package/espeak/Config.in"
source "package/faad2/Config.in"
source "package/ffmpeg/Config.in"
diff --git a/package/dvdrw-tools/0001-limits.h.patch b/package/dvdrw-tools/0001-limits.h.patch
new file mode 100644
index 0000000..ccda8ee
--- /dev/null
+++ b/package/dvdrw-tools/0001-limits.h.patch
@@ -0,0 +1,23 @@
+transport.hxx: add limits.h include now needed because of kernel changes
+
+Signed-off-by: Steve Kenton <skenton@ou.edu>
+
+diff -pruN dvd+rw-tools-7.1.ori/transport.hxx dvd+rw-tools-7.1/transport.hxx
+--- dvd+rw-tools-7.1.ori/transport.hxx 2008-03-01 04:34:43.000000000 -0600
++++ dvd+rw-tools-7.1/transport.hxx 2015-01-18 15:47:24.245863631 -0600
+@@ -9,6 +9,7 @@
+ #if defined(__unix) || defined(__unix__)
+ #include <stdio.h>
+ #include <stdlib.h>
++#include <limits.h>
+ #include <unistd.h>
+ #include <string.h>
+ #include <sys/types.h>
+@@ -40,6 +41,7 @@ inline long getmsecs()
+ #include <stddef.h>
+ #include <stdio.h>
+ #include <stdlib.h>
++#include <limits.h>
+ #define ssize_t LONG_PTR
+ #define off64_t __int64
+
diff --git a/package/dvdrw-tools/Config.in b/package/dvdrw-tools/Config.in
new file mode 100644
index 0000000..04f8006
--- /dev/null
+++ b/package/dvdrw-tools/Config.in
@@ -0,0 +1,60 @@
+config BR2_PACKAGE_DVDRW_TOOLS
+ bool "dvdrw-tools"
+ depends on BR2_USE_MMU # fork()
+ depends on BR2_TOOLCHAIN_HAS_THREADS
+ depends on BR2_INSTALL_LIBSTDCPP
+ depends on BR2_USE_WCHAR
+ depends on BR2_LARGEFILE
+ help
+ The dvd+rw-tools are used to master Blu-ray Disc
+ and DVD Disc media, both +RW/+R and -RW/-R. Note:
+ The +RW in the name is a historical artifact. This
+ package contains the widely used growisofs program.
+
+ Buildroot does not support packages with a '+' sign
+ in their name, which explains why it is named
+ dvdrw-tools and not dvd+rw-tools.
+
+ Because dvd+rw-tools does not directly interact with
+ disc media it uses a separate media backend program.
+ The usual backend is mkisofs from the cdrtools package.
+ However, cdrtools is not currently part of buildroot.
+
+ The Linux From Scratch project uses uses xorriso for the
+ media backend and Ubuntu uses cdrkit for the backend.
+ Choose the one which seems most appropriate for your use.
+ NOTE: xorriso does not currently support UDF.
+
+ http://fy.chalmers.se/~appro/linux/DVD+RW/tools
+
+comment "dvdrw-tools needs a toolchain w/threads, C++, wchar, largefile"
+ depends on BR2_USE_MMU
+ depends on !BR2_TOOLCHAIN_HAS_THREADS \
+ || !BR2_INSTALL_LIBSTDCPP || !BR2_USE_WCHAR \
+ || !BR2_LARGEFILE
+
+if BR2_PACKAGE_DVDRW_TOOLS
+choice
+ prompt "Media Backend"
+ default BR2_PACKAGE_DVDRW_CDRKIT_BACKEND
+ help
+ Choose which media backend program to use.
+
+config BR2_PACKAGE_DVDRW_TOOLS_CDRKIT_BACKEND
+ bool "cdrkit"
+ depends on BR2_TOOLCHAIN_HEADERS_AT_LEAST_3_0 # cdrkit
+ select BR2_PACKAGE_CDRKIT
+ help
+ Symlink mkisofs to genisoimage from the cdrkit package.
+
+comment "cdrkit needs a toolchain with headers >= 3.0"
+ depends on !BR2_TOOLCHAIN_HEADERS_AT_LEAST_3_0
+
+config BR2_PACKAGE_DVDRW_TOOLS_XORRISO_BACKEND
+ bool "xorriso"
+ select BR2_PACKAGE_XORRISO
+ help
+ Symlink mkisofs to xorrisofs from the xorriso package.
+
+endchoice
+endif
diff --git a/package/dvdrw-tools/dvdrw-tools.hash b/package/dvdrw-tools/dvdrw-tools.hash
new file mode 100644
index 0000000..5d79709
--- /dev/null
+++ b/package/dvdrw-tools/dvdrw-tools.hash
@@ -0,0 +1,3 @@
+# Locally computed using sha256sum
+sha256 f8d60f822e914128bcbc5f64fbe3ed131cbff9045dca7e12c5b77b26edde72ca dvd+rw-tools-7.1.tar.gz
+
diff --git a/package/dvdrw-tools/dvdrw-tools.mk b/package/dvdrw-tools/dvdrw-tools.mk
new file mode 100644
index 0000000..9f8732c
--- /dev/null
+++ b/package/dvdrw-tools/dvdrw-tools.mk
@@ -0,0 +1,34 @@
+################################################################################
+#
+# dvdrw-tools
+#
+################################################################################
+
+DVDRW_TOOLS_VERSION = 7.1
+DVDRW_TOOLS_SOURCE = dvd+rw-tools-$(DVDRW_TOOLS_VERSION).tar.gz
+DVDRW_TOOLS_SITE = http://fy.chalmers.se/~appro/linux/DVD+RW/tools
+DVDRW_TOOLS_LICENSE = GPLv2
+DVDRW_TOOLS_LICENSE_FILES = LICENSE
+
+define DVDRW_TOOLS_BUILD_CMDS
+ $(TARGET_MAKE_ENV) $(MAKE) $(TARGET_CONFIGURE_OPTS) -C $(@D)
+endef
+
+ifeq ($(BR2_PACKAGE_DVDRW_TOOLS_CDRKIT_BACKEND),y)
+DVDRW_TOOLS_BACKEND = genisoimage
+DVDRW_TOOLS_DEPENDENCIES = cdrkit
+else ifeq ($(BR2_PACKAGE_DVDRW_TOOLS_XORRISO_BACKEND),y)
+DVDRW_TOOLS_BACKEND = xorrisofs
+DVDRW_TOOLS_DEPENDENCIES = xorriso
+endif
+
+define DVDRW_TOOLS_INSTALL_TARGET_CMDS
+ $(INSTALL) -m 0755 -D $(@D)/dvd-ram-control $(TARGET_DIR)/usr/bin/dvd-ram-control
+ $(INSTALL) -m 0755 -D $(@D)/dvd+rw-booktype $(TARGET_DIR)/usr/bin/dvd+rw-booktype
+ $(INSTALL) -m 0755 -D $(@D)/dvd+rw-format $(TARGET_DIR)/usr/bin/dvd+rw-format
+ $(INSTALL) -m 0755 -D $(@D)/dvd+rw-mediainfo $(TARGET_DIR)/usr/bin/dvd+rw-mediainfo
+ $(INSTALL) -m 0755 -D $(@D)/growisofs $(TARGET_DIR)/usr/bin/growisofs
+ ln -s -f /usr/bin/$(DVDRW_TOOLS_BACKEND) $(TARGET_DIR)/usr/bin/mkisofs
+endef
+
+$(eval $(generic-package))
--
2.1.0
^ permalink raw reply related [flat|nested] 7+ messages in thread
* [Buildroot] [PATCH 1/1] dvdrw-tools: new package
2015-03-17 18:57 Steve Kenton
@ 2015-03-17 22:12 ` Thomas Petazzoni
0 siblings, 0 replies; 7+ messages in thread
From: Thomas Petazzoni @ 2015-03-17 22:12 UTC (permalink / raw)
To: buildroot
Dear Steve Kenton,
On Tue, 17 Mar 2015 13:57:38 -0500, Steve Kenton wrote:
> The dvd+rw-tools are used to master Blu-ray Disc
> and DVD Disc media, both +RW/+R and -RW/-R. Note:
> The +RW in the name is a historical artifact. This
> package contains the widely used growisofs program.
>
> Signed-off-by: Steve Kenton <skenton@ou.edu>
One thing you forgot to do is to adjust the way the patch is generated
to include a version number. You should have done:
git format-patch --subject-prefix="PATCH v5"
for example. And then include a changelog between the different
versions.
But that will be for another patch, since I applied this version. I
only did some minor final changes to it:
[Thomas:
- adjust minor formatting issues in Config.in file.
- remove unneeded empty line in hash file.
- make the mkisofs symbolic link a relative one.]
Thanks,
Thomas
--
Thomas Petazzoni, CTO, Free Electrons
Embedded Linux, Kernel and Android engineering
http://free-electrons.com
^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2015-03-17 22:12 UTC | newest]
Thread overview: 7+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2015-03-16 16:31 [Buildroot] [PATCH 1/1] dvdrw-tools: new package Steve Kenton
2015-03-16 16:31 ` Steve Kenton
2015-03-16 18:33 ` Thomas Petazzoni
-- strict thread matches above, loose matches on Subject: below --
2015-03-17 15:07 Steve Kenton
2015-03-17 17:17 ` Yann E. MORIN
2015-03-17 18:57 Steve Kenton
2015-03-17 22:12 ` Thomas Petazzoni
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox