GNU Autoconf is a tool for producing configure scripts for building, installing and packaging software on computer systems where a Bourne shell is available.
configure script takes options, which set variables in the makefile. The following table illustrates some common options encountered.
| ||Directory to install the code into|| |
| ||Setting environment variable, commonly used for compiler|| |
| ||Enable || |
| ||Use optional package || |
| ||Lists all options to |
variable=VALUE option is almost always necessary at NERSC, because configure scripts usually cannot find the compiler wrappers.
./configure CC=cc CXX=CC FC=ftn F77=ftn
A hypothetical configure line using additional options could look something like this:
./configure --prefix=$CFS/m1234/myapp --enable-mpi --with-fftw-dir=$FFTW_ROOT CC=cc MPICC=cc CFLAGS="-O3 -Wall"
A typical Makefile looks something like this:
TARGET = test LIBS = CC = cc CFLAGS = -g -Wall -qopenmp .PHONY: default all clean default: $(TARGET) all: default OBJECTS = $(patsubst %.c, %.o, $(wildcard *.c)) HEADERS = $(wildcard *.h) %.o: %.c $(HEADERS) $(CC) $(CFLAGS) -c $< -o $@ .PRECIOUS: $(TARGET) $(OBJECTS) $(TARGET): $(OBJECTS) $(CC) $(CFLAGS) $(OBJECTS) -Wall $(LIBS) -o $@ clean: -rm -f *.o -rm -f $(TARGET)
The basic concept behind Makefiles is that there is a file known as a makefile that controls how the code is compiled into object files and linked. Within the makefile, the name of the compiler, compiler flags, and other settings are made. For more information about Makefiles, please see the Software Carpentry tutorial on Makefiles.
Many codes have a build system that uses a build tool such as autoconf or CMake to customize the makefile with the proper settings. Still other codes depend on the user to directly edit the makefile to add the proper settings by hand. The file to be edited is usually named
Sometimes a code will provide pre-populated custom makefiles for common platforms, e.g.,
Makefile.perlmutter, that can be used directly, either by renaming the file to
Makefile or entering the name of the file into the main makefile. If something like this is the case for your code, instructions may be available in a file which is often called
If the code does not have a custom Makefile for this platform, then you will need to edit the Makefile. Read the compilation instructions. For some codes, we edit the file
Makefile; in others there may be a file called
Make.inc. It really depends on the way the developers set it up.
In the appropriate file, there are likely macros (think of these as variables) set up for the names of the compilers and compiler flags. In addition, there may be macros for the include directories, link directories, and libraries used by the code. You can leave many of these latter macros blank, especially those pertaining to MPI.
MPI codes distributed via make have lines like
CC = mpicc. In most cases it is sufficient to change these lines to
CC = cc.
You will commonly need to set the compiler to be invoked. Unless the code does not use MPI and is meant to be run on a login node, use the Cray compiler wrappers
ftn as the C, C++, and Fortran compilers, respectively. You may want to use optimizations, which are specific to the compiler invoked by the compiler wrapper. Please see the pages on compilers for specifics.
Especially if you are compiling a C or C++ code, you may need to set a macro that is often named
INCLUDEDIR to point to directories where header files (referenced like
#include <file.h> within the code) are located.