Details | Last modification | View Log | RSS feed
| Rev | Author | Line No. | Line | 
|---|---|---|---|
| 14 | pmbaty | 1 | //===- LegacyPassManager.h - Legacy Container for Passes --------*- 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 the legacy PassManager class.  This class is used to hold, | ||
| 10 | // maintain, and optimize execution of Passes.  The PassManager class ensures | ||
| 11 | // that analysis results are available before a pass runs, and that Pass's are | ||
| 12 | // destroyed when the PassManager is destroyed. | ||
| 13 | // | ||
| 14 | //===----------------------------------------------------------------------===// | ||
| 15 | |||
| 16 | #ifndef LLVM_IR_LEGACYPASSMANAGER_H | ||
| 17 | #define LLVM_IR_LEGACYPASSMANAGER_H | ||
| 18 | |||
| 19 | #include "llvm/Support/CBindingWrapping.h" | ||
| 20 | |||
| 21 | namespace llvm { | ||
| 22 | |||
| 23 | class Function; | ||
| 24 | class Pass; | ||
| 25 | class Module; | ||
| 26 | |||
| 27 | namespace legacy { | ||
| 28 | |||
| 29 | // Whether or not -debug-pass has been specified. For use to check if it's | ||
| 30 | // specified alongside the new PM. | ||
| 31 | bool debugPassSpecified(); | ||
| 32 | |||
| 33 | class PassManagerImpl; | ||
| 34 | class FunctionPassManagerImpl; | ||
| 35 | |||
| 36 | /// PassManagerBase - An abstract interface to allow code to add passes to | ||
| 37 | /// a pass manager without having to hard-code what kind of pass manager | ||
| 38 | /// it is. | ||
| 39 | class PassManagerBase { | ||
| 40 | public: | ||
| 41 | virtual ~PassManagerBase(); | ||
| 42 | |||
| 43 |   /// Add a pass to the queue of passes to run.  This passes ownership of | ||
| 44 |   /// the Pass to the PassManager.  When the PassManager is destroyed, the pass | ||
| 45 |   /// will be destroyed as well, so there is no need to delete the pass.  This | ||
| 46 |   /// may even destroy the pass right away if it is found to be redundant. This | ||
| 47 |   /// implies that all passes MUST be allocated with 'new'. | ||
| 48 | virtual void add(Pass *P) = 0; | ||
| 49 | }; | ||
| 50 | |||
| 51 | /// PassManager manages ModulePassManagers | ||
| 52 | class PassManager : public PassManagerBase { | ||
| 53 | public: | ||
| 54 | |||
| 55 | PassManager(); | ||
| 56 | ~PassManager() override; | ||
| 57 | |||
| 58 | void add(Pass *P) override; | ||
| 59 | |||
| 60 |   /// run - Execute all of the passes scheduled for execution.  Keep track of | ||
| 61 |   /// whether any of the passes modifies the module, and if so, return true. | ||
| 62 | bool run(Module &M); | ||
| 63 | |||
| 64 | private: | ||
| 65 |   /// PassManagerImpl_New is the actual class. PassManager is just the | ||
| 66 |   /// wraper to publish simple pass manager interface | ||
| 67 | PassManagerImpl *PM; | ||
| 68 | }; | ||
| 69 | |||
| 70 | /// FunctionPassManager manages FunctionPasses. | ||
| 71 | class FunctionPassManager : public PassManagerBase { | ||
| 72 | public: | ||
| 73 |   /// FunctionPassManager ctor - This initializes the pass manager.  It needs, | ||
| 74 |   /// but does not take ownership of, the specified Module. | ||
| 75 | explicit FunctionPassManager(Module *M); | ||
| 76 | ~FunctionPassManager() override; | ||
| 77 | |||
| 78 | void add(Pass *P) override; | ||
| 79 | |||
| 80 |   /// run - Execute all of the passes scheduled for execution.  Keep | ||
| 81 |   /// track of whether any of the passes modifies the function, and if | ||
| 82 |   /// so, return true. | ||
| 83 |   /// | ||
| 84 | bool run(Function &F); | ||
| 85 | |||
| 86 |   /// doInitialization - Run all of the initializers for the function passes. | ||
| 87 |   /// | ||
| 88 | bool doInitialization(); | ||
| 89 | |||
| 90 |   /// doFinalization - Run all of the finalizers for the function passes. | ||
| 91 |   /// | ||
| 92 | bool doFinalization(); | ||
| 93 | |||
| 94 | private: | ||
| 95 | FunctionPassManagerImpl *FPM; | ||
| 96 | Module *M; | ||
| 97 | }; | ||
| 98 | |||
| 99 | } // End legacy namespace | ||
| 100 | |||
| 101 | // Create wrappers for C Binding types (see CBindingWrapping.h). | ||
| 102 | DEFINE_STDCXX_CONVERSION_FUNCTIONS(legacy::PassManagerBase, LLVMPassManagerRef) | ||
| 103 | |||
| 104 | } // End llvm namespace | ||
| 105 | |||
| 106 | #endif |