fcml_common.h

Go to the documentation of this file.

/*
 * FCML - Free Code Manipulation Library.
 * Copyright (C) 2010-2020 Slawomir Wojtasiak
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 */

#ifndef FCML_INT_COMMON_H_
#define FCML_INT_COMMON_H_

#include "fcml_lib_export.h"

#include "fcml_types.h"
#include "fcml_instructions.h"

#define FCML_OPERANDS_COUNT           5

#define FCML_INSTRUCTION_SIZE         15

#define FCML_OPCODES_NUM              3

#define FCML_PREFIX_LOCK            0x0001

#define FCML_PREFIX_REPNE           0x0002

#define FCML_PREFIX_REPNZ           FCML_PREFIX_REPNE

#define FCML_PREFIX_REP             0x0004

#define FCML_PREFIX_REPE            FCML_PREFIX_REP

#define FCML_PREFIX_REPZ            FCML_PREFIX_REP

#define FCML_PREFIX_XACQUIRE        0x0008

#define FCML_PREFIX_XRELEASE        0x0010

#define FCML_PREFIX_BRANCH_HINT     0x0020

#define FCML_PREFIX_NOBRANCH_HINT   0x0040

typedef enum fcml_en_operating_mode {
    FCML_OM_16_BIT = 1,
    FCML_OM_32_BIT,
    FCML_OM_64_BIT,
} fcml_en_operating_mode;

/* Simple types. */

typedef fcml_uint16_t fcml_hints;

typedef fcml_uint16_t fcml_prefixes;

typedef fcml_int64_t fcml_ip;

/* Register numbers.*/

#define FCML_REG_AL     0
#define FCML_REG_AX     0
#define FCML_REG_EAX    0
#define FCML_REG_RAX    0
#define FCML_REG_MM0    0
#define FCML_REG_XMM0   0
#define FCML_REG_YMM0   0
#define FCML_REG_ZMM0   0

#define FCML_REG_CL     1
#define FCML_REG_CX     1
#define FCML_REG_ECX    1
#define FCML_REG_RCX    1
#define FCML_REG_MM1    1
#define FCML_REG_XMM1   1
#define FCML_REG_YMM1   1
#define FCML_REG_ZMM1   1

#define FCML_REG_DL     2
#define FCML_REG_DX     2
#define FCML_REG_EDX    2
#define FCML_REG_RDX    2
#define FCML_REG_MM2    2
#define FCML_REG_XMM2   2
#define FCML_REG_YMM2   2
#define FCML_REG_ZMM2   2

#define FCML_REG_BL     3
#define FCML_REG_BX     3
#define FCML_REG_EBX    3
#define FCML_REG_RBX    3
#define FCML_REG_MM3    3
#define FCML_REG_XMM3   3
#define FCML_REG_YMM3   3
#define FCML_REG_ZMM3   3

#define FCML_REG_AH     4
#define FCML_REG_SP     4
#define FCML_REG_SPL    4
#define FCML_REG_ESP    4
#define FCML_REG_RSP    4
#define FCML_REG_MM4    4
#define FCML_REG_XMM4   4
#define FCML_REG_YMM4   4
#define FCML_REG_ZMM4   4

#define FCML_REG_CH     5
#define FCML_REG_BP     5
#define FCML_REG_BPL    5
#define FCML_REG_EBP    5
#define FCML_REG_RBP    5
#define FCML_REG_MM5    5
#define FCML_REG_XMM5   5
#define FCML_REG_YMM5   5
#define FCML_REG_ZMM5   5

#define FCML_REG_DH     6
#define FCML_REG_SI     6
#define FCML_REG_SIL    6
#define FCML_REG_ESI    6
#define FCML_REG_RSI    6
#define FCML_REG_MM6    6
#define FCML_REG_XMM6   6
#define FCML_REG_YMM6   6
#define FCML_REG_ZMM6   6

#define FCML_REG_BH     7
#define FCML_REG_DI     7
#define FCML_REG_DIL    7
#define FCML_REG_EDI    7
#define FCML_REG_RDI    7
#define FCML_REG_MM7    7
#define FCML_REG_XMM7   7
#define FCML_REG_YMM7   7
#define FCML_REG_ZMM7   7

#define FCML_REG_R8L    8
#define FCML_REG_R8W    8
#define FCML_REG_R8D    8
#define FCML_REG_R8     8
#define FCML_REG_XMM8   8
#define FCML_REG_YMM8   8
#define FCML_REG_ZMM8   8

#define FCML_REG_R9L    9
#define FCML_REG_R9W    9
#define FCML_REG_R9D    9
#define FCML_REG_R9     9
#define FCML_REG_XMM9   9
#define FCML_REG_YMM9   9
#define FCML_REG_ZMM9   9

#define FCML_REG_R10L   10
#define FCML_REG_R10W   10
#define FCML_REG_R10D   10
#define FCML_REG_R10    10
#define FCML_REG_XMM10  10
#define FCML_REG_YMM10  10
#define FCML_REG_ZMM10  10

#define FCML_REG_R11L   11
#define FCML_REG_R11W   11
#define FCML_REG_R11D   11
#define FCML_REG_R11    11
#define FCML_REG_XMM11  11
#define FCML_REG_YMM11  11
#define FCML_REG_ZMM11  11

#define FCML_REG_R12L   12
#define FCML_REG_R12W   12
#define FCML_REG_R12D   12
#define FCML_REG_R12    12
#define FCML_REG_XMM12  12
#define FCML_REG_YMM12  12
#define FCML_REG_ZMM12  12

#define FCML_REG_R13L   13
#define FCML_REG_R13W   13
#define FCML_REG_R13D   13
#define FCML_REG_R13    13
#define FCML_REG_XMM13  13
#define FCML_REG_YMM13  13
#define FCML_REG_ZMM13  13

#define FCML_REG_R14L   14
#define FCML_REG_R14W   14
#define FCML_REG_R14D   14
#define FCML_REG_R14    14
#define FCML_REG_XMM14  14
#define FCML_REG_YMM14  14
#define FCML_REG_ZMM14  14

#define FCML_REG_R15L   15
#define FCML_REG_R15W   15
#define FCML_REG_R15D   15
#define FCML_REG_R15    15
#define FCML_REG_XMM15  15
#define FCML_REG_YMM15  15
#define FCML_REG_ZMM15  15

#define FCML_REG_XMM16  16
#define FCML_REG_YMM16  16
#define FCML_REG_ZMM16  16

#define FCML_REG_XMM17  17
#define FCML_REG_YMM17  17
#define FCML_REG_ZMM17  17

#define FCML_REG_XMM18  18
#define FCML_REG_YMM18  18
#define FCML_REG_ZMM18  18

#define FCML_REG_XMM19  19
#define FCML_REG_YMM19  19
#define FCML_REG_ZMM19  19

#define FCML_REG_XMM20  20
#define FCML_REG_YMM20  20
#define FCML_REG_ZMM20  20

#define FCML_REG_XMM21  21
#define FCML_REG_YMM21  21
#define FCML_REG_ZMM21  21

#define FCML_REG_XMM22  22
#define FCML_REG_YMM22  22
#define FCML_REG_ZMM22  22

#define FCML_REG_XMM23  23
#define FCML_REG_YMM23  23
#define FCML_REG_ZMM23  23

#define FCML_REG_XMM24  24
#define FCML_REG_YMM24  24
#define FCML_REG_ZMM24  24

#define FCML_REG_XMM25  25
#define FCML_REG_YMM25  25
#define FCML_REG_ZMM25  25

#define FCML_REG_XMM26  26
#define FCML_REG_YMM26  26
#define FCML_REG_ZMM26  26

#define FCML_REG_XMM27  27
#define FCML_REG_YMM27  27
#define FCML_REG_ZMM27  27

#define FCML_REG_XMM28  28
#define FCML_REG_YMM28  28
#define FCML_REG_ZMM28  28

#define FCML_REG_XMM29  29
#define FCML_REG_YMM29  29
#define FCML_REG_ZMM29  29

#define FCML_REG_XMM30  30
#define FCML_REG_YMM30  30
#define FCML_REG_ZMM30  30

#define FCML_REG_XMM31  31
#define FCML_REG_YMM31  31
#define FCML_REG_ZMM31  31

/* Segment registers. */

#define FCML_REG_ES     0
#define FCML_REG_CS     1
#define FCML_REG_SS     2
#define FCML_REG_DS     3
#define FCML_REG_FS     4
#define FCML_REG_GS     5

/* FPU registers */

#define FCML_REG_ST0    0
#define FCML_REG_ST1    1
#define FCML_REG_ST2    2
#define FCML_REG_ST3    3
#define FCML_REG_ST4    4
#define FCML_REG_ST5    5
#define FCML_REG_ST6    6
#define FCML_REG_ST7    7

/* Control registers. */

#define FCML_REG_CR0    0
#define FCML_REG_CR2    2
#define FCML_REG_CR3    3
#define FCML_REG_CR4    4
#define FCML_REG_CR8    8

/* Debug register. */

#define FCML_REG_DR0    0
#define FCML_REG_DR1    1
#define FCML_REG_DR2    2
#define FCML_REG_DR3    3
#define FCML_REG_DR4    4
#define FCML_REG_DR5    5
#define FCML_REG_DR6    6
#define FCML_REG_DR7    7

/* Opmask registers. */

#define FCML_REG_K0     0
#define FCML_REG_K1     1
#define FCML_REG_K2     2
#define FCML_REG_K3     3
#define FCML_REG_K4     4
#define FCML_REG_K5     5
#define FCML_REG_K6     6
#define FCML_REG_K7     7

#define FCML_DS_UNDEF   0
#define FCML_DS_8       8
#define FCML_DS_16      16
#define FCML_DS_32      32
#define FCML_DS_64      64
#define FCML_DS_128     128
#define FCML_DS_256     256
#define FCML_DS_512     512

/* Size operators. */

#define FCML_OS_UNDEFINED       0
#define FCML_OS_BYTE            8
#define FCML_OS_WORD            16
#define FCML_OS_DWORD           32
#define FCML_OS_FWORD           48
#define FCML_OS_QWORD           64
#define FCML_OS_MWORD           64
#define FCML_OS_TBYTE           80
#define FCML_OS_OWORD           128
#define FCML_OS_XWORD           128
#define FCML_OS_YWORD           256
#define FCML_OS_ZWORD           512

/* SIMD tuple types. */

/* Instructions affected by embedded broadcast */
#define FCML_TT_NONE            0
#define FCML_TT_FV              1
#define FCML_TT_HV              2

/* Instructions not affected by embedded broadcast */
#define FCML_TT_FVM             3 /* Full Mem */
#define FCML_TT_T1S             4
#define FCML_TT_T1F             5
#define FCML_TT_T2              6
#define FCML_TT_T4              7
#define FCML_TT_T8              8
#define FCML_TT_HVM             9
#define FCML_TT_QVM             10
#define FCML_TT_OVM             11
#define FCML_TT_M128            12
#define FCML_TT_DUP             13
#define FCML_TT_T1x4            14 /* Tuple1_4X */

/* Embedded rounding mode. */

#define FCML_ER_RN_SAE          0
#define FCML_ER_RD_SAE          1
#define FCML_ER_RU_SAE          2
#define FCML_ER_RZ_SAE          3

typedef enum fcml_en_register {
    FCML_REG_UNDEFINED = 0,
    FCML_REG_GPR,
    FCML_REG_SIMD,
    FCML_REG_FPU,
    FCML_REG_SEG,
    FCML_REG_CR,
    FCML_REG_DR,
    FCML_REG_IP,
    FCML_REG_OPMASK
} fcml_en_register;

typedef struct fcml_st_register {
    fcml_en_register type;
    fcml_usize size;
    fcml_uint8_t reg;
    fcml_bool x64_exp;
} fcml_st_register;

/*********************************
 * Conditions.
 *********************************/

#define FCML_NUMBER_OF_CONDITIONS  8

typedef enum fcml_en_condition_type {
    FCML_CONDITION_O = 0,
    FCML_CONDITION_B,
    FCML_CONDITION_E,
    FCML_CONDITION_BE,
    FCML_CONDITION_S,
    FCML_CONDITION_P,
    FCML_CONDITION_L,
    FCML_CONDITION_LE
} fcml_en_condition_type;

typedef struct fcml_st_condition {
    /* Condition type.*/
    fcml_en_condition_type condition_type;
    /* True if condition should be negated.*/
    fcml_bool is_negation;
} fcml_st_condition;

/*********************************
 * Size attributes flags.
 *********************************/

/* Addressing mode is not set, so the caller does not care about it - any
 * addressing mode is allowed. */
#define    FCML_EN_ASF_ANY    0x00
#define    FCML_EN_ASF_16     0x01
#define    FCML_EN_ASF_32     0x02
#define    FCML_EN_ASF_64     0x04
/* All addressing modes are allowed, but in this particular case it's explicitly stated.
 * Effectively it's the same option as FCML_EN_ASF_ANY. */
#define    FCML_EN_ASF_ALL    FCML_EN_ASF_16 | FCML_EN_ASF_32 | FCML_EN_ASF_64

typedef struct fcml_st_nullable_size_flags {
    fcml_bool is_set;
    fcml_flags flags;
} fcml_st_nullable_size_flags;

/*********************************
 * Operands.
 *********************************/

typedef enum fcml_en_access_mode {
    FCML_AM_ACCESS_MODE_UNDEFINED = 0,
    FCML_AM_READ = 0x01,
    FCML_AM_WRITE = 0x02,
    FCML_AM_READ_WRITE = FCML_AM_READ | FCML_AM_WRITE
} fcml_en_access_mode;

typedef struct fcml_st_far_pointer {
    fcml_uint16_t segment;
    fcml_usize offset_size;
    fcml_int16_t offset16;
    fcml_int32_t offset32;
} fcml_st_far_pointer;

/********************************************/
/********************************************/

typedef enum fcml_en_address_form {
    FCML_AF_UNDEFINED,
    FCML_AF_OFFSET,
    FCML_AF_COMBINED
} fcml_en_effective_address_form;

typedef struct fcml_st_offset {
    fcml_usize size;
    fcml_bool is_signed;
    fcml_int16_t off16;
    fcml_int32_t off32;
    fcml_int64_t off64;
} fcml_st_offset;

typedef struct fcml_st_effective_address {
    fcml_st_register base;
    fcml_st_register index;
    fcml_uint8_t scale_factor;
    fcml_st_integer displacement;
} fcml_st_effective_address;

typedef struct fcml_st_segment_selector {
    fcml_st_register segment_selector;
    fcml_bool is_default_reg;
} fcml_st_segment_selector;

typedef struct fcml_st_address {
    fcml_usize size_operator;
    fcml_en_effective_address_form address_form;
    fcml_st_segment_selector segment_selector;
    fcml_st_effective_address effective_address;
    fcml_st_offset offset;
} fcml_st_address;

typedef enum fcml_en_embeeded_rounding_control {
    FCML_ERC_RNE, FCML_ERC_RD, FCML_ERC_RU, FCML_ERC_RZ
} fcml_en_embeeded_rounding_control;

typedef struct fcml_st_operand_decorators {
    fcml_nuint8_t bcast;
    fcml_bool z;
    fcml_st_register operand_mask_reg;
    fcml_nuint8_t er;
    fcml_bool sae;
} fcml_st_operand_decorators;

typedef enum fcml_en_operand_type {
    FCML_OT_NONE,
    FCML_OT_IMMEDIATE,
    FCML_OT_FAR_POINTER,
    FCML_OT_ADDRESS,
    FCML_OT_REGISTER,
    FCML_OT_VIRTUAL
} fcml_en_operand_type;

typedef enum fcml_en_operand_hints {
    FCML_OP_HINT_UNDEFIEND = 0x0000,
    FCML_OP_HINT_MULTIMEDIA_INSTRUCTION = 0x0001,
    FCML_OP_HINT_DISPLACEMENT_RELATIVE_ADDRESS = 0x0002,
    FCML_OP_HINT_PSEUDO_OPCODE = 0x0004,
    FCML_OP_HINT_ABSOLUTE_ADDRESSING = 0x0008,
    FCML_OP_HINT_RELATIVE_ADDRESSING = 0x0010,
    FCML_OP_HINT_SIB_ENCODING = 0x0020
} fcml_en_operand_hints;

typedef struct fcml_st_operand {
    fcml_en_operand_type type;
    fcml_hints hints;
    fcml_st_integer immediate;
    fcml_st_far_pointer far_pointer;
    fcml_st_address address;
    fcml_st_register reg;
    fcml_st_operand_decorators decorators;
} fcml_st_operand;

/*********************************
 * Instruction definition.
 *********************************/

typedef enum fcml_en_instruction_hints {
    FCML_HINT_NO_HINTS,
    FCML_HINT_FAR_POINTER = 0x0001,
    FCML_HINT_NEAR_POINTER = 0x0002,
    FCML_HINT_LONG_FORM_POINTER = 0x0004,
    FCML_HINT_INDIRECT_POINTER = 0x0008,
    FCML_HINT_DIRECT_POINTER = 0x0010
} fcml_en_instruction_hints;

typedef struct fcml_st_instruction {
    fcml_prefixes prefixes;
    fcml_hints hints;
    fcml_char *mnemonic;
    fcml_bool is_conditional;
    fcml_st_condition condition;
    fcml_st_operand operands[FCML_OPERANDS_COUNT];
    fcml_int operands_count;
} fcml_st_instruction;

/*********************************
 * Instruction definition.
 *********************************/

typedef struct fcml_st_instruction_code {
    fcml_uint8_t *code;
    fcml_usize code_length;
} fcml_st_instruction_code;

/****************************
 * Instruction entry point.
 ****************************/

typedef struct fcml_st_entry_point {
    fcml_en_operating_mode op_mode;
    fcml_usize address_size_attribute;
    fcml_usize operand_size_attribute;
    fcml_ip ip;
} fcml_st_entry_point;

#endif /* FCML_INT_COMMON_H_ */