Home | History | Annotate | Line # | Download | only in compat
README revision 1.14 
      1 $NetBSD: README,v 1.14 2021/05/06 07:32:15 cjep Exp $
      2 
      3 Special notes for cross-hosting a NetBSD build on certain platforms.  
      4 Only those platforms which have been tested to complete a "build.sh" run
      5 are listed.
      6 
      7 All hosts must have a POSIX compatible sh. /bin/sh is assumed unless 
      8 otherwise set. This can be overridden by setting HOST_SH in the environment.
      9 
     10 In 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 
     16 FreeBSD
     17 =======
     18 
     19 build.sh was recently tested on FreeBSD 13 with the compiler tools installed.
     20 
     21 Linux
     22 =====
     23 
     24 build.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 
     40 macOS/Darwin
     41 ============
     42 
     43 build.sh was recently tested on macOS Big Sur with an APFS filesystem
     44 and the Xcode command line tools. (Previously, there have been issues
     45 building on case-insensitive HFS filesystems.)
     46 
     47 HP-UX
     48 =====
     49 
     50 * zlib must be available.
     51 
     52 NetBSD (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 
     60 Solaris
     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 
     86 Solaris 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