Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

diag-file, Qdiag-file

Causes the results of diagnostic analysis to be output to a file.

Syntax

Linux:

-diag-file[=filename]

Windows:

/Qdiag-file[:filename]

Arguments

filename

Is the name of the file for output.

Default

OFF

Diagnostic messages are output to stderr.

Description

This option causes the results of diagnostic analysis to be output to a file. The file is placed in the current working directory.

You can include a file extension in filename. For example, if file.txt is specified, the name of the output file is file.txt. If you do not provide a file extension, the name of the file is filename.diag.

If filename is not specified, the name of the file is name-of-the-first-source-file.diag. This is also the name of the file if the name specified for file conflicts with a source file name provided in the command line.

NOTE:

If you specify the [Q]diag-file option and you also specify the [Q]diag-file-append option, the last option specified on the command line takes precedence.

IDE Equivalent

Visual Studio: Diagnostics > Diagnostics File

Alternate Options

None

Example

The following example shows how to cause diagnostic analysis to be output to a file named my_diagnostics.diag:

-diag-file=my_diagnostics       ! Linux systems
/Qdiag-file:my_diagnostics      ! Windows systems

See Also