Cpp - Nintendo Ultra64 Programmer's Manual

Introduction
20
The rspasm assembler outputs several special files. The root filename for
these files can be specified with the -o flag.
• <rootname>, is the binary executable code (text section). This file
can be loaded into the RSP simulator instruction memory (IMEM)
and executed.
• <rootname>.dat, is the binary data section. This is usually
loaded into RSP data memory (DMEM).
• <rootname>.lst, is a text program listing generated by the
assembler.
• <rootname>.sym, is a "symbol file" used by the RSP simulator to
perform source level debugging.
• <rootname>.dbg, is a "symbol file" used by the rsp2elf utility
in order to build an ELF object that can be used with makerom and
the gvd debugger.
The RSP assembler has no provisions for linking separately-compiled
objects. Since IMEM only holds 1024 instructions and assembling is so fast,
the lack of a sophisticated linker is not a problem. Source code can be broken
up into separate files and #include'd to enforce modularity.
Facilities to support dynamic linking, such as code overlays, are provided by
the buildtask tool.

cpp

By default, rspasm invokes the C preprocessor (/usr/bin/cc -E,
actually) before assembly so that source code can use #define,
#include, #ifdef, etc.
Like other MIPS assemblers, rspasm defines _LANGUAGE_ASSEMBLY
(useful for sharing header files with C programs).