ACC - Astaroth Code Compiler
ACC is a source-to-source compiler for generating CUDA kernels from programs written in Astaroth Code (AC). This document focuses on how to build and run the compiler. For detailed description of code generation and compilation phases, we refer the reader to J. Pekkilä, Astaroth: A Library for Stencil Computations on Graphics Processing Units. 2019., Section 4.3. We refer the reader to Specification for a detailed description of AC syntax.
ACC is automatically compiled and invoked when compiling the Astaroth Library, user intervention is not needed. The instructions presented in this file are only for developers looking to debug the AC compiler.
Dependencies
gcc flex bison
Building
mkdir buildcd buildcmake ..make -j
Usage
Script compile_acc_module.sh executes all compilation stages from preprocessing to linking AC standard libraries. The resulting cuda headers are placed in the current working directory. The script should be invoked as follows.
./compile_acc_module <a directory containing AC files>
For preprocessing only, see preprocess.sh. The first parameter is regarded as the AC source file, while rest of the parameters are passed to gcc. For example:
./preprocess.sh file.ac -I dir
Preprocesses file.ac and searches dir for files to be included.
For invoking the code generator, pass preprocessed files that respect AC syntax to acc.
For example:
acc < file.ac.preprocessed
See Building on how to obtain acc.