ompparser: A Standalone and Unified OpenMP Parser

ompparser is a standalone OpenMP parser for C/C++ and Fortran. It can be used as an independent tool or embedded into compiler pipelines. The Flex/Bison grammar parses OpenMP directives and builds an intermediate representation (IR) that supports normalization and round-trip unparsing. The implementation tracks OpenMP 6.0 constructs and is released under the BSD-3-Clause license.

Build and Usage

1. clone the repo and configure a build directory

   git clone https://github.com/ouankou/ompparser.git
   cmake -S ompparser -B build -DCMAKE_BUILD_TYPE=Release
   

2. build and install

   cmake --build build
   cmake --install build --prefix /path/to/install
   

3. run the regression tests (requires Flex and Bison in PATH)

   cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug
   cmake --build build --target check
   

omparser API

enum OpenMPBaseLang {
    Lang_C,
    Lang_Cplusplus,
    Lang_Fortran,
    Lang_unknown
};

class OpenMPClause : public SourceLocation {
 ...
}
 
class OpenMPDirective : public SourceLocation  {
 ...
}

extern  OpenMPDirective * parseOpenMP(const char *, void * exprParse(const char * expr));

Features and Limitation

1. OpenMP 6.0 standard support for both C/C++ and Fortran, including parsing and unparsing
2. Flex lexer rules and Bison grammars for OpenMP 6.0 syntax
3. Intermediate representation of OpenMP constructs
4. Interface to parse OpenMP constructs and emit the OpenMP IR
5. Syntax checking in grammar, parsing, IR construction, and post-parsing
6. Clause normalization, e.g., combining multiple shared clauses into one shared clause
7. Limited semantics checking when a construct uses C/C++/Fortran identifiers or expressions
8. Testing driver and test cases for OpenMP constructs
9. DOT graph output of OpenMP constructs
10. Conversion between perfectly-nested OpenMP constructs and combined constructs (ongoing work)

Contribution

Submit contribution as github pull request to this repository. We require all new contributions must be made with the similar license.

Getting Involved and Technical Support

Submit feature request, bugs and questions from the repository's "Issues" tab.

Acknowledgement

The work has been performed with support from Department of Energy Lawrence Livermore National Laboratory and the National Science Foundation. To cite, please use following paper:

Anjia Wang, Yaying Shi, Xinyao Yi, Yonghong Yan, Chunhua Liao and Bronis R. de Supinski, ompparser: A Standalone and Unified OpenMP Parser, the 15th International Workshop on OpenMP (IWOMP), 11th - 13th September, in Auckland, New Zealand. The presentation of the paper, which is from IWOMP'19 website.

Authors

Anjia Wang, Yaying Shi, Xinyao Yi, Yonghong Yan, Chunhua Liao and Bronis R. de Supinski

Contact

Please contact Yonghong Yan (@yanyh15) from github or gmail.

License

ompparser is released under a BSD license. For more details see the file LICENSE.

LLNL-CODE-798101