1 //===- ScopedNoAliasAA.h - Scoped No-Alias Alias Analysis -------*- C++ -*-===//
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
7 //===----------------------------------------------------------------------===//
10 /// This is the interface for a metadata-based scoped no-alias analysis.
12 //===----------------------------------------------------------------------===//
14 #ifndef LLVM_ANALYSIS_SCOPEDNOALIASAA_H
15 #define LLVM_ANALYSIS_SCOPEDNOALIASAA_H
17 #include "llvm/Analysis/AliasAnalysis.h"
18 #include "llvm/IR/PassManager.h"
19 #include "llvm/Pass.h"
28 /// A simple AA result which uses scoped-noalias metadata to answer queries.
29 class ScopedNoAliasAAResult : public AAResultBase<ScopedNoAliasAAResult> {
30 friend AAResultBase<ScopedNoAliasAAResult>;
33 /// Handle invalidation events from the new pass manager.
35 /// By definition, this result is stateless and so remains valid.
36 bool invalidate(Function &, const PreservedAnalyses &,
37 FunctionAnalysisManager::Invalidator &) {
41 AliasResult alias(const MemoryLocation &LocA, const MemoryLocation &LocB,
43 ModRefInfo getModRefInfo(const CallBase *Call, const MemoryLocation &Loc,
45 ModRefInfo getModRefInfo(const CallBase *Call1, const CallBase *Call2,
49 bool mayAliasInScopes(const MDNode *Scopes, const MDNode *NoAlias) const;
52 /// Analysis pass providing a never-invalidated alias analysis result.
53 class ScopedNoAliasAA : public AnalysisInfoMixin<ScopedNoAliasAA> {
54 friend AnalysisInfoMixin<ScopedNoAliasAA>;
56 static AnalysisKey Key;
59 using Result = ScopedNoAliasAAResult;
61 ScopedNoAliasAAResult run(Function &F, FunctionAnalysisManager &AM);
64 /// Legacy wrapper pass to provide the ScopedNoAliasAAResult object.
65 class ScopedNoAliasAAWrapperPass : public ImmutablePass {
66 std::unique_ptr<ScopedNoAliasAAResult> Result;
71 ScopedNoAliasAAWrapperPass();
73 ScopedNoAliasAAResult &getResult() { return *Result; }
74 const ScopedNoAliasAAResult &getResult() const { return *Result; }
76 bool doInitialization(Module &M) override;
77 bool doFinalization(Module &M) override;
78 void getAnalysisUsage(AnalysisUsage &AU) const override;
81 //===--------------------------------------------------------------------===//
83 // createScopedNoAliasAAWrapperPass - This pass implements metadata-based
84 // scoped noalias analysis.
86 ImmutablePass *createScopedNoAliasAAWrapperPass();
88 } // end namespace llvm
90 #endif // LLVM_ANALYSIS_SCOPEDNOALIASAA_H