User manual

Building VAX MP
82
Cross-building x86 version of VAX MP with no network support on x64 Linux systems is possible,
but requires installation of 32-bit version of glibc, with appropriate development header files
(package libcx-dev or glibc-devel, depending on your edition of Linux). For simplicity, we suggest
to build 32-bit version of VAX MP under 32-bit Linux and then copy produced executable file to
64-bit Linux system.
Building VAX MP on OS X
XCode comes with GCC-LLVM compiler. We advise against the use of GCC-LLVM since simulator
produced by it is about 2x less performant than compiled with regular GCC compiler.
Accordingly, VAX MP build files are not even set up for LLVM. Unfortunately OS X or XCode do
not ship with regular GCC included, so to build VAX MP under OS X you need either to obtain
existing prebuilt GCC or build and install GCC on your machine.
VAX MP had been tested under OS X with GCC 4.7.0. We recommend using either this or higher
version of the compiler.
Convert project files from DOS (CR-LF) format to Unix (LF) format by executing the following
commands. The first two commands in the sequence (perl and mv) can be skipped if file
d2u.sh
is intact and are required only if
d2u.sh had been inadvertently converted during project
transfer (such as FTP) to DOS format and fails to run. You can copy these commands from the
comment at the top of
d2u.sh and paste them into Terminal shell prompt.
perl -p -e 's/(\r\n|\n|\r)/\n/g' d2u.sh >d2u.tmp
mv -f d2u.tmp d2u.sh
chmod a+x d2u.sh
./d2u.sh
To build VAX MP, execute in the project’s directory (assuming g++-470 is the name of your
private-built GCC executable):
chmod a+x *.sh
export OSTYPE
CXX=g++-470
export CXX
./mk.sh x64 {dbg|rel} {nonet|shr} [tap] [vde] rebuild
For example:
./mk.sh x64 rel shr tap rebuild
Options meaning is as follows:
x64 selects target processor architecture (32-bit x86 mode is not supported)
dbg|rel selects debug or release build