summaryrefslogtreecommitdiff
path: root/src/arch/operand-int.h
blob: d2f43f1591c6d14ce1b8fb1b822ea46318786393 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139

/* Chrysalide - Outil d'analyse de fichiers binaires
 * operand-int.h - prototypes pour la définition générique interne des opérandes
 *
 * Copyright (C) 2008-2020 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/>.
 */


#ifndef _ARCH_OPERAND_INT_H
#define _ARCH_OPERAND_INT_H


#include "operand.h"
#include "../analysis/storage/storage.h"
#include "../glibext/objhole.h"



/* Compare un opérande avec un autre. */
typedef int (* operand_compare_fc) (const GArchOperand *, const GArchOperand *, bool);

/* Détermine le chemin conduisant à un opérande interne. */
typedef char * (* find_inner_operand_fc) (const GArchOperand *, const GArchOperand *);

/* Obtient l'opérande correspondant à un chemin donné. */
typedef GArchOperand * (* get_inner_operand_fc) (const GArchOperand *, const char *);

/* Traduit un opérande en version humainement lisible. */
typedef void (* operand_print_fc) (const GArchOperand *, GBufferLine *);

/* Construit un petit résumé concis de l'opérande. */
typedef char * (* operand_build_tooltip_fc) (const GArchOperand *, const GLoadedBinary *);

/* Fournit une liste de candidats embarqués par un candidat. */
typedef GArchOperand ** (* operand_list_inners_fc) (const GArchOperand *, size_t *);

/* Met à jour une liste de candidats embarqués par un candidat. */
typedef void (* operand_update_inners_fc) (GArchOperand *, GArchOperand **, size_t);

/* Fournit l'empreinte d'un candidat à une centralisation. */
typedef guint (* operand_hash_fc) (const GArchOperand *, bool);

/* Charge un contenu depuis une mémoire tampon. */
typedef bool (* load_operand_fc) (GArchOperand *, GObjectStorage *, packed_buffer_t *);

/* Sauvegarde un contenu dans une mémoire tampon. */
typedef bool (* store_operand_fc) (GArchOperand *, GObjectStorage *, packed_buffer_t *);


/* Informations glissées dans la structure GObject de GArchOperand */
typedef struct _operand_extra_data_t
{
    ArchOperandFlag flags;                  /* Informations diverses       */

} operand_extra_data_t;

/* Encapsulation avec un verrou d'accès */
typedef union _operand_obj_extra_t
{
    operand_extra_data_t data;              /* Données embarquées          */
    lockable_obj_extra_t lockable;          /* Gestion d'accès aux fanions */

} operand_obj_extra_t;


/* Définition générique d'un opérande d'architecture (instance) */
struct _GArchOperand
{
    GObject parent;                         /* A laisser en premier        */

#if __SIZEOF_INT__ == __SIZEOF_LONG__

    /**
     * L'inclusion des informations suivantes dépend de l'architecture.
     *
     * Si la structure GObject possède un trou, on remplit de préférence
     * ce dernier.
     */

    operand_obj_extra_t extra;              /* Externalisation embarquée   */

#endif

};

/* Définition générique d'un opérande d'architecture (classe) */
struct _GArchOperandClass
{
    GObjectClass parent;                    /* A laisser en premier        */

    operand_compare_fc compare;             /* Comparaison d'opérandes     */
    find_inner_operand_fc find_inner;       /* Définition d'un chemin      */
    get_inner_operand_fc get_inner;         /* Récupération d'un opérande  */

    operand_print_fc print;                 /* Texte humain équivalent     */
    operand_build_tooltip_fc build_tooltip; /* Construction de description */

    operand_list_inners_fc list_inner;      /* Récupération d'internes     */
    operand_update_inners_fc update_inner;  /* Mise à jour des éléments    */
    operand_hash_fc hash;                   /* Prise d'empreinte           */

    load_operand_fc load;                   /* Chargement depuis un tampon */
    store_operand_fc store;                 /* Conservation dans un tampon */

};


/**
 * Accès aux informations éventuellement déportées.
 */

#if __SIZEOF_INT__ == __SIZEOF_LONG__

#   define GET_ARCH_OP_EXTRA(op) (operand_extra_data_t *)&op->extra

#else

#   define GET_ARCH_OP_EXTRA(op) GET_GOBJECT_EXTRA(G_OBJECT(op), operand_extra_data_t)

#endif



#endif  /* _ARCH_OPERAND_INT_H */