LLVM 20.0.0git
SafepointIRVerifier.h
Go to the documentation of this file.
1//===- SafepointIRVerifier.h - Checks for GC relocation problems *- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This file defines a verifier which is useful for enforcing the relocation
10// properties required by a relocating GC. Specifically, it looks for uses of
11// the unrelocated value of pointer SSA values after a possible safepoint. It
12// attempts to report no false negatives, but may end up reporting false
13// positives in rare cases (see the note at the top of the corresponding cpp
14// file.)
15//
16//===----------------------------------------------------------------------===//
17
18#ifndef LLVM_IR_SAFEPOINTIRVERIFIER_H
19#define LLVM_IR_SAFEPOINTIRVERIFIER_H
20
21#include "llvm/IR/PassManager.h"
22
23namespace llvm {
24
25class Function;
26class FunctionPass;
27
28/// Run the safepoint verifier over a single function. Crashes on failure.
29void verifySafepointIR(Function &F);
30
31/// Create an instance of the safepoint verifier pass which can be added to
32/// a pass pipeline to check for relocation bugs.
33FunctionPass *createSafepointIRVerifierPass();
34
35/// Create an instance of the safepoint verifier pass which can be added to
36/// a pass pipeline to check for relocation bugs.
37class SafepointIRVerifierPass : public PassInfoMixin<SafepointIRVerifierPass> {
38
39public:
40 explicit SafepointIRVerifierPass() = default;
41
43
44 static bool isRequired() { return true; }
45};
46}
47
48#endif // LLVM_IR_SAFEPOINTIRVERIFIER_H
#define F(x, y, z)
Definition: MD5.cpp:55
This header defines various interfaces for pass management in LLVM.
A container for analyses that lazily runs them and caches their results.
Definition: PassManager.h:253
A set of analyses that are preserved following a run of a transformation pass.
Definition: Analysis.h:111
Create an instance of the safepoint verifier pass which can be added to a pass pipeline to check for ...
PreservedAnalyses run(Function &F, FunctionAnalysisManager &AM)
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
void verifySafepointIR(Function &F)
Run the safepoint verifier over a single function. Crashes on failure.
FunctionPass * createSafepointIRVerifierPass()
Create an instance of the safepoint verifier pass which can be added to a pass pipeline to check for ...
A CRTP mix-in to automatically provide informational APIs needed for passes.
Definition: PassManager.h:69