cstool_x86.c File Reference

#include <stdio.h>
#include <stdlib.h>
#include <capstone/capstone.h>

Go to the source code of this file.

Functions
void	print_string_hex (const char *comment, unsigned char *str, size_t len)
static const char *	get_eflag_name (uint64_t flag)
static const char *	get_fpu_flag_name (uint64_t flag)
void	print_insn_detail_x86 (csh ud, cs_mode mode, cs_insn *ins)

Function Documentation

get_eflag_name()

static const char* get_eflag_name ( uint64_t  flag )

static

Definition at line 10 of file cstool_x86.c.

{
    switch(flag) {
        default:
            return NULL;
        case X86_EFLAGS_UNDEFINED_OF:
            return "UNDEF_OF";
        case X86_EFLAGS_UNDEFINED_SF:
            return "UNDEF_SF";
        case X86_EFLAGS_UNDEFINED_ZF:
            return "UNDEF_ZF";
        case X86_EFLAGS_MODIFY_AF:
            return "MOD_AF";
        case X86_EFLAGS_UNDEFINED_PF:
            return "UNDEF_PF";
        case X86_EFLAGS_MODIFY_CF:
            return "MOD_CF";
        case X86_EFLAGS_MODIFY_SF:
            return "MOD_SF";
        case X86_EFLAGS_MODIFY_ZF:
            return "MOD_ZF";
        case X86_EFLAGS_UNDEFINED_AF:
            return "UNDEF_AF";
        case X86_EFLAGS_MODIFY_PF:
            return "MOD_PF";
        case X86_EFLAGS_UNDEFINED_CF:
            return "UNDEF_CF";
        case X86_EFLAGS_MODIFY_OF:
            return "MOD_OF";
        case X86_EFLAGS_RESET_OF:
            return "RESET_OF";
        case X86_EFLAGS_RESET_CF:
            return "RESET_CF";
        case X86_EFLAGS_RESET_DF:
            return "RESET_DF";
        case X86_EFLAGS_RESET_IF:
            return "RESET_IF";
        case X86_EFLAGS_RESET_ZF:
            return "RESET_ZF";
        case X86_EFLAGS_TEST_OF:
            return "TEST_OF";
        case X86_EFLAGS_TEST_SF:
            return "TEST_SF";
        case X86_EFLAGS_TEST_ZF:
            return "TEST_ZF";
        case X86_EFLAGS_TEST_PF:
            return "TEST_PF";
        case X86_EFLAGS_TEST_CF:
            return "TEST_CF";
        case X86_EFLAGS_RESET_SF:
            return "RESET_SF";
        case X86_EFLAGS_RESET_AF:
            return "RESET_AF";
        case X86_EFLAGS_RESET_TF:
            return "RESET_TF";
        case X86_EFLAGS_RESET_NT:
            return "RESET_NT";
        case X86_EFLAGS_PRIOR_OF:
            return "PRIOR_OF";
        case X86_EFLAGS_PRIOR_SF:
            return "PRIOR_SF";
        case X86_EFLAGS_PRIOR_ZF:
            return "PRIOR_ZF";
        case X86_EFLAGS_PRIOR_AF:
            return "PRIOR_AF";
        case X86_EFLAGS_PRIOR_PF:
            return "PRIOR_PF";
        case X86_EFLAGS_PRIOR_CF:
            return "PRIOR_CF";
        case X86_EFLAGS_PRIOR_TF:
            return "PRIOR_TF";
        case X86_EFLAGS_PRIOR_IF:
            return "PRIOR_IF";
        case X86_EFLAGS_PRIOR_DF:
            return "PRIOR_DF";
        case X86_EFLAGS_TEST_NT:
            return "TEST_NT";
        case X86_EFLAGS_TEST_DF:
            return "TEST_DF";
        case X86_EFLAGS_RESET_PF:
            return "RESET_PF";
        case X86_EFLAGS_PRIOR_NT:
            return "PRIOR_NT";
        case X86_EFLAGS_MODIFY_TF:
            return "MOD_TF";
        case X86_EFLAGS_MODIFY_IF:
            return "MOD_IF";
        case X86_EFLAGS_MODIFY_DF:
            return "MOD_DF";
        case X86_EFLAGS_MODIFY_NT:
            return "MOD_NT";
        case X86_EFLAGS_MODIFY_RF:
            return "MOD_RF";
        case X86_EFLAGS_SET_CF:
            return "SET_CF";
        case X86_EFLAGS_SET_DF:
            return "SET_DF";
        case X86_EFLAGS_SET_IF:
            return "SET_IF";
        case X86_EFLAGS_SET_OF:
            return "SET_OF";
        case X86_EFLAGS_SET_SF:
            return "SET_SF";
        case X86_EFLAGS_SET_ZF:
            return "SET_ZF";
        case X86_EFLAGS_SET_AF:
            return "SET_AF";
        case X86_EFLAGS_SET_PF:
            return "SET_PF";
        case X86_EFLAGS_TEST_AF:
            return "TEST_AF";
        case X86_EFLAGS_TEST_TF:
            return "TEST_TF";
        case X86_EFLAGS_TEST_RF:
            return "TEST_RF";
        case X86_EFLAGS_RESET_0F:
            return "RESET_0F";
        case X86_EFLAGS_RESET_AC:
            return "RESET_AC";
    }
}

References NULL, X86_EFLAGS_MODIFY_AF, X86_EFLAGS_MODIFY_CF, X86_EFLAGS_MODIFY_DF, X86_EFLAGS_MODIFY_IF, X86_EFLAGS_MODIFY_NT, X86_EFLAGS_MODIFY_OF, X86_EFLAGS_MODIFY_PF, X86_EFLAGS_MODIFY_RF, X86_EFLAGS_MODIFY_SF, X86_EFLAGS_MODIFY_TF, X86_EFLAGS_MODIFY_ZF, X86_EFLAGS_PRIOR_AF, X86_EFLAGS_PRIOR_CF, X86_EFLAGS_PRIOR_DF, X86_EFLAGS_PRIOR_IF, X86_EFLAGS_PRIOR_NT, X86_EFLAGS_PRIOR_OF, X86_EFLAGS_PRIOR_PF, X86_EFLAGS_PRIOR_SF, X86_EFLAGS_PRIOR_TF, X86_EFLAGS_PRIOR_ZF, X86_EFLAGS_RESET_0F, X86_EFLAGS_RESET_AC, X86_EFLAGS_RESET_AF, X86_EFLAGS_RESET_CF, X86_EFLAGS_RESET_DF, X86_EFLAGS_RESET_IF, X86_EFLAGS_RESET_NT, X86_EFLAGS_RESET_OF, X86_EFLAGS_RESET_PF, X86_EFLAGS_RESET_SF, X86_EFLAGS_RESET_TF, X86_EFLAGS_RESET_ZF, X86_EFLAGS_SET_AF, X86_EFLAGS_SET_CF, X86_EFLAGS_SET_DF, X86_EFLAGS_SET_IF, X86_EFLAGS_SET_OF, X86_EFLAGS_SET_PF, X86_EFLAGS_SET_SF, X86_EFLAGS_SET_ZF, X86_EFLAGS_TEST_AF, X86_EFLAGS_TEST_CF, X86_EFLAGS_TEST_DF, X86_EFLAGS_TEST_NT, X86_EFLAGS_TEST_OF, X86_EFLAGS_TEST_PF, X86_EFLAGS_TEST_RF, X86_EFLAGS_TEST_SF, X86_EFLAGS_TEST_TF, X86_EFLAGS_TEST_ZF, X86_EFLAGS_UNDEFINED_AF, X86_EFLAGS_UNDEFINED_CF, X86_EFLAGS_UNDEFINED_OF, X86_EFLAGS_UNDEFINED_PF, X86_EFLAGS_UNDEFINED_SF, and X86_EFLAGS_UNDEFINED_ZF.

Referenced by print_insn_detail_x86().

get_fpu_flag_name()

static const char* get_fpu_flag_name ( uint64_t  flag )

static

Definition at line 132 of file cstool_x86.c.

{
    switch (flag) {
        default:
            return NULL;
        case X86_FPU_FLAGS_MODIFY_C0:
            return "MOD_C0";
        case X86_FPU_FLAGS_MODIFY_C1:
            return "MOD_C1";
        case X86_FPU_FLAGS_MODIFY_C2:
            return "MOD_C2";
        case X86_FPU_FLAGS_MODIFY_C3:
            return "MOD_C3";
        case X86_FPU_FLAGS_RESET_C0:
            return "RESET_C0";
        case X86_FPU_FLAGS_RESET_C1:
            return "RESET_C1";
        case X86_FPU_FLAGS_RESET_C2:
            return "RESET_C2";
        case X86_FPU_FLAGS_RESET_C3:
            return "RESET_C3";
        case X86_FPU_FLAGS_SET_C0:
            return "SET_C0";
        case X86_FPU_FLAGS_SET_C1:
            return "SET_C1";
        case X86_FPU_FLAGS_SET_C2:
            return "SET_C2";
        case X86_FPU_FLAGS_SET_C3:
            return "SET_C3";
        case X86_FPU_FLAGS_UNDEFINED_C0:
            return "UNDEF_C0";
        case X86_FPU_FLAGS_UNDEFINED_C1:
            return "UNDEF_C1";
        case X86_FPU_FLAGS_UNDEFINED_C2:
            return "UNDEF_C2";
        case X86_FPU_FLAGS_UNDEFINED_C3:
            return "UNDEF_C3";
        case X86_FPU_FLAGS_TEST_C0:
            return "TEST_C0";
        case X86_FPU_FLAGS_TEST_C1:
            return "TEST_C1";
        case X86_FPU_FLAGS_TEST_C2:
            return "TEST_C2";
        case X86_FPU_FLAGS_TEST_C3:
            return "TEST_C3";
    }
}

References NULL, X86_FPU_FLAGS_MODIFY_C0, X86_FPU_FLAGS_MODIFY_C1, X86_FPU_FLAGS_MODIFY_C2, X86_FPU_FLAGS_MODIFY_C3, X86_FPU_FLAGS_RESET_C0, X86_FPU_FLAGS_RESET_C1, X86_FPU_FLAGS_RESET_C2, X86_FPU_FLAGS_RESET_C3, X86_FPU_FLAGS_SET_C0, X86_FPU_FLAGS_SET_C1, X86_FPU_FLAGS_SET_C2, X86_FPU_FLAGS_SET_C3, X86_FPU_FLAGS_TEST_C0, X86_FPU_FLAGS_TEST_C1, X86_FPU_FLAGS_TEST_C2, X86_FPU_FLAGS_TEST_C3, X86_FPU_FLAGS_UNDEFINED_C0, X86_FPU_FLAGS_UNDEFINED_C1, X86_FPU_FLAGS_UNDEFINED_C2, and X86_FPU_FLAGS_UNDEFINED_C3.

Referenced by print_insn_detail_x86().

print_insn_detail_x86()

void print_insn_detail_x86	(	csh	ud,
		cs_mode	mode,
		cs_insn *	ins
	)

Definition at line 180 of file cstool_x86.c.

{
    int count, i;
    cs_x86 *x86;
    cs_regs regs_read, regs_write;
    uint8_t regs_read_count, regs_write_count;
    
    // detail can be NULL on "data" instruction if SKIPDATA option is turned ON
    if (ins->detail == NULL)
        return;
 
    x86 = &(ins->detail->x86);
 
    print_string_hex("\tPrefix:", x86->prefix, 4);
    print_string_hex("\tOpcode:", x86->opcode, 4);
    printf("\trex: 0x%x\n", x86->rex);
    printf("\taddr_size: %u\n", x86->addr_size);
    printf("\tmodrm: 0x%x\n", x86->modrm);
    printf("\tdisp: 0x%" PRIx64 "\n", x86->disp);
 
    // SIB is not available in 16-bit mode
    if ((mode & CS_MODE_16) == 0) {
        printf("\tsib: 0x%x\n", x86->sib);
        if (x86->sib_base != X86_REG_INVALID)
            printf("\t\tsib_base: %s\n", cs_reg_name(ud, x86->sib_base));
        if (x86->sib_index != X86_REG_INVALID)
            printf("\t\tsib_index: %s\n", cs_reg_name(ud, x86->sib_index));
        if (x86->sib_scale != 0)
            printf("\t\tsib_scale: %d\n", x86->sib_scale);
    }
 
    // XOP code condition
    if (x86->xop_cc != X86_XOP_CC_INVALID) {
        printf("\txop_cc: %u\n", x86->xop_cc);
    }
 
    // SSE code condition
    if (x86->sse_cc != X86_SSE_CC_INVALID) {
        printf("\tsse_cc: %u\n", x86->sse_cc);
    }
 
    // AVX code condition
    if (x86->avx_cc != X86_AVX_CC_INVALID) {
        printf("\tavx_cc: %u\n", x86->avx_cc);
    }
 
    // AVX Suppress All Exception
    if (x86->avx_sae) {
        printf("\tavx_sae: %u\n", x86->avx_sae);
    }
 
    // AVX Rounding Mode
    if (x86->avx_rm != X86_AVX_RM_INVALID) {
        printf("\tavx_rm: %u\n", x86->avx_rm);
    }
 
    // Print out all immediate operands
    count = cs_op_count(ud, ins, X86_OP_IMM);
    if (count > 0) {
        printf("\timm_count: %u\n", count);
        for (i = 1; i < count + 1; i++) {
            int index = cs_op_index(ud, ins, X86_OP_IMM, i);
            printf("\t\timms[%u]: 0x%" PRIx64 "\n", i, x86->operands[index].imm);
        }
    }
 
    if (x86->op_count)
        printf("\top_count: %u\n", x86->op_count);
 
    // Print out all operands
    for (i = 0; i < x86->op_count; i++) {
        cs_x86_op *op = &(x86->operands[i]);
 
        switch((int)op->type) {
            case X86_OP_REG:
                printf("\t\toperands[%u].type: REG = %s\n", i, cs_reg_name(ud, op->reg));
                break;
            case X86_OP_IMM:
                printf("\t\toperands[%u].type: IMM = 0x%" PRIx64 "\n", i, op->imm);
                break;
            case X86_OP_MEM:
                printf("\t\toperands[%u].type: MEM\n", i);
                if (op->mem.segment != X86_REG_INVALID)
                    printf("\t\t\toperands[%u].mem.segment: REG = %s\n", i, cs_reg_name(ud, op->mem.segment));
                if (op->mem.base != X86_REG_INVALID)
                    printf("\t\t\toperands[%u].mem.base: REG = %s\n", i, cs_reg_name(ud, op->mem.base));
                if (op->mem.index != X86_REG_INVALID)
                    printf("\t\t\toperands[%u].mem.index: REG = %s\n", i, cs_reg_name(ud, op->mem.index));
                if (op->mem.scale != 1)
                    printf("\t\t\toperands[%u].mem.scale: %u\n", i, op->mem.scale);
                if (op->mem.disp != 0)
                    printf("\t\t\toperands[%u].mem.disp: 0x%" PRIx64 "\n", i, op->mem.disp);
                break;
            default:
                break;
        }
 
        // AVX broadcast type
        if (op->avx_bcast != X86_AVX_BCAST_INVALID)
            printf("\t\toperands[%u].avx_bcast: %u\n", i, op->avx_bcast);
 
        // AVX zero opmask {z}
        if (op->avx_zero_opmask != false)
            printf("\t\toperands[%u].avx_zero_opmask: TRUE\n", i);
 
        printf("\t\toperands[%u].size: %u\n", i, op->size);
 
        switch(op->access) {
            default:
                break;
            case CS_AC_READ:
                printf("\t\toperands[%u].access: READ\n", i);
                break;
            case CS_AC_WRITE:
                printf("\t\toperands[%u].access: WRITE\n", i);
                break;
            case CS_AC_READ | CS_AC_WRITE:
                printf("\t\toperands[%u].access: READ | WRITE\n", i);
                break;
        }
    }
 
    // Print out all registers accessed by this instruction (either implicit or explicit)
    if (!cs_regs_access(ud, ins,
                        regs_read, &regs_read_count,
                        regs_write, &regs_write_count)) {
        if (regs_read_count) {
            printf("\tRegisters read:");
            for(i = 0; i < regs_read_count; i++) {
                printf(" %s", cs_reg_name(ud, regs_read[i]));
            }
            printf("\n");
        }
 
        if (regs_write_count) {
            printf("\tRegisters modified:");
            for(i = 0; i < regs_write_count; i++) {
                printf(" %s", cs_reg_name(ud, regs_write[i]));
            }
            printf("\n");
        }
    }
 
    if (x86->eflags || x86->fpu_flags) {
        for(i = 0; i < ins->detail->groups_count; i++) {
            if (ins->detail->groups[i] == X86_GRP_FPU) {
                printf("\tFPU_FLAGS:");
                for(i = 0; i <= 63; i++)
                    if (x86->fpu_flags & ((uint64_t)1 << i)) {
                        printf(" %s", get_fpu_flag_name((uint64_t)1 << i));
                    }
                printf("\n");
                break;
            }
        }
 
        if (i == ins->detail->groups_count) {
            printf("\tEFLAGS:");
            for(i = 0; i <= 63; i++)
                if (x86->eflags & ((uint64_t)1 << i)) {
                    printf(" %s", get_eflag_name((uint64_t)1 << i));
                }
            printf("\n");
        }
    }
}

References count, CS_AC_READ, CS_AC_WRITE, CS_MODE_16, cs_op_count(), cs_op_index(), cs_reg_name(), cs_regs_access(), get_eflag_name(), get_fpu_flag_name(), i, NULL, print_string_hex(), printf(), PRIx64, X86_AVX_BCAST_INVALID, X86_AVX_CC_INVALID, X86_AVX_RM_INVALID, X86_GRP_FPU, X86_OP_IMM, X86_OP_MEM, X86_OP_REG, X86_REG_INVALID, X86_SSE_CC_INVALID, and X86_XOP_CC_INVALID.

Referenced by print_details().

print_string_hex()

void print_string_hex	(	const char *	comment,
		unsigned char *	str,
		size_t	len
	)

Definition at line 91 of file cstool.c.

{
    unsigned char *c;
 
    printf("%s", comment);
    for (c = str; c < str + len; c++) {
        printf("0x%02x ", *c & 0xff);
    }
 
    printf("\n");
}

References c, len, printf(), and cmd_descs_generate::str.

Referenced by test_x86::print_insn_detail(), and print_insn_detail_x86().