#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 program 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, or (at your option) any later version.

This program 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; see the file COPYING3. If not see http://www.gnu.org/licenses/. 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.

void(* gcc_debug_hooks::begin_epilogue)(unsigned int line, const char *file)

Called at beginning of epilogue code.

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 function.

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.

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 function.

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 function.

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.

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.

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:

debug.h

Data Fields

Detailed Description

Field Documentation