24.05.2014 Views

XL Fortran Enterprise Edition for AIX : User's Guide - IBM

XL Fortran Enterprise Edition for AIX : User's Guide - IBM

XL Fortran Enterprise Edition for AIX : User's Guide - IBM

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

If you specify short, the Object File Map, Source File Map, and Global<br />

Symbols Map sections are included. If you specify long, the preceding<br />

sections appear in addition to the Object Resolution Warnings, Object<br />

Reference Map, Inliner Report, and Partition Map sections.<br />

If you specify the -qipa and -qlist options together, IPA generates an a.lst<br />

file that overwrites any existing a.lst file. If you have a source file named<br />

a.f, the IPA listing will overwrite the regular compiler listing a.lst. You<br />

can use the list=filename suboption to specify an alternative listing file<br />

name.<br />

lowfreq=procedure_names<br />

Specifies a list of procedures that are likely to be called infrequently during<br />

the course of a typical program run. For example, procedures <strong>for</strong><br />

initialization and cleanup might only be called once, and debugging<br />

procedures might not be called at all in a production-level program. The<br />

compiler can make other parts of the program faster by doing less<br />

optimization <strong>for</strong> calls to these procedures.<br />

missing={unknown | safe | isolated | pure}<br />

Specifies the interprocedural behavior of procedures that are not compiled<br />

with -qipa and are not explicitly named in an unknown, safe, isolated, or<br />

pure suboption. The default is to assume unknown, which greatly restricts<br />

the amount of interprocedural optimization <strong>for</strong> calls to those procedures.<br />

noinline=procedure_names<br />

Specifies a list of procedures that are not to be inlined.<br />

partition={small | medium | large}<br />

Specifies the size of the regions within the program to analyze. Larger<br />

partitions contain more procedures, which result in better interprocedural<br />

analysis but require more storage to optimize. Reduce the partition size if<br />

compilation takes too long because of paging.<br />

pdfname=[filename]<br />

Specifies the name of the profile data file containing the PDF profiling<br />

in<strong>for</strong>mation. If you do not specify a filename, the default file name is<br />

__pdf. The profile is placed in the current working directory or in the<br />

directory that the PDFDIR environment variable names. This allows the<br />

programmer to do simultaneous runs of multiple executables using the<br />

same PDFDIR. This is especially useful when tuning with PDF on<br />

dynamic libraries. (See “-qpdf Option” on page 210 <strong>for</strong> more in<strong>for</strong>mation<br />

on tuning optimizations.)<br />

pure=procedure_names<br />

Specifies a list of procedures that are not compiled with -qipa. Any<br />

procedure that you specified as “pure” must be “isolated” and “safe”. It<br />

must not alter the internal state nor have side-effects, which are defined as<br />

potentially altering any data object visible to the caller.<br />

safe=procedure_names<br />

Specifies a list of procedures that are not compiled with -qipa. Any<br />

procedure that you specified as “safe” may modify global variables and<br />

dummy arguments. No calls to procedures that are compiled with -qipa<br />

may be made from within a “safe” procedure’s call chain.<br />

stdexits | nostdexits<br />

Specifies that certain predefined routines can be optimized as with the<br />

exits suboption. The procedures are: abort, exit, _exit, and _assert.<br />

184 <strong>XL</strong> <strong>Fortran</strong> <strong>Enterprise</strong> <strong>Edition</strong> <strong>for</strong> <strong>AIX</strong> : User’s <strong>Guide</strong>

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!