Files
swift-mirror/include/swift/Reflection/RuntimeInternals.h
Mike Ash ecd6d4ddec Add a new ConcurrentReadableHashMap type. Switch the protocol conformance cache
to use it.

ConcurrentReadableHashMap is lock-free for readers, with writers using a lock to
ensure mutual exclusion amongst each other. The intent is to eventually replace
all uses ConcurrentMap with ConcurrentReadableHashMap.

ConcurrentReadableHashMap provides for relatively quick lookups by using a hash
table. Rearders perform an atomic increment/decrement in order to inform writers
that there are active readers. The design attempts to minimize wasted memory by
storing the actual elements out-of-line, and having the table store indices into
a separate array of elements.

The protocol conformance cache now uses ConcurrentReadableHashMap, which
provides faster lookups and less memory use than the previous ConcurrentMap
implementation. The previous implementation caches
ProtocolConformanceDescriptors and extracts the WitnessTable after the cache
lookup. The new implementation directly caches the WitnessTable, removing an
extra step (potentially a quite slow one) from the fast path.

The previous implementation used a generational scheme to detect when negative
cache entries became obsolete due to new dynamic libraries being loaded, and
update them in place. The new implementation just clears the entire cache when
libraries are loaded, greatly simplifying the code and saving the memory needed
to track the current generation in each negative cache entry. This means we need
to re-cache all requested conformances after loading a dynamic library, but
loading libraries at runtime is rare and slow anyway.

rdar://problem/67268325
2020-08-20 13:05:30 -04:00

67 lines
2.1 KiB
C++

//===--- RuntimeInternals.h - Runtime Internal Structures -------*- C++ -*-===//
//
// This source file is part of the Swift.org open source project
//
// Copyright (c) 2014 - 2020 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
//
//===----------------------------------------------------------------------===//
//
// Runtime data structures that Reflection inspects externally.
//
// FIXME: Ideally the original definitions would be templatized on a Runtime
// parameter and we could use the original definitions in both the runtime and
// in Reflection.
//
//===----------------------------------------------------------------------===//
#ifndef SWIFT_REFLECTION_RUNTIME_INTERNALS_H
#define SWIFT_REFLECTION_RUNTIME_INTERNALS_H
namespace swift {
namespace reflection {
template <typename Runtime>
struct ConformanceNode {
typename Runtime::StoredPointer Left, Right;
typename Runtime::StoredPointer Type;
typename Runtime::StoredPointer Proto;
typename Runtime::StoredPointer Description;
typename Runtime::StoredSize FailureGeneration;
};
template <typename Runtime>
struct MetadataAllocation {
uint16_t Tag;
typename Runtime::StoredPointer Ptr;
unsigned Size;
};
template <typename Runtime> struct MetadataCacheNode {
typename Runtime::StoredPointer Left;
typename Runtime::StoredPointer Right;
};
template <typename Runtime> struct ConcurrentHashMap {
typename Runtime::StoredSize ReaderCount;
typename Runtime::StoredSize ElementCount;
typename Runtime::StoredPointer Elements;
typename Runtime::StoredPointer Indices;
// We'll ignore the remaining fields for now....
};
template <typename Runtime> struct ConformanceCacheEntry {
typename Runtime::StoredPointer Type;
typename Runtime::StoredPointer Proto;
typename Runtime::StoredPointer Witness;
};
} // end namespace reflection
} // end namespace swift
#endif // SWIFT_REFLECTION_RUNTIME_INTERNALS_H