From culberts@hplwbc.hpl.hp.com Wed Apr  4 13:16:18 1990
Date: Wed, 4 Apr 90 10:15:24 pdt
From: Bruce Culbertson <culberts@hplwbc.hpl.hp.com>
To: budd@bu-it
Subject: tools: 1 of 4

This is one of four parts of a distribution of tools for the National
Semiconductor Series 32000 microprocessors.  The tools consist of an
assembler, linker and library utilities similar to Unix's as, ld, ar,
ranlib, and nm.  See the file doc/manual.txt for a list of tools and
descriptions of what they do and how to run them.

Installation Notes

Although bugs surely remain, these tools have been built and used
extensively on Hewlett-Packard's HP-UX and Amdahl's UTS implementations
of the Unix System V operating system.  They also have been used on a
National 32016 system running the Minix operating system.  They have
been used somewhat less extensively with MSDOS after compiling with the
Microsoft version 5 C compiler.  To build them on MSDOS, #define the
variable MSDOS and rename the file include/a.out.h to include/a_out.h.
There are known problems in MSDOS if segment sizes in relocatable files
exceed 64k bytes.  The assembler and linker have been compiled and
tested minimally on the MacIntosh using the Lightspeed C compiler.

The linker by default relocates the data segment to the next page
following the text segment.  On my system, the logical page size is 1k
bytes.  The NS32532 cannot accommodate a 1k page size; #define NS32532
to change the page size to 4k bytes.  You can #define the macro NATIVE
on machines which store the most significant byte of a word at the
lowest address.  This eliminates conversions between big and little
endian formats, leaving the code endian-dependent but faster.  NATIVE
configuration has received minimal testing.  (Actually, I #define'd
NATIVE recently and verified that it did NOT work.  Have not had time
to debug it.  WBC)

