Usage
To use the Cray wrappers with the PGI compilers, the PrgEnv-pgi module should be loaded:
module avail PrgEnv
module swap PrgEnv-pgi PrgEnv-pgi # this loads some version of pgi, currently 15.7.0
To just use the PGI compilers directly, just load the pgi module you want:
module avail pgi
module load pgi/15.7.0 # Note that this does not changed the Cray wrappers.
It is possible to use the PGI compiler versions directly without loading the Cray Programming Environments, but note that the Cray wrappers will probably not work as expected if you do that.
It is best to review the pgcc, pgCC, and pgf90 man pages for a list of their options.
C/C++ Options
The following options control the amount of debugging information generated by the compiler. They can adversely affect optimization.
| Option |
Description |
| -g |
Generates symbolic debug information. Turns off optimization. |
| -Mbounds |
Adds array bound checking. |
For most cases, the usual levels of optimization are appropriate (-O0, -O1, -O2 [default], -O3). Here are a few exceptions.
| Option |
Description |
| -fast |
Chooses generally optimal flags for the target platform. Use pgcc -fast -help to see the equivalent switches. Note this sets the optimization level to a minimum of 2; see -O. |
| -fastsse |
Chooses generally optimal flags for a processor that supports the streaming SIMD extensions (SSE) (Pentium 3/4, AthlonXP/MP, Opteron) and SSE2 (Pentium 4, Opteron) instructions. Use pgcc -fastsse -help to see the equivalent switches. |
| -tp barcelona-64 |
Targets optimization to the 64-bit Opteron quad-core processor. |
| -Mflushz |
Sets SSE to flush-to-zero mode. |
| -pg, -Mprof |
Instrument program for profiling. These flags imply different types of profiling. |
| -Minfo |
Generates an optimization report to standard error. This has several suboptions, so check the man page. |
| -mp=nonuma |
Enables the compiler to generate multithreaded code based on the OpenMP directives. Use the nonuma suboption when linking with the Cray wrappers. |
Fortran Options
The following options control how source files are translated into machine code.
| Option |
Description |
| -M fixed |
The source code uses fixed-form syntax, as in Fortran 77. This option is on by default for source files ending in .f, .F, .for, and .fpp. |
| -M free |
The source code uses free-form syntax, introduced in Fortran 90. This option is on by default for source files ending in .f90, .F90, .f95, .F95. |
| -F |
This option preprocesses each file and leaves the output in a file named file.f for each file named file.F. |
| -i8 |
This option treats INTEGER variables as 8 bytes. For operations involving integers, uses 64 bits for computations. |
| -r8 |
This option interprets REAL variables as DOUBLE PRECISION. Equivalent to using the options -Mr8 and -Mr8intrinsics. |
The following options control the amount of debugging information generated by the compiler. They can adversely affect optimization.
| Option |
Description |
| -g |
Generates symbolic debugging information. Turns off optimization. |
| -Mbounds |
Adds array bound checking. |
| -Mchkptr |
Checks for unintended dereferencing of null pointers. |
For most cases, the usual levels of optimization are appropriate (-O0, -O1, -O2 [default], -O3). Here are a few exceptions.
| Option |
Description |
| -fast |
Chooses generally optimal flags for the target platform. Use pgf90 -fast -help to see the equivalent switches. Note this sets the optimization level to a minimum of 2; see -O. |
| -fastsse |
Chooses generally optimal flags for a processor that supports the SSE (Pentium 3/4, AthlonXP/MP, Opteron) and SSE2 (Pentium 4, Opteron) instructions. Use pgf90 -fastsse -help to see the equivalent switches. |
| -Mflushz |
Sets SSE to flush-to-zero mode. -pg, |
| -Mprof |
Instrument program for profiling. These flags imply different types of profiling. |
| -Minfo |
Generates an optimization report to standard error. This has several suboptions, so check the man page. |
| -Mlist |
Generates a listing file. |
| -mp=nonuma |
Enables the compiler to generate multithreaded code based on the OpenMP directives. Use the nonuma suboption when linking with the Cray wrappers. |
The following information is available by running module help pgi
----------- Module Specific Help for 'pgi/15.7.0' -----------------
PGI 15.7.0
===========
Purpose:
--------
Features of PGI 15.7.0 are documented at:
http://www.pgroup.com/doc/pgirn157.pdf
Documentation:
--------------
Documentation for PGI 15.7.0 is in /opt/pgi/15.7.0/linux86-64/15.7/doc/
PGI User's Guide, pgi15ug.pdf
PGI Fortran Reference, pgifortref.pdf
PGI CUDA Fortran Guide, pgicudaforug.pdf
PGI 15.7 Release Notes, pgirn157.pdf
PGI 15.7 Installation Guide, pgiinstall157.pdf
Modulefile:
-----------
module load pgi/15.7.0
Making Default:
---------------
To make this the default version, execute:
/opt/admin-pe/set_default_files/set_default_pgi_15.7.0
Certain components, files or programs contained within this package or product are Copyright -2015 Cray Inc. All rights reserved.
