/FA, /Fa (Listing File)

2017-06-05

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at /FA, /Fa (Listing File).

Creates a listing file containing assembly code.

Syntax

/FA[c|s|u]  
/Fapathname

Remarks

The arguments control the generation of source code and machine code and the extension of the listing file.

The following table describes the various values to /FA. It is possible to specify more than one value to /FA. For example, you can specify /FAsu.

Option	Listing contents and file extension
/FA	Assembly code; .asm
/FAc	Machine and assembly code; .cod
/FAs	Source and assembly code; .asm If /FAcs is specified, the file extension will be .cod
/FAu	Causes the output file to be created in UTF-8 format, with a byte order marker. By default, the file encoding is ANSI, but use /FAu if you want a listing file that displays correctly on any system, or if you are using Unicode source code files as input to the compiler. If /FAsu is specified, and if a source code file uses Unicode encoding other than UTF-8, then the code lines in the .asm file may not display correctly.

By default, the listing file gets the same base name as the source file. You can change the name of the listing file and the directory where it is created using the /Fa option.

/Fa usage	Result
/Fa	One source_file.asm is created for each source code file in the compilation.
/Fa filename	filename.asm is placed in the current directory. Only valid when compiling a single source code file.
/Fa filename.extension	filename.extension is placed in the current directory. Only valid when compiling a single source code file.
/Fa directory\	One source_file.asm is created and placed in the specified directory for each source code file in the compilation. Note the required trailing backslash. Only paths on the current disk are allowed.
/Fa directory\filename	filename.asm is placed in the specified `directory`. Only valid when compiling a single source code file.
/Fa directory\filename.extension	filename.extension is placed in the specified `directory`. Only valid when compiling a single source code file.

To set this compiler option in the Visual Studio development environment

Open the project's Property Pages dialog box. For details, see Setting Visual C++ Project Properties.
Click the C/C++ folder.
Click the Output Files property page.
Modify the ASM List Location (/Fa) or Assembler Output (/FA) property (/FAu must be specified in the Command Line property page, Additional Options box..

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

Share via