clang 20.0.0git
MicrosoftCXXABI.cpp
Go to the documentation of this file.
1//===------- MicrosoftCXXABI.cpp - AST support for the Microsoft C++ ABI --===//
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 provides C++ AST support targeting the Microsoft Visual C++
10// ABI.
11//
12//===----------------------------------------------------------------------===//
13
14#include "CXXABI.h"
16#include "clang/AST/Attr.h"
18#include "clang/AST/DeclCXX.h"
19#include "clang/AST/Mangle.h"
22#include "clang/AST/Type.h"
24
25using namespace clang;
26
27namespace {
28
29/// Numbers things which need to correspond across multiple TUs.
30/// Typically these are things like static locals, lambdas, or blocks.
31class MicrosoftNumberingContext : public MangleNumberingContext {
32 llvm::DenseMap<const Type *, unsigned> ManglingNumbers;
33 unsigned LambdaManglingNumber = 0;
34 unsigned StaticLocalNumber = 0;
35 unsigned StaticThreadlocalNumber = 0;
36
37public:
38 MicrosoftNumberingContext() = default;
39
40 unsigned getManglingNumber(const CXXMethodDecl *CallOperator) override {
41 return ++LambdaManglingNumber;
42 }
43
44 unsigned getManglingNumber(const BlockDecl *BD) override {
45 const Type *Ty = nullptr;
46 return ++ManglingNumbers[Ty];
47 }
48
49 unsigned getStaticLocalNumber(const VarDecl *VD) override {
50 if (VD->getTLSKind())
51 return ++StaticThreadlocalNumber;
52 return ++StaticLocalNumber;
53 }
54
55 unsigned getManglingNumber(const VarDecl *VD,
56 unsigned MSLocalManglingNumber) override {
57 return MSLocalManglingNumber;
58 }
59
60 unsigned getManglingNumber(const TagDecl *TD,
61 unsigned MSLocalManglingNumber) override {
62 return MSLocalManglingNumber;
63 }
64};
65
66class MSHIPNumberingContext : public MicrosoftNumberingContext {
67 std::unique_ptr<MangleNumberingContext> DeviceCtx;
68
69public:
70 using MicrosoftNumberingContext::getManglingNumber;
71 MSHIPNumberingContext(MangleContext *DeviceMangler) {
72 DeviceCtx = createItaniumNumberingContext(DeviceMangler);
73 }
74
75 unsigned getDeviceManglingNumber(const CXXMethodDecl *CallOperator) override {
76 return DeviceCtx->getManglingNumber(CallOperator);
77 }
78
79 unsigned getManglingNumber(const TagDecl *TD,
80 unsigned MSLocalManglingNumber) override {
81 unsigned DeviceN = DeviceCtx->getManglingNumber(TD, MSLocalManglingNumber);
82 unsigned HostN =
83 MicrosoftNumberingContext::getManglingNumber(TD, MSLocalManglingNumber);
84 if (DeviceN > 0xFFFF || HostN > 0xFFFF) {
86 unsigned DiagID = Diags.getCustomDiagID(
87 DiagnosticsEngine::Error, "Mangling number exceeds limit (65535)");
88 Diags.Report(TD->getLocation(), DiagID);
89 }
90 return (DeviceN << 16) | HostN;
91 }
92};
93
94class MSSYCLNumberingContext : public MicrosoftNumberingContext {
95 std::unique_ptr<MangleNumberingContext> DeviceCtx;
96
97public:
98 MSSYCLNumberingContext(MangleContext *DeviceMangler) {
99 DeviceCtx = createItaniumNumberingContext(DeviceMangler);
100 }
101
102 unsigned getDeviceManglingNumber(const CXXMethodDecl *CallOperator) override {
103 return DeviceCtx->getManglingNumber(CallOperator);
104 }
105};
106
107class MicrosoftCXXABI : public CXXABI {
108 ASTContext &Context;
109 llvm::SmallDenseMap<CXXRecordDecl *, CXXConstructorDecl *> RecordToCopyCtor;
110
111 llvm::SmallDenseMap<TagDecl *, DeclaratorDecl *>
112 UnnamedTagDeclToDeclaratorDecl;
113 llvm::SmallDenseMap<TagDecl *, TypedefNameDecl *>
114 UnnamedTagDeclToTypedefNameDecl;
115
116 // MangleContext for device numbering context, which is based on Itanium C++
117 // ABI.
118 std::unique_ptr<MangleContext> DeviceMangler;
119
120public:
121 MicrosoftCXXABI(ASTContext &Ctx) : Context(Ctx) {
122 if (Context.getLangOpts().CUDA && Context.getAuxTargetInfo()) {
123 assert(Context.getTargetInfo().getCXXABI().isMicrosoft() &&
125 "Unexpected combination of C++ ABIs.");
126 DeviceMangler.reset(
127 Context.createMangleContext(Context.getAuxTargetInfo()));
128 }
129 else if (Context.getLangOpts().isSYCL()) {
130 DeviceMangler.reset(
131 ItaniumMangleContext::create(Context, Context.getDiagnostics()));
132 }
133 }
134
135 MemberPointerInfo
136 getMemberPointerInfo(const MemberPointerType *MPT) const override;
137
138 CallingConv getDefaultMethodCallConv(bool isVariadic) const override {
139 if (!isVariadic &&
140 Context.getTargetInfo().getTriple().getArch() == llvm::Triple::x86)
141 return CC_X86ThisCall;
142 return Context.getTargetInfo().getDefaultCallingConv();
143 }
144
145 bool isNearlyEmpty(const CXXRecordDecl *RD) const override {
146 llvm_unreachable("unapplicable to the MS ABI");
147 }
148
149 const CXXConstructorDecl *
151 return RecordToCopyCtor[RD];
152 }
153
154 void
156 CXXConstructorDecl *CD) override {
157 assert(CD != nullptr);
158 assert(RecordToCopyCtor[RD] == nullptr || RecordToCopyCtor[RD] == CD);
159 RecordToCopyCtor[RD] = CD;
160 }
161
163 TypedefNameDecl *DD) override {
164 TD = TD->getCanonicalDecl();
165 DD = DD->getCanonicalDecl();
166 TypedefNameDecl *&I = UnnamedTagDeclToTypedefNameDecl[TD];
167 if (!I)
168 I = DD;
169 }
170
172 return UnnamedTagDeclToTypedefNameDecl.lookup(
173 const_cast<TagDecl *>(TD->getCanonicalDecl()));
174 }
175
177 DeclaratorDecl *DD) override {
178 TD = TD->getCanonicalDecl();
179 DD = cast<DeclaratorDecl>(DD->getCanonicalDecl());
180 DeclaratorDecl *&I = UnnamedTagDeclToDeclaratorDecl[TD];
181 if (!I)
182 I = DD;
183 }
184
186 return UnnamedTagDeclToDeclaratorDecl.lookup(
187 const_cast<TagDecl *>(TD->getCanonicalDecl()));
188 }
189
190 std::unique_ptr<MangleNumberingContext>
191 createMangleNumberingContext() const override {
192 if (Context.getLangOpts().CUDA && Context.getAuxTargetInfo()) {
193 assert(DeviceMangler && "Missing device mangler");
194 return std::make_unique<MSHIPNumberingContext>(DeviceMangler.get());
195 } else if (Context.getLangOpts().isSYCL()) {
196 assert(DeviceMangler && "Missing device mangler");
197 return std::make_unique<MSSYCLNumberingContext>(DeviceMangler.get());
198 }
199
200 return std::make_unique<MicrosoftNumberingContext>();
201 }
202};
203}
204
205// getNumBases() seems to only give us the number of direct bases, and not the
206// total. This function tells us if we inherit from anybody that uses MI, or if
207// we have a non-primary base class, which uses the multiple inheritance model.
209 while (RD->getNumBases() > 0) {
210 if (RD->getNumBases() > 1)
211 return true;
212 assert(RD->getNumBases() == 1);
213 const CXXRecordDecl *Base =
215 if (RD->isPolymorphic() && !Base->isPolymorphic())
216 return true;
217 RD = Base;
218 }
219 return false;
220}
221
225 if (getNumVBases() > 0)
230}
231
233 MSInheritanceAttr *IA = getAttr<MSInheritanceAttr>();
234 assert(IA && "Expected MSInheritanceAttr on the CXXRecordDecl!");
235 return IA->getInheritanceModel();
236}
237
239 return !inheritanceModelHasOnlyOneField(/*IsMemberFunction=*/false,
242}
243
245 if (MSVtorDispAttr *VDA = getAttr<MSVtorDispAttr>())
246 return VDA->getVtorDispMode();
247 return getASTContext().getLangOpts().getVtorDispMode();
248}
249
250// Returns the number of pointer and integer slots used to represent a member
251// pointer in the MS C++ ABI.
252//
253// Member function pointers have the following general form; however, fields
254// are dropped as permitted (under the MSVC interpretation) by the inheritance
255// model of the actual class.
256//
257// struct {
258// // A pointer to the member function to call. If the member function is
259// // virtual, this will be a thunk that forwards to the appropriate vftable
260// // slot.
261// void *FunctionPointerOrVirtualThunk;
262//
263// // An offset to add to the address of the vbtable pointer after
264// // (possibly) selecting the virtual base but before resolving and calling
265// // the function.
266// // Only needed if the class has any virtual bases or bases at a non-zero
267// // offset.
268// int NonVirtualBaseAdjustment;
269//
270// // The offset of the vb-table pointer within the object. Only needed for
271// // incomplete types.
272// int VBPtrOffset;
273//
274// // An offset within the vb-table that selects the virtual base containing
275// // the member. Loading from this offset produces a new offset that is
276// // added to the address of the vb-table pointer to produce the base.
277// int VirtualBaseAdjustmentOffset;
278// };
279static std::pair<unsigned, unsigned>
281 const CXXRecordDecl *RD = MPT->getMostRecentCXXRecordDecl();
282 MSInheritanceModel Inheritance = RD->getMSInheritanceModel();
283 unsigned Ptrs = 0;
284 unsigned Ints = 0;
285 if (MPT->isMemberFunctionPointer())
286 Ptrs = 1;
287 else
288 Ints = 1;
290 Inheritance))
291 Ints++;
293 Ints++;
295 Ints++;
296 return std::make_pair(Ptrs, Ints);
297}
298
299CXXABI::MemberPointerInfo MicrosoftCXXABI::getMemberPointerInfo(
300 const MemberPointerType *MPT) const {
301 // The nominal struct is laid out with pointers followed by ints and aligned
302 // to a pointer width if any are present and an int width otherwise.
303 const TargetInfo &Target = Context.getTargetInfo();
304 unsigned PtrSize = Target.getPointerWidth(LangAS::Default);
305 unsigned IntSize = Target.getIntWidth();
306
307 unsigned Ptrs, Ints;
308 std::tie(Ptrs, Ints) = getMSMemberPointerSlots(MPT);
309 MemberPointerInfo MPI;
310 MPI.HasPadding = false;
311 MPI.Width = Ptrs * PtrSize + Ints * IntSize;
312
313 // When MSVC does x86_32 record layout, it aligns aggregate member pointers to
314 // 8 bytes. However, __alignof usually returns 4 for data memptrs and 8 for
315 // function memptrs.
316 if (Ptrs + Ints > 1 && Target.getTriple().isArch32Bit())
317 MPI.Align = 64;
318 else if (Ptrs)
319 MPI.Align = Target.getPointerAlign(LangAS::Default);
320 else
321 MPI.Align = Target.getIntAlign();
322
323 if (Target.getTriple().isArch64Bit()) {
324 MPI.Width = llvm::alignTo(MPI.Width, MPI.Align);
325 MPI.HasPadding = MPI.Width != (Ptrs * PtrSize + Ints * IntSize);
326 }
327 return MPI;
328}
329
331 return new MicrosoftCXXABI(Ctx);
332}
Defines the clang::ASTContext interface.
static bool usesMultipleInheritanceModel(const CXXRecordDecl *RD)
static std::pair< unsigned, unsigned > getMSMemberPointerSlots(const MemberPointerType *MPT)
Defines the C++ Decl subclasses, other than those for templates (found in DeclTemplate....
llvm::MachO::Target Target
Definition: MachO.h:51
C Language Family Type Representation.
Holds long-lived AST nodes (such as types and decls) that can be referred to throughout the semantic ...
Definition: ASTContext.h:187
MangleContext * createMangleContext(const TargetInfo *T=nullptr)
If T is null pointer, assume the target in ASTContext.
const LangOptions & getLangOpts() const
Definition: ASTContext.h:797
const TargetInfo * getAuxTargetInfo() const
Definition: ASTContext.h:780
DiagnosticsEngine & getDiagnostics() const
const TargetInfo & getTargetInfo() const
Definition: ASTContext.h:779
Represents a block literal declaration, which is like an unnamed FunctionDecl.
Definition: Decl.h:4467
Implements C++ ABI-specific semantic analysis functions.
Definition: CXXABI.h:29
virtual void addTypedefNameForUnnamedTagDecl(TagDecl *TD, TypedefNameDecl *DD)=0
virtual MemberPointerInfo getMemberPointerInfo(const MemberPointerType *MPT) const =0
Returns the width and alignment of a member pointer in bits, as well as whether it has padding.
virtual std::unique_ptr< MangleNumberingContext > createMangleNumberingContext() const =0
Returns a new mangling number context for this C++ ABI.
virtual CallingConv getDefaultMethodCallConv(bool isVariadic) const =0
Returns the default calling convention for C++ methods.
virtual void addDeclaratorForUnnamedTagDecl(TagDecl *TD, DeclaratorDecl *DD)=0
virtual TypedefNameDecl * getTypedefNameForUnnamedTagDecl(const TagDecl *TD)=0
virtual const CXXConstructorDecl * getCopyConstructorForExceptionObject(CXXRecordDecl *)=0
Retrieves the mapping from class to copy constructor for this C++ ABI.
virtual void addCopyConstructorForExceptionObject(CXXRecordDecl *, CXXConstructorDecl *)=0
Adds a mapping from class to copy constructor for this C++ ABI.
virtual DeclaratorDecl * getDeclaratorForUnnamedTagDecl(const TagDecl *TD)=0
virtual bool isNearlyEmpty(const CXXRecordDecl *RD) const =0
Returns whether the given class is nearly empty, with just virtual pointers and no data except possib...
QualType getType() const
Retrieves the type of the base class.
Definition: DeclCXX.h:249
Represents a C++ constructor within a class.
Definition: DeclCXX.h:2539
Represents a static or instance method of a struct/union/class.
Definition: DeclCXX.h:2064
Represents a C++ struct/union/class.
Definition: DeclCXX.h:258
bool isParsingBaseSpecifiers() const
Definition: DeclCXX.h:604
bool isPolymorphic() const
Whether this class is polymorphic (C++ [class.virtual]), which means that the class contains or inher...
Definition: DeclCXX.h:1219
unsigned getNumBases() const
Retrieves the number of base classes of this class.
Definition: DeclCXX.h:614
base_class_iterator bases_begin()
Definition: DeclCXX.h:627
MSInheritanceModel getMSInheritanceModel() const
Returns the inheritance model used for this record.
bool nullFieldOffsetIsZero() const
In the Microsoft C++ ABI, use zero for the field offset of a null data member pointer if we can guara...
bool hasDefinition() const
Definition: DeclCXX.h:572
MSInheritanceModel calculateInheritanceModel() const
Calculate what the inheritance model would be for this class.
MSVtorDispMode getMSVtorDispMode() const
Controls when vtordisps will be emitted if this record is used as a virtual base.
unsigned getNumVBases() const
Retrieves the number of virtual base classes of this class.
Definition: DeclCXX.h:635
ASTContext & getASTContext() const LLVM_READONLY
Definition: DeclBase.cpp:523
SourceLocation getLocation() const
Definition: DeclBase.h:446
virtual Decl * getCanonicalDecl()
Retrieves the "canonical" declaration of the given declaration.
Definition: DeclBase.h:968
Represents a ValueDecl that came out of a declarator.
Definition: Decl.h:731
Concrete class used by the front-end to report problems and issues.
Definition: Diagnostic.h:192
DiagnosticBuilder Report(SourceLocation Loc, unsigned DiagID)
Issue the message to the client.
Definition: Diagnostic.h:1547
unsigned getCustomDiagID(Level L, const char(&FormatString)[N])
Return an ID for a diagnostic with the specified format string and level.
Definition: Diagnostic.h:873
static ItaniumMangleContext * create(ASTContext &Context, DiagnosticsEngine &Diags, bool IsAux=false)
bool isSYCL() const
Definition: LangOptions.h:712
MangleContext - Context for tracking state which persists across multiple calls to the C++ name mangl...
Definition: Mangle.h:45
Keeps track of the mangled names of lambda expressions and block literals within a particular context...
virtual unsigned getManglingNumber(const CXXMethodDecl *CallOperator)=0
Retrieve the mangling number of a new lambda expression with the given call operator within this cont...
virtual unsigned getStaticLocalNumber(const VarDecl *VD)=0
Static locals are numbered by source order.
A pointer to member type per C++ 8.3.3 - Pointers to members.
Definition: Type.h:3508
CXXRecordDecl * getMostRecentCXXRecordDecl() const
Definition: Type.cpp:5056
bool isMemberFunctionPointer() const
Returns true if the member type (i.e.
Definition: Type.h:3528
Represents the declaration of a struct/union/class/enum.
Definition: Decl.h:3557
TagDecl * getCanonicalDecl() override
Retrieves the "canonical" declaration of the given declaration.
Definition: Decl.cpp:4712
bool isMicrosoft() const
Is this ABI an MSVC-compatible ABI?
Definition: TargetCXXABI.h:136
bool isItaniumFamily() const
Does this ABI generally fall into the Itanium family of ABIs?
Definition: TargetCXXABI.h:122
Exposes information about the current target.
Definition: TargetInfo.h:218
const llvm::Triple & getTriple() const
Returns the target triple of the primary target.
Definition: TargetInfo.h:1256
uint64_t getPointerWidth(LangAS AddrSpace) const
Return the width of pointers on this target, for the specified address space.
Definition: TargetInfo.h:472
virtual CallingConv getDefaultCallingConv() const
Gets the default calling convention for the given target and declaration context.
Definition: TargetInfo.h:1676
TargetCXXABI getCXXABI() const
Get the C++ ABI currently in use.
Definition: TargetInfo.h:1327
The base class of the type hierarchy.
Definition: Type.h:1829
CXXRecordDecl * getAsCXXRecordDecl() const
Retrieves the CXXRecordDecl that this type refers to, either because the type is a RecordType or beca...
Definition: Type.cpp:1882
Base class for declarations which introduce a typedef-name.
Definition: Decl.h:3405
TypedefNameDecl * getCanonicalDecl() override
Retrieves the canonical declaration of this typedef-name.
Definition: Decl.h:3477
Represents a variable declaration or definition.
Definition: Decl.h:879
TLSKind getTLSKind() const
Definition: Decl.cpp:2150
Defines the clang::TargetInfo interface.
The JSON file list parser is used to communicate input to InstallAPI.
std::unique_ptr< MangleNumberingContext > createItaniumNumberingContext(MangleContext *)
CXXABI * CreateMicrosoftCXXABI(ASTContext &Ctx)
bool inheritanceModelHasNVOffsetField(bool IsMemberFunction, MSInheritanceModel Inheritance)
bool inheritanceModelHasOnlyOneField(bool IsMemberFunction, MSInheritanceModel Inheritance)
bool inheritanceModelHasVBPtrOffsetField(MSInheritanceModel Inheritance)
bool inheritanceModelHasVBTableOffsetField(MSInheritanceModel Inheritance)
MSVtorDispMode
In the Microsoft ABI, this controls the placement of virtual displacement members used to implement v...
Definition: LangOptions.h:35
MSInheritanceModel
Assigned inheritance model for a class in the MS C++ ABI.
Definition: Specifiers.h:392
CallingConv
CallingConv - Specifies the calling convention that a function uses.
Definition: Specifiers.h:278
@ CC_X86ThisCall
Definition: Specifiers.h:282