-F
Category
Pragma equivalent
None.
Purpose
Names an alternative configuration file or stanza for the compiler.
Note: This option is not equivalent to the -F option
that GCC provides.
Syntax
>>- -F--+-file_path--+-----------+-+--------------------------->< | '-:--stanza-' | '-:--stanza----------------'
Defaults
By default, the compiler uses the configuration file that is configured at installation time, and uses the stanza defined in that file for the invocation command currently being used.
Parameters
- file_path
- The full path name of the alternate compiler configuration file to use.
- stanza
- The name of the configuration file stanza to use for compilation. This directs the compiler to use the entries under that stanza regardless of the invocation command being used. For example, if you are compiling with xlc, but you specify the c99 stanza, the compiler will use all the settings specified in the c99 stanza.
Usage
Note that any file names or stanzas that you specify with the -F option override the defaults specified in the system configuration file. If you have specified a custom configuration file with the XLC_USR_CONFIG environment variable, that file is processed before the one specified by the -F option.
The -B, -t, and -W options override the -F option.
Predefined macros
None.
Examples
To compile myprogram.c using
a stanza called debug that you have added to the
default configuration file, enter:
xlc myprogram.c -F:debug
To
compile myprogram.c using
a configuration file called /usr/tmp/myconfig.cfg,
enter:
xlc myprogram.c -F/usr/tmp/myconfig.cfg
To
compile myprogram.c using
the stanza c99 you
have created in a configuration file called /usr/tmp/myconfig.cfg,
enter:
xlc myprogram.c -F/usr/tmp/myconfig.cfg:c99