summaryrefslogtreecommitdiffstats
path: root/js/src/zydis/Zydis/Zydis.h
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 19:33:14 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 19:33:14 +0000
commit36d22d82aa202bb199967e9512281e9a53db42c9 (patch)
tree105e8c98ddea1c1e4784a60a5a6410fa416be2de /js/src/zydis/Zydis/Zydis.h
parentInitial commit. (diff)
downloadfirefox-esr-upstream.tar.xz
firefox-esr-upstream.zip
Adding upstream version 115.7.0esr.upstream/115.7.0esrupstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'js/src/zydis/Zydis/Zydis.h')
-rw-r--r--js/src/zydis/Zydis/Zydis.h185
1 files changed, 185 insertions, 0 deletions
diff --git a/js/src/zydis/Zydis/Zydis.h b/js/src/zydis/Zydis/Zydis.h
new file mode 100644
index 0000000000..6c3cc7dba3
--- /dev/null
+++ b/js/src/zydis/Zydis/Zydis.h
@@ -0,0 +1,185 @@
+/***************************************************************************************************
+
+ Zyan Disassembler Library (Zydis)
+
+ Original Author : Florian Bernd
+
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+
+***************************************************************************************************/
+
+/**
+ * @file
+ * Master include file. Includes everything else.
+ */
+
+#ifndef ZYDIS_H
+#define ZYDIS_H
+
+#include "zydis/Zycore/Defines.h"
+#include "zydis/Zycore/Types.h"
+
+#if !defined(ZYDIS_DISABLE_DECODER)
+# include "zydis/Zydis/Decoder.h"
+# include "zydis/Zydis/DecoderTypes.h"
+#endif
+
+#if !defined(ZYDIS_DISABLE_ENCODER)
+# include "zydis/Zydis/Encoder.h"
+#endif
+
+#if !defined(ZYDIS_DISABLE_FORMATTER)
+# include "zydis/Zydis/Formatter.h"
+#endif
+
+#if !defined(ZYDIS_DISABLE_SEGMENT)
+# include "zydis/Zydis/Segment.h"
+#endif
+
+#if !defined(ZYDIS_DISABLE_DECODER) && !defined(ZYDIS_DISABLE_FORMATTER)
+# include "zydis/Zydis/Disassembler.h"
+#endif
+
+#include "zydis/Zydis/MetaInfo.h"
+#include "zydis/Zydis/Mnemonic.h"
+#include "zydis/Zydis/Register.h"
+#include "zydis/Zydis/SharedTypes.h"
+#include "zydis/Zydis/Status.h"
+#include "zydis/Zydis/Utils.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @addtogroup version Version
+ *
+ * Functions for checking the library version and build options.
+ *
+ * @{
+ */
+
+/* ============================================================================================== */
+/* Macros */
+/* ============================================================================================== */
+
+/* ---------------------------------------------------------------------------------------------- */
+/* Constants */
+/* ---------------------------------------------------------------------------------------------- */
+
+/**
+ * A macro that defines the zydis version.
+ */
+#define ZYDIS_VERSION (ZyanU64)0x0004000000000000
+
+/* ---------------------------------------------------------------------------------------------- */
+/* Helper macros */
+/* ---------------------------------------------------------------------------------------------- */
+
+/**
+ * Extracts the major-part of the zydis version.
+ *
+ * @param version The zydis version value
+ */
+#define ZYDIS_VERSION_MAJOR(version) (ZyanU16)(((version) & 0xFFFF000000000000) >> 48)
+
+/**
+ * Extracts the minor-part of the zydis version.
+ *
+ * @param version The zydis version value
+ */
+#define ZYDIS_VERSION_MINOR(version) (ZyanU16)(((version) & 0x0000FFFF00000000) >> 32)
+
+/**
+ * Extracts the patch-part of the zydis version.
+ *
+ * @param version The zydis version value
+ */
+#define ZYDIS_VERSION_PATCH(version) (ZyanU16)(((version) & 0x00000000FFFF0000) >> 16)
+
+/**
+ * Extracts the build-part of the zydis version.
+ *
+ * @param version The zydis version value
+ */
+#define ZYDIS_VERSION_BUILD(version) (ZyanU16)((version) & 0x000000000000FFFF)
+
+/* ---------------------------------------------------------------------------------------------- */
+
+/* ============================================================================================== */
+/* Enums and types */
+/* ============================================================================================== */
+
+/**
+ * Defines the `ZydisFeature` enum.
+ */
+typedef enum ZydisFeature_
+{
+ ZYDIS_FEATURE_DECODER,
+ ZYDIS_FEATURE_ENCODER,
+ ZYDIS_FEATURE_FORMATTER,
+ ZYDIS_FEATURE_AVX512,
+ ZYDIS_FEATURE_KNC,
+ ZYDIS_FEATURE_SEGMENT,
+
+ /**
+ * Maximum value of this enum.
+ */
+ ZYDIS_FEATURE_MAX_VALUE = ZYDIS_FEATURE_KNC,
+ /**
+ * The minimum number of bits required to represent all values of this enum.
+ */
+ ZYDIS_FEATURE_REQUIRED_BITS = ZYAN_BITS_TO_REPRESENT(ZYDIS_FEATURE_MAX_VALUE)
+} ZydisFeature;
+
+/* ============================================================================================== */
+/* Exported functions */
+/* ============================================================================================== */
+
+/**
+ * Returns the zydis version.
+ *
+ * @return The zydis version.
+ *
+ * Use the macros provided in this file to extract the major, minor, patch and build part from the
+ * returned version value.
+ */
+ZYDIS_EXPORT ZyanU64 ZydisGetVersion(void);
+
+/**
+ * Checks, if the specified feature is enabled in the current zydis library instance.
+ *
+ * @param feature The feature.
+ *
+ * @return `ZYAN_STATUS_TRUE` if the feature is enabled, `ZYAN_STATUS_FALSE` if not. Another
+ * zyan status code, if an error occured.
+ */
+ZYDIS_EXPORT ZyanStatus ZydisIsFeatureEnabled(ZydisFeature feature);
+
+/* ============================================================================================== */
+
+/**
+ * @}
+ */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* ZYDIS_H */