/* Chrysalide - Outil d'analyse de fichiers binaires
* binary.c - équivalent Python du fichier "analysis/binary.h"
*
* Copyright (C) 2010-2012 Cyrille Bagard
*
* This file is part of Chrysalide.
*
* 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 this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
#include "binary.h"
#include <pygobject.h>
#include <i18n.h>
#include <analysis/binary.h>
#include "content.h"
#include "../helpers.h"
/* Crée un nouvel objet Python de type 'LoadedBinary'. */
static PyObject *py_loaded_binary_new(PyTypeObject *, PyObject *, PyObject *);
/* Fournit le nom associé à l'élément binaire. */
static PyObject *py_loaded_binary_get_name(PyObject *, void *);
/* Lance l'analyse d'un élément binaire chargé. */
static PyObject *py_loaded_binary_analyse(PyObject *, PyObject *);
/* Fournit le format de fichier reconnu dans le contenu binaire. */
static PyObject *py_loaded_binary_get_format(PyObject *, void *);
/* Fournit le processeur de l'architecture liée au binaire. */
static PyObject *py_loaded_binary_get_processor(PyObject *, void *);
/* Fournit le tampon associé au contenu assembleur d'un binaire. */
static PyObject *py_loaded_binary_get_disassembled_buffer(PyObject *, void *);
/******************************************************************************
* *
* Paramètres : type = type de l'objet à instancier. *
* args = arguments fournis à l'appel. *
* kwds = arguments de type key=val fournis. *
* *
* Description : Crée un nouvel objet Python de type 'LoadedBinary'. *
* *
* Retour : Instance Python mise en place. *
* *
* Remarques : - *
* *
******************************************************************************/
static PyObject *py_loaded_binary_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
{
PyObject *result; /* Instance à retourner */
PyObject *content_obj; /* Objet pour le contenu */
int ret; /* Bilan de lecture des args. */
GBinContent *content; /* Instance GLib correspondante*/
GLoadedBinary *binary; /* Version GLib du format */
ret = PyArg_ParseTuple(args, "O", &content_obj);
if (!ret) return NULL;
ret = PyObject_IsInstance(content_obj, (PyObject *)get_python_binary_content_type());
if (ret == 0)
{
PyErr_SetString(PyExc_TypeError, _("Expected a BinContent as argument"));
return NULL;
}
content = G_BIN_CONTENT(pygobject_get(content_obj));
binary = g_loaded_binary_new(content);
result = pygobject_new(G_OBJECT(binary));
g_object_unref(binary);
return result;
}
/******************************************************************************
* *
* Paramètres : self = objet Python concerné par l'appel. *
* closure = non utilisé ici. *
* *
* Description : Fournit le nom associé à l'élément binaire. *
* *
* Retour : Nom de fichier avec chemin absolu. *
* *
* Remarques : - *
* *
******************************************************************************/
static PyObject *py_loaded_binary_get_name(PyObject *self, void *closure)
{
PyObject *result; /* Trouvailles à retourner */
GLoadedBinary *binary; /* Version native */
const char *name; /* Désignation du binaire */
binary = G_LOADED_BINARY(pygobject_get(self));
name = g_loaded_binary_get_name(binary, true);
result = PyUnicode_FromString(name);
return result;
}
/******************************************************************************
* *
* Paramètres : self = contenu binaire à manipuler. *
* args = non utilisé ici. *
* *
* Description : Lance l'analyse d'un élément binaire chargé. *
* *
* Retour : Rien (None). *
* *
* Remarques : - *
* *
******************************************************************************/
static PyObject *py_loaded_binary_analyse(PyObject *self, PyObject *args)
{
GLoadedBinary *binary; /* Version GLib du format */
binary = G_LOADED_BINARY(pygobject_get(self));
g_loaded_binary_analyse(binary);
Py_RETURN_NONE;
}
/******************************************************************************
* *
* Paramètres : self = objet Python concerné par l'appel. *
* closure = non utilisé ici. *
* *
* Description : Fournit le format de fichier reconnu dans le contenu binaire.*
* *
* Retour : Instance du format reconnu. *
* *
* Remarques : - *
* *
******************************************************************************/
static PyObject *py_loaded_binary_get_format(PyObject *self, void *closure)
{
PyObject *result; /* Instance Python à retourner */
GLoadedBinary *binary; /* Binaire en cours d'analyse */
GExeFormat *format; /* Format du binaire lié */
binary = G_LOADED_BINARY(pygobject_get(self));
format = g_loaded_binary_get_format(binary);
result = pygobject_new(G_OBJECT(format));
//g_object_unref(G_OBJECT(format));
return result;
}
/******************************************************************************
* *
* Paramètres : self = objet Python concerné par l'appel. *
* closure = non utilisé ici. *
* *
* Description : Fournit le processeur de l'architecture liée au binaire. *
* *
* Retour : Instance du processeur associé. *
* *
* Remarques : - *
* *
******************************************************************************/
static PyObject *py_loaded_binary_get_processor(PyObject *self, void *closure)
{
PyObject *result; /* Instance Python à retourner */
GLoadedBinary *binary; /* Binaire en cours d'analyse */
GArchProcessor *proc; /* Architecture visée */
binary = G_LOADED_BINARY(pygobject_get(self));
proc = g_loaded_binary_get_processor(binary);
result = pygobject_new(G_OBJECT(proc));
g_object_unref(G_OBJECT(proc));
return result;
}
/******************************************************************************
* *
* Paramètres : self = classe représentant une instruction. *
* closure = adresse non utilisée ici. *
* *
* Description : Fournit le tampon associé au contenu assembleur d'un binaire.*
* *
* Retour : Valeur associée à la propriété consultée. *
* *
* Remarques : - *
* *
******************************************************************************/
static PyObject *py_loaded_binary_get_disassembled_buffer(PyObject *self, void *closure)
{
PyObject *result; /* Trouvailles à retourner */
GLoadedBinary *binary; /* Version native */
GCodeBuffer *buffer; /* Tampon à récupérer */
binary = G_LOADED_BINARY(pygobject_get(self));
buffer = g_loaded_binary_get_disassembled_buffer(binary);
result = pygobject_new(G_OBJECT(buffer));
return result;
}
/******************************************************************************
* *
* Paramètres : - *
* *
* Description : Fournit un accès à une définition de type à diffuser. *
* *
* Retour : Définition d'objet pour Python. *
* *
* Remarques : - *
* *
******************************************************************************/
PyTypeObject *get_python_loaded_binary_type(void)
{
static PyMethodDef py_loaded_binary_methods[] = {
{
"analyse", py_loaded_binary_analyse,
METH_NOARGS,
"analyse(/)\n--\n\nStart the analysis of the loaded binary and " \
"send a \"disassembly-done\" signal when done."
},
{ NULL }
};
static PyGetSetDef py_loaded_binary_getseters[] = {
{
"name", py_loaded_binary_get_name, NULL,
"Name of the loaded binary.", NULL
},
{
"format", py_loaded_binary_get_format, NULL,
"File format recognized in the binary content.", NULL
},
{
"processor", py_loaded_binary_get_processor, NULL,
"Handler for the current binary processor.", NULL
},
{
"disassembled_buffer", py_loaded_binary_get_disassembled_buffer, NULL,
"Disassembled code buffer.", NULL
},
{ NULL }
};
static PyTypeObject py_loaded_binary_type = {
PyVarObject_HEAD_INIT(NULL, 0)
.tp_name = "pychrysalide.analysis.LoadedBinary",
.tp_flags = Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE,
.tp_doc = "PyChrysalide loaded binary",
.tp_methods = py_loaded_binary_methods,
.tp_getset = py_loaded_binary_getseters,
.tp_new = (newfunc)py_loaded_binary_new
};
return &py_loaded_binary_type;
}
/******************************************************************************
* *
* Paramètres : module = module dont la définition est à compléter. *
* *
* Description : Prend en charge l'objet 'pychrysalide.analysis.LoadedBinary'.*
* *
* Retour : Bilan de l'opération. *
* *
* Remarques : - *
* *
******************************************************************************/
bool register_python_loaded_binary(PyObject *module)
{
PyTypeObject *py_loaded_binary_type; /* Type Python 'LoadedBinary' */
int ret; /* Bilan d'un appel */
PyObject *dict; /* Dictionnaire du module */
py_loaded_binary_type = get_python_loaded_binary_type();
py_loaded_binary_type->tp_base = &PyGObject_Type;
py_loaded_binary_type->tp_basicsize = py_loaded_binary_type->tp_base->tp_basicsize;
//APPLY_ABSTRACT_FLAG(py_loaded_binary_type);
if (PyType_Ready(py_loaded_binary_type) != 0)
return false;
Py_INCREF(py_loaded_binary_type);
ret = PyModule_AddObject(module, "LoadedBinary", (PyObject *)py_loaded_binary_type);
if (ret != 0) return false;
dict = PyModule_GetDict(module);
pygobject_register_class(dict, "LoadedBinary", G_TYPE_LOADED_BINARY, py_loaded_binary_type,
Py_BuildValue("(O)", py_loaded_binary_type->tp_base));
return true;
}