README revision 1.14
11.14Scjep$NetBSD: README,v 1.14 2021/05/06 07:32:15 cjep Exp $
21.1Stv
31.1StvSpecial notes for cross-hosting a NetBSD build on certain platforms.  
41.1StvOnly those platforms which have been tested to complete a "build.sh" run
51.1Stvare listed.
61.7Slukem
71.10SjmcAll hosts must have a POSIX compatible sh. /bin/sh is assumed unless 
81.10Sjmcotherwise set. This can be overridden by setting HOST_SH in the environment.
91.10Sjmc
101.10SjmcIn addition all hosts must provide the following local tools:
111.14Scjep  gzip
121.14Scjep  gcc
131.14Scjep  g++
141.14Scjep  zlib and headers (this requirement may be dropped in future)
151.10Sjmc
161.14ScjepFreeBSD
171.14Scjep=======
181.10Sjmc
191.14Scjepbuild.sh was recently tested on FreeBSD 13 with the compiler tools installed.
201.1Stv
211.14ScjepLinux
221.1Stv=====
231.1Stv
241.14Scjepbuild.sh has been tested on:
251.14Scjep* Amazon Linux 2 (x86)
261.14Scjep* Debian 10 (x86)
271.14Scjep* Red Hat Enterprise Linux 8 (x86)
281.14Scjep* SUSE Enterprise Server 15 (x86)
291.14Scjep* Ubuntu Server 20.04 (x86)
301.14Scjep
311.14Scjep* The gcc and g++ package must be installed, along with the typical system 
321.14Scjep  development packages (glibc-devel, etc.). The g++ package is sometimes 
331.14Scjep  called gcc-c++.
341.1Stv
351.14Scjep* The ncurses-devel package must be installed (for nbinfo).
361.12Sjmc
371.14Scjep* The zlib and zlib-devel packages must be installed (these are
381.14Scjep  called zlib1g and zlib1g-dev on Debian and Ubuntu Linux)
391.1Stv
401.14ScjepmacOS/Darwin
411.14Scjep============
421.1Stv
431.14Scjepbuild.sh was recently tested on macOS Big Sur with an APFS filesystem
441.14Scjepand the Xcode command line tools. (Previously, there have been issues
451.14Scjepbuilding on case-insensitive HFS filesystems.)
461.9Sdbj
471.14ScjepHP-UX
481.9Sdbj=====
491.9Sdbj
501.14Scjep* zlib must be available.
511.1Stv
521.14ScjepNetBSD (earlier releases)
531.14Scjep=========================
541.1Stv
551.1Stv* Tested on NetBSD 1.5.2 (machine-independently).
561.1Stv* Should need no special setup.
571.14Scjep* _NETBSD_SOURCE is *not* to be defined/pulled in during compat/tools builds.
581.14Scjep  compat_defs.h will error out if it finds it defined. 
591.1Stv
601.14ScjepSolaris
611.14Scjep=======
621.1Stv
631.13Spalle(updated instruction for Solaris 11 further below)
641.13Spalle
651.4Sthorpej* Tested on Solaris/x86 8 (5.8) with gcc 2.95.2 and Solaris/sparc 8 (5.8)
661.4Sthorpej  with gcc 3.2 (not yet tested with SUNWspro).
671.1Stv
681.1Stv* $HOST_CC needs to be set properly (for gcc, it should be set to "gcc",
691.1Stv  otherwise the improper /usr/ucb/cc may be invoked by accident).
701.1Stv
711.4Sthorpej* The SUNWzlib package (or a built version of zlib visible to $HOST_CC,
721.4Sthorpej  such as SMCzlib from sunfreeware.com) must be installed.  This will be
731.4Sthorpej  fixed in the future to include zlib in libnbcompat.
741.1Stv
751.1Stv* Needs the following paths, in this order, in $PATH:
761.1Stv
771.5Sthorpej      /usr/xpg4/bin
781.4Sthorpej      /usr/ccs/bin
791.4Sthorpej      <path to host C and C++ compilers>
801.4Sthorpej      /usr/bin
811.4Sthorpej
821.4Sthorpej  /usr/ucb may optionally be placed before /usr/bin, per your preference,
831.4Sthorpej  but /usr/ucb *MUST NOT* be before /usr/ccs/bin or before the path to
841.4Sthorpej  the host C and C++ compilers.
851.13Spalle
861.13SpalleSolaris 11:
871.13Spalle
881.13Spalle* Solaris 11.3
891.13Spalle * Set PATH to /usr/xpg6/bin:/usr/xpg4/bin:/usr/bin
901.13Spalle * Set HOST_CC to /usr/bin/gcc
911.13Spalle
921.13Spalle* Solaris 11.4
931.13Spalle * Install gcc-5 since the default installed gcc-7 has issues when compiling 
941.13Spalle   toolchain version of groff (hypot())
951.13Spalle * Set PATH to /usr/xpg7/bin:/usr/xpg6/bin:/usr/xpg4/bin:/usr/bin
961.13Spalle * set HOST_CC to /usr/gcc/5/bin/gcc
971.13Spalle * set HOST_CXX to /usr/gcc/5/bin/g++
98