/FA, /Fa (Listing file)

Creates a listing file containing assembler code.

Syntax

/FA[c][s][u]
/Fapathname

Remarks

The /FA compiler option generates an assembler listing file for each translation unit in the compilation, which generally corresponds to a C or C++ source file. By default, only assembler is included in the listing file, which is encoded as ANSI. The optional c, s, and u arguments to /FA control whether machine code or source code are output together with the assembler listing, and whether the listing is encoded as UTF-8.

By default, each listing file gets the same base name as the source file, and has an .asm extension. When machine code is included by using the c option, the listing file has a .cod extension. You can change the name and extension of the listing file and the directory where it's created by using the /Fa option.

/FA arguments

none
Only assembler language is included in the listing.

c
Optional. Includes machine code in the listing.

s
Optional. Includes source code in the listing.

u
Optional. Encodes the listing file in UTF-8 format, and includes a byte order marker. By default, the file is encoded as ANSI. Use u to create a listing file that displays correctly on any system, or if you're using Unicode source code files as input to the compiler.

If both s and u are specified, and if a source code file uses a Unicode encoding other than UTF-8, then the code lines in the .asm file may not display correctly.

/Fa argument

none
One source.asm file is created for each source code file in the compilation.

filename
The compiler places a listing file named filename.asm in the current directory. This argument form is only valid when compiling a single source code file.

filename.extension
The compiler places a listing file named filename.extension in the current directory. This argument form is only valid when compiling a single source code file.

directory\
The compiler creates one source_file.asm file for each source code file in the compilation. It's placed in the specified directory. The trailing backslash is required. Only paths on the current disk are allowed.

directory\filename
A listing file named filename.asm is placed in the specified directory. This argument form is only valid when compiling a single source code file.

directory\filename.extension
A listing file named filename.extension is placed in the specified directory. This argument form is only valid when compiling a single source code file.

To set this compiler option in the Visual Studio development environment

1. Open the project's Property Pages dialog box. For details, see Set C++ compiler and build properties in Visual Studio.

2. Select the Configuration Properties > C/C++ > Output Files property page.

3. Modify the Assembler Output property to set the /FAc and /FAs options for assembler, machine, and source code. Modify the Use Unicode For Assembler Listing property to set the /FAu option for ANSI or UTF-8 output. Modify the ASM List Location to set the /Fa option for listing file name and location.

Setting both Assembler Output and Use Unicode For Assembler Listing properties can cause Command-Line Warning D9025. To combine these options in the IDE, use the Additional Options field in the Command Line property page instead.

To set this compiler option programmatically

• See AssemblerListingLocation or AssemblerOutput. To specify /FAu, see AdditionalOptions.

Example

The following command line produces a combined source and machine-code listing called HELLO.cod:

CL /FAcs HELLO.CPP

See also

Output-File (/F) Options
MSVC Compiler Options
MSVC Compiler Command-Line Syntax
Specifying the Pathname