mirror of
https://github.com/apple/swift.git
synced 2025-12-21 12:14:44 +01:00
c20ef6de2a
without relying on spare bit information in the reflection metadata (which was added in #40906). As a result, we can remove the code from #40906. This is the first step in such removal. It removes the RemoteMirror code for looking up such metadata. It leaves behind: * Sufficient stubs for LLDB to continue to build. Once LLDB is updated, these stubs can be removed as well. * The compiler code to emit such metadata. This allows new binaries to still reflect MPEs on older runtimes. This will need to be kept for a transitional period.
141 lines
4.3 KiB
C++
141 lines
4.3 KiB
C++
//===--------------- DescriptorFinder.h -------------------------*- C++ -*-===//
|
|
//
|
|
// This source file is part of the Swift.org open source project
|
|
//
|
|
// Copyright (c) 2014 - 2017 Apple Inc. and the Swift project authors
|
|
// Licensed under Apache License v2.0 with Runtime Library Exception
|
|
//
|
|
// See https://swift.org/LICENSE.txt for license information
|
|
// See https://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef SWIFT_REFLECTION_DESCRIPTOR_FINDER_H
|
|
#define SWIFT_REFLECTION_DESCRIPTOR_FINDER_H
|
|
|
|
#include "swift/Demangling/Demangle.h"
|
|
#include "swift/RemoteInspection/Records.h"
|
|
#include "llvm/ADT/StringRef.h"
|
|
|
|
namespace swift {
|
|
namespace reflection {
|
|
|
|
class TypeRef;
|
|
|
|
/// An abstract interface for a builtin type descriptor.
|
|
struct BuiltinTypeDescriptorBase {
|
|
const uint32_t Size;
|
|
const uint32_t Alignment;
|
|
const uint32_t Stride;
|
|
const uint32_t NumExtraInhabitants;
|
|
const bool IsBitwiseTakable;
|
|
|
|
BuiltinTypeDescriptorBase(uint32_t Size, uint32_t Alignment, uint32_t Stride,
|
|
uint32_t NumExtraInhabitants, bool IsBitwiseTakable)
|
|
: Size(Size), Alignment(Alignment), Stride(Stride),
|
|
NumExtraInhabitants(NumExtraInhabitants),
|
|
IsBitwiseTakable(IsBitwiseTakable) {}
|
|
|
|
virtual ~BuiltinTypeDescriptorBase(){};
|
|
|
|
virtual llvm::StringRef getMangledTypeName() = 0;
|
|
};
|
|
|
|
/// An abstract interface for a field record.
|
|
struct FieldRecordBase {
|
|
const bool IsIndirectCase;
|
|
const bool IsVar;
|
|
const bool HasMangledTypeName;
|
|
|
|
FieldRecordBase(bool IsIndirectCase, bool IsVar,
|
|
bool HasMangledTypeName)
|
|
: IsIndirectCase(IsIndirectCase), IsVar(IsVar),
|
|
HasMangledTypeName(HasMangledTypeName) {}
|
|
|
|
virtual ~FieldRecordBase(){};
|
|
|
|
virtual llvm::StringRef getFieldName() = 0;
|
|
virtual Demangle::Node *getDemangledTypeName() = 0;
|
|
};
|
|
|
|
/// An abstract interface for a field descriptor.
|
|
struct FieldDescriptorBase {
|
|
const FieldDescriptorKind Kind;
|
|
const bool HasSuperClass;
|
|
|
|
FieldDescriptorBase(FieldDescriptorKind Kind, bool HasSuperClass)
|
|
: Kind(Kind), HasSuperClass(HasSuperClass) {}
|
|
|
|
bool isEnum() const {
|
|
return (Kind == FieldDescriptorKind::Enum ||
|
|
Kind == FieldDescriptorKind::MultiPayloadEnum);
|
|
}
|
|
|
|
bool isClass() const {
|
|
return (Kind == FieldDescriptorKind::Class ||
|
|
Kind == FieldDescriptorKind::ObjCClass);
|
|
}
|
|
|
|
bool isProtocol() const {
|
|
return (Kind == FieldDescriptorKind::Protocol ||
|
|
Kind == FieldDescriptorKind::ClassProtocol ||
|
|
Kind == FieldDescriptorKind::ObjCProtocol);
|
|
}
|
|
|
|
bool isStruct() const {
|
|
return Kind == FieldDescriptorKind::Struct;
|
|
}
|
|
|
|
virtual ~FieldDescriptorBase(){};
|
|
|
|
virtual Demangle::Node *demangleSuperclass() = 0;
|
|
virtual std::vector<std::unique_ptr<FieldRecordBase>>
|
|
getFieldRecords() = 0;
|
|
};
|
|
|
|
// There are no longer any clients of this interface, but we
|
|
// need to keep this stubbed out until all the
|
|
// implementors have been removed. In particular, LLDB
|
|
// still implements this interface.
|
|
// TODO: Delete this after Swift 6.0 ships
|
|
struct MultiPayloadEnumDescriptorBase {
|
|
virtual ~MultiPayloadEnumDescriptorBase(){ abort(); };
|
|
|
|
virtual llvm::StringRef getMangledTypeName() { abort(); };
|
|
|
|
virtual uint32_t getContentsSizeInWords() const { abort(); };
|
|
|
|
virtual size_t getSizeInBytes() const { abort(); };
|
|
|
|
virtual uint32_t getFlags() const { abort(); };
|
|
|
|
virtual bool usesPayloadSpareBits() const { abort(); };
|
|
|
|
virtual uint32_t getPayloadSpareBitMaskByteOffset() const { abort(); };
|
|
|
|
virtual uint32_t getPayloadSpareBitMaskByteCount() const { abort(); };
|
|
|
|
virtual const uint8_t *getPayloadSpareBits() const { abort(); };
|
|
};
|
|
|
|
/// Interface for finding type descriptors. Implementors may provide descriptors
|
|
/// that live inside or outside reflection metadata.
|
|
struct DescriptorFinder {
|
|
virtual ~DescriptorFinder(){};
|
|
|
|
virtual std::unique_ptr<BuiltinTypeDescriptorBase>
|
|
getBuiltinTypeDescriptor(const TypeRef *TR) = 0;
|
|
|
|
|
|
virtual std::unique_ptr<FieldDescriptorBase>
|
|
getFieldDescriptor(const TypeRef *TR) = 0;
|
|
|
|
// TODO: Delete this as soon as LLDB no longer attempts to override it
|
|
virtual std::unique_ptr<MultiPayloadEnumDescriptorBase>
|
|
getMultiPayloadEnumDescriptor(const TypeRef *TR) { abort(); };
|
|
};
|
|
|
|
} // namespace reflection
|
|
} // namespace swift
|
|
#endif
|