/* OpenIDA - Outil d'analyse de fichiers binaires * operand.h - prototypes pour la gestion des operandes de l'architecture Dalvik * * Copyright (C) 2010 Cyrille Bagard * * This file is part of OpenIDA. * * OpenIDA is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 3 of the License, or * (at your option) any later version. * * OpenIDA 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 General Public License for more details. * * You should have received a copy of the GNU General Public License * along with Foobar. If not, see . */ #ifndef _ARCH_DALVIK_OPERAND_H #define _ARCH_DALVIK_OPERAND_H #include "../instruction.h" #include "../../common/endianness.h" /* ----------------------- COQUILLE VIDE POUR OPERANDE DALVIK ----------------------- */ #define G_TYPE_DALVIK_OPERAND g_dalvik_operand_get_type() #define G_DALVIK_OPERAND(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), g_dalvik_operand_get_type(), GDalvikOperand)) #define G_IS_DALVIK_OPERAND(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), g_dalvik_operand_get_type())) #define G_DALVIK_OPERAND_GET_IFACE(inst) (G_TYPE_INSTANCE_GET_INTERFACE((inst), g_dalvik_operand_get_type(), GDalvikOperandIface)) /* Définition d'un opérande de Dalvik (instance) */ typedef struct _GDalvikOperand GDalvikOperand; /* Définition d'un opérande de Dalvik (classe) */ typedef struct _GDalvikOperandClass GDalvikOperandClass; /* Indique le type défini par la GLib pour un opérande de Dalvik. */ GType g_dalvik_operand_get_type(void); /* --------------------- OPERANDES VISANT UN REGISTRE DE DALVIK --------------------- */ #define G_TYPE_DALVIK_REGISTER_OPERAND g_dalvik_register_operand_get_type() #define G_DALVIK_REGISTER_OPERAND(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), g_dalvik_register_operand_get_type(), GDalvikRegisterOperand)) #define G_IS_DALVIK_REGISTER_OPERAND(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), g_dalvik_register_operand_get_type())) #define G_DALVIK_REGISTER_OPERAND_GET_IFACE(inst) (G_TYPE_INSTANCE_GET_INTERFACE((inst), g_dalvik_register_operand_get_type(), GDalvikRegisterOperandIface)) /* Définition d'un opérande visant un registre Dalvik (instance) */ typedef struct _GDalvikRegisterOperand GDalvikRegisterOperand; /* Définition d'un opérande visant un registre Dalvik (classe) */ typedef struct _GDalvikRegisterOperandClass GDalvikRegisterOperandClass; /* Indique le type défini par la GLib pour un opérande de registre Dalvik. */ GType g_dalvik_register_operand_get_type(void); /* Crée un opérande visant un registre Dalvik. */ GArchOperand *g_dalvik_register_operand_new(const bin_t *, off_t *, off_t, bool *, MemoryDataSize, SourceEndian); /* -------------------- LISTE D'OPERANDES RASSEMBLES EN ARGUMENT -------------------- */ #define G_TYPE_DALVIK_ARGS_OPERAND g_dalvik_args_operand_get_type() #define G_DALVIK_ARGS_OPERAND(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), g_dalvik_args_operand_get_type(), GDalvikArgsOperand)) #define G_IS_DALVIK_ARGS_OPERAND(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), g_dalvik_args_operand_get_type())) #define G_DALVIK_ARGS_OPERAND_GET_IFACE(inst) (G_TYPE_INSTANCE_GET_INTERFACE((inst), g_dalvik_args_operand_get_type(), GDalvikArgsOperandIface)) /* Définition d'un opérande visant une liste d'opérandes Dalvik (instance) */ typedef struct _GDalvikArgsOperand GDalvikArgsOperand; /* Définition d'un opérande visant une liste d'opérandes Dalvik (classe) */ typedef struct _GDalvikArgsOperandClass GDalvikArgsOperandClass; /* Indique le type défini par la GLib pour une liste d'arguments Dalvik. */ GType g_dalvik_args_operand_get_type(void); /* Crée un réceptacle pour opérandes Dalvik servant d'arguments. */ GArchOperand *g_dalvik_args_operand_new(void); /* Ajoute un élément à la liste d'arguments Dalvik. */ void g_dalvik_args_operand_add(GDalvikArgsOperand *, GArchOperand *); /* ----------------- OPERANDES POINTANT VERS LA TABLE DE CONSTANTES ----------------- */ #define G_TYPE_DALVIK_POOL_OPERAND g_dalvik_pool_operand_get_type() #define G_DALVIK_POOL_OPERAND(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), g_dalvik_pool_operand_get_type(), GDalvikPoolOperand)) #define G_IS_DALVIK_POOL_OPERAND(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), g_dalvik_pool_operand_get_type())) #define G_DALVIK_POOL_OPERAND_GET_IFACE(inst) (G_TYPE_INSTANCE_GET_INTERFACE((inst), g_dalvik_pool_operand_get_type(), GDalvikPoolOperandIface)) /* Définition d'un opérande visant un élément de table de constantes Dalvik (instance) */ typedef struct _GDalvikPoolOperand GDalvikPoolOperand; /* Définition d'un opérande visant un élément de table de constantes Dalvik (classe) */ typedef struct _GDalvikPoolOperandClass GDalvikPoolOperandClass; /* Type de table de constantes */ typedef enum _DalvikPoolType { DPT_NONE = 0x0, DPT_STRING = 0x1, DPT_TYPE = 0x2, DPT_PROTO = 0x3, DPT_FIELD = 0x4, DPT_METHOD = 0x5 } DalvikPoolType; /* Indique le type défini par la GLib pour un un élément de table de constantes Dalvik. */ GType g_dalvik_pool_operand_get_type(void); /* Crée un opérande visant un élément constant Dalvik. */ GArchOperand *g_dalvik_pool_operand_new(DalvikPoolType, const bin_t *, off_t *, off_t, MemoryDataSize, SourceEndian); /* Indique la nature de la table de constantes visée ici. */ DalvikPoolType g_dalvik_pool_operand_get_pool_type(const GDalvikPoolOperand *); /* Indique l'indice de l'élément dans la table de constantes. */ uint32_t g_dalvik_pool_operand_get_index(const GDalvikPoolOperand *); /* ------------------------- AIDE A LA CREATION D'OPERANDES ------------------------- */ /** * Cf. les documentations suivantes : * - http://www.netmite.com/android/mydroid/dalvik/docs/instruction-formats.html * - http://www.netmite.com/android/mydroid/dalvik/docs/dalvik-bytecode.html * - http://pallergabor.uw.hu/androidblog/dalvik_opcodes.html */ /* Construction d'identifiants typés */ #define DALVIK_OP_LEN_OFF 28 #define DALVIK_OP_LEN_MASK 0xf0000000 #define DALVIK_OP_REG_OFF 24 #define DALVIK_OP_REG_MASK 0x0f000000 #define DALVIK_OP_POOL_OFF 20 #define DALVIK_OP_POOL_MASK 0x00f00000 #define DALVIK_OP_LEN(l) ((l) << DALVIK_OP_LEN_OFF) #define DALVIK_OP_GET_LEN(v) (((v) & DALVIK_OP_LEN_MASK) >> DALVIK_OP_LEN_OFF) #define DALVIK_OP_REG(r) ((r) << DALVIK_OP_REG_OFF) #define DALVIK_OP_COUNT_REG(v) (((v) & DALVIK_OP_REG_MASK) >> DALVIK_OP_REG_OFF) #define DALVIK_OP_POOL(p) ((p) << DALVIK_OP_POOL_OFF) #define DALVIK_OP_GET_POOL(v) (((v) & DALVIK_OP_POOL_MASK) >> DALVIK_OP_POOL_OFF) /* Types d'opérandes supportés */ typedef enum _DalvikOperandType { DALVIK_OPT_10X = DALVIK_OP_LEN(1) | DALVIK_OP_REG(0) | 'X', DALVIK_OPT_11N = DALVIK_OP_LEN(1) | DALVIK_OP_REG(1) | 'N', DALVIK_OPT_11X = DALVIK_OP_LEN(1) | DALVIK_OP_REG(1) | 'X', DALVIK_OPT_12X = DALVIK_OP_LEN(1) | DALVIK_OP_REG(2) | 'X', DALVIK_OPT_21C = DALVIK_OP_LEN(2) | DALVIK_OP_REG(1) | 'C', DALVIK_OPT_21H = DALVIK_OP_LEN(2) | DALVIK_OP_REG(1) | 'H', DALVIK_OPT_21S = DALVIK_OP_LEN(2) | DALVIK_OP_REG(1) | 'S', DALVIK_OPT_35C = DALVIK_OP_LEN(3) | DALVIK_OP_REG(5) | 'C' } DalvikOperandType; /* Procède à la lecture d'opérandes pour une instruction. */ bool dalvik_read_operands(GArchInstruction *, const bin_t *, off_t *, off_t, SourceEndian, DalvikOperandType); #endif /* _ARCH_DALVIK_OPERAND_H */