xref: /src/tools/compat/README

$NetBSD: README,v 1.1 2002/02/01 04:43:39 tv Exp $

Special notes for cross-hosting a NetBSD build on certain platforms.  
Only those platforms which have been tested to complete a "build.sh" run
are listed.

=====

LINUX:

* Tested on RedHat Linux 7.1 (i386).

* The gcc (and libstdc++, if needed) package must be installed, along
  with the typical system development packages (glibc-devel, etc.).

* The ncurses-devel package must be installed (for nbinfo).

* The zlib and zlib-devel packages must be installed.  This will be
  fixed in the future to include zlib in libnbcompat.

* src/tools/dbsym will not build on this platform yet.  NO_DBSYM=1 may be set in
  mk.conf or the environment to cause this to be skipped during the build
  (harmless to non-embedded platforms).

=====

NETBSD (earlier releases):

* Tested on NetBSD 1.5.2 (machine-independently).

* Should need no special setup.

=====

SOLARIS:

* Tested on Solaris/x86 8 (5.8) with gcc 2.95.2 (not yet tested with
  SUNWspro).

* $HOST_CC needs to be set properly (for gcc, it should be set to "gcc",
  otherwise the improper /usr/ucb/cc may be invoked by accident).

* The SUNWxcu4 package (containing /usr/xpg4/bin/*) must be installed.

* The SUNWzlib package (or a built version of zlib visible to $HOST_CC)
  must be installed.  This will be fixed in the future to include zlib
  in libnbcompat.

* Needs the following paths, in this order, in $PATH:

      /usr/xpg4/bin:/usr/ccs/bin:/usr/bin

  (/usr/ucb may optionally be placed before /usr/bin per your preference,
  but /usr/ucb *MUST NOT* be before /usr/ccs/bin or /usr/xpg4/bin!)

* /bin/sh *MUST* be replaced with a copy of, or symlink to, either
  /bin/ksh or /usr/xpg4/bin/sh.  This will be fixed in the future to use
  /usr/xpg4/bin/sh in nbmake by default.  (Solaris's /bin/sh is broken
  in some fantastic and amazing ways.)

* Needs the "mktemp" script from src/tools/compat/scripts, made
  executable, available somewhere in $PATH.  (Solaris has no
  command-line mktemp(1).)  This may be worked around in the future.

* src/tools/dbsym will not build on this platform yet.  NO_DBSYM=1 may be set in
  mk.conf or the environment to cause this to be skipped during the build
  (harmless to non-embedded platforms).