Files
2025-06-04 11:31:02 -07:00

140 lines
5.4 KiB
Python

#===-----------------------------------------------------------------------===//
#
# This source file is part of the Swift.org open source project
#
# Copyright (c) 2020 - 2025 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
#
#===-----------------------------------------------------------------------===//
def autogenerated_warning():
return """
// #############################################################################
// # #
// # DO NOT EDIT THIS FILE; IT IS AUTOGENERATED. #
// # #
// #############################################################################
"""
cPrimitives = [
#Storage Value
("_AtomicInt8Storage", "Int8"),
("_AtomicInt16Storage", "Int16"),
("_AtomicInt32Storage", "Int32"),
("_AtomicInt64Storage", "Int64"),
("_AtomicIntStorage", "Int"),
("_AtomicDoubleWordStorage", "DoubleWord"),
]
nativePrimitives = [
#Storage Builtin Alignment
("_AtomicInt8Storage", "Int8", "1"),
("_AtomicInt16Storage", "Int16", "2"),
("_AtomicInt32Storage", "Int32", "4"),
("_AtomicInt64Storage", "Int64", "8"),
("_AtomicInt128Storage", "Int128", "16"),
]
loadOrderings = [
# Swift enum case, API name, doc name, llvm name
('relaxed', 'Relaxed', 'relaxed', 'monotonic'),
('acquiring', 'Acquiring', 'acquiring', 'acquire'),
('sequentiallyConsistent', 'SequentiallyConsistent', 'sequentially consistent', 'seqcst'),
]
storeOrderings = [
# Swift enum case, API name, doc name, llvm name
('relaxed', 'Relaxed', 'relaxed', 'monotonic'),
('releasing', 'Releasing', 'releasing', 'release'),
('sequentiallyConsistent', 'SequentiallyConsistent', 'sequentially consistent', 'seqcst'),
]
updateOrderings = [
# Swift enum case, API name, documentation name, llvm name, failure name
('relaxed', 'Relaxed', 'relaxed', 'monotonic', 'monotonic'),
('acquiring', 'Acquiring', 'acquiring', 'acquire', 'acquire'),
('releasing', 'Releasing', 'releasing', 'release', 'monotonic'),
('acquiringAndReleasing', 'AcquiringAndReleasing', 'acquiring-and-releasing', 'acqrel', 'acquire'),
('sequentiallyConsistent', 'SequentiallyConsistent', 'sequentially consistent', 'seqcst', 'seqcst'),
]
def shim_name(llvmOrdering):
if llvmOrdering == 'monotonic':
return "relaxed"
if llvmOrdering == 'acquire':
return "acquire"
if llvmOrdering == 'release':
return "release"
if llvmOrdering == 'acqrel':
return "acq_rel"
if llvmOrdering == 'seqcst':
return "seq_cst"
raise ValueError("Unknown ordering " + llvmOrdering)
def isStrongerThan(rmw, load): # See llvm/Support/AtomicOrdering.h
if rmw == "sequentiallyConsistent":
return load == "relaxed" or load == "acquiring"
if rmw == "acquiringAndReleasing":
return load == "relaxed"
if rmw == "releasing":
return False
if rmw == "acquiring":
return load == "relaxed"
if rmw == "relaxed":
return False
def failureOrderingOf(update):
if update == "release":
return "monotonic"
if update == "acqrel":
return "acquire"
return update
# LLVM doesn't support arbitrary ordering combinations yet, so for the
# two-ordering cmpxchg variants we need to upgrade the success
# ordering when necessary so that it is at least as "strong" as the
# failure case. This function implements that mapping.
#
# See llvm/Support/AtomicOrdering.h
def actualOrders(success, failure):
def max(success, failure):
if failure == "acquire":
if success == "monotonic":
return "acquire"
if success == "release":
return "acqrel"
if failure == "seqcst":
return "seqcst"
return success
actualSuccess = max(success, failure)
return actualSuccess + "_" + failure
def actualShimOrders(success, failure):
r=actualOrders(success, failure).split("_")
return shim_name(r[0]) + "_" + shim_name(r[1])
integerOperations = [
# Swift name, llvm name, operator, label, doc
('WrappingIncrement', 'add', '&+', "by", "wrapping add"),
('WrappingDecrement', 'sub', '&-', "by", "wrapping subtract"),
('BitwiseAnd', 'and', '&', "with", "bitwise AND"),
('BitwiseOr', 'or', '|', "with", "bitwise OR"),
('BitwiseXor', 'xor', '^', "with", "bitwise XOR")
]
boolOperations = [
# Swift name, Int8 name, operator, label, doc
('LogicalAnd', 'BitwiseAnd', '&&', "with", "logical AND"),
('LogicalOr', 'BitwiseOr', '||', "with", "logical OR"),
('LogicalXor', 'BitwiseXor', '!=', "with", "logical XOR")
]
def lowerFirst(str):
return str[:1].lower() + str[1:] if str else ""
def argLabel(label):
return label + ": " if label != "_" else ""