Home | History | Annotate | Line # | Download | only in compat
README revision 1.13
      1 $NetBSD: README,v 1.13 2018/09/09 19:17:21 palle 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 
     12 gzip
     13 
     14 =====
     15 
     16 NetBSD:
     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 
     21 HP-UX:
     22 
     23 * zlib must be available.
     24   This will be fixed in the future to include zlib in libnbcompat.
     25 
     26 =====
     27 
     28 LINUX:
     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 
     48 MACOS
     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 
     58 NETBSD (earlier releases):
     59 
     60 * Tested on NetBSD 1.5.2 (machine-independently).
     61 
     62 * Should need no special setup.
     63 
     64 =====
     65 
     66 SOLARIS:
     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 
     91 Solaris 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