Rivanna offers multiple compiler bundles for C, C++, and Fortran. Different compilers have different strengths and weaknesses and different error messaging and debugging features, so users should be willing to try another one when appropriate. The modules system manages the compiler environment and ensures that only compatible libraries are available for loading.
Many users of compiled languages are working with codes that can employ MPI for multinode parallel runs. MPI users should first understand how their chosen compiler works, then see the MPI instructions at our parallel programming page.
Compiled languages can be more difficult to debug, and the assistance of a good debugger can be essential. Descriptions of debuggers available on Rivanna can be found at our debuggers and utilities page.
Available Compilers on Rivanna
| Module |
Category |
Description |
| aria2 |
compiler |
aria2 is a lightweight multi-protocol & multi-source, cross platform download utility operated in command-line. It supports HTTP/HTTPS, FTP, SFTP, BitTorrent and Metalink. |
| gcc |
compiler |
The GNU Compiler Collection includes front ends for C, C++, Objective-C, Fortran, Java, and Ada,
as well as libraries for these languages (libstdc++, libgcj,...). |
| intel-compilers |
compiler |
Intel C, C++ & Fortran compilers (classic and oneAPI) |
| llvm |
compiler |
The LLVM Core libraries provide a modern source- and target-independent
optimizer, along with code generation support for many popular CPUs
(as well as some less common ones!) These libraries are built around a well
specified code representation known as the LLVM intermediate representation
("LLVM IR"). The LLVM Core libraries are well documented, and it is
particularly easy to invent your own language (or port an existing compiler)
to use LLVM as an optimizer and code generator. |
| ocaml |
compiler |
OCaml is an industrial-strength programming language supporting functional, imperative and object-oriented styles |
| pgi |
compiler |
C, C++ and Fortran compilers from The Portland Group - PGI |
Gnu Compiler
The Gnu Compiler Collection compilers are free, open-source tools. Additional tools included are the gdb debugger and the gprof performance profiler. For detailed documentation, visit the Gnu website.
The compilers are:
- Fixed-format Fortran: gfortran [options] filename.f
- Free-format Fortran: gfortran [options] filename.f90
- C: gcc [options] filename.c
- C++: g++ [options] filename.cpp or g++ [options] filename.cxx
A list of compiler options can be obtained by invoking the compiler with the -help option. For example: gfortran -help
More information is available from the manpage, e.g.:
man g++
The default Gnu compilers on Rivanna are typically fairly old. Newer versions can be invoked through an appropriate module. For available versions, please run
module spider gcc
It is important to load the correct module if you want to use more advanced features available in newer standards, particularly for C++ and Fortran.
module load gcc
It may be necessary to use an older compiler for programs using GPGPUs. The gcccuda module will load the correct version.
Available Gnu Compilers
| Module | Version |
Module Load Command |
|---|
| gcc | 11.2.0 |
module load gcc/11.2.0
|
| gcc | 12.2.0 |
module load gcc/12.2.0
|
| gcc | 7.1.0 |
module load gcc/7.1.0
|
| gcc | 9.2.0 |
module load gcc/9.2.0
|
| gcc | system |
module load gcc/system
|
Intel Compiler
The Intel Linux Fortran and C/C++ compilers are for x86-64 processor-based systems running Linux. These compilers have specific optimizations for Intel architectures. The University has floating network licenses for the Intel compiler suite as well as for the Math Kernel Libraries.
For detailed information, review the documentation on the Intel C/C++ and Fortran compiler website.
The Intel compilers are accessed on the Rivanna cluster by using the modules software to dynamically set the appropriate environmental variables (e.g. PATH and LD_LIBRARY_PATH). To initialize your environment to use the Intel compilers, use the command:
module load intel
- Fortran fixed format: ifort [options] filename.f
- Fortran free format: ifort [options] filename.f90
- C: icc [options] filename.c
- C++: icpc [options] filename.cpp or: icpc [options] filename.cxx
A list of compiler options can be obtained by invoking the compiler with the -help option, e.g.:
ifort -help
or by accessing the manpage, e.g.
man ifort
To see the available versions, run
module spider intel
Then load the appropriate module, in this case the default version
module load intel
Available Intel Compilers
| Module | Version |
Module Load Command |
|---|
| intel | 18.0 |
module load intel/18.0
|
| intel | 20.0 |
module load intel/20.0
|
| intel | 2022.11 |
module load intel/2022.11
|
Important note for Fortran programmers: Nearly all Fortran code must be compiled with the flag -heap-arrays added or it will encounter a segmentation violation.
If you still experience segmentation violations, recompile with -g -CB (for debugging and bounds checking respectively) and run the program under the control of a debugger. Once the program is debugged, be sure to remove the -g and certainly the -CB flags and recompile with -O or -O -ipo. If that works, try -O3 or -O3 -ipo for a higher level of optimization.
If mathematical libraries are needed, we strongly recommend the Intel Math Kernel Libraries (MKL). They provide LAPACK, BLAS, and a number of other libraries. They are highly optimized, especially for Intel architecture, and they automatically work with the compiler. The Intel module for any version loads the MKL that is compatible with that compiler. The module script sets an environment variable MKL_DIR (with MKLROOT as a synonym). This variable can be used in scripts and makefiles. For example, in a [mM]akefile: LIBS=-L$(MKLROOT).
The MKL consists of a number of libraries, and which ones to link is not always obvious. In newer Intel compilers a flag -mkl can be added for both compiler and linker. However, that does not always suffice, so Intel provides a link line advisor at their site. Remember that default integers are 32 bits even on 64-bit systems. The MKL bundled with our compiler suite includes ScaLAPACK.
The Intel compiler should also be used, along with its companion Intel MPI, for Intel Many-Integrated Core systems. To compile for MIC architectures use the flag -xMIC-AVX512 on your compile line.
NVIDIA CUDA Compiler
The NVIDIA HPC SDK C, C++, and Fortran compilers support GPU acceleration of HPC modeling and simulation applications with standard C++ and Fortran, OpenACC directives, and CUDA.
NVIDIA CUDA compilers are accessed on the HPC cluster by using modules to dynamically set the appropriate environmental variables (e.g. PATH and LD_LIBRARY_PATH). To initialize your environment to use the CUDA compilers, use the command
module load cuda
or
module load nvhpc
Available NVIDIA CUDA Compilers
| Module | Version |
Module Load Command |
|---|
| cuda | 11.4.2 |
module load gcc/11.2.0 cuda/11.4.2
|
| cuda | 11.0.228 |
module load gcc/9.2.0 cuda/11.0.228
|
| cuda | 10.1.168 |
module load cuda/10.1.168
|
| cuda | 10.2.89 |
module load cuda/10.2.89
|
| cuda | 11.0.228 |
module load cuda/11.0.228
|
| cuda | 11.4.2 |
module load cuda/11.4.2
|
| cuda | 12.2.2 |
module load cuda/12.2.2
|
| Module | Version |
Module Load Command |
|---|
| nvhpc | 21.9 |
module load nvhpc/21.9
|
Please see here for details.
PGI Compiler
The PGI Server Compilers and tools are licensed for Linux systems.
PGI compilers are accessed on the HPC cluster by using modules to dynamically set the appropriate environmental variables (e.g. PATH and LD_LIBRARY_PATH). To initialize your environment to use the PGI compilers, use the command
module load pgi
Available PGI Compilers
| Module | Version |
Module Load Command |
|---|
| pgi | 19.10 |
module load pgi/19.10
|
After you have modified your environment to access the PGI compilers, you can invoke the compiler on a source code file in one of the following ways.
- Fortran fixed format: pgf77 or pgf90 [options] filename.f
- Fortran free format: pgf90 [options] filename.f90
- C: pgcc [options] filename.c
- C++: pgc++ [options] filename.cpp or pgCC [options] filename.cxx
A list of compiler options can be obtained by invoking the compiler with the -help option, e.g.: pgf90 –help
More information is available from the manpage, e.g.: man pgf90
PGI provides a very capable debugger, pgdbg. In its default mode, it is graphical, and it requires that an X server run on the user’s local desktop machine. It may be run in command-line mode with the -text option; see the manpage for a full list of options. As with all debuggers, the user’s program must be compiled with the -g flag in order to enable debugging. If you wish to use the graphical debugger and do not have or want to install an X11 server, you can also use FastX. Another option for a graphical debugger is TotalView.
The PGI compilers are particularly strong in their support of OpenACC for programming NVIDIA GPGPUs.
Building on Rivanna
For more information about building your code on Rivanna, please see our howto.
