summaryrefslogtreecommitdiff
path: root/plugins/pychrysalide
diff options
context:
space:
mode:
authorCyrille Bagard <nocbos@gmail.com>2020-02-23 22:51:40 (GMT)
committerCyrille Bagard <nocbos@gmail.com>2020-02-23 22:51:40 (GMT)
commit526985383c4e601775b4f04b273566b8ab930a58 (patch)
treeb248ff952c9054e8afa47dcaff279c17d51009fe /plugins/pychrysalide
parent89f9d10299e5ae520e2652b03abced1cdedca064 (diff)
Defined a working way to build routines from Python.
Diffstat (limited to 'plugins/pychrysalide')
-rw-r--r--plugins/pychrysalide/analysis/routine.c126
1 files changed, 101 insertions, 25 deletions
diff --git a/plugins/pychrysalide/analysis/routine.c b/plugins/pychrysalide/analysis/routine.c
index 0c0ef89..dee07f7 100644
--- a/plugins/pychrysalide/analysis/routine.c
+++ b/plugins/pychrysalide/analysis/routine.c
@@ -50,6 +50,9 @@ static PyObject *py_binary_routine_to_str(PyObject *);
/* Crée un nouvel objet Python de type 'BinRoutine'. */
static PyObject *py_binary_routine_new(PyTypeObject *, PyObject *, PyObject *);
+/* Initialise une instance sur la base du dérivé de GObject. */
+static int py_binary_routine_init(PyObject *, PyObject *, PyObject *);
+
/* Fournit le groupe d'appartenance d'une routine donnée. */
static PyObject *py_binary_routine_get_namespace(PyObject *, void *);
@@ -143,6 +146,49 @@ static PyObject *py_binary_routine_new(PyTypeObject *type, PyObject *args, PyObj
/******************************************************************************
* *
+* Paramètres : self = objet à initialiser (théoriquement). *
+* args = arguments fournis à l'appel. *
+* kwds = arguments de type key=val fournis. *
+* *
+* Description : Initialise une instance sur la base du dérivé de GObject. *
+* *
+* Retour : 0. *
+* *
+* Remarques : - *
+* *
+******************************************************************************/
+
+static int py_binary_routine_init(PyObject *self, PyObject *args, PyObject *kwds)
+{
+ int result; /* Bilan à retourner */
+
+ /**
+ * Si cette fonction n'est pas définie, l'initialisation de l'instance
+ * se réalise via py_binary_symbol_init(), et l'interface attend là
+ * des arguments...
+ */
+
+#define BINARY_ROUTINE_DOC \
+ "BinRoutine is an object for a function in a binary.\n" \
+ "\n" \
+ "Instances can be created using the following constructor:\n" \
+ "\n" \
+ " BinRoutine()" \
+ "\n" \
+ "As routines can be built from demangling, with no information other than" \
+ " a name at first glance, the usual process is to create a routine object" \
+ " and to define its core properties (namely a location range and a symbol" \
+ " type) after this operation."
+
+ result = 0;
+
+ return result;
+
+}
+
+
+/******************************************************************************
+* *
* Paramètres : self = objet Python concerné par l'appel. *
* closure = non utilisé ici. *
* *
@@ -160,6 +206,13 @@ static PyObject *py_binary_routine_get_namespace(PyObject *self, void *closure)
GBinRoutine *routine; /* Elément à consulter */
GDataType *ns; /* Espace de noms */
+#define BINARY_ROUTINE_NAMESPACE_ATTRIB PYTHON_GETSET_DEF_FULL \
+( \
+ namespace, py_binary_routine, \
+ "Namespace of the routine, provided as a" \
+ " pychrysalide.analysis.DataType instance, or None if any." \
+)
+
routine = G_BIN_ROUTINE(pygobject_get(self));
ns = g_binary_routine_get_namespace(routine);
@@ -258,6 +311,12 @@ static PyObject *py_binary_routine_get_name(PyObject *self, void *closure)
GBinRoutine *routine; /* Elément à consulter */
const char *name; /* Désignation courante */
+#define BINARY_ROUTINE_NAME_ATTRIB PYTHON_GETSET_DEF_FULL \
+( \
+ name, py_binary_routine, \
+ "String for the raw name of the routine or None if any." \
+)
+
routine = G_BIN_ROUTINE(pygobject_get(self));
name = g_binary_routine_get_name(routine);
@@ -330,6 +389,17 @@ static PyObject *py_binary_routine_get_typed_name(PyObject *self, void *closure)
GBinRoutine *routine; /* Elément à consulter */
GDataType *name; /* Type de nom */
+#define BINARY_ROUTINE_TYPED_NAME_ATTRIB PYTHON_GETSET_DEF_FULL \
+( \
+ typed_name, py_binary_routine, \
+ "Typed name of the routine, provided as a" \
+ " pychrysalide.analysis.DataType instance, or None if any.\n" \
+ "\n" \
+ "When a routine is built from a demangling operation, its final" \
+ " name carries some type information. This kind of information can" \
+ " be retrived thanks to this attribute." \
+)
+
routine = G_BIN_ROUTINE(pygobject_get(self));
name = g_binary_routine_get_typed_name(routine);
@@ -413,6 +483,13 @@ static PyObject *py_binary_routine_get_return_type(PyObject *self, void *closure
GBinRoutine *routine; /* Elément à consulter */
GDataType *ret; /* Type de retour */
+#define BINARY_ROUTINE_RETURN_TYPE_ATTRIB PYTHON_GETSET_DEF_FULL \
+( \
+ return_type, py_binary_routine, \
+ "Return of the routine, provided as a" \
+ " pychrysalide.analysis.DataType instance, or None if any." \
+)
+
routine = G_BIN_ROUTINE(pygobject_get(self));
ret = g_binary_routine_get_return_type(routine);
@@ -498,6 +575,13 @@ static PyObject *py_binary_routine_get_args(PyObject *self, void *closure)
size_t i; /* Boucle de parcours */
GBinVariable *arg; /* Argument à transcrire */
+#define BINARY_ROUTINE_ARGS_ATTRIB PYTHON_GET_DEF_FULL \
+( \
+ args, py_binary_routine, \
+ "Arguments for the routine, provided as a tuple of" \
+ " pychrysalide.analysis.BinVariable instances." \
+)
+
routine = G_BIN_ROUTINE(pygobject_get(self));
count = g_binary_routine_get_args_count(routine);
@@ -538,6 +622,14 @@ static PyObject *py_binary_routine_get_basic_blocks(PyObject *self, void *closur
GBinRoutine *routine; /* Version native */
GBlockList *blocks; /* Blocs basiques de routine */
+#define BINARY_ROUTINE_BASIC_BLOCKS_ATTRIB PYTHON_GETSET_DEF_FULL \
+( \
+ basic_blocks, py_binary_routine, \
+ "Basic blocks for the routine.\n" \
+ "\n" \
+ "This list is managed by a pychrysalide.analysis.BlockList instance." \
+)
+
routine = G_BIN_ROUTINE(pygobject_get(self));
blocks = g_binary_routine_get_basic_blocks(routine);
@@ -602,30 +694,12 @@ PyTypeObject *get_python_binary_routine_type(void)
};
static PyGetSetDef py_binary_routine_getseters[] = {
- {
- "namespace", py_binary_routine_get_namespace, py_binary_routine_set_namespace,
- "Namespace for the routine, None if any.", NULL
- },
- {
- "name", py_binary_routine_get_name, py_binary_routine_set_name,
- "Name of the current routine.", NULL
- },
- {
- "typed_name", py_binary_routine_get_typed_name, py_binary_routine_set_typed_name,
- "Name of the current routine provided by a type.", NULL
- },
- {
- "ret", py_binary_routine_get_return_type, py_binary_routine_set_return_type,
- "Return type of the routine, None if any.", NULL
- },
- {
- "args", py_binary_routine_get_args, NULL,
- "Arguments for the routine.", NULL
- },
- {
- "basic_blocks", py_binary_routine_get_basic_blocks, py_binary_routine_set_basic_blocks,
- "Basic blocks of the binary routine.", NULL
- },
+ BINARY_ROUTINE_NAMESPACE_ATTRIB,
+ BINARY_ROUTINE_NAME_ATTRIB,
+ BINARY_ROUTINE_TYPED_NAME_ATTRIB,
+ BINARY_ROUTINE_RETURN_TYPE_ATTRIB,
+ BINARY_ROUTINE_ARGS_ATTRIB,
+ BINARY_ROUTINE_BASIC_BLOCKS_ATTRIB,
{ NULL }
};
@@ -639,10 +713,12 @@ PyTypeObject *get_python_binary_routine_type(void)
.tp_flags = Py_TPFLAGS_DEFAULT,
- .tp_doc = "PyChrysalide binary routine",
+ .tp_doc = BINARY_ROUTINE_DOC,
.tp_methods = py_binary_routine_methods,
.tp_getset = py_binary_routine_getseters,
+
+ .tp_init = py_binary_routine_init,
.tp_new = py_binary_routine_new
};