README revision 1.14 
1$NetBSD: README,v 1.14 2021/05/06 07:32:15 cjep Exp $
2
3Special notes for cross-hosting a NetBSD build on certain platforms.  
4Only those platforms which have been tested to complete a "build.sh" run
5are listed.
6
7All hosts must have a POSIX compatible sh. /bin/sh is assumed unless 
8otherwise set. This can be overridden by setting HOST_SH in the environment.
9
10In addition all hosts must provide the following local tools:
11  gzip
12  gcc
13  g++
14  zlib and headers (this requirement may be dropped in future)
15
16FreeBSD
17=======
18
19build.sh was recently tested on FreeBSD 13 with the compiler tools installed.
20
21Linux
22=====
23
24build.sh has been tested on:
25* Amazon Linux 2 (x86)
26* Debian 10 (x86)
27* Red Hat Enterprise Linux 8 (x86)
28* SUSE Enterprise Server 15 (x86)
29* Ubuntu Server 20.04 (x86)
30
31* The gcc and g++ package must be installed, along with the typical system 
32  development packages (glibc-devel, etc.). The g++ package is sometimes 
33  called gcc-c++.
34
35* The ncurses-devel package must be installed (for nbinfo).
36
37* The zlib and zlib-devel packages must be installed (these are
38  called zlib1g and zlib1g-dev on Debian and Ubuntu Linux)
39
40macOS/Darwin
41============
42
43build.sh was recently tested on macOS Big Sur with an APFS filesystem
44and the Xcode command line tools. (Previously, there have been issues
45building on case-insensitive HFS filesystems.)
46
47HP-UX
48=====
49
50* zlib must be available.
51
52NetBSD (earlier releases)
53=========================
54
55* Tested on NetBSD 1.5.2 (machine-independently).
56* Should need no special setup.
57* _NETBSD_SOURCE is *not* to be defined/pulled in during compat/tools builds.
58  compat_defs.h will error out if it finds it defined. 
59
60Solaris
61=======
62
63(updated instruction for Solaris 11 further below)
64
65* Tested on Solaris/x86 8 (5.8) with gcc 2.95.2 and Solaris/sparc 8 (5.8)
66  with gcc 3.2 (not yet tested with SUNWspro).
67
68* $HOST_CC needs to be set properly (for gcc, it should be set to "gcc",
69  otherwise the improper /usr/ucb/cc may be invoked by accident).
70
71* The SUNWzlib package (or a built version of zlib visible to $HOST_CC,
72  such as SMCzlib from sunfreeware.com) must be installed.  This will be
73  fixed in the future to include zlib in libnbcompat.
74
75* Needs the following paths, in this order, in $PATH:
76
77      /usr/xpg4/bin
78      /usr/ccs/bin
79      <path to host C and C++ compilers>
80      /usr/bin
81
82  /usr/ucb may optionally be placed before /usr/bin, per your preference,
83  but /usr/ucb *MUST NOT* be before /usr/ccs/bin or before the path to
84  the host C and C++ compilers.
85
86Solaris 11:
87
88* Solaris 11.3
89 * Set PATH to /usr/xpg6/bin:/usr/xpg4/bin:/usr/bin
90 * Set HOST_CC to /usr/bin/gcc
91
92* Solaris 11.4
93 * Install gcc-5 since the default installed gcc-7 has issues when compiling 
94   toolchain version of groff (hypot())
95 * Set PATH to /usr/xpg7/bin:/usr/xpg6/bin:/usr/xpg4/bin:/usr/bin
96 * set HOST_CC to /usr/gcc/5/bin/gcc
97 * set HOST_CXX to /usr/gcc/5/bin/g++
98