text: /* Debugging routines for the remote server for GDB.
     Copyright (C) 2014 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 3 of the License, 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.  If not, see <http://www.gnu.org/licenses/>.  */
  
  #ifndef DEBUG_H
  #define DEBUG_H
  
  /* We declare debug format variables here, and debug_threads but no other
     debug content variables (e.g., not remote_debug) because while this file
     is not currently used by IPA it may be some day, and IPA may have its own
     set of debug content variables.  It's ok to declare debug_threads here
     because it is misnamed - a better name is debug_basic or some such,
     which can work for any program, gdbserver or IPA.  If/when this file is
     used with IPA it is recommended to fix debug_thread's name.  */
  extern int debug_threads;
  extern int debug_timestamp;
  
  void debug_printf (const char *msg, ...) ATTRIBUTE_PRINTF (1, 2);
  void debug_flush (void);
  void do_debug_enter (const char *function_name);
  void do_debug_exit (const char *function_name);
  
  /* These macros are for use in major functions that produce a lot of
     debugging output.  They help identify in the mass of debugging output
     when these functions enter and exit.  debug_enter is intended to be
     called at the start of a function, before any other debugging output.
     debug_exit is intended to be called at the end of the same function,
     after all debugging output.  */
  #ifdef FUNCTION_NAME
  #define debug_enter() \
    do { do_debug_enter (FUNCTION_NAME); } while (0)
  #define debug_exit() \
    do { do_debug_exit (FUNCTION_NAME); } while (0)
  #else
  #define debug_enter() \
    do { } while (0)
  #define debug_exit() \
    do { } while (0)
  #endif
  
  #endif /* DEBUG_H */
  