X-Git-Url: http://nsz.repo.hu/git/?a=blobdiff_plain;f=include%2Flibfirm%2Fdbginfo.h;h=025e5eb594e681058b10f0aa95334a1c3d9711da;hb=94f6c873ed355ad4480e62d1b3aa47899148c436;hp=b6c538c1d1629d1a381709645b7b9ca7c5e52531;hpb=d6810426845f32bd728c815b403a3c2722c6ae4f;p=libfirm diff --git a/include/libfirm/dbginfo.h b/include/libfirm/dbginfo.h index b6c538c1d..025e5eb59 100644 --- a/include/libfirm/dbginfo.h +++ b/include/libfirm/dbginfo.h @@ -35,6 +35,7 @@ #ifndef FIRM_DEBUG_DBGINFO_H #define FIRM_DEBUG_DBGINFO_H +#include #include "firm_types.h" #include "ident.h" @@ -119,26 +120,9 @@ typedef void merge_pair_func(ir_node *new_node, ir_node *old_node, dbg_action ac */ typedef void merge_sets_func(ir_node **new_node_array, int new_num_entries, ir_node **old_node_array, int old_num_entries, dbg_action action); -/** - * The type of the debug info to human readable string function. - * - * @param buf pointer to a buffer that will hold the info - * @param len length of the buffer - * @param dbg the debug info - * - * @return Number of written characters to the buffer. - * - * @see dbg_init() - */ -typedef unsigned snprint_dbg_func(char *buf, unsigned len, const dbg_info *dbg); - /** * Initializes the debug support. * - * @param dbg_info_merge_pair see function description - * @param dbg_info_merge_sets see function description - * @param snprint_dbg see function description - * * This function takes pointers to two functions that merge the * debug information when a * transformation of a Firm graph is performed. @@ -158,43 +142,18 @@ typedef unsigned snprint_dbg_func(char *buf, unsigned len, const dbg_info *dbg); * * Further both functions pass an enumeration indicating the action * performed by the transformation, e.g. the kind of optimization performed. - * - * The third argument snprint_dbg is called to convert a debug info into a human readable string. - * This string is the dumped in the dumper functions. - * - * Note that if NULL is passed for dbg_info_merge_pair or dbg_info_merge_sets, the default - * implementations default_dbg_info_merge_pair() and default_dbg_info_merge_sets() are used. - * NULL passed for snprint_dbg means no output. */ -void dbg_init(merge_pair_func *dbg_info_merge_pair, merge_sets_func *dbg_info_merge_sets, snprint_dbg_func *snprint_dbg); +void dbg_init(merge_pair_func *dbg_info_merge_pair, + merge_sets_func *dbg_info_merge_sets); -/** - * The default merge_pair_func implementation, simply copies the debug info - * from the old Firm node to the new one if the new one does not have debug info yet. - * - * @param nw The new Firm node. - * @param old The old Firm node. - * @param info The action that cause old node to be replaced by new one. - */ -void default_dbg_info_merge_pair(ir_node *nw, ir_node *old, dbg_action info); +/** @} */ /** - * The default merge_sets_func implementation. If n_old_nodes is equal 1, copies - * the debug info from the old node to all new ones (if they do not have one), else does nothing. - * - * @param new_nodes An array of new Firm nodes. - * @param n_new_nodes The length of the new_nodes array. - * @param old_nodes An array of old (replaced) Firm nodes. - * @param n_old_nodes The length of the old_nodes array. - * @param info The action that cause old node to be replaced by new one. + * The type of the debug info retriever function. + * When given a dbg_info returns the name (usually the filename) of the + * compilation unit defining it. @p line is set to the line number of the + * definition. */ -void default_dbg_info_merge_sets(ir_node **new_nodes, int n_new_nodes, - ir_node **old_nodes, int n_old_nodes, - dbg_action info); - -/** @} */ - -/** The type of the debug info retriever function. */ typedef const char *(*retrieve_dbg_func)(const dbg_info *dbg, unsigned *line); /** @@ -204,9 +163,28 @@ typedef const char *(*retrieve_dbg_func)(const dbg_info *dbg, unsigned *line); */ void ir_set_debug_retrieve(retrieve_dbg_func func); +/** + * The type of the type debug info retrieve function. + * Prints a human readable source representation of a type to an obstack. + * (Used for generating debug info like stabs or dwarf) + */ +typedef void (*retrieve_type_dbg_func)(char *buffer, size_t buffer_size, + const type_dbg_info *tdbgi); + +/** + * Set global print_type_dbg_info function in firm + */ +void ir_set_type_debug_retrieve(retrieve_type_dbg_func func); + /** * Retrieve the debug info. */ const char *ir_retrieve_dbg_info(const dbg_info *dbg, unsigned *line); +/** + * Retrieve type debug info + */ +void ir_retrieve_type_dbg_info(char *buffer, size_t buffer_size, + const type_dbg_info *tdbgi); + #endif