- Description
- Version
- Status
- Prerequisites
- Building Gino
- Testing Gino
- Repository structure
- Projects built upon Gino
- Contributions
- License
- Logo
Gino is a parallelizing compiler for LLVM IR. Gino is built upon NOELLE, VIRGIL, and LLVM.
We release Gino's source code in the hope of benefiting others. You are kindly asked to acknowledge usage of the tool by citing the following paper:
@inproceedings{NOELLE,
title={{NOELLE} {O}ffers {E}mpowering {LL}VM {E}xtensions},
author={Angelo Matni and Enrico Armenio Deiana and Yian Su and Lukas Gross and Souradip Ghosh and Sotiris Apostolakis and Ziyang Xu and Zujun Tan and Ishita Chaturvedi and David I. August and Simone Campanoni},
booktitle={International Symposium on Code Generation and Optimization, 2022. CGO 2022.},
year={2022}
}
The only documentation available for Gino is:
- a video introducing NOELLE and Gino
- the paper
- the comments within the code
- the slides we use in the class Advanced Topics in Compilers
The latest stable version is 14.1.0 (tag = v14.1.0).
The version number is in the form of [v Major.Minor.Revision ]
- Major: Each major version matches a specific LLVM version (e.g., version 9 matches LLVM 9, version 11 matches LLVM 11)
- Minor: Starts from 0, each minor version represents either one or more API replacements/removals that might impact the users OR a forced update every six months (the minimum minor update frequency)
- Revision: Starts from 0; each revision version may include bug fixes or incremental improvements
- Major: Matches the LLVM releases on a best-effort basis
- Minor: At least once per six months, at most once per month (1/month ~ 2/year)
- Revision: At least once per month, at most twice per week (2/week ~ 1/month)
Next is the status of Gino for different LLVM versions.
| LLVM | Gino's branch | NOELLE's branch | Regression tests failed out of 31087 tests | Performance tests failed out of 23 tests | Latest version | Maintained |
|---|---|---|---|---|---|---|
| 14.0.6 | master | master | 614 | 0 | 14.1.0 | ✅ |
| 9.0.0 | v9 | v9 | 797 | 0 | 9.3.0 | ❌ |
- LLVM 14.0.6
- NOELLE 14.1.0
Next is the information for those that have access to the Zythos cluster at Northwestern.
To enable the correct LLVM, run the following command from any node of the Zythos cluster:
source /project/extra/llvm/14.0.6/enable
To enable the correct NOELLE, run the following command from any node of the Zythos cluster:
source /project/extra/noelle/14.1.0/enable
To build and install Gino: run make from the repository root directory.
Run make clean from the root directory to clean the repository.
Run make uninstall from the root directory to uninstall the Gino installation.
To run all tests in parallel using Condor, invoke the following commands:
make clean ;
cd tests ;
make condor ;
To monitor how tests are doing: cd tests ; make condor_watch
To find out if all tests passed: cd tests ; make condor_check
To test Gino using condor to run all tests in parallel, go to "tests" and run "make condor".
This creates one regression_X sub-directory per configuration where X is going to be a number (e.g., regression_42).
Each single test within a given regression_X sub-directory will contain a run_me.sh script, which is automatically generated by make condor.
To re-produce the compilation for a specific test for a specific configuration (e.g., the one associated with the current regression_X sub-directory), then do the following:
cd tests/regression_42 ;
cd THE_TEST_YOU_ARE_INTERESTED ;
./run_me.sh ;
where regression_42 is the sub-directory of the configuration you are interested and THE_TEST_YOU_ARE_INTERESTED is the test you care.
To run only the autotuned performance tests using Condor, invoke the following commands:
make clean ;
cd tests ;
make condor_autotuner ;
The speedup results will be collected in the tests/performance/speedups_autotuner.txt file.
The directory src includes sources of the Gino parallelizer.
Within this directory, src/core includes the analyses and transformations needed by Gino to parallelize the code.
Also, src/tools includes tools that can be used to diagnose Gino (e.g., to understand the decisions Gino made to parallelize the code).
The directory tests includes integration tests, and performance tests.
Furthermore, this directory includes the scripts to run all these tests in parallel via condor.
Finally, the directory doc includes the documentation of Gino.
Gino uses clang-format to ensure uniform styling across the project's source code.
clang-format is run automatically as a pre-commit git hook, meaning that when you commit a file clang-format is automatically run on the file in-place.
Since git doesn't allow for git hooks to be installed when you clone the repository we manage this with our top-level Makefile.
To install the Gino git hooks, run make hooks at the root of the directory.
This make rule is run at the start of the make all rule as well for ease of use.
Several projects have already been built successfully upon Gino. These projects are (in no particular order):
We welcome contributions from the community to improve this framework and evolve it to cater for more users. If you have any trouble using this framework feel free to reach out to us for help (contact [email protected]).
Gino is licensed under the MIT License.
Gino is the name of our cat we have taken home from the Tree house cat shelter when we moved to Chicago.
It was surprisingly hard to find a picture of Gino by himself.
He is always playing and cuddling with his brother Gigi like here:
A future project may or may not be called Gigi.