PGI User's Guide

Chapter 2. Using Command Line OptionsUsing –helpThe –help option is useful because it provides information about all options supported by a given compiler.You can use –help in one of three ways:• Use –help with no parameters to obtain a list of all the available options with a brief one-line descriptionof each.• Add a parameter to –help to restrict the output to information about a specific option. The syntax for thisusage is this:–help Suppose you use the following command to restrict the output to information about the -fast option:$ pgfortran -help -fastThe output you see is similar to this:-fast Common optimizations; includes -O2 -Munroll=c:1 -Mnoframe -MlreIn the following example, we add the –help parameter to restrict the output to information about thehelp command. The usage information for –help shows how groups of options can be listed or examinedaccording to function.$ pgfortran -help -help-help[=groups|asm|debug|language|linker|opt|other|overall|phase|prepro|suffix|switch|target|variable]Show compiler switches• Add a parameter to –help to restrict the output to a specific set of options or to a building process. Thesyntax for this usage is this:-help=By using the command pgfortran -help -help, as previously shown, we can see output that showsthe available subgroups. You can use the following command to restrict the output on the –help commandto information about only the options related to only one group, such as debug information generation.$ pgfortran -help=debugThe output you see is similar to this:Debugging switches:-M[no]bounds Generate code to check array bounds-Mchkfpstk Check consistency of floating point stack at subprogram calls(32-bit only)-Mchkstk Check for sufficient stack space upon subprogram entry-Mcoff Generate COFF format object-Mdwarf1 Generate DWARF1 debug information with -g-Mdwarf2 Generate DWARF2 debug information with -g-Mdwarf3 Generate DWARF3 debug information with -g-Melf Generate ELF format object-g Generate information for debugger-gopt Generate information for debugger without disablingoptimizationsFor a complete description of subgroups, refer to the “–help” description in the Command Line OptionsReference chapter of the PGI Compiler Reference Manual.19