NAME

dsploadwrap − generate code to load a DSP linker file into the DSP
 

SYNOPSIS

dsploadwrap [ -{relative,absolute} ] [ -{ug,ap} ] [ -system ] [ -simulator ] [ -argtemplate <string> ] [ -start <address> ] [ -trace <n> ] <filename(s)>
 

DESCRIPTION

The dsploadwrap program is called by the dspwrap program.  It is normally not run by itself. 
 

OPTIONS

Each option can be abbreviated to the shortest disambiguating extent. 
 

−relative
Force treatment of input files as relative assembly. This is automatic if the filename extension is ’.lnk’ or ’.dsp’.

−absolute
Force treatment of input files as absolute assembly. This is automatic if the filename extension is ’.lod’.

−ugForce treatment of input files as unit generators.  The assembly type must be relative in this case.  Unit-generators require special structs to be output into .m and .h files which are included by the unit-generator’s Objective-C class file. 

−apForce treatment of input files as array processing macros.  Array processor input files are handled like general purpose DSP programs. 

−system
Load system code (and user code, if any). When this option is not present, only symbols and data for section USER are processed. When set, the input file is completely loaded, including anything from section SYSTEM it may have. Unless the -boot option is also present, the resulting file will be loaded into a running DSP, allowing overwriting of system memory. This is a dangerous thing to do, and it will only work if you know how to avoid clobbering state info used while downloading into the DSP.  For example, overwriting system x variables (which contain various system pointers and running status) could clobber the host interface.

−simulator
Generate a simulator host-interface file.

−argtemplate
Use <string> as the argument template. 

−start
Sets the program start address to <address>, overriding any address specified by the assembler END statement.  This option is only applicable to main programs, not unit generators. 

−trace
Sets the trace variable. To get all possible tracing, use -1.
 

SEE ALSO

dspwrap − source processor for unit-generator and array-processing macros. 
 

NeXT, Inc.  —  6 Jun 1989