README revision 1.13 
1$NetBSD: README,v 1.13 2018/09/09 19:17:21 palle 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
12gzip
13
14=====
15
16NetBSD:
17
18* _NETBSD_SOURCE is *not* to be defined/pulled in during compat/tools builds.
19  compat_defs.h will error out if it finds it defined. 
20
21HP-UX:
22
23* zlib must be available.
24  This will be fixed in the future to include zlib in libnbcompat.
25
26=====
27
28LINUX:
29
30* Tested on RedHat Linux 7.1 (i386).
31  Tested on RedHat Linux 7.3 (i686) on 16 Sep 2002.  Requires "LANG=C"
32  in the environment.
33
34* Tested on Redhat Linux 8.0 (i686) in Fall 2003. Requires no special settings.
35
36* Tested on Redhat ES3 and AS3 in spring of 2004. Requires no special settings.
37
38* The gcc (and libstdc++, if needed) package must be installed, along
39  with the typical system development packages (glibc-devel, etc.).
40
41* The ncurses-devel package must be installed (for nbinfo).
42
43* The zlib and zlib-devel packages must be installed.  This will be
44  fixed in the future to include zlib in libnbcompat.
45
46=====
47
48MACOS
49  Requires a case sensitive filesystem such as UFS
50
51* Tested on 10.2.8 with Dec 2002 Developer Tools
52    - may require a fix to /usr/bin/join, netbsd's join should work fine
53* Tested on 10.3 with xcode 1.5
54    - compiles fine out of the box
55
56=====
57
58NETBSD (earlier releases):
59
60* Tested on NetBSD 1.5.2 (machine-independently).
61
62* Should need no special setup.
63
64=====
65
66SOLARIS:
67
68(updated instruction for Solaris 11 further below)
69
70* Tested on Solaris/x86 8 (5.8) with gcc 2.95.2 and Solaris/sparc 8 (5.8)
71  with gcc 3.2 (not yet tested with SUNWspro).
72
73* $HOST_CC needs to be set properly (for gcc, it should be set to "gcc",
74  otherwise the improper /usr/ucb/cc may be invoked by accident).
75
76* The SUNWzlib package (or a built version of zlib visible to $HOST_CC,
77  such as SMCzlib from sunfreeware.com) must be installed.  This will be
78  fixed in the future to include zlib in libnbcompat.
79
80* Needs the following paths, in this order, in $PATH:
81
82      /usr/xpg4/bin
83      /usr/ccs/bin
84      <path to host C and C++ compilers>
85      /usr/bin
86
87  /usr/ucb may optionally be placed before /usr/bin, per your preference,
88  but /usr/ucb *MUST NOT* be before /usr/ccs/bin or before the path to
89  the host C and C++ compilers.
90
91Solaris 11:
92
93* Solaris 11.3
94 * Set PATH to /usr/xpg6/bin:/usr/xpg4/bin:/usr/bin
95 * Set HOST_CC to /usr/bin/gcc
96
97* Solaris 11.4
98 * Install gcc-5 since the default installed gcc-7 has issues when compiling 
99   toolchain version of groff (hypot())
100 * Set PATH to /usr/xpg7/bin:/usr/xpg6/bin:/usr/xpg4/bin:/usr/bin
101 * set HOST_CC to /usr/gcc/5/bin/gcc
102 * set HOST_CXX to /usr/gcc/5/bin/g++
103