rz_graph_drawable.h File Reference

#include <rz_types.h>
#include <rz_util/rz_graph.h>
#include <rz_config.h>

Go to the source code of this file.

Classes
struct	rz_analysis_graph_node_info_t
	Generic drawable graph node. More...

Typedefs
typedef struct rz_analysis_graph_node_info_t	RzGraphNodeInfo
	Generic drawable graph node. More...

Functions
RZ_API void	rz_graph_free_node_info (void *ptr)
RZ_API RzGraphNodeInfo *	rz_graph_create_node_info (const char *title, const char *body, ut64 offset)
RZ_API RzGraphNode *	rz_graph_add_node_info (RzGraph *graph, const char *title, const char *body, ut64 offset)
RZ_API char *	rz_graph_drawable_to_dot (RzGraph *graph, const char *node_properties, const char *edge_properties)
	Convert graph to Graphviz dot format. More...
RZ_API void	rz_graph_drawable_to_json (RzGraph *graph, PJ *pj, bool use_offset)
	Convert graph to JSON. More...

Typedef Documentation

RzGraphNodeInfo

typedef struct rz_analysis_graph_node_info_t RzGraphNodeInfo

Generic drawable graph node.

Provides minimal information to draw something without output format specific details.

Function Documentation

rz_graph_add_node_info()

RZ_API RzGraphNode* rz_graph_add_node_info	(	RzGraph *	graph,
		const char *	title,
		const char *	body,
		ut64	offset
	)

Definition at line 28 of file graph_drawable.c.

                                                                                                             {
    rz_return_val_if_fail(graph, NULL);
    RzGraphNodeInfo *data = rz_graph_create_node_info(title, body, offset);
    if (!data) {
        return NULL;
    }
    RzGraphNode *node = rz_graph_add_nodef(graph, data, rz_graph_free_node_info);
    if (!node) {
        rz_graph_free_node_info(data);
    }
    return node;
}

References NULL, rz_graph_add_nodef(), rz_graph_create_node_info(), rz_graph_free_node_info(), and rz_return_val_if_fail.

Referenced by add_single_addr_xrefs(), rz_analysis_class_get_inheritance_graph(), and rz_core_analysis_importxrefs().

rz_graph_create_node_info()

RZ_API RzGraphNodeInfo* rz_graph_create_node_info	(	const char *	title,
		const char *	body,
		ut64	offset
	)

Definition at line 18 of file graph_drawable.c.

                                                                                                    {
    RzGraphNodeInfo *data = RZ_NEW0(RzGraphNodeInfo);
    if (data) {
        data->title = RZ_STR_DUP(title);
        data->body = RZ_STR_DUP(body);
        data->offset = offset;
    }
    return data;
}

References rz_analysis_graph_node_info_t::body, rz_analysis_graph_node_info_t::offset, RZ_NEW0, RZ_STR_DUP, and rz_analysis_graph_node_info_t::title.

Referenced by rz_graph_add_node_info().

rz_graph_drawable_to_dot()

RZ_API char* rz_graph_drawable_to_dot	(	RzGraph *	graph,
		const char *	node_properties,
		const char *	edge_properties
	)

Convert graph to Graphviz dot format.

Parameters

graph	Graph with RzGraphNodeInfo used as node user data
node_properties	List node styling attributes. Can be set to NULL.
edge_properties	List edge styling attributes. Can be set to NULL.

Definition at line 41 of file graph_drawable.c.

                                                                                                                  {
    RzList *nodes = graph->nodes;
    RzListIter *it, *itt;
    RzGraphNode *node = NULL, *target = NULL;
    RzStrBuf buf;
    rz_strbuf_init(&buf);
    rz_strbuf_appendf(&buf,
        "digraph code {\nrankdir=LR;\noutputorder=edgesfirst\ngraph [bgcolor=azure];\n"
        "edge [arrowhead=normal, color=\"#3030c0\" style=bold weight=2 %s];\n"
        "node [fillcolor=white, style=filled shape=box "
        "fontsize=\"8\" %s];\n",
        edge_properties ? edge_properties : "",
        node_properties ? node_properties : "");
 
    rz_list_foreach (nodes, it, node) {
        RzGraphNodeInfo *print_node = (RzGraphNodeInfo *)node->data;
        const char *body = print_node->body;
        if (!body || !*body) {
            rz_strbuf_appendf(&buf, "%d [URL=\"%s\", color=\"lightgray\", label=\"%s\"]\n",
                node->idx, print_node->title, print_node->title);
        } else {
            rz_strbuf_appendf(&buf, "%d [URL=\"%s\", color=\"lightgray\", label=\"%s\\n%s\"]\n",
                node->idx, print_node->title, print_node->title, body);
        }
        rz_list_foreach (node->out_nodes, itt, target) {
            rz_strbuf_appendf(&buf, "%d -> %d\n", node->idx, target->idx);
        }
    }
    rz_strbuf_append(&buf, "}\n");
    return rz_strbuf_drain_nofree(&buf);
}

References rz_analysis_graph_node_info_t::body, rz_graph_node_t::data, rz_graph_node_t::idx, if(), rz_graph_t::nodes, NULL, rz_graph_node_t::out_nodes, rz_strbuf_append(), rz_strbuf_appendf(), rz_strbuf_drain_nofree(), rz_strbuf_init(), and rz_analysis_graph_node_info_t::title.

Referenced by print_graph_dot().

rz_graph_drawable_to_json()

RZ_API void rz_graph_drawable_to_json	(	RzGraph *	graph,
		PJ *	pj,
		bool	use_offset
	)

Convert graph to JSON.

Parameters

[in]	graph	Graph to convert
[out]	pj	Json output structure. Can be used to include the resulting JSON value inside bigger JSON.
[in]	use_offset	Set this to true if graph uses RzGraphNodeInfo::offset offset field.

Definition at line 73 of file graph_drawable.c.

                                                                                 {
    RzList *nodes = graph->nodes, *neighbours = NULL;
    RzListIter *it, *itt;
    RzGraphNode *node = NULL, *neighbour = NULL;
    if (!pj) {
        return;
    }
    pj_o(pj);
    pj_k(pj, "nodes");
    pj_a(pj);
 
    rz_list_foreach (nodes, it, node) {
        RzGraphNodeInfo *print_node = (RzGraphNodeInfo *)node->data;
        pj_o(pj);
        pj_ki(pj, "id", node->idx);
        if (print_node->title) {
            pj_ks(pj, "title", print_node->title);
        }
        if (print_node->body) {
            pj_ks(pj, "body", print_node->body);
        }
        if (use_offset) {
            pj_kn(pj, "offset", print_node->offset);
        }
        pj_k(pj, "out_nodes");
        pj_a(pj);
        neighbours = node->out_nodes;
        rz_list_foreach (neighbours, itt, neighbour) {
            pj_i(pj, neighbour->idx);
        }
        pj_end(pj);
        pj_end(pj);
    }
    pj_end(pj);
    pj_end(pj);
}

References rz_analysis_graph_node_info_t::body, rz_graph_node_t::data, rz_graph_node_t::idx, rz_graph_t::nodes, NULL, rz_analysis_graph_node_info_t::offset, rz_graph_node_t::out_nodes, pj_a(), pj_end(), pj_i(), pj_k(), pj_ki(), pj_kn(), pj_ks(), pj_o(), and rz_analysis_graph_node_info_t::title.

Referenced by rz_core_graph_print().

rz_graph_free_node_info()

RZ_API void rz_graph_free_node_info

(

void *

ptr

)

Definition at line 8 of file graph_drawable.c.

                                               {
    if (!ptr) {
        return;
    }
    RzGraphNodeInfo *info = ptr;
    free(info->body);
    free(info->title);
    free(info);
}

References free(), and info().

Referenced by rz_graph_add_node_info().