Changeset 73386 in vbox for trunk/include/iprt

Timestamp:

Jul 27, 2018 3:18:50 PM (6 years ago)

Author:

vboxsync

Message:

iprt/formats/pecoff.h: More AMD64 unwind stuff.

File:

• trunk/include/iprt/formats/pecoff.h (modified) (1 diff)

trunk/include/iprt/formats/pecoff.h

@@ -670 +670 @@
     uint32_t    UnwindInfoAddress;
 } IMAGE_RUNTIME_FUNCTION_ENTRY;
+AssertCompileSize(IMAGE_RUNTIME_FUNCTION_ENTRY, 12);
 typedef IMAGE_RUNTIME_FUNCTION_ENTRY *PIMAGE_RUNTIME_FUNCTION_ENTRY;
 typedef IMAGE_RUNTIME_FUNCTION_ENTRY const *PCIMAGE_RUNTIME_FUNCTION_ENTRY;
 
+/**
+ * An unwind code for AMD64 and ARM64.
+ *
+ * @note Also known as UNWIND_CODE or _UNWIND_CODE.
+ */
+typedef union IMAGE_UNWIND_CODE
+{
+    struct
+    {
+        /** The prolog offset where the change takes effect.
+         * This means the instruction following the one being described.  */
+        uint8_t CodeOffset;
+        /** Unwind opcode.
+         * For AMD64 see IMAGE_AMD64_UNWIND_OP_CODES. */
+        uint8_t UnwindOp : 4;
+        /** Opcode specific. */
+        uint8_t OpInfo   : 4;
+    } u;
+    uint16_t    FrameOffset;
+} IMAGE_UNWIND_CODE;
+AssertCompileSize(IMAGE_UNWIND_CODE, 2);
+
+/**
+ * Unwind information for AMD64 and ARM64.
+ *
+ * Pointed to by IMAGE_RUNTIME_FUNCTION_ENTRY::UnwindInfoAddress,
+ *
+ * @note Also known as UNWIND_INFO or _UNWIND_INFO.
+ */
+typedef struct IMAGE_UNWIND_INFO
+{
+    /** Version, currently 1.   */
+    uint8_t             Version : 3;
+    /** IMAGE_UNW_FLAG_XXX */
+    uint8_t             Flags : 5;
+    /** Size of function prolog. */
+    uint8_t             SizeOfProlog;
+    /** Number of opcodes in aOpcodes. */
+    uint8_t             CountOfCodes;
+    /** Initial frame register. */
+    uint8_t             FrameRegister : 4;
+    /** Scaled frame register offset. */
+    uint8_t             FrameOffset : 4;
+    /** Unwind opcodes. */
+    IMAGE_UNWIND_CODE   aOpcodes[RT_FLEXIBLE_ARRAY];
+} IMAGE_UNWIND_INFO;
+AssertCompileMemberOffset(IMAGE_UNWIND_INFO, aOpcodes, 4);
+typedef IMAGE_UNWIND_INFO *PIMAGE_UNWIND_INFO;
+typedef IMAGE_UNWIND_INFO const *PCIMAGE_UNWIND_INFO;
+
+/** IMAGE_UNW_FLAGS_XXX - IMAGE_UNWIND_INFO::Flags.
+ * @{  */
+/** No handler.
+ * @note Aslo know as UNW_FLAG_NHANDLER. */
+#define IMAGE_UNW_FLAGS_NHANDLER        0
+/** Have exception handler (RVA after codes, dword aligned.)
+ * @note Aslo know as UNW_FLAG_NHANDLER. */
+#define IMAGE_UNW_FLAGS_EHANDLER        1
+/** Have unwind handler (RVA after codes, dword aligned.)
+ * @note Aslo know as UNW_FLAG_NHANDLER. */
+#define IMAGE_UNW_FLAGS_UHANDLER        2
+/** Set if not primary unwind info for a function.  An
+ * IMAGE_RUNTIME_FUNCTION_ENTRY giving the chained unwind info follows the
+ * aOpcodes array at a dword aligned offset. */
+#define IMAGE_UNW_FLAGS_CHAININFO       4
+/** @}  */
+
+/**
+ * AMD64 unwind opcodes.
+ */
+typedef enum IMAGE_AMD64_UNWIND_OP_CODES
+{
+    /** Push non-volatile register (OpInfo).
+     * YASM: [pushreg reg]
+     * MASM: .PUSHREG reg */
+    IMAGE_AMD64_UWOP_PUSH_NONVOL = 0,
+    /** Stack allocation: Size stored in the next two slots (dword).
+     * YASM: [allocstack size]
+     * MASM: .ALLOCSTACK size */
+    IMAGE_AMD64_UWOP_ALLOC_LARGE,
+    /** Stack allocation: OpInfo = size / 8 - 1.
+     * YASM: [allocstack size]
+     * MASM: .ALLOCSTACK size  */
+    IMAGE_AMD64_UWOP_ALLOC_SMALL,
+    /** Set frame pointer register: RSP + FrameOffset * 16.
+     * YASM: [setframe reg, offset]
+     * MASM: .SETFRAME reg, offset
+     * @code
+     *      LEA     RBP, [RSP + 20h]
+     *      [setframe RBP, 20h]
+     * @endcode */
+    IMAGE_AMD64_UWOP_SET_FPREG,
+    /** Save non-volatile register (OpInfo) on stack (RSP/FP + next slot).
+     * YASM: [savereg reg, offset]
+     * MASM: .SAVEREG reg, offset */
+    IMAGE_AMD64_UWOP_SAVE_NONVOL,
+    /** Save non-volatile register (OpInfo) on stack (RSP/FP + next two slots).
+     * YASM: [savereg reg, offset]
+     * MASM: .SAVEREG reg, offset  */
+    IMAGE_AMD64_UWOP_SAVE_NONVOL_FAR,
+    IMAGE_AMD64_UWOP_RESERVED_6,
+    IMAGE_AMD64_UWOP_RESERVED_7,
+    /** Save 128-bit XMM register (OpInfo) on stack (RSP/FP + next slot).
+     * YASM: [savexmm128 reg, offset]
+     * MASM: .SAVEXMM128 reg, offset */
+    IMAGE_AMD64_UWOP_SAVE_XMM128,
+    /** Save 128-bit XMM register (OpInfo) on stack (RSP/FP + next two slots).
+     * YASM: [savexmm128 reg, offset]
+     * MASM: .SAVEXMM128 reg, offset  */
+    IMAGE_AMD64_UWOP_SAVE_XMM128_FAR,
+    /** IRET frame, OpInfo serves as error code indicator.
+     * YASM: [pushframe with-code]
+     * MASM: .pushframe with-code  */
+    IMAGE_AMD64_UWOP_PUSH_MACHFRAME
+} IMAGE_AMD64_UNWIND_OP_CODES;
 /** @} */