/* Debug hooks for GCC.
- Copyright (C) 2001 Free Software Foundation, Inc.
+ Copyright (C) 2001, 2002 Free Software Foundation, Inc.
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
toplev.c according to command line options. */
struct gcc_debug_hooks
{
- /* Initialise debug output to FILE. MAIN_FILENAME is the name of
- the main input file. */
- void (* init) PARAMS ((FILE * file, const char *main_filename));
+ /* Initialize debug output. MAIN_FILENAME is the name of the main
+ input file. */
+ void (* init) PARAMS ((const char *main_filename));
- /* Output debug symbols to FILE. */
- void (* finish) PARAMS ((FILE * file, const char *main_filename));
+ /* Output debug symbols. */
+ void (* finish) PARAMS ((const char *main_filename));
/* Macro defined on line LINE with name and expansion TEXT. */
void (* define) PARAMS ((unsigned int line, const char *text));
/* Record the resumption of a source file. LINE is the line number
in the source file we are returning to. */
void (* end_source_file) PARAMS ((unsigned int line));
+
+ /* Record the beginning of block N, counting from 1 and not
+ including the function-scope block, at LINE. */
+ void (* begin_block) PARAMS ((unsigned int line, unsigned int n));
+
+ /* Record the end of a block. Arguments as for begin_block. */
+ void (* end_block) PARAMS ((unsigned int line, unsigned int n));
+
+ /* 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. */
+ bool (* ignore_block) PARAMS ((tree));
+
+ /* Record a source file location at (FILE, LINE). */
+ void (* source_line) PARAMS ((unsigned int line, const char *file));
+
+ /* Called at start of prologue code. LINE is the first line in the
+ function. This has been given the same prototype as source_line,
+ so that the source_line hook can be substituted if appropriate. */
+ void (* begin_prologue) PARAMS ((unsigned int line, const char *file));
+
+ /* Called at end of prologue code. LINE is the first line in the
+ function. */
+ void (* end_prologue) PARAMS ((unsigned int line, const char *file));
+
+ /* Record end of epilogue code. */
+ void (* end_epilogue) PARAMS ((unsigned int line, const char *file));
+
+ /* Called at start of function DECL, before it is declared. */
+ void (* begin_function) PARAMS ((tree decl));
+
+ /* Record end of function. LINE is highest line number in function. */
+ void (* end_function) PARAMS ((unsigned int line));
+
+ /* 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 (* function_decl) PARAMS ((tree decl));
+
+ /* Debug information for a global DECL. Called from toplev.c after
+ compilation proper has finished. */
+ void (* global_decl) PARAMS ((tree decl));
+
+ /* DECL is an inline function, whose body is present, but which is
+ not being output at this point. */
+ void (* deferred_inline_function) PARAMS ((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 (* outlining_inline_function) PARAMS ((tree decl));
+
+ /* Called from final_scan_insn for any CODE_LABEL insn whose
+ LABEL_NAME is non-null. */
+ void (* label) PARAMS ((rtx));
+
+ /* 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. */
+ void (* handle_pch) PARAMS ((unsigned int));
};
-extern struct gcc_debug_hooks *debug_hooks;
+extern const struct gcc_debug_hooks *debug_hooks;
/* The do-nothing hooks. */
-extern void debug_nothing_file_charstar
- PARAMS ((FILE *, const char *));
+extern void debug_nothing_void
+ PARAMS ((void));
+extern void debug_nothing_charstar
+ PARAMS ((const char *));
extern void debug_nothing_int_charstar
PARAMS ((unsigned int, const char *));
extern void debug_nothing_int
PARAMS ((unsigned int));
+extern void debug_nothing_int_int
+ PARAMS ((unsigned int, unsigned int));
+extern void debug_nothing_tree
+ PARAMS ((tree));
+extern bool debug_true_tree
+ PARAMS ((tree));
+extern void debug_nothing_rtx
+ PARAMS ((rtx));
/* Hooks for various debug formats. */
-extern struct gcc_debug_hooks do_nothing_debug_hooks;
-extern struct gcc_debug_hooks dbx_debug_hooks;
-extern struct gcc_debug_hooks sdb_debug_hooks;
-extern struct gcc_debug_hooks dwarf_debug_hooks;
-extern struct gcc_debug_hooks dwarf2_debug_hooks;
+extern const struct gcc_debug_hooks do_nothing_debug_hooks;
+extern const struct gcc_debug_hooks dbx_debug_hooks;
+extern const struct gcc_debug_hooks sdb_debug_hooks;
+extern const struct gcc_debug_hooks xcoff_debug_hooks;
+extern const struct gcc_debug_hooks dwarf_debug_hooks;
+extern const struct gcc_debug_hooks dwarf2_debug_hooks;
+extern const struct gcc_debug_hooks vmsdbg_debug_hooks;
+
+/* Dwarf2 frame information. */
+
+extern void dwarf2out_begin_prologue PARAMS ((unsigned int, const char *));
+extern void dwarf2out_end_epilogue PARAMS ((unsigned int, const char *));
+extern void dwarf2out_frame_init PARAMS ((void));
+extern void dwarf2out_frame_finish PARAMS ((void));
+/* Decide whether we want to emit frame unwind information for the current
+ translation unit. */
+extern int dwarf2out_do_frame PARAMS ((void));
#endif /* !GCC_DEBUG_H */