NAME

m11 − Macro-11 assembler for UNIX

SYNTAX

m11 [ option... ] file... 

DESCRIPTION

The m11 command assembles the concatenation of each specified file and terminates when an .end statement is encountered.  The resulting object file is usually named  filen.obj (see below).  If a file argument, filei does not contain a “.” in its name, the file filei.m11 will be sought before filei itself. 

OPTIONS

Options, if desired, may appear anywhere in the command and are chosen from the following list.  All options are interpreted before any files are read. 

−ls Produce an assembly listing and place in filen.lst

−lt Produce an assembly listing on the standard output. 

−fl If coupled with the −ls or −lt directives, makes the listing have a shortened format.  It is shorthand for −nl:seq:loc:bin:bex:me:meb:ttm:toc:sym. 

−uc Simulate an initial .dsabl lc directive.  Force all characters in macro definitions to be upper case.  This flag makes lower-case handling in m11 compatible with the DEC Macro-11 assemblers. 

−um Force all characters in macro definitions to be upper case.  This flag makes lower-case handling in this release of m11 compatible with previous versions of m11. 

−de Make all option choices needed to make assembly mimic DEC Macro-11.  Implies (inter alia) the −uc flag.  This includes the Johns Hopkins asm assembler. 

−ha Make all option choices needed to make assembly mimic earlier (Harvard) releases of m11.  This implies the −um flag.  Default .psect and .csect attributes are set up according to the Harvard syntax. 

−mx Produce a listing of the source program as it appears after macro expansion.  Macro calls, conditional directives and so on appear in the listing as comments.  Listing appears on standard output.  No machine code is generated or listed.  This option is meant to correspond to the −E or −P options of the C compiler cc(1). 

−my Like −mx, except that macro calls and conditional directives do not show up in the listing. 

−10 Generate an error whenever op codes not in the PDP-11 standard instruction set are encountered.  Programmers writing for a PDP 11/10 can catch instructions illegal for that machine by using this argument. 

−dp:args
The default attributes for a are redefined, using  the colon-separated list args of valid .psect attributes. 

−da:args
The default attributes for an

−dp:c The default attributes for a named are redefined. 

−li:arglist
Simulate an initial directive. All .list and .nlist directives in the program text which attempt to change the settings established with the .B −li flag will be ignored. .TP −nl:arglist Like −li:arglist, but for the .nlist directive.  .TP −en:arglist Similarly, for the .enabl directive.  .TP −ds:arglist Similarly, but for the .dsabl directive.  .TP −cr:arglist Produces a cross-reference listing.  If the .B −ls option is also included, the cross-reference listing will follow the assembly listing in .IR filen .lst.  References which are tagged with the symbol # are definitions.  References tagged with * are destructive references: the value of the symbol or variable in question is changed.  The .I arglist consists of colon-separated keywords from the following set.  The keywords may be prefix abbreviated: .RS .TP sym All user-defined symbols are indexed.  .TP mac All macro names are indexed.  .TP per All uses of permanent symbols − op codes, directives, etc − are indexed.  .TP pse All psect names are indexed.  For compatibility with the RT-11 .I CREF program, the argument .I cse is synonymous with .I pse.  .TP err All errors are indexed.  .TP reg All register uses are indexed.  .PP If no .I arglist is specified the default .B "sym:mac:err" is used.  In the listing page and line numbers for uses of symbols are followed by a # sign if the symbol is defined and by a * sign if the symbol is modified.  .RE .TP .B −lp Same as −ls, but also spools .IR filen .lst for printing upon completion. .TP .B −no No object file is produced.  This is useful for syntax checking or list producing. .TP −xs:n Allots nK words of extra space for symbol table and macro storage.  NOTE: This option is currently inoperative: .B m11 automatically allots core for its tables as needed.  .TP .B −xx Debug flag: generate verbose debug statements. .TP .B −ns No symbol table is included in the object file (thus ddt knows of no symbols from this assembly). .TP .B −sx Make the symbol table contain local symbols as well as ordinary symbols. .TP .B −u Treat form feed characters as spaces.  This will make the .B m11 idea of line numbers coincide with the UNIX text editors. Macro-11 statements containing embedded form feed characters will be parsed differently when the .B −u flag is in effect. .TP −na:file Override the convention of using last name as file name.  Instead, use names .I file.obj and .I file.lst for object and listing files.  .SH FILES .ta 2.5i /usr/lib/sysmac.sml system macro library  (for .mcall directive) .br filen.xrf intermediate cross-reference  temporary file .br lpr(1) spooler .br /usr/ucb/macxrf cross-reference post-processor .SH SEE ALSO .I PDP-11 MACRO-11 Language Reference Manual .br .I New UCB M11 Manual