GCC Middle and Back End API Reference
gcc_debug_hooks Struct Reference

#include <debug.h>

Data Fields

void(* init )(const char *main_filename)
void(* finish )(const char *main_filename)
void(* assembly_start )(void)
void(* define )(unsigned int line, const char *text)
void(* undef )(unsigned int line, const char *macro)
void(* start_source_file )(unsigned int line, const char *file)
void(* end_source_file )(unsigned int line)
void(* begin_block )(unsigned int line, unsigned int n)
void(* end_block )(unsigned int line, unsigned int n)
bool(* ignore_block )(const_tree)
void(* source_line )(unsigned int line, const char *file, int discriminator, bool is_stmt)
void(* begin_prologue )(unsigned int line, const char *file)
void(* end_prologue )(unsigned int line, const char *file)
void(* begin_epilogue )(unsigned int line, const char *file)
void(* end_epilogue )(unsigned int line, const char *file)
void(* begin_function )(tree decl)
void(* end_function )(unsigned int line)
void(* function_decl )(tree decl)
void(* global_decl )(tree decl)
void(* type_decl )(tree decl, int local)
void(* imported_module_or_decl )(tree decl, tree name, tree context, bool child)
void(* deferred_inline_function )(tree decl)
void(* outlining_inline_function )(tree decl)
void(* label )(rtx)
void(* handle_pch )(unsigned int)
void(* var_location )(rtx)
void(* switch_text_section )(void)
void(* set_name )(tree, tree)
int start_end_main_source_file
int tree_type_symtab_field

Detailed Description

   This structure contains hooks for the debug information output
   functions, accessed through the global instance debug_hooks set in
   toplev.c according to command line options.  

Field Documentation

void(* gcc_debug_hooks::assembly_start)(void)
     Called from cgraph_optimize before starting to assemble
     functions/variables/toplevel asms.  
void(* gcc_debug_hooks::begin_block)(unsigned int line, unsigned int n)
     Record the beginning of block N, counting from 1 and not
     including the function-scope block, at LINE.  

Referenced by vmsdbgout_begin_epilogue().

void(* gcc_debug_hooks::begin_epilogue)(unsigned int line, const char *file)
     Called at beginning of epilogue code.  

Referenced by vmsdbgout_begin_prologue().

void(* gcc_debug_hooks::begin_function)(tree decl)
     Called at start of function DECL, before it is declared.  
void(* gcc_debug_hooks::begin_prologue)(unsigned int line, const char *file)
     Called at start of prologue code.  LINE is the first line in the
void(* gcc_debug_hooks::deferred_inline_function)(tree decl)
     DECL is an inline function, whose body is present, but which is
     not being output at this point.  
void(* gcc_debug_hooks::define)(unsigned int line, const char *text)
     Macro defined on line LINE with name and expansion TEXT.  

Referenced by vmsdbgout_start_source_file().

void(* gcc_debug_hooks::end_block)(unsigned int line, unsigned int n)
     Record the end of a block.  Arguments as for begin_block.  
void(* gcc_debug_hooks::end_epilogue)(unsigned int line, const char *file)
     Record end of epilogue code.  
void(* gcc_debug_hooks::end_function)(unsigned int line)
     Record end of function.  LINE is highest line number in function.  
void(* gcc_debug_hooks::end_prologue)(unsigned int line, const char *file)
     Called at end of prologue code.  LINE is the first line in the
void(* gcc_debug_hooks::end_source_file)(unsigned int line)
     Record the resumption of a source file.  LINE is the line number
     in the source file we are returning to.  
void(* gcc_debug_hooks::finish)(const char *main_filename)
     Output debug symbols.  
void(* gcc_debug_hooks::function_decl)(tree decl)
     Debug information for a function DECL.  This might include the
     function name (a symbol), its parameters, and the block that
     makes up the function's body, and the local variables of the

Referenced by vmsdbgout_init().

void(* gcc_debug_hooks::global_decl)(tree decl)
     Debug information for a global DECL.  Called from toplev.c after
     compilation proper has finished.  

Referenced by go_undef().

void(* gcc_debug_hooks::handle_pch)(unsigned int)
     Called after the start and before the end of writing a PCH file.
     The parameter is 0 if after the start, 1 if before the end.  
bool(* gcc_debug_hooks::ignore_block)(const_tree)
     Returns nonzero if it is appropriate not to emit any debugging
     information for BLOCK, because it doesn't contain any
     instructions.  This may not be the case for blocks containing
     nested functions, since we may actually call such a function even
     though the BLOCK information is messed up.  Defaults to true.  
void(* gcc_debug_hooks::imported_module_or_decl)(tree decl, tree name, tree context, bool child)
     Debug information for imported modules and declarations.  
void(* gcc_debug_hooks::init)(const char *main_filename)
     Initialize debug output.  MAIN_FILENAME is the name of the main
     input file.  
void(* gcc_debug_hooks::label)(rtx)
     Called from final_scan_insn for any CODE_LABEL insn whose
     LABEL_NAME is non-null.  

Referenced by dbxout_stab_value_zero().

void(* gcc_debug_hooks::outlining_inline_function)(tree decl)
     DECL is an inline function which is about to be emitted out of
     line.  The hook is useful to, e.g., emit abstract debug info for
     the inline before it gets mangled by optimization.  
void(* gcc_debug_hooks::set_name)(tree, tree)
     Called from grokdeclarator.  Replaces the anonymous name with the
     type name.  
void(* gcc_debug_hooks::source_line)(unsigned int line, const char *file, int discriminator, bool is_stmt)
     Record a source file location at (FILE, LINE, DISCRIMINATOR).  
int gcc_debug_hooks::start_end_main_source_file
     This is 1 if the debug writer wants to see start and end commands for the
     main source files, and 0 otherwise.  
void(* gcc_debug_hooks::start_source_file)(unsigned int line, const char *file)
     Record the beginning of a new source file FILE from LINE number
     in the previous one.  
void(* gcc_debug_hooks::switch_text_section)(void)
     Called from final_scan_insn if there is a switch between hot and cold
     text sections.  
int gcc_debug_hooks::tree_type_symtab_field
     The type of symtab field used by these debug hooks.  This is one
     of the TYPE_SYMTAB_IS_xxx values defined in tree.h.  
void(* gcc_debug_hooks::type_decl)(tree decl, int local)
     Debug information for a type DECL.  Called from toplev.c after
     compilation proper, also from various language front ends to
     record built-in types.  The second argument is properly a
     boolean, which indicates whether or not the type is a "local"
     type as determined by the language.  (It's not a boolean for
     legacy reasons.)  
void(* gcc_debug_hooks::undef)(unsigned int line, const char *macro)
     MACRO undefined on line LINE.  

Referenced by vmsdbgout_end_source_file().

void(* gcc_debug_hooks::var_location)(rtx)
     Called from final_scan_insn for any NOTE_INSN_VAR_LOCATION note.  

The documentation for this struct was generated from the following file: