summaryrefslogtreecommitdiff
path: root/Build/source/doc/README.solaris
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-04-27 18:01:36 +0000
committerKarl Berry <karl@freefriends.org>2015-04-27 18:01:36 +0000
commitf4740ad774eb166db34dcc0edf9c79cb7006c7ca (patch)
tree2ec7fa976155d5053599f8c40ffa4c9c4694bbf4 /Build/source/doc/README.solaris
parent274ff8ac2225aae653807b8aed904f334dfbc6f8 (diff)
README.solaris: move to doc/ subdir, public domain, a couple words about configure
git-svn-id: svn://tug.org/texlive/trunk@37077 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/doc/README.solaris')
-rw-r--r--Build/source/doc/README.solaris103
1 files changed, 103 insertions, 0 deletions
diff --git a/Build/source/doc/README.solaris b/Build/source/doc/README.solaris
new file mode 100644
index 00000000000..7aa91d76f96
--- /dev/null
+++ b/Build/source/doc/README.solaris
@@ -0,0 +1,103 @@
+(This file public domain. Originally written by Mojca Miklavec, 2015.)
+
+Compiling TeX binaries on Solaris
+
+(The document describes the procedures used on Sparc Solaris binaries,
+but the same rules should apply to i386 and x86_64 as well.)
+
+Solaris 9 has been out of official support for a while and making
+software compile on that platform is challenging, so it hardly make any
+sense to try to support it.
+
+Solaris 10 reaches end of support in January 2021:
+ http://en.wikipedia.org/wiki/Solaris_(operating_system)#Version_history
+and TeX Live binaries try to stay compatible with that OS version.
+
+Every once in a while a new Update is shipped:
+ U1 2006-01
+ U2 2006-06
+ U3 2006-11
+ U4 2007-08
+ U5 2008-05
+ U6 2008-10
+ U7 2009-05
+ U8 2009-10
+ U9 2010-09
+ U10 2011-08
+ U11 2013-01
+and the problem is that binaries compiled on an updated system might not
+run on an older one.
+
+You can check the libc version with
+> pvs -no /usr/lib/libc.so
+
+> pvs -d /lib/libc.so.1 | grep SUNW
+ SUNW_1.23;
+ SUNW_1.22.7;
+ SUNW_1.22.6;
+ /.../
+ SUNW_1.1;
+ SUNW_0.9;
+ SUNW_0.8;
+ SUNW_0.7;
+
+Building wget
+=============
+
+Building wget on the latest version of Solaris 10 will make the binary
+useless on older Updates of Solaris 10 as it would depend on SUNW_1.22.7.
+
+One option to build wget in a "compatible way" would be to build it on
+Solaris 9 with "cc". The other hack is the usage of map files.
+
+To make it work on older systems the following hack was used (thanks to
+the OpenCSW community):
+ https://buildfarm.opencsw.org/source/xref/opencsw/csw/mgar/pkg/wget/trunk/files/map.wget
+
+> cat mapfile
+libc.so - SUNW_1.22.5 SUNWprivate_1.1 $ADDVERS=SUNW_1.22.5;
+
+export LD_OPTIONS="-M $PWD/mapfile"
+
+And the following configuration was used to get rid of dependencies (which
+are not installed on Solaris by default):
+
+> ./configure --enable-ipv6 --disable-iri --disable-nls \
+ --disable-ntlm --disable-pcre --without-libiconv-prefix \
+ --without-libintl-prefix --without-libuuid --without-libpsl \
+ --without-ssl --without-zlib
+
+The binary was built with gcc 4.9.2.
+
+> pvs Master/tlpkg/installer/wget/wget.sparc-solaris
+ libsocket.so.1 (SUNW_1.4);
+ libnsl.so.1 (SUNW_1.7);
+ librt.so.1 (SUNW_1.2);
+ libc.so.1 (SUNW_1.22.5, SUNWprivate_1.1);
+
+> ./Master/tlpkg/installer/wget/wget.sparc-solaris --version
+ GNU Wget 1.16.3 built on solaris2.10.
+ +digest -https +ipv6 -iri +large-file -nls -ntlm +opie -psl -ssl
+
+(That list of configure options is current as of the above version of
+wget; not all those dependencies are present in earlier versions.)
+
+Building xz
+===========
+
+The xz binaries would likewise depend on SUNW_1.22.6 by default, so we
+used the same hack with a map file to make it work on slightly older
+systems.
+
+> export LD_OPTIONS="-M $PWD/mapfile"
+> ./configure --disable-nls --disable-shared
+
+> pvs Master/tlpkg/installer/xz/xz.sparc-solaris
+ librt.so.1 (SUNW_1.2);
+ libpthread.so.1 (SUNW_1.2);
+ libc.so.1 (SUNW_1.22);
+> pvs Master/tlpkg/installer/xz/xzdec.sparc-solaris
+ libc.so.1 (SUNW_1.22);
+
+If users need binaries to run on even older systems, we can target what
+is desired by changing the map file.