Affix

 view release on metacpan or  search on metacpan

infix/src/arch/x64/abi_x64_emitters.h  view on Meta::CPAN

#pragma once
/**
 * Copyright (c) 2025 Sanko Robinson
 *
 * This source code is dual-licensed under the Artistic License 2.0 or the MIT License.
 * You may choose to use this code under the terms of either license.
 *
 * SPDX-License-Identifier: (Artistic-2.0 OR MIT)
 *
 * The documentation blocks within this file are licensed under the
 * Creative Commons Attribution 4.0 International License (CC BY 4.0).
 *
 * SPDX-License-Identifier: CC-BY-4.0
 */
/**
 * @file abi_x64_emitters.h
 * @brief Declares internal helper functions for emitting x86-64 machine code.
 * @ingroup internal_abi_x64
 *
 * @internal
 * This header provides the function prototypes for all low-level x86-64
 * instruction emitters. These functions are the fundamental building blocks
 * used by both the Windows x64 and System V x64 ABI implementations to generate
 * machine code. Each function corresponds to a specific machine instruction
 * or a common addressing mode, encapsulating the complexities of x86-64 encoding.
 * @endinternal
 */
#include "arch/x64/abi_x64_common.h"
#include "common/infix_internals.h"

/** @internal @brief Emits `endbr64` (terminate indirect branch) for Intel IBT / CET. */
INFIX_INTERNAL void emit_endbr64(code_buffer * buf);

// GPR <-> Immediate Value Emitters
/** @internal @brief Emits `mov r64, imm64` to load a 64-bit immediate value into a register. */
INFIX_INTERNAL void emit_mov_reg_imm64(code_buffer * buf, x64_gpr reg, uint64_t value);
/** @internal @brief Emits `mov r64, imm32` (sign-extended) to load a 32-bit immediate into a register. */
INFIX_INTERNAL void emit_mov_reg_imm32(code_buffer * buf, x64_gpr reg, int32_t imm);

// GPR <-> GPR Move Emitters
/** @internal @brief Emits `mov r64, r64` for a register-to-register move. */
INFIX_INTERNAL void emit_mov_reg_reg(code_buffer * buf, x64_gpr dest, x64_gpr src);

// Memory -> GPR Load Emitters
/** @internal @brief Emits `mov r64, [base + offset]` to load a 64-bit value from memory. */
INFIX_INTERNAL void emit_mov_reg_mem(code_buffer * buf, x64_gpr dest, x64_gpr src_base, int32_t offset);
/** @internal @brief Emits `mov r32, [base + offset]` to load a 32-bit value (zero-extended to 64). */
INFIX_INTERNAL void emit_mov_reg32_mem(code_buffer * buf, x64_gpr dest, x64_gpr src_base, int32_t offset);
/** @internal @brief Emits `movsxd r64, [base + offset]` to load a 32-bit value and sign-extend to 64. */
INFIX_INTERNAL void emit_movsxd_reg_mem(code_buffer * buf, x64_gpr dest, x64_gpr src_base, int32_t offset);
/** @internal @brief Emits `movsx r64, r/m8` to load a signed 8-bit value and sign-extend to 64. */
INFIX_INTERNAL void emit_movsx_reg64_mem8(code_buffer * buf, x64_gpr dest, x64_gpr src_base, int32_t offset);
/** @internal @brief Emits `movsx r64, r/m16` to load a signed 16-bit value and sign-extend to 64. */
INFIX_INTERNAL void emit_movsx_reg64_mem16(code_buffer * buf, x64_gpr dest, x64_gpr src_base, int32_t offset);
/** @internal @brief Emits `movzx r64, r/m8` to load an unsigned 8-bit value and zero-extend to 64. */
INFIX_INTERNAL void emit_movzx_reg64_mem8(code_buffer * buf, x64_gpr dest, x64_gpr src_base, int32_t offset);
/** @internal @brief Emits `movzx r64, r/m16` to load an unsigned 16-bit value and zero-extend to 64. */
INFIX_INTERNAL void emit_movzx_reg64_mem16(code_buffer * buf, x64_gpr dest, x64_gpr src_base, int32_t offset);

// GPR -> Memory Store Emitters
/** @internal @brief Emits `mov [base + offset], r64` to store a 64-bit GPR to memory. */
INFIX_INTERNAL void emit_mov_mem_reg(code_buffer * buf, x64_gpr dest_base, int32_t offset, x64_gpr src);
/** @internal @brief Emits `mov [base + offset], r32` to store a 32-bit GPR to memory. */
INFIX_INTERNAL void emit_mov_mem_reg32(code_buffer * buf, x64_gpr dest_base, int32_t offset, x64_gpr src);
/** @internal @brief Emits `mov [base + offset], r16` to store a 16-bit GPR to memory. */
INFIX_INTERNAL void emit_mov_mem_reg16(code_buffer * buf, x64_gpr dest_base, int32_t offset, x64_gpr src);
/** @internal @brief Emits `mov [base + offset], r8` to store an 8-bit GPR to memory. */
INFIX_INTERNAL void emit_mov_mem_reg8(code_buffer * buf, x64_gpr dest_base, int32_t offset, x64_gpr src);

// Memory <-> XMM/YMM (SSE/AVX) Emitters
/** @internal @brief Emits `movss xmm, [base + offset]` to load a 32-bit float from memory. */
INFIX_INTERNAL void emit_movss_xmm_mem(code_buffer * buf, x64_xmm dest, x64_gpr src_base, int32_t offset);
/** @internal @brief Emits `movss [base + offset], xmm` to store a 32-bit float to memory. */
INFIX_INTERNAL void emit_movss_mem_xmm(code_buffer * buf, x64_gpr dest_base, int32_t offset, x64_xmm src);
/** @internal @brief Emits `movsd xmm, [base + offset]` to load a 64-bit double from memory. */
INFIX_INTERNAL void emit_movsd_xmm_mem(code_buffer * buf, x64_xmm dest, x64_gpr src_base, int32_t offset);
/** @internal @brief Emits `movsd [base + offset], xmm` to store a 64-bit double to memory. */
INFIX_INTERNAL void emit_movsd_mem_xmm(code_buffer * buf, x64_gpr dest_base, int32_t offset, x64_xmm src);
/** @internal @brief Emits `movups xmm, [base + offset]` to load a 128-bit unaligned value from memory. */
INFIX_INTERNAL void emit_movups_xmm_mem(code_buffer * buf, x64_xmm dest, x64_gpr src_base, int32_t offset);
/** @internal @brief Emits `movups [base + offset], xmm` to store a 128-bit unaligned value to memory. */
INFIX_INTERNAL void emit_movups_mem_xmm(code_buffer * buf, x64_gpr dest_base, int32_t offset, x64_xmm src);
/** @internal @brief Emits `movaps xmm, xmm` to move 128 bits between XMM registers. */
INFIX_INTERNAL void emit_movups_xmm_xmm(code_buffer * buf, x64_xmm dest, x64_xmm src);
/** @internal @brief Emits `vmovupd ymm, [base + offset]` to load a 256-bit unaligned value (AVX). */
INFIX_INTERNAL void emit_vmovupd_ymm_mem(code_buffer * buf, x64_xmm dest, x64_gpr src_base, int32_t offset);
/** @internal @brief Emits `vmovupd zmm, [base + offset]` to load a 512-bit unaligned value (AVX-512). */
INFIX_INTERNAL void emit_vmovupd_zmm_mem(code_buffer * buf, x64_xmm dest, x64_gpr src_base, int32_t offset);
/** @internal @brief Emits `vmovupd [base + offset], zmm` to store a 512-bit unaligned value (AVX-512). */
INFIX_INTERNAL void emit_vmovupd_mem_zmm(code_buffer * buf, x64_gpr dest_base, int32_t offset, x64_xmm src);
/** @internal @brief Emits `vmovupd [base + offset], ymm` to store a 256-bit unaligned value (AVX). */



( run in 0.895 second using v1.01-cache-2.11-cpan-1bcd28dbaf1 )