This option instructs the compiler to output the disassembly of the machine code generated by the compiler to a file.

Unlike the --asm option, object modules are not generated. The name of the assembly output file defaults to filename.s in the current directory, where filename is the name of the source file stripped of any leading directory names. The default filename can be overridden with the -o option.

You can use armasm to assemble the output file and produce object code. The compiler adds ASSERT directives for command-line options such as AAPCS variants and byte order to ensure that compatible compiler and assembler options are used when reassembling the output. You must specify the same AAPCS settings to both the assembler and the compiler.