/* Chrysalide - Outil d'analyse de fichiers binaires
* method.c - manipulation des methodes du format DEX
*
* Copyright (C) 2010-2017 Cyrille Bagard
*
* This file is part of Chrysalide.
*
* Chrysalide 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.
*
* Chrysalide 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 Chrysalide. If not, see .
*/
#include "method.h"
#include
#include
#include
#include
#include "dex-int.h"
#include "pool.h"
#include "routine.h"
/* Methode issue du code source (instance) */
struct _GDexMethod
{
GObject parent; /* A laisser en premier */
GBinRoutine *routine; /* Représentation interne */
/**
* Les champs suivants ne sont renseignés que pour les objets mis
* en place à partir du constructeur g_dex_method_new_defined().
*/
#ifndef NDEBUG
bool already_defined; /* Vérification d'unicité */
#endif
method_id_item id_item; /* Définition de la méthode */
encoded_method info; /* Propriétés de la méthode */
bool has_body; /* Indication de présence */
code_item body; /* Corps de la méthode */
off_t offset; /* Position du code */
};
/* Methode issue du code source (classe) */
struct _GDexMethodClass
{
GObjectClass parent; /* A laisser en premier */
};
/* Procède à l'initialisation d'une methode issue du code. */
static void g_dex_method_class_init(GDexMethodClass *);
/* Procède à l'initialisation d'une methode issue du code. */
static void g_dex_method_init(GDexMethod *);
/* Supprime toutes les références externes. */
static void g_dex_method_dispose(GDexMethod *);
/* Procède à la libération totale de la mémoire. */
static void g_dex_method_finalize(GDexMethod *);
/* Détermine le type d'une methode issue du code source. */
G_DEFINE_TYPE(GDexMethod, g_dex_method, G_TYPE_OBJECT);
/******************************************************************************
* *
* Paramètres : class = classe de composant GLib à initialiser. *
* *
* Description : Procède à l'initialisation des methodes issues du code. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void g_dex_method_class_init(GDexMethodClass *class)
{
GObjectClass *object; /* Autre version de la classe */
object = G_OBJECT_CLASS(class);
object->dispose = (GObjectFinalizeFunc/* ! */)g_dex_method_dispose;
object->finalize = (GObjectFinalizeFunc)g_dex_method_finalize;
}
/******************************************************************************
* *
* Paramètres : method = composant GLib à initialiser. *
* *
* Description : Procède à l'initialisation d'une methode issue du code. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void g_dex_method_init(GDexMethod *method)
{
#ifndef NDEBUG
method->already_defined = false;
#endif
}
/******************************************************************************
* *
* Paramètres : method = instance d'objet GLib à traiter. *
* *
* Description : Supprime toutes les références externes. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void g_dex_method_dispose(GDexMethod *method)
{
if (method->routine != NULL)
g_object_unref(G_OBJECT(method->routine));
G_OBJECT_CLASS(g_dex_method_parent_class)->dispose(G_OBJECT(method));
}
/******************************************************************************
* *
* Paramètres : method = instance d'objet GLib à traiter. *
* *
* Description : Procède à la libération totale de la mémoire. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void g_dex_method_finalize(GDexMethod *method)
{
if (method->has_body)
reset_dex_code_item(&method->body);
G_OBJECT_CLASS(g_dex_method_parent_class)->finalize(G_OBJECT(method));
}
/******************************************************************************
* *
* Paramètres : format = représentation interne du format DEX à consulter. *
* seed = graine des informations à extraire. *
* last = dernier indice utilisé (à mettre à jour). [OUT] *
* *
* Description : Crée une nouvelle représentation de methode issue de code. *
* *
* Retour : Composant GLib créé. *
* *
* Remarques : - *
* *
******************************************************************************/
GDexMethod *g_dex_method_new_defined(GDexFormat *format, const encoded_method *seed, uleb128_t *last)
{
GDexMethod *result; /* Composant à retourner */
GDexPool *pool; /* Table de ressources */
vmpa2t addr; /* Tête de lecture générique */
code_item item; /* Corps de la méthode */
phys_t ins_offset; /* Position physique du code */
mrange_t range; /* Emplacement du code associé */
*last += seed->method_idx_diff;
pool = g_dex_format_get_pool(format);
result = g_dex_pool_get_method(pool, *last);
g_object_unref(G_OBJECT(pool));
if (result == NULL)
return NULL;
#ifndef NDEBUG
assert(!result->already_defined);
result->already_defined = true;
#endif
result->info = *seed;
result->has_body = (seed->code_off > 0);
if (result->has_body)
{
init_vmpa(&addr, seed->code_off, VMPA_NO_VIRTUAL);
if (!read_dex_code_item(format, &addr, &item))
goto gdmnd_bad_code_item;
ins_offset = seed->code_off + offsetof(code_item, insns);
if (!g_exe_format_translate_offset_into_vmpa(G_EXE_FORMAT(format), ins_offset, &addr))
goto gdmnd_bad_translation;
result->body = item;
result->offset = ins_offset;
init_mrange(&range, &addr, item.insns_size * sizeof(uint16_t));
g_binary_symbol_set_range(G_BIN_SYMBOL(result->routine), &range);
}
return result;
gdmnd_bad_translation:
reset_dex_code_item(&item);
gdmnd_bad_code_item:
g_object_unref(G_OBJECT(result));
return NULL;
}
/******************************************************************************
* *
* Paramètres : format = représentation interne du format DEX à consulter.*
* id_item = informations de base quant à la méthode. *
* *
* Description : Crée une nouvelle représentation de methode vide. *
* *
* Retour : Composant GLib créé. *
* *
* Remarques : - *
* *
******************************************************************************/
GDexMethod *g_dex_method_new_callable(GDexFormat *format, const method_id_item *id_item)
{
GDexMethod *result; /* Composant à retourner */
GDexPool *pool; /* Table de ressources */
GDataType *ns; /* Espace d'appartenance */
const char *name; /* Nom de la routine finale */
GBinRoutine *routine; /* Routine représentée */
result = NULL;
pool = g_dex_format_get_pool(format);
ns = g_dex_pool_get_type_(pool, id_item->class_idx);
name = g_dex_pool_get_string(pool, id_item->name_idx, NULL);
if (name == NULL) goto gdmne_exit;
routine = g_dex_pool_get_prototype(pool, id_item->proto_idx);
if (routine == NULL) goto gdmne_exit;
if (ns != NULL)
g_binary_routine_set_namespace(routine, ns, strdup("."));
g_binary_routine_set_name(routine, strdup(name));
result = g_object_new(G_TYPE_DEX_METHOD, NULL);
result->routine = routine;
g_dex_routine_attach_method(G_DEX_ROUTINE(routine), result);
result->id_item = *id_item;
gdmne_exit:
g_object_unref(G_OBJECT(pool));
return result;
}
/******************************************************************************
* *
* Paramètres : method = représentation interne de la méthode à consulter. *
* *
* Description : Fournit les identifiants Dex concernant la méthode. *
* *
* Retour : Données brutes du binaire. *
* *
* Remarques : - *
* *
******************************************************************************/
const method_id_item *g_dex_method_get_dex_id_item(const GDexMethod *method)
{
return &method->id_item;
}
/******************************************************************************
* *
* Paramètres : method = représentation interne de la méthode à consulter. *
* *
* Description : Fournit les indications Dex concernant la méthode. *
* *
* Retour : Données brutes du binaire. *
* *
* Remarques : - *
* *
******************************************************************************/
const encoded_method *g_dex_method_get_dex_info(const GDexMethod *method)
{
return &method->info;
}
/******************************************************************************
* *
* Paramètres : method = représentation interne de la méthode à consulter. *
* *
* Description : Indique si du code est rattaché à une méthode Dex. *
* *
* Retour : true si la méthode n'est pas abstraite ni native. *
* *
* Remarques : - *
* *
******************************************************************************/
bool g_dex_method_has_dex_body(const GDexMethod *method)
{
return method->has_body;
}
/******************************************************************************
* *
* Paramètres : method = représentation interne de la méthode à consulter. *
* *
* Description : Fournit les indications Dex relatives au corps de la méthode.*
* *
* Retour : Données brutes du binaire. *
* *
* Remarques : - *
* *
******************************************************************************/
const code_item *g_dex_method_get_dex_body(const GDexMethod *method)
{
return (method->has_body ? &method->body : NULL);
}
/******************************************************************************
* *
* Paramètres : method = représentation interne du format DEX à consulter. *
* *
* Description : Fournit la routine Chrysalide correspondant à la méthode. *
* *
* Retour : Instance de routine mise en place. *
* *
* Remarques : - *
* *
******************************************************************************/
GBinRoutine *g_dex_method_get_routine(const GDexMethod *method)
{
GBinRoutine *result; /* Instance à retourner */
result = method->routine;
g_object_ref(G_OBJECT(result));
return result;
}
/******************************************************************************
* *
* Paramètres : method = représentation interne du format DEX à consulter. *
* format = format permettant d'obtenir une adresse complète. *
* *
* Description : Intègre la méthode en tant que portion de code. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
void g_dex_method_include_as_portion(const GDexMethod *method, GExeFormat *format)
{
vmpa2t addr; /* Emplacement dans le binaire */
GBinPortion *new; /* Nouvelle portion définie */
/* Si la taille est nulle, on ne fait rien */
if (method->info.access_flags & ACC_NATIVE)
return;
if (!method->has_body)
return;
if (!g_exe_format_translate_offset_into_vmpa(format, method->offset, &addr))
return;
new = g_binary_portion_new(BPC_CODE, &addr, method->body.insns_size * sizeof(uint16_t));
g_binary_portion_set_desc(new, _("Dalvik code"));
g_binary_portion_set_rights(new, PAC_READ | PAC_EXEC);
g_exe_format_include_portion(format, new, &method->info.origin);
}
/******************************************************************************
* *
* Paramètres : method = représentation interne du format DEX à consulter. *
* offset = position physique à renseigner. [OUT] *
* *
* Description : Indique la position de la méthode au sein du binaire. *
* *
* Retour : Validiter de la position dans le contenu binaire. *
* *
* Remarques : - *
* *
******************************************************************************/
bool g_dex_method_get_offset(const GDexMethod *method, phys_t *offset)
{
bool result; /* Indication à retourner */
result = method->has_body;
if (result)
*offset = method->offset;
return result;
}
/******************************************************************************
* *
* Paramètres : method = représentation interne du format DEX à consulter. *
* index = indice de base comme seul indice. *
* *
* Description : Fournit des indications sur la nature d'une variable donnée. *
* *
* Retour : Indentifiant complet d'une variable utilisée. *
* *
* Remarques : - *
* *
******************************************************************************/
DexVariableIndex g_dex_method_get_variable(const GDexMethod *method, uint32_t index)
{
const encoded_method *info; /* Propriétés de la méthode */
const code_item *body; /* Corps de la méthode */
uint32_t pivot; /* Bascule pour les arguments */
assert(method->has_body);
info = &method->info;
body = &method->body;
/* S'agit-il d'un argument ? */
pivot = body->registers_size - body->ins_size;
if (!(info->access_flags & ACC_STATIC))
pivot++;
if (index >= pivot)
return (index - pivot) | DVI_ARGUMENT;
/* S'agit-il de "this" ? */
if (!(info->access_flags & ACC_STATIC)
&& index == (body->registers_size - body->ins_size))
return DVI_THIS;
/* Alors il s'agit d'une variable locale... */
return index | DVI_LOCAL;
}