# guide-file, Qguide-file

Causes the results of guided auto parallelism to be output to a file.

## Syntax

Linux: | -guide-file[=filename]

macOS: | -guide-file[=filename]

Windows: | /Qguide-file[:filename]

## Arguments

filename | Is the name of the file for output. It can include a path.

## Default

OFF | Messages that are generated by guided auto parallelism are output to stderr.

## Description

This option causes the results of guided auto parallelism to be output to a file.

This option is ignored unless you also specify one or more of the following options:

- [Q]guide

- [Q]guide-vec

- [Q]guide-data-trans

- [Q]guide-par

If you do not specify a path, the file is placed in the current working directory.

If there is already a file named filename, it will be overwritten.

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.guide.

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

### Note

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

## IDE Equivalent

Visual Studio: Diagnostics > Emit Guided Auto Parallelism Diagnostics to File

Diagnostics > Guided Auto Parallelism Diagnostics File

Eclipse: Compilation Diagnostics > Emit Guided Auto Parallelism diagnostics to File

Compilation Diagnostics > Guided Auto Parallelism Report File

Xcode: Diagnostics > Emit Guided Auto Parallelism diagnostics to File

Diagnostics > Guided Auto Parallelism Report File

## Alternate Options

None

## Example

The following example shows how to cause guided auto parallelism messages to be output to a file named my_guided_autopar.guide:

    -guide-file=my_guided_autopar       ! Linux and macOS systems
    /Qguide-file:my_guided_autopar      ! Windows systems

Parent topic: Advanced Optimization Options

## See Also

guide, Qguide compiler option
guide-file-append, Qguide-file-append compiler option