1//===- llvm/CodeGen/GCMetadataPrinter.h - Prints asm GC tables --*- 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// The abstract base class GCMetadataPrinter supports writing GC metadata tables
10// as assembly code. This is a separate class from GCStrategy in order to allow
11// users of the LLVM JIT to avoid linking with the AsmWriter.
12//
13// Subclasses of GCMetadataPrinter must be registered using the
14// GCMetadataPrinterRegistry. This is separate from the GCStrategy itself
15// because these subclasses are logically plugins for the AsmWriter.
16//
17//===----------------------------------------------------------------------===//
18
19#ifndef LLVM_CODEGEN_GCMETADATAPRINTER_H
20#define LLVM_CODEGEN_GCMETADATAPRINTER_H
21
22#include "llvm/Support/Registry.h"
23
24namespace llvm {
25
26class AsmPrinter;
27class GCMetadataPrinter;
28class GCModuleInfo;
29class GCStrategy;
30class Module;
31class StackMaps;
32
33/// GCMetadataPrinterRegistry - The GC assembly printer registry uses all the
34/// defaults from Registry.
35using GCMetadataPrinterRegistry = Registry<GCMetadataPrinter>;
36
37/// GCMetadataPrinter - Emits GC metadata as assembly code. Instances are
38/// created, managed, and owned by the AsmPrinter.
39class GCMetadataPrinter {
40private:
41 friend class AsmPrinter;
42
43 GCStrategy *S;
44
45protected:
46 // May only be subclassed.
47 GCMetadataPrinter();
48
49public:
50 GCMetadataPrinter(const GCMetadataPrinter &) = delete;
51 GCMetadataPrinter &operator=(const GCMetadataPrinter &) = delete;
52 virtual ~GCMetadataPrinter();
53
54 GCStrategy &getStrategy() { return *S; }
55
56 /// Called before the assembly for the module is generated by
57 /// the AsmPrinter (but after target specific hooks.)
58 virtual void beginAssembly(Module &M, GCModuleInfo &Info, AsmPrinter &AP) {}
59
60 /// Called after the assembly for the module is generated by
61 /// the AsmPrinter (but before target specific hooks)
62 virtual void finishAssembly(Module &M, GCModuleInfo &Info, AsmPrinter &AP) {}
63
64 /// Called when the stack maps are generated. Return true if
65 /// stack maps with a custom format are generated. Otherwise
66 /// returns false and the default format will be used.
67 virtual bool emitStackMaps(StackMaps &SM, AsmPrinter &AP) { return false; }
68};
69
70} // end namespace llvm
71
72#endif // LLVM_CODEGEN_GCMETADATAPRINTER_H
73

source code of llvm/include/llvm/CodeGen/GCMetadataPrinter.h