GDBserver
debug.c
Go to the documentation of this file.
1 /* Debugging routines for the remote server for GDB.
2  Copyright (C) 2014-2015 Free Software Foundation, Inc.
3 
4  This file is part of GDB.
5 
6  This program is free software; you can redistribute it and/or modify
7  it under the terms of the GNU General Public License as published by
8  the Free Software Foundation; either version 3 of the License, or
9  (at your option) any later version.
10 
11  This program is distributed in the hope that it will be useful,
12  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14  GNU General Public License for more details.
15 
16  You should have received a copy of the GNU General Public License
17  along with this program. If not, see <http://www.gnu.org/licenses/>. */
18 
19 #include "server.h"
20 #include <sys/time.h>
21 
22 /* Enable miscellaneous debugging output. The name is historical - it
23  was originally used to debug LinuxThreads support. */
25 
26 /* Include timestamps in debugging output. */
28 
29 /* Print a debugging message.
30  If the text begins a new line it is preceded by a timestamp, if the
31  system has gettimeofday.
32  We don't get fancy with newline checking, we just check whether the
33  previous call ended with "\n". */
34 
35 void
36 debug_vprintf (const char *format, va_list ap)
37 {
38 #if !defined (IN_PROCESS_AGENT)
39  /* N.B. Not thread safe, and can't be used, as is, with IPA. */
40  static int new_line = 1;
41 
42  if (debug_timestamp && new_line)
43  {
44  struct timeval tm;
45 
46  gettimeofday (&tm, NULL);
47 
48  /* If gettimeofday doesn't exist, and as a portability solution it has
49  been replaced with, e.g., time, then it doesn't make sense to print
50  the microseconds field. Is there a way to check for that? */
51  fprintf (stderr, "%ld:%06ld ", (long) tm.tv_sec, (long) tm.tv_usec);
52  }
53 #endif
54 
55  vfprintf (stderr, format, ap);
56 
57 #if !defined (IN_PROCESS_AGENT)
58  if (*format)
59  new_line = format[strlen (format) - 1] == '\n';
60 #endif
61 }
62 
63 /* Flush debugging output.
64  This is called, for example, when starting an inferior to ensure all debug
65  output thus far appears before any inferior output. */
66 
67 void
69 {
70  fflush (stderr);
71 }
72 
73 /* Notify the user that the code is entering FUNCTION_NAME.
74  FUNCTION_NAME is the name of the calling function, or NULL if unknown.
75 
76  This is intended to be called via the debug_enter macro. */
77 
78 void
79 do_debug_enter (const char *function_name)
80 {
81  if (function_name != NULL)
82  debug_printf (">>>> entering %s\n", function_name);
83 }
84 
85 /* Notify the user that the code is exiting FUNCTION_NAME.
86  FUNCTION_NAME is the name of the calling function, or NULL if unknown.
87 
88  This is intended to be called via the debug_exit macro. */
89 
90 void
91 do_debug_exit (const char *function_name)
92 {
93  if (function_name != NULL)
94  debug_printf ("<<<< exiting %s\n", function_name);
95 }
int debug_threads
Definition: debug.c:24
int debug_timestamp
Definition: debug.c:27
void debug_flush(void)
Definition: debug.c:68
void do_debug_exit(const char *function_name)
Definition: debug.c:91
void debug_vprintf(const char *format, va_list ap)
Definition: debug.c:36
void do_debug_enter(const char *function_name)
Definition: debug.c:79
void debug_printf(const char *fmt,...)
Definition: common-debug.c:30