/* Chrysalide - Outil d'analyse de fichiers binaires
* args.c - listes d'opérandes rassemblées en arguments
*
* 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 <http://www.gnu.org/licenses/>.
*/
#include "args.h"
#include <assert.h>
#include <malloc.h>
#include <arch/operand-int.h>
#include <common/sort.h>
/* Définition d'un opérande visant une liste d'opérandes Dalvik (instance) */
struct _GDalvikArgsOperand
{
GArchOperand parent; /* Instance parente */
GArchOperand **args; /* Liste d'arguments */
size_t count; /* Taille de cette liste */
};
/* Définition d'un opérande visant une liste d'opérandes Dalvik (classe) */
struct _GDalvikArgsOperandClass
{
GArchOperandClass parent; /* Classe parente */
};
/* Initialise la classe des listes d'opérandes Dalvik. */
static void g_dalvik_args_operand_class_init(GDalvikArgsOperandClass *);
/* Initialise une instance de liste d'opérandes Dalvik. */
static void g_dalvik_args_operand_init(GDalvikArgsOperand *);
/* Supprime toutes les références externes. */
static void g_dalvik_args_operand_dispose(GDalvikArgsOperand *);
/* Procède à la libération totale de la mémoire. */
static void g_dalvik_args_operand_finalize(GDalvikArgsOperand *);
/* Compare un opérande avec un autre. */
static int g_dalvik_args_operand_compare(const GDalvikArgsOperand *, const GDalvikArgsOperand *);
/* Traduit un opérande en version humainement lisible. */
static void g_dalvik_args_operand_print(const GDalvikArgsOperand *, GBufferLine *);
/* --------------------- TRANSPOSITIONS VIA CACHE DES OPERANDES --------------------- */
/* Charge un opérande depuis une mémoire tampon. */
static bool g_dalvik_args_operand_unserialize(GDalvikArgsOperand *, GAsmStorage *, GBinFormat *, packed_buffer *);
/* Sauvegarde un opérande dans une mémoire tampon. */
static bool g_dalvik_args_operand_serialize(const GDalvikArgsOperand *, GAsmStorage *, packed_buffer *);
/* Indique le type défini par la GLib pour une liste d'arguments Dalvik. */
G_DEFINE_TYPE(GDalvikArgsOperand, g_dalvik_args_operand, G_TYPE_ARCH_OPERAND);
/******************************************************************************
* *
* Paramètres : klass = classe à initialiser. *
* *
* Description : Initialise la classe des listes d'opérandes Dalvik. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void g_dalvik_args_operand_class_init(GDalvikArgsOperandClass *klass)
{
GObjectClass *object; /* Autre version de la classe */
GArchOperandClass *operand; /* Version de classe parente */
object = G_OBJECT_CLASS(klass);
operand = G_ARCH_OPERAND_CLASS(klass);
object->dispose = (GObjectFinalizeFunc/* ! */)g_dalvik_args_operand_dispose;
object->finalize = (GObjectFinalizeFunc)g_dalvik_args_operand_finalize;
operand->compare = (operand_compare_fc)g_dalvik_args_operand_compare;
operand->print = (operand_print_fc)g_dalvik_args_operand_print;
operand->unserialize = (unserialize_operand_fc)g_dalvik_args_operand_unserialize;
operand->serialize = (serialize_operand_fc)g_dalvik_args_operand_serialize;
}
/******************************************************************************
* *
* Paramètres : operand = instance à initialiser. *
* *
* Description : Initialise une instance de liste d'opérandes Dalvik. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void g_dalvik_args_operand_init(GDalvikArgsOperand *operand)
{
operand->args = NULL;
operand->count = 0;
}
/******************************************************************************
* *
* Paramètres : operand = instance d'objet GLib à traiter. *
* *
* Description : Supprime toutes les références externes. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void g_dalvik_args_operand_dispose(GDalvikArgsOperand *operand)
{
size_t i;
for (i = 0; i < operand->count; i++)
g_object_unref(G_OBJECT(operand->args[i]));
G_OBJECT_CLASS(g_dalvik_args_operand_parent_class)->dispose(G_OBJECT(operand));
}
/******************************************************************************
* *
* Paramètres : operand = instance d'objet GLib à traiter. *
* *
* Description : Procède à la libération totale de la mémoire. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void g_dalvik_args_operand_finalize(GDalvikArgsOperand *operand)
{
if (operand->args != NULL)
free(operand->args);
G_OBJECT_CLASS(g_dalvik_args_operand_parent_class)->finalize(G_OBJECT(operand));
}
/******************************************************************************
* *
* Paramètres : a = premier opérande à consulter. *
* b = second opérande à consulter. *
* *
* Description : Compare un opérande avec un autre. *
* *
* Retour : Bilan de la comparaison. *
* *
* Remarques : - *
* *
******************************************************************************/
static int g_dalvik_args_operand_compare(const GDalvikArgsOperand *a, const GDalvikArgsOperand *b)
{
int result; /* Bilan à renvoyer */
size_t i; /* Boucle de parcours */
/* Création de l'objet... */
if (b == NULL)
result = 1;
else
{
result = sort_unsigned_long(a->count, b->count);
for (i = 0; i < a->count && result == 0; i++)
result = g_arch_operand_compare(a->args[i], b->args[i]);
}
return result;
}
/******************************************************************************
* *
* Paramètres : operand = opérande à traiter. *
* line = ligne tampon où imprimer l'opérande donné. *
* *
* Description : Traduit un opérande en version humainement lisible. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void g_dalvik_args_operand_print(const GDalvikArgsOperand *operand, GBufferLine *line)
{
size_t i; /* Boucle de parcours */
g_buffer_line_append_text(line, BLC_ASSEMBLY, "{", 1, RTT_HOOK, NULL);
if (operand->count > 0)
{
g_arch_operand_print(operand->args[0], line);
for (i = 1; i < operand->count; i++)
{
g_buffer_line_append_text(line, BLC_ASSEMBLY, ",", 1, RTT_PUNCT, NULL);
g_buffer_line_append_text(line, BLC_ASSEMBLY, " ", 1, RTT_RAW, NULL);
g_arch_operand_print(operand->args[i], line);
}
}
g_buffer_line_append_text(line, BLC_ASSEMBLY, "}", 1, RTT_HOOK, NULL);
}
/******************************************************************************
* *
* Paramètres : - *
* *
* Description : Crée un réceptacle pour opérandes Dalvik servant d'arguments.*
* *
* Retour : Opérande mis en place. *
* *
* Remarques : - *
* *
******************************************************************************/
GArchOperand *g_dalvik_args_operand_new(void)
{
GArchOperand *result; /* Structure à retourner */
result = g_object_new(G_TYPE_DALVIK_ARGS_OPERAND, NULL);
return result;
}
/******************************************************************************
* *
* Paramètres : operand = opérande à compléter. *
* arg = nouvel argument pour un appel. *
* *
* Description : Ajoute un élément à la liste d'arguments Dalvik. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
void g_dalvik_args_operand_add(GDalvikArgsOperand *operand, GArchOperand *arg)
{
operand->count++;
operand->args = (GArchOperand **)realloc(operand->args, operand->count * sizeof(GArchOperand *));
operand->args[operand->count - 1] = arg;
}
/******************************************************************************
* *
* Paramètres : operand = opérande à compléter. *
* *
* Description : Fournit le nombre d'arguments pris en charge. *
* *
* Retour : Nombre positif ou nul. *
* *
* Remarques : - *
* *
******************************************************************************/
size_t g_dalvik_args_count(const GDalvikArgsOperand *operand)
{
return operand->count;
}
/******************************************************************************
* *
* Paramètres : operand = opérande à compléter. *
* index = indice de l'argument recherché. *
* *
* Description : Founit un élément de la liste d'arguments Dalvik. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
GArchOperand *g_dalvik_args_operand_get(const GDalvikArgsOperand *operand, size_t index)
{
assert(index < operand->count);
return operand->args[index];
}
/* ---------------------------------------------------------------------------------- */
/* TRANSPOSITIONS VIA CACHE DES OPERANDES */
/* ---------------------------------------------------------------------------------- */
/******************************************************************************
* *
* Paramètres : operand = opérande d'assemblage à constituer. *
* storage = mécanisme de sauvegarde à manipuler. *
* format = format binaire chargé associé à l'architecture. *
* pbuf = zone tampon à remplir. *
* *
* Description : Charge un opérande depuis une mémoire tampon. *
* *
* Retour : Bilan de l'opération. *
* *
* Remarques : - *
* *
******************************************************************************/
static bool g_dalvik_args_operand_unserialize(GDalvikArgsOperand *operand, GAsmStorage *storage, GBinFormat *format, packed_buffer *pbuf)
{
bool result; /* Bilan à retourner */
GArchOperandClass *parent; /* Classe parente à consulter */
size_t count; /* Nombre d'opérandes à charger*/
size_t i; /* Boucle de parcours */
GArchOperand *arg; /* Nouvel argument à intégrer */
parent = G_ARCH_OPERAND_CLASS(g_dalvik_args_operand_parent_class);
result = parent->unserialize(G_ARCH_OPERAND(operand), storage, format, pbuf);
if (result)
result = extract_packed_buffer(pbuf, &count, sizeof(size_t), true);
for (i = 0; i < count && result; i++)
{
arg = g_arch_operand_load(storage, format, pbuf);
if (arg == NULL)
result = false;
else
g_dalvik_args_operand_add(operand, arg);
}
return result;
}
/******************************************************************************
* *
* Paramètres : operand = opérande d'assemblage à consulter. *
* storage = mécanisme de sauvegarde à manipuler. *
* pbuf = zone tampon à remplir. *
* *
* Description : Sauvegarde un opérande dans une mémoire tampon. *
* *
* Retour : Bilan de l'opération. *
* *
* Remarques : - *
* *
******************************************************************************/
static bool g_dalvik_args_operand_serialize(const GDalvikArgsOperand *operand, GAsmStorage *storage, packed_buffer *pbuf)
{
bool result; /* Bilan à retourner */
GArchOperandClass *parent; /* Classe parente à consulter */
size_t i; /* Boucle de parcours */
parent = G_ARCH_OPERAND_CLASS(g_dalvik_args_operand_parent_class);
result = parent->serialize(G_ARCH_OPERAND(operand), storage, pbuf);
if (result)
result = extend_packed_buffer(pbuf, &operand->count, sizeof(size_t), true);
for (i = 0; i < operand->count && result; i++)
result = g_arch_operand_store(operand->args[i], storage, pbuf);
return result;
}