X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=gdb%2Fannotate.h;h=00bf6c392d1357434925ffe1b669f00c07ddba37;hb=2c474c46943e5242f356a0c0676e2f7bd223c8a9;hp=0521896f23dc7317310817dd7b758a813ff62cf3;hpb=72ec28b8afa357cdde70c612b4e0e9f37a34f8e4;p=binutils-gdb.git diff --git a/gdb/annotate.h b/gdb/annotate.h index 0521896f23d..00bf6c392d1 100644 --- a/gdb/annotate.h +++ b/gdb/annotate.h @@ -1,11 +1,11 @@ /* Annotation routines for GDB. - Copyright 1986, 1989, 1990, 1991, 1992, 1999 Free Software Foundation, Inc. + Copyright (C) 1986-2022 Free Software Foundation, Inc. This file is part of GDB. 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 2 of the License, or + the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, @@ -14,92 +14,122 @@ GNU General Public License for more details. You should have received a copy of the GNU General Public License - along with this program; if not, write to the Free Software - Foundation, Inc., 59 Temple Place - Suite 330, - Boston, MA 02111-1307, USA. */ + along with this program. If not, see . */ + +#ifndef ANNOTATE_H +#define ANNOTATE_H #include "symtab.h" #include "gdbtypes.h" -extern void breakpoints_changed PARAMS ((void)); - -extern void annotate_ignore_count_change (void); -extern void annotate_breakpoint PARAMS ((int)); -extern void annotate_catchpoint PARAMS ((int)); -extern void annotate_watchpoint PARAMS ((int)); -extern void annotate_starting PARAMS ((void)); -extern void annotate_stopped PARAMS ((void)); -extern void annotate_exited PARAMS ((int)); -extern void annotate_signalled PARAMS ((void)); -extern void annotate_signal_name PARAMS ((void)); -extern void annotate_signal_name_end PARAMS ((void)); -extern void annotate_signal_string PARAMS ((void)); -extern void annotate_signal_string_end PARAMS ((void)); -extern void annotate_signal PARAMS ((void)); - -extern void annotate_breakpoints_headers PARAMS ((void)); -extern void annotate_field PARAMS ((int)); -extern void annotate_breakpoints_table PARAMS ((void)); -extern void annotate_record PARAMS ((void)); -extern void annotate_breakpoints_table_end PARAMS ((void)); - -extern void annotate_frames_invalid PARAMS ((void)); +extern void annotate_breakpoint (int); +extern void annotate_catchpoint (int); +extern void annotate_watchpoint (int); +extern void annotate_starting (void); +extern void annotate_stopped (void); +extern void annotate_exited (int); +extern void annotate_signalled (void); +extern void annotate_signal_name (void); +extern void annotate_signal_name_end (void); +extern void annotate_signal_string (void); +extern void annotate_signal_string_end (void); +extern void annotate_signal (void); + +extern void annotate_breakpoints_headers (void); +extern void annotate_field (int); +extern void annotate_breakpoints_table (void); +extern void annotate_record (void); +extern void annotate_breakpoints_table_end (void); + +extern void annotate_frames_invalid (void); +extern void annotate_new_thread (void); +extern void annotate_thread_changed (void); + +extern void annotate_display_prompt (void); struct type; -extern void annotate_field_begin PARAMS ((struct type *)); -extern void annotate_field_name_end PARAMS ((void)); -extern void annotate_field_value PARAMS ((void)); -extern void annotate_field_end PARAMS ((void)); - -extern void annotate_quit PARAMS ((void)); -extern void annotate_error PARAMS ((void)); -extern void annotate_error_begin PARAMS ((void)); - -extern void annotate_value_history_begin PARAMS ((int, struct type *)); -extern void annotate_value_begin PARAMS ((struct type *)); -extern void annotate_value_history_value PARAMS ((void)); -extern void annotate_value_history_end PARAMS ((void)); -extern void annotate_value_end PARAMS ((void)); - -extern void annotate_display_begin PARAMS ((void)); -extern void annotate_display_number_end PARAMS ((void)); -extern void annotate_display_format PARAMS ((void)); -extern void annotate_display_expression PARAMS ((void)); -extern void annotate_display_expression_end PARAMS ((void)); -extern void annotate_display_value PARAMS ((void)); -extern void annotate_display_end PARAMS ((void)); - -extern void annotate_arg_begin PARAMS ((void)); -extern void annotate_arg_name_end PARAMS ((void)); -extern void annotate_arg_value PARAMS ((struct type *)); -extern void annotate_arg_end PARAMS ((void)); - -extern void annotate_source PARAMS ((char *, int, int, int, CORE_ADDR)); - -extern void annotate_frame_begin PARAMS ((int, CORE_ADDR)); -extern void annotate_function_call PARAMS ((void)); -extern void annotate_signal_handler_caller PARAMS ((void)); -extern void annotate_frame_address PARAMS ((void)); -extern void annotate_frame_address_end PARAMS ((void)); -extern void annotate_frame_function_name PARAMS ((void)); -extern void annotate_frame_args PARAMS ((void)); -extern void annotate_frame_source_begin PARAMS ((void)); -extern void annotate_frame_source_file PARAMS ((void)); -extern void annotate_frame_source_file_end PARAMS ((void)); -extern void annotate_frame_source_line PARAMS ((void)); -extern void annotate_frame_source_end PARAMS ((void)); -extern void annotate_frame_where PARAMS ((void)); -extern void annotate_frame_end PARAMS ((void)); - -extern void annotate_array_section_begin PARAMS ((int, struct type *)); -extern void annotate_elt_rep PARAMS ((unsigned int)); -extern void annotate_elt_rep_end PARAMS ((void)); -extern void annotate_elt PARAMS ((void)); -extern void annotate_array_section_end PARAMS ((void)); - -extern void (*annotate_starting_hook) PARAMS ((void)); -extern void (*annotate_stopped_hook) PARAMS ((void)); -extern void (*annotate_signalled_hook) PARAMS ((void)); -extern void (*annotate_signal_hook) PARAMS ((void)); -extern void (*annotate_exited_hook) PARAMS ((void)); +extern void annotate_field_begin (struct type *); +extern void annotate_field_name_end (void); +extern void annotate_field_value (void); +extern void annotate_field_end (void); + +extern void annotate_quit (void); +extern void annotate_error (void); +extern void annotate_error_begin (void); + +extern void annotate_value_history_begin (int, struct type *); +extern void annotate_value_begin (struct type *); +extern void annotate_value_history_value (void); +extern void annotate_value_history_end (void); +extern void annotate_value_end (void); + +extern void annotate_display_begin (void); +extern void annotate_display_number_end (void); +extern void annotate_display_format (void); +extern void annotate_display_expression (void); +extern void annotate_display_expression_end (void); +extern void annotate_display_value (void); +extern void annotate_display_end (void); + +extern void annotate_arg_begin (void); +extern void annotate_arg_name_end (void); +extern void annotate_arg_value (struct type *); +extern void annotate_arg_end (void); + +/* Wrap calls to annotate_arg_begin and annotate_arg_end in an RAII + class. */ +struct annotate_arg_emitter +{ + annotate_arg_emitter () { annotate_arg_begin (); } + ~annotate_arg_emitter () { annotate_arg_end (); } + + DISABLE_COPY_AND_ASSIGN (annotate_arg_emitter); +}; + +/* If annotations are turned on then print annotation describing the full + name of the source file S and the line number LINE and its corresponding + character position. + + MID_STATEMENT is nonzero if the PC is not at the beginning of that + line. + + The current symtab and line is updated to reflect S and LINE. + + Return true if the annotation was printed and the current symtab and + line were updated, otherwise return false, which can happen if the + source file for S can't be found, or LINE is out of range. + + This does leave GDB in the weird situation where, even when annotations + are on, we only sometimes print the annotation, and only sometimes + update the current symtab and line. However, this particular annotation + has behaved this way for some time, and front ends that still use + annotations now depend on this behaviour. */ +extern bool annotate_source_line (struct symtab *s, int line, + int mid_statement, CORE_ADDR pc); + +extern void annotate_frame_begin (int, struct gdbarch *, CORE_ADDR); +extern void annotate_function_call (void); +extern void annotate_signal_handler_caller (void); +extern void annotate_frame_address (void); +extern void annotate_frame_address_end (void); +extern void annotate_frame_function_name (void); +extern void annotate_frame_args (void); +extern void annotate_frame_source_begin (void); +extern void annotate_frame_source_file (void); +extern void annotate_frame_source_file_end (void); +extern void annotate_frame_source_line (void); +extern void annotate_frame_source_end (void); +extern void annotate_frame_where (void); +extern void annotate_frame_end (void); + +extern void annotate_array_section_begin (int, struct type *); +extern void annotate_elt_rep (unsigned int); +extern void annotate_elt_rep_end (void); +extern void annotate_elt (void); +extern void annotate_array_section_end (void); + +extern void (*deprecated_annotate_signalled_hook) (void); +extern void (*deprecated_annotate_signal_hook) (void); + +#endif /* ANNOTATE_H */