How tuoreste/evaluating-necessary-instrumentation-for-verification works
This repository evaluates MPI verification instrumentation: MPI test programs are compiled and instrumented with CoVer, then executed to observe race violations; the minimizer removes memory callbacks one at a time and records which removals preserve detection. A separate LLVM pass lists or removes callbacks by ID. The README documents interactive CoVer use, while the sampled scripts show the automated IR, linking, and minimization workflow. The sampled code does not establish that the custom pass is wired into that workflow, so no such connection is asserted.
Main entry points: cover_ir.py CoVer IR driver · minimize.py Callback minimizer · RemoveCallbacks.cpp RemoveCallbacks pass · link_ir.py IR linker
Components 14
MPI test inputs
- MPI test programs
tests
Instrumentation and IR
- CoVer IR driver
scripts/cover/cover_ir.py - Instrumented LLVM IR
results - IR linker
scripts/cover/link_ir.py - IR link launcher
scripts/cover/link_ir.sh
Execution and minimization
- Instrumented MPI program
results - Callback minimizer
scripts/minimize.py - Evaluation results
results
Callback analysis
- RemoveCallbacks pass
pass/src/RemoveCallbacks.cpp - Callback ID file
Other components
- Engineer
- CoVer toolchain
- MPI runtime
- LLVM opt
Connections 16
- Engineer → MPI test programs: selects tests
README.md - Engineer → CoVer IR driver: runs instrumentation
README.md - CoVer IR driver → MPI test programs: compiles
scripts/cover/cover_ir.py - CoVer IR driver → CoVer toolchain: invokes instrumentation
scripts/cover/cover_ir.py - CoVer IR driver → Instrumented LLVM IR: writes IR
scripts/cover/cover_ir.py - CoVer IR driver → IR linker: invokes linker
scripts/cover/cover_ir.py - IR linker → Instrumented LLVM IR: reads IR
scripts/cover/link_ir.py - IR linker → Instrumented MPI program: links executable
scripts/cover/link_ir.py - Engineer → Callback minimizer: runs minimization
scripts/minimize.py - Callback minimizer → IR link launcher: rebuilds trials
scripts/minimize.py - Callback minimizer → MPI runtime: runs trials
scripts/minimize.py - Callback minimizer → Evaluation results: writes minimized IR and summary
scripts/minimize.py - Engineer → RemoveCallbacks pass: runs LLVM pass
- LLVM opt → RemoveCallbacks pass: loads plugin
pass/src/RemoveCallbacks.cpp - RemoveCallbacks pass → Instrumented LLVM IR: scans callbacks
pass/src/RemoveCallbacks.cpp - RemoveCallbacks pass → Callback ID file: reads removal IDs
pass/src/RemoveCallbacks.cpp