summaryrefslogtreecommitdiffstats
path: root/js/src/jit/ABIFunctions.h
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-28 14:29:10 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-28 14:29:10 +0000
commit2aa4a82499d4becd2284cdb482213d541b8804dd (patch)
treeb80bf8bf13c3766139fbacc530efd0dd9d54394c /js/src/jit/ABIFunctions.h
parentInitial commit. (diff)
downloadfirefox-2aa4a82499d4becd2284cdb482213d541b8804dd.tar.xz
firefox-2aa4a82499d4becd2284cdb482213d541b8804dd.zip
Adding upstream version 86.0.1.upstream/86.0.1upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'js/src/jit/ABIFunctions.h')
-rw-r--r--js/src/jit/ABIFunctions.h73
1 files changed, 73 insertions, 0 deletions
diff --git a/js/src/jit/ABIFunctions.h b/js/src/jit/ABIFunctions.h
new file mode 100644
index 0000000000..d6bd15555f
--- /dev/null
+++ b/js/src/jit/ABIFunctions.h
@@ -0,0 +1,73 @@
+/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*-
+ * vim: set ts=8 sts=2 et sw=2 tw=80:
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+#ifndef jit_ABIFunctions_h
+#define jit_ABIFunctions_h
+
+#include "jstypes.h" // JS_FUNC_TO_DATA_PTR
+
+namespace js {
+namespace jit {
+
+// This class is used to ensure that all known targets of callWithABI are
+// registered here. Otherwise, this would raise a static assertion at compile
+// time.
+template <typename Sig, Sig fun>
+struct ABIFunctionData {
+ static const bool registered = false;
+};
+
+template <typename Sig, Sig fun>
+struct ABIFunction {
+ void* address() const { return JS_FUNC_TO_DATA_PTR(void*, fun); }
+
+ // If this assertion fails, you are likely in the context of a
+ // `callWithABI<Sig, fn>()` call. This error indicates that ABIFunction has
+ // not been specialized for `<Sig, fn>` by the time of this call.
+ //
+ // This can be fixed by adding the function signature to either
+ // ABIFUNCTION_LIST or ABIFUNCTION_AND_TYPE_LIST (if overloaded) within
+ // `ABIFunctionList-inl.h` and to add an `#include` statement of this header
+ // in the file which is making the call to `callWithABI<Sig, fn>()`.
+ static_assert(ABIFunctionData<Sig, fun>::registered,
+ "ABI function is not registered.");
+};
+
+template <typename Sig>
+struct ABIFunctionSignatureData {
+ static const bool registered = false;
+};
+
+template <typename Sig>
+struct ABIFunctionSignature {
+ void* address(Sig fun) const { return JS_FUNC_TO_DATA_PTR(void*, fun); }
+
+ // If this assertion fails, you are likely in the context of a
+ // `DynamicFunction<Sig>(fn)` call. This error indicates that
+ // ABIFunctionSignature has not been specialized for `Sig` by the time of this
+ // call.
+ //
+ // This can be fixed by adding the function signature to ABIFUNCTIONSIG_LIST
+ // within `ABIFunctionList-inl.h` and to add an `#include` statement of this
+ // header in the file which is making the call to `DynamicFunction<Sig>(fn)`.
+ static_assert(ABIFunctionSignatureData<Sig>::registered,
+ "ABI function signature is not registered.");
+};
+
+// This is a structure created to ensure that the dynamically computed
+// function pointer is well typed.
+//
+// It is meant to be created only through DynamicFunction function calls. In
+// extremelly rare cases, such as VMFunctions, it might be produced as a result
+// of GetVMFunctionTarget.
+struct DynFn {
+ void* address;
+};
+
+} // namespace jit
+} // namespace js
+
+#endif /* jit_VMFunctions_h */