gdbsupport/common-debug.h

   1 /* Declarations for debug printing functions.
   2
   3    Copyright (C) 2014-2020 Free Software Foundation, Inc.
   4
   5    This file is part of GDB.
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 3 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  19
  20 #ifndef COMMON_COMMON_DEBUG_H
  21 #define COMMON_COMMON_DEBUG_H
  22
  23 /* Set to true to enable debugging of hardware breakpoint/
  24    watchpoint support code.  */
  25
  26 extern bool show_debug_regs;
  27
  28 /* Print a formatted message to the appropriate channel for
  29    debugging output for the client.  */
  30
  31 extern void debug_printf (const char *format, ...)
  32      ATTRIBUTE_PRINTF (1, 2);
  33
  34 /* Print a formatted message to the appropriate channel for
  35    debugging output for the client.  This function must be
  36    provided by the client.  */
  37
  38 extern void debug_vprintf (const char *format, va_list ap)
  39      ATTRIBUTE_PRINTF (1, 0);
  40
  41 /* Print a debug statement prefixed with the module and function name, and
  42    with a newline at the end.  */
  43
  44 extern void ATTRIBUTE_PRINTF (3, 4) debug_prefixed_printf
  45   (const char *module, const char *func, const char *format, ...);
  46
  47 /* Print a debug statement prefixed with the module and function name, and
  48    with a newline at the end.  */
  49
  50 extern void ATTRIBUTE_PRINTF (3, 0) debug_prefixed_vprintf
  51   (const char *module, const char *func, const char *format, va_list args);
  52
  53 #endif /* COMMON_COMMON_DEBUG_H */