Cross-hosting notes for foreign OS's. (Currently Linux, Solaris, and older

releases of NetBSD.)
This commit is contained in:
tv 2002-02-01 04:43:39 +00:00
parent f65c7d5689
commit 6bd56c8eda

67
tools/compat/README Normal file
View File

@ -0,0 +1,67 @@
$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).