tools/compat/README

   1 $NetBSD: README,v 1.12 2005/04/05 00:21:22 jmc 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 * Tested on Solaris/x86 8 (5.8) with gcc 2.95.2 and Solaris/sparc 8 (5.8)
  69   with gcc 3.2 (not yet tested with SUNWspro).
  70
  71 * $HOST_CC needs to be set properly (for gcc, it should be set to "gcc",
  72   otherwise the improper /usr/ucb/cc may be invoked by accident).
  73
  74 * The SUNWzlib package (or a built version of zlib visible to $HOST_CC,
  75   such as SMCzlib from sunfreeware.com) must be installed.  This will be
  76   fixed in the future to include zlib in libnbcompat.
  77
  78 * Needs the following paths, in this order, in $PATH:
  79
  80       /usr/xpg4/bin
  81       /usr/ccs/bin
  82       <path to host C and C++ compilers>
  83       /usr/bin
  84
  85   /usr/ucb may optionally be placed before /usr/bin, per your preference,
  86   but /usr/ucb *MUST NOT* be before /usr/ccs/bin or before the path to
  87   the host C and C++ compilers.