x86 Assembly Language Reference Manual

Assembler Command Line Options

-b

Enable Sun SourceBrowser.

-Dname
-Dname=def

When the -P option is in effect, these options are passed to the cpp preprocessor without interpretation by the as command; otherwise, they are ignored.

-Ipath

When the -P option is in effect, this option is passed to the cpp preprocessor without interpretation by the as command; otherwise, it is ignored.

-K {pic.PIC}

Generate position-independent code.

-L

Save all symbols, including temporary labels that are normally discarded to save space, in the ELF symbol table.

-m

This new option runs m4 macro preprocessing on input. The m4 preprocessor is more powerful than the C preprocessor (invoked by the -P option), so it is more useful for complex preprocessing. See the SunOS 5.x Reference Manual for x86 for a detailed description of the m4 macro-processor.

-o outfile

Takes the next argument as the name of the output file to be produced. By default, the .s suffix, if present, is removed from the input file and the .o suffix is appended to form the output file name.

-P

Run cpp, the C preprocessor, on the files being assembled. The preprocessor is run separately on each input file, not on their concatenation. The preprocessor output is passed to the assembler.

-Q[y|n]

This new option produces the "assembler version" information in the comment section of the output object file if the y option is specified; if the n option is specified, the information is suppressed.

-s

This new option places all stabs in the .stabs section. By default, stabs are placed in stabs.excl sections, that are stripped out by the static linker ld during final execution. When the -s option is used, stabs remain in the final executable because .stab sections are not stripped out by the static linker ld.

-S [[aAbBcClL]]

Produce a disassembly of the emitted code to the standard output. Adding the character to the S option:

a - disassembling with address

b - disassembling with '.bof'

c - disassembling with comments (default)

l - disassembling with line numbers

Capital letters turn switch off for corresponding option

-T

This is a migration option for 4.1 assembly files to be assembled on 5.0 systems. With this option, the symbol names in 4.1 assembly files will be interpreted as 5.0 symbol names.

-Uname

When the -P option is in effect, this option is passed to the cpp preprocessor without interpretation by the as command; otherwise, it is ignored.

-V

This option writes the version information on the standard error output.

-xF

Generates additional information for performance analysis of the executable using WorkShop (SPARC-works) analyzer. If the input file does not contain any stabs (debugging directives), then the assembler will generate some default stabs which are needed by the SPARCworks analyzer.