Note: The recommended way to call the assembler is to use the driver to call the assembler. Do not call the assembler directly.
The syntax for the Macro Assembler is:
asmcore [options] [input_files]
The Macro Assembler combines each specified ASCII input_file and produces a single output object module.
As an option, a listing is written to the standard output file. A number of options may be specified except where the default is not to perform the function enabled by the option.
-g Outputs line number debug information. This allows MULTI to
debug assembly code. This should only be used for hand-coded assembly language files; compiler-generated assembly language files have their own debug information.
-Idir Searches directory dir for files specified in .include directives.
-list[,[pagelength][,pagewidth][=][file]
Enables the source listing. A page length and page width can be specified for the source listing. If either value is omitted, the defaults are used. If only one comma and one value are used (e.g. -list,80=foo), that value will be the page length and the default page width is used. The default page length is 64, and the default page width is 132.
If = is specified but file is not specified, then the listing is displayed on the standard output. If =file is specified, then the listing is written to file. If neither = nor file are specified, then the listing file is written to a file with a .lst extension, replacing the current extension (e.g. .s).
-list Save listing to .lst file with default page length and
-list,80 Save listing to .lst file with page length of 80 and
-list=trax Save listing to file trax with default page length and
-list,,110 Save listing to .lst file with default page length and
Save listing to file trax with default page length
-list= Display listing on standard output with default
-nogen Disables source listing of macro expansions.
-o file Sets the name of the output module to file. The default is the name of the assembly language file with a .o extension. For example, foo.o is produced for foo.s.
-r Prints a listing of symbol names in alphabetical order.
-ref Prints a full cross reference of the symbols in alphabetical order, including the symbol name, type, file and line defined, and file and line of each usage.
-V Prints the Macro Assembler version number to the standard output.
The following Macro Assembler command line produces an object file example.o with DWARF 1.1 line number debugging information from the assembler source file example.s:
% asmcore -g example.s -o example.o