/* Chrysalide - Outil d'analyse de fichiers binaires
* undefined.c - instructions au comportement non défini
*
* Copyright (C) 2016-2025 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 "undefined.h"
#include
#include
#include
#include "undefined-int.h"
#include "../../glibext/serialize-int.h"
/* ------------------------- INSTRUCTION INCONNUE / DONNEES ------------------------- */
/* Initialise la classe des instructions non définies. */
static void g_undefined_instruction_class_init(GUndefinedInstructionClass *);
/* Initialise une instance d'instruction non définie. */
static void g_undefined_instruction_init(GUndefinedInstruction *);
/* Supprime toutes les références externes. */
static void g_undefined_instruction_dispose(GObject *);
/* Procède à la libération totale de la mémoire. */
static void g_undefined_instruction_finalize(GObject *);
/* --------------------- IMPLEMENTATION DES FONCTIONS DE CLASSE --------------------- */
/* Indique l'encodage d'une instruction de façon détaillée. */
static char *g_undefined_instruction_get_encoding(const GArchInstruction *);
/* Fournit le nom humain de l'instruction manipulée. */
static char *g_undefined_instruction_get_keyword(const GArchInstruction *);
/* ---------------------------------------------------------------------------------- */
/* INSTRUCTION INCONNUE / DONNEES */
/* ---------------------------------------------------------------------------------- */
/* Indique le type défini pour une instruction au comportement non défini. */
G_DEFINE_TYPE_WITH_CODE(GUndefinedInstruction, g_undefined_instruction, G_TYPE_ARCH_INSTRUCTION,
G_IMPLEMENT_INTERFACE_IF_SYM(g_token_generator_get_type, g_undefined_instruction_ui_token_generator_iface_init));
/******************************************************************************
* *
* Paramètres : klass = classe à initialiser. *
* *
* Description : Initialise la classe des instructions non définies. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void g_undefined_instruction_class_init(GUndefinedInstructionClass *klass)
{
GObjectClass *object; /* Autre version de la classe */
GArchInstructionClass *instr; /* Encore une autre vision... */
object = G_OBJECT_CLASS(klass);
object->dispose = g_undefined_instruction_dispose;
object->finalize = g_undefined_instruction_finalize;
instr = G_ARCH_INSTRUCTION_CLASS(klass);
instr->get_encoding = g_undefined_instruction_get_encoding;
instr->get_keyword = g_undefined_instruction_get_keyword;
}
/******************************************************************************
* *
* Paramètres : instr = instance à initialiser. *
* *
* Description : Initialise une instance d'instruction non définie. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void g_undefined_instruction_init(GUndefinedInstruction *instr)
{
undef_extra_data_t extra; /* Données insérées à consulter*/
extra = GET_UNDEF_INSTR_EXTRA(instr);
extra.behavior = IEB_UNDEFINED;
SET_UNDEF_INSTR_EXTRA(instr, &extra);
}
/******************************************************************************
* *
* Paramètres : object = instance d'objet GLib à traiter. *
* *
* Description : Supprime toutes les références externes. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void g_undefined_instruction_dispose(GObject *object)
{
G_OBJECT_CLASS(g_undefined_instruction_parent_class)->dispose(object);
}
/******************************************************************************
* *
* Paramètres : object = instance d'objet GLib à traiter. *
* *
* Description : Procède à la libération totale de la mémoire. *
* *
* Retour : - *
* *
* Remarques : - *
* *
******************************************************************************/
static void g_undefined_instruction_finalize(GObject *object)
{
G_OBJECT_CLASS(g_undefined_instruction_parent_class)->finalize(object);
}
/******************************************************************************
* *
* Paramètres : behavior = état réel du CPU après une passe de l'instruction.*
* *
* Description : Crée une instruction au comportement nominalement indéfini. *
* *
* Retour : Instruction mise en place. *
* *
* Remarques : - *
* *
******************************************************************************/
GArchInstruction *g_undefined_instruction_new(InstrExpectedBehavior behavior)
{
GArchInstruction *result; /* Instruction à retourner */
result = g_object_new(G_TYPE_UNDEFINED_INSTRUCTION, NULL);
if (!g_undefined_instruction_create(G_UNDEFINED_INSTRUCTION(result), behavior))
g_clear_object(&result);
return result;
}
/******************************************************************************
* *
* Paramètres : instr = instance à initialiser pleinement. *
* behavior = état réel du CPU après une passe de l'instruction.*
* *
* Description : Met en place une instruction au comportement indéfini. *
* *
* Retour : Bilan de l'opération. *
* *
* Remarques : - *
* *
******************************************************************************/
bool g_undefined_instruction_create(GUndefinedInstruction *instr, InstrExpectedBehavior behavior)
{
bool result; /* Bilan à retourner */
undef_extra_data_t extra; /* Données insérées à modifier */
result = true;
extra = GET_UNDEF_INSTR_EXTRA(instr);
extra.behavior = behavior;
SET_UNDEF_INSTR_EXTRA(instr, &extra);
return result;
}
/******************************************************************************
* *
* Paramètres : instr = instruction à consulter. *
* *
* Description : Indique le type de conséquences réél de l'instruction. *
* *
* Retour : Etat réel du CPU après l'exécution de l'instruction. *
* *
* Remarques : - *
* *
******************************************************************************/
InstrExpectedBehavior g_undefined_instruction_get_behavior(const GUndefinedInstruction *instr)
{
InstrExpectedBehavior result; /* Comportement à retourner */
undef_extra_data_t extra; /* Données insérées à consulter*/
extra = GET_UNDEF_INSTR_EXTRA(instr);
result = extra.behavior;
return result;
}
/* ---------------------------------------------------------------------------------- */
/* IMPLEMENTATION DES FONCTIONS DE CLASSE */
/* ---------------------------------------------------------------------------------- */
/******************************************************************************
* *
* Paramètres : instr = instruction quelconque à consulter. *
* *
* Description : Indique l'encodage d'une instruction de façon détaillée. *
* *
* Retour : Description humaine de l'encodage utilisé. *
* *
* Remarques : - *
* *
******************************************************************************/
static char *g_undefined_instruction_get_encoding(const GArchInstruction *instr)
{
char *result; /* Description à retourner */
result = strdup(_("Undefined"));
return result;
}
/******************************************************************************
* *
* Paramètres : instr = instruction d'assemblage à consulter. *
* *
* Description : Fournit le nom humain de l'instruction manipulée. *
* *
* Retour : Mot clef de bas niveau. *
* *
* Remarques : - *
* *
******************************************************************************/
static char *g_undefined_instruction_get_keyword(const GArchInstruction *instr)
{
char *result; /* Désignation à retourner */
undef_extra_data_t extra; /* Données insérées à consulter*/
extra = GET_UNDEF_INSTR_EXTRA(instr);
switch (extra.behavior)
{
case IEB_NOP:
result = strdup("nop");
break;
case IEB_UNDEFINED:
result = strdup("undefined");
break;
case IEB_UNPREDICTABLE:
result = strdup("unpredictable");
break;
case IEB_RESERVED:
result = strdup("reserved");
break;
default:
assert(false);
result = NULL;
break;
}
return result;
}