This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Fix language referring to GitHub issue tracker in various places
[perl5.git] / README.synology
index 652f0f9..1fde18c 100644 (file)
@@ -16,31 +16,33 @@ businesses and homes.
 The NAS systems are equipped with Synology Disk Storage Manager (DSM),
 which is a trimmed-down Linux system enhanced with several tools for
 managing the NAS. There are several flavours of hardware: Marvell
-Armada (ARMv5te, ARMv7l), Intel Atom (i686, x86_64), Freescale QorIQ
+Armada (ARMv5tel, ARMv7l), Intel Atom (i686, x86_64), Freescale QorIQ
 (PPC), and more. For a full list see the
-L<Synology FAQ|http://forum.synology.com/wiki/index.php/What_kind_of_CPU_does_my_NAS_have>.
+L<Synology FAQ|https://forum.synology.com/wiki/index.php/What_kind_of_CPU_does_my_NAS_have>.
 
 Since it is based on Linux, the NAS can run many popular Linux
 software packages, including Perl. In fact, Synology provides a
-ready-to-install package for Perl, albeit version 5.8.6 which should
-be considered very old.
+ready-to-install package for Perl, depending on the version of DSM
+the installed perl ranges from 5.8.6 on DSM-4.3 to 5.24.0 on DSM-6.1.
 
 There is an active user community that provides many software packages
 for the Synology DSM systems; at the time of writing this document
-they provide Perl version 5.8.8.
+they provide Perl version 5.24.1.
 
 This document describes various features of Synology DSM operating
 system that will affect how Perl 5 (hereafter just Perl) is
 configured, compiled and/or runs. It has been compiled and verified by
 Johan Vromans for the Synology DS413 (QorIQ), with feedback from
-H.Merijn Brand (DS213, ARMv5te).
+H.Merijn Brand (DS213, ARMv5tel and RS815, Intel Atom x64).
 
 =head2 Setting up the build environment
 
+=head3 DSM 5
+
 As DSM is a trimmed-down Linux system, it lacks many of the tools and
 libraries commonly found on Linux. The basic tools like sh, cp, rm,
 etc. are implemented using
-L<BusyBox|http://en.wikipedia.org/wiki/BusyBox>.
+L<BusyBox|https://en.wikipedia.org/wiki/BusyBox>.
 
 =over 4
 
@@ -57,7 +59,7 @@ If you want to smoke test Perl, install C<Perl>.
 
 In Settings, add the following Package Sources:
 
-  http://www.cphub.net
+  https://www.cphub.net
   http://packages.quadrat4.de
 
 =item *
@@ -120,7 +122,8 @@ Execute the following commands:
   ln -s libm.so.6 libm.so
   ln -s libcrypt.so.1 libcrypt.so
   ln -s libdl.so.2 libdl.so
-  cd /opt/powerpc-linux-gnuspe/lib
+  cd /opt/powerpc-linux-gnuspe/lib  (or
+                                    /opt/arm-none-linux-gnueabi/lib)
   ln -s /lib/libdl.so.2 libdl.so
 
 =back
@@ -128,6 +131,21 @@ Execute the following commands:
 B<WARNING:> When you perform a system software upgrade, these links
 will disappear and need to be re-established.
 
+=head3 DSM 6
+
+Using iPkg has been deprecated on DSM 6, but an alternative is available
+for DSM 6: entware/opkg. For instructions on how to use that, please read
+L<Install Entware-ng on Synology NAS|https://github.com/Entware-ng/Entware-ng/wiki/Install-on-Synology-NAS>
+
+That sadly does not (yet) work on QorIQ. At the moment of writing, the
+supported architectures are armv5, armv7, mipsel, wl500g, x86_32, and x86_64.
+Check L<here|https://pkg.entware.net/binaries/> for supported platforms.
+
+Entware-ng comes with a precompiled 5.24.1 (June 2017) that allowes
+building shared XS code. Note that this installation does B<not> use
+a site_perl folder. The available C<cpan> works. If all required
+development packages are installed too, also for XS.
+
 =head2 Compiling Perl 5
 
 When the build environment has been set up, building and testing Perl
@@ -188,12 +206,12 @@ commit 7a8f1212e5482613c8a5b0402528e3105b26ff24.
 
 =over 4
 
-=item C<ext/DynaLoader/t/DynaLoader.t>
+=item F<ext/DynaLoader/t/DynaLoader.t>
 
 One subtest fails due to the uncommon structure of the Synology file
-system. The file C</lib/glibc.so> is missing.
+system. The file F</lib/glibc.so> is missing.
 
-B<WARNING:> Do not symlink C</lib/glibc.so.6> to C</lib/glibc.so> or
+B<WARNING:> Do not symlink F</lib/glibc.so.6> to F</lib/glibc.so> or
 some system components will start to fail.
 
 =back
@@ -249,14 +267,11 @@ the programs are run.
 
 =head1 REVISION
 
-November 2013, for Synology DSM 4.3.3810.
+June 2017, for Synology DSM 5.1.5022 and DSM 6.1-15101-4.
 
 =head1 AUTHOR
 
 Johan Vromans <jvromans@squirrel.nl>
-
-=head1 THANKS
-
 H. Merijn Brand <h.m.brand@xs4all.nl>
 
 =cut