{ $Id$ }

         INSTALLATION and USE of the ASSEMBLER for TRAP2/3 MIMD
         by V.Angelov, angelov@kip.uni-heidelberg.de

I Installation

I.1 DOS-Windows version

Copy the two files asm_mimd.exe and asm_mimd.inc in the same directory, add
(if necessary) the directory to the PATH.

I.2 Linux version

Copy the two files asm_mimd and asm_mimd.inc in the same directory
(for example /usr/local/bin/ or ~/bin), be sure they are in the PATH.

Alternative locations of the asm_mimd.inc file:

1) if asm_mimd.inc is not copyied together with the executable, the next possible location
is specified at the beginning of the asm_mimd.pas file and provided the compiler
option -ddefinc is used by the compilation (see the Makefile).

2) the last possible location can be set with the environment variable:
export ASM_MIMD_INC='/usr/share/trapasm/asm_mimd.inc'

I.3 For both operating systems:

If you wish to have some common aliases, edit the file asm_mimd.inc. It must
remain in the same directory with the executable.


II. Use

To see how to use the assembler just enter

asm_mimd

To see the instruction set supported by the assembler just enter

asm_mimd -t |more

To compile the assembler test program enter

asm_mimd test test |more

III. Compiling

The assembler can be compiled using the Free Pascal Compiler (http://www.freepascal.org)

In order to compile the assembler for linux just execute

make clean
make

In order to compile the assembler for DOS/Win32 just execute the batch file

make_asm.bat