1 /* General utility routines for the remote server for GDB.
2 Copyright (C) 1986, 1989, 1993, 1995, 1996, 1997, 1999, 2000, 2002, 2003,
3 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
5 This file is part of GDB.
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.
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.
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/>. */
28 #ifdef IN_PROCESS_AGENT
29 # define PREFIX "ipa: "
30 # define TOOLNAME "GDBserver in-process agent"
32 # define PREFIX "gdbserver: "
33 # define TOOLNAME "GDBserver"
36 /* Generally useful subroutines used throughout the program. */
38 static void malloc_failure (size_t size
) ATTR_NORETURN
;
41 malloc_failure (size_t size
)
43 fprintf (stderr
, PREFIX
"ran out of memory while trying to allocate %lu bytes\n",
44 (unsigned long) size
);
48 /* Allocate memory without fail.
49 If malloc fails, this will print a message to stderr and exit. */
58 newmem
= malloc (size
);
60 malloc_failure (size
);
65 /* Reallocate memory without fail. This works like xmalloc. */
68 xrealloc (void *ptr
, size_t size
)
76 val
= realloc (ptr
, size
); /* OK: realloc */
78 val
= malloc (size
); /* OK: malloc */
80 malloc_failure (size
);
85 /* Allocate memory without fail and set it to zero.
86 If malloc fails, this will print a message to stderr and exit. */
89 xcalloc (size_t nelem
, size_t elsize
)
93 if (nelem
== 0 || elsize
== 0)
96 newmem
= calloc (nelem
, elsize
);
98 malloc_failure (nelem
* elsize
);
103 /* Copy a string into a memory buffer.
104 If malloc fails, this will print a message to stderr and exit. */
107 xstrdup (const char *s
)
109 char *ret
= strdup (s
);
111 malloc_failure (strlen (s
) + 1);
115 #ifndef IN_PROCESS_AGENT
117 /* Free a standard argv vector. */
120 freeargv (char **vector
)
126 for (scan
= vector
; *scan
!= NULL
; scan
++)
136 /* Print the system error message for errno, and also mention STRING
137 as the file name for which the error was encountered.
138 Then return to command level. */
141 perror_with_name (const char *string
)
146 err
= strerror (errno
);
148 err
= "unknown error";
150 combined
= (char *) alloca (strlen (err
) + strlen (string
) + 3);
151 strcpy (combined
, string
);
152 strcat (combined
, ": ");
153 strcat (combined
, err
);
155 error ("%s.", combined
);
158 /* Print an error message and return to command level.
159 STRING is the error message, used as a fprintf string,
160 and ARG is passed as an argument to it. */
163 error (const char *string
,...)
165 #ifndef IN_PROCESS_AGENT
166 extern jmp_buf toplevel
;
169 va_start (args
, string
);
171 vfprintf (stderr
, string
, args
);
172 fprintf (stderr
, "\n");
173 #ifndef IN_PROCESS_AGENT
174 longjmp (toplevel
, 1);
180 /* Print an error message and exit reporting failure.
181 This is for a error that we cannot continue from.
182 STRING and ARG are passed to fprintf. */
186 fatal (const char *string
,...)
189 va_start (args
, string
);
190 fprintf (stderr
, PREFIX
);
191 vfprintf (stderr
, string
, args
);
192 fprintf (stderr
, "\n");
199 warning (const char *string
,...)
202 va_start (args
, string
);
203 fprintf (stderr
, PREFIX
);
204 vfprintf (stderr
, string
, args
);
205 fprintf (stderr
, "\n");
209 /* Report a problem internal to GDBserver, and exit. */
212 internal_error (const char *file
, int line
, const char *fmt
, ...)
215 va_start (args
, fmt
);
218 %s:%d: A problem internal to " TOOLNAME
" has been detected.\n", file
, line
);
219 vfprintf (stderr
, fmt
, args
);
220 fprintf (stderr
, "\n");
225 /* Temporary storage using circular buffer. */
229 /* Return the next entry in the circular buffer. */
234 static char buf
[NUMCELLS
][CELLSIZE
];
236 if (++cell
>= NUMCELLS
)
241 /* Stdarg wrapper around vsnprintf.
242 SIZE is the size of the buffer pointed to by STR. */
245 xsnprintf (char *str
, size_t size
, const char *format
, ...)
250 va_start (args
, format
);
251 ret
= vsnprintf (str
, size
, format
, args
);
258 decimal2str (char *sign
, ULONGEST addr
, int width
)
260 /* Steal code from valprint.c:print_decimal(). Should this worry
261 about the real size of addr as the above does? */
262 unsigned long temp
[3];
263 char *str
= get_cell ();
268 temp
[i
] = addr
% (1000 * 1000 * 1000);
269 addr
/= (1000 * 1000 * 1000);
273 while (addr
!= 0 && i
< (sizeof (temp
) / sizeof (temp
[0])));
282 xsnprintf (str
, CELLSIZE
, "%s%0*lu", sign
, width
, temp
[0]);
285 xsnprintf (str
, CELLSIZE
, "%s%0*lu%09lu", sign
, width
,
289 xsnprintf (str
, CELLSIZE
, "%s%0*lu%09lu%09lu", sign
, width
,
290 temp
[2], temp
[1], temp
[0]);
293 internal_error (__FILE__
, __LINE__
,
294 "failed internal consistency check");
300 /* %u for ULONGEST. The result is stored in a circular static buffer,
304 pulongest (ULONGEST u
)
306 return decimal2str ("", u
, 0);
309 /* %d for LONGEST. The result is stored in a circular static buffer,
316 return decimal2str ("-", -l
, 0);
318 return decimal2str ("", l
, 0);
321 /* Eliminate warning from compiler on 32-bit systems. */
322 static int thirty_two
= 32;
324 /* Convert a ULONGEST into a HEX string, like %lx. The result is
325 stored in a circular static buffer, NUMCELLS deep. */
328 phex_nz (ULONGEST l
, int sizeof_l
)
336 unsigned long high
= (unsigned long) (l
>> thirty_two
);
339 xsnprintf (str
, CELLSIZE
, "%lx",
340 (unsigned long) (l
& 0xffffffff));
342 xsnprintf (str
, CELLSIZE
, "%lx%08lx", high
,
343 (unsigned long) (l
& 0xffffffff));
348 xsnprintf (str
, CELLSIZE
, "%lx", (unsigned long) l
);
352 xsnprintf (str
, CELLSIZE
, "%x", (unsigned short) (l
& 0xffff));
355 str
= phex_nz (l
, sizeof (l
));
362 /* Convert a CORE_ADDR into a HEX string, like %lx.
363 The result is stored in a circular static buffer, NUMCELLS deep. */
366 paddress (CORE_ADDR addr
)
368 return phex_nz (addr
, sizeof (CORE_ADDR
));
371 /* Convert a file descriptor into a printable string. */
374 pfildes (gdb_fildes_t fd
)
377 return phex_nz (fd
, sizeof (gdb_fildes_t
));
379 return plongest (fd
);