Commit | Line | Data |
---|---|---|
c906108c | 1 | /* General utility routines for GDB, the GNU debugger. |
a752853e AC |
2 | Copyright 1986, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, |
3 | 1996, 1997, 1998, 1999, 2000, 2001, 2002 | |
d9fcf2fb | 4 | Free Software Foundation, Inc. |
c906108c | 5 | |
c5aa993b | 6 | This file is part of GDB. |
c906108c | 7 | |
c5aa993b JM |
8 | This program is free software; you can redistribute it and/or modify |
9 | it under the terms of the GNU General Public License as published by | |
10 | the Free Software Foundation; either version 2 of the License, or | |
11 | (at your option) any later version. | |
c906108c | 12 | |
c5aa993b JM |
13 | This program is distributed in the hope that it will be useful, |
14 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
15 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
16 | GNU General Public License for more details. | |
c906108c | 17 | |
c5aa993b JM |
18 | You should have received a copy of the GNU General Public License |
19 | along with this program; if not, write to the Free Software | |
20 | Foundation, Inc., 59 Temple Place - Suite 330, | |
21 | Boston, MA 02111-1307, USA. */ | |
c906108c | 22 | |
f33c6cbf AC |
23 | /* FIXME: cagney/2002-02-28: The GDB coding standard indicates that |
24 | "defs.h" should be included first. Unfortunatly some systems | |
25 | (currently Debian GNU/Linux) include the <stdbool.h> via <curses.h> | |
26 | and they clash with "bfd.h"'s definiton of true/false. The correct | |
27 | fix is to remove true/false from "bfd.h", however, until that | |
28 | happens, hack around it by including "config.h" and <curses.h> | |
29 | first. */ | |
30 | ||
4e8f7a8b | 31 | #include "config.h" |
c906108c SS |
32 | |
33 | #ifdef HAVE_CURSES_H | |
34 | #include <curses.h> | |
35 | #endif | |
36 | #ifdef HAVE_TERM_H | |
37 | #include <term.h> | |
38 | #endif | |
39 | ||
4e8f7a8b DJ |
40 | #include "defs.h" |
41 | #include "gdb_assert.h" | |
42 | #include <ctype.h> | |
43 | #include "gdb_string.h" | |
44 | #include "event-top.h" | |
45 | ||
9d271fd8 AC |
46 | #ifdef __GO32__ |
47 | #include <pc.h> | |
48 | #endif | |
49 | ||
c906108c SS |
50 | /* SunOS's curses.h has a '#define reg register' in it. Thank you Sun. */ |
51 | #ifdef reg | |
52 | #undef reg | |
53 | #endif | |
54 | ||
042be3a9 | 55 | #include <signal.h> |
c906108c SS |
56 | #include "gdbcmd.h" |
57 | #include "serial.h" | |
58 | #include "bfd.h" | |
59 | #include "target.h" | |
60 | #include "demangle.h" | |
61 | #include "expression.h" | |
62 | #include "language.h" | |
234b45d4 | 63 | #include "charset.h" |
c906108c | 64 | #include "annotate.h" |
303c8ebd | 65 | #include "filenames.h" |
c906108c | 66 | |
ac2e2ef7 AC |
67 | #include "inferior.h" /* for signed_pointer_to_address */ |
68 | ||
2d1b2124 AC |
69 | #include <sys/param.h> /* For MAXPATHLEN */ |
70 | ||
c906108c SS |
71 | #include <readline/readline.h> |
72 | ||
ed1801df AC |
73 | #ifdef USE_MMALLOC |
74 | #include "mmalloc.h" | |
75 | #endif | |
76 | ||
3c37485b AC |
77 | #ifdef NEED_DECLARATION_MALLOC |
78 | extern PTR malloc (); | |
79 | #endif | |
0e52036f AC |
80 | #ifdef NEED_DECLARATION_REALLOC |
81 | extern PTR realloc (); | |
82 | #endif | |
81b8eb80 AC |
83 | #ifdef NEED_DECLARATION_FREE |
84 | extern void free (); | |
85 | #endif | |
a4db0f07 RH |
86 | /* Actually, we'll never have the decl, since we don't define _GNU_SOURCE. */ |
87 | #if defined(HAVE_CANONICALIZE_FILE_NAME) \ | |
88 | && defined(NEED_DECLARATION_CANONICALIZE_FILE_NAME) | |
89 | extern char *canonicalize_file_name (const char *); | |
90 | #endif | |
81b8eb80 | 91 | |
c906108c SS |
92 | /* readline defines this. */ |
93 | #undef savestring | |
94 | ||
507f3c78 | 95 | void (*error_begin_hook) (void); |
c906108c | 96 | |
2acceee2 JM |
97 | /* Holds the last error message issued by gdb */ |
98 | ||
d9fcf2fb | 99 | static struct ui_file *gdb_lasterr; |
2acceee2 | 100 | |
c906108c SS |
101 | /* Prototypes for local functions */ |
102 | ||
d9fcf2fb JM |
103 | static void vfprintf_maybe_filtered (struct ui_file *, const char *, |
104 | va_list, int); | |
c906108c | 105 | |
d9fcf2fb | 106 | static void fputs_maybe_filtered (const char *, struct ui_file *, int); |
c906108c SS |
107 | |
108 | #if defined (USE_MMALLOC) && !defined (NO_MMCHECK) | |
a14ed312 | 109 | static void malloc_botch (void); |
c906108c SS |
110 | #endif |
111 | ||
a14ed312 | 112 | static void prompt_for_continue (void); |
c906108c | 113 | |
a14ed312 | 114 | static void set_width_command (char *, int, struct cmd_list_element *); |
c906108c | 115 | |
a14ed312 | 116 | static void set_width (void); |
c906108c | 117 | |
c906108c SS |
118 | /* Chain of cleanup actions established with make_cleanup, |
119 | to be executed if an error happens. */ | |
120 | ||
c5aa993b JM |
121 | static struct cleanup *cleanup_chain; /* cleaned up after a failed command */ |
122 | static struct cleanup *final_cleanup_chain; /* cleaned up when gdb exits */ | |
123 | static struct cleanup *run_cleanup_chain; /* cleaned up on each 'run' */ | |
124 | static struct cleanup *exec_cleanup_chain; /* cleaned up on each execution command */ | |
6426a772 JM |
125 | /* cleaned up on each error from within an execution command */ |
126 | static struct cleanup *exec_error_cleanup_chain; | |
43ff13b4 JM |
127 | |
128 | /* Pointer to what is left to do for an execution command after the | |
129 | target stops. Used only in asynchronous mode, by targets that | |
130 | support async execution. The finish and until commands use it. So | |
131 | does the target extended-remote command. */ | |
132 | struct continuation *cmd_continuation; | |
c2d11a7d | 133 | struct continuation *intermediate_continuation; |
c906108c SS |
134 | |
135 | /* Nonzero if we have job control. */ | |
136 | ||
137 | int job_control; | |
138 | ||
139 | /* Nonzero means a quit has been requested. */ | |
140 | ||
141 | int quit_flag; | |
142 | ||
143 | /* Nonzero means quit immediately if Control-C is typed now, rather | |
144 | than waiting until QUIT is executed. Be careful in setting this; | |
145 | code which executes with immediate_quit set has to be very careful | |
146 | about being able to deal with being interrupted at any time. It is | |
147 | almost always better to use QUIT; the only exception I can think of | |
148 | is being able to quit out of a system call (using EINTR loses if | |
149 | the SIGINT happens between the previous QUIT and the system call). | |
150 | To immediately quit in the case in which a SIGINT happens between | |
151 | the previous QUIT and setting immediate_quit (desirable anytime we | |
152 | expect to block), call QUIT after setting immediate_quit. */ | |
153 | ||
154 | int immediate_quit; | |
155 | ||
4a351cef AF |
156 | /* Nonzero means that encoded C++/ObjC names should be printed out in their |
157 | C++/ObjC form rather than raw. */ | |
c906108c SS |
158 | |
159 | int demangle = 1; | |
160 | ||
4a351cef AF |
161 | /* Nonzero means that encoded C++/ObjC names should be printed out in their |
162 | C++/ObjC form even in assembler language displays. If this is set, but | |
c906108c SS |
163 | DEMANGLE is zero, names are printed raw, i.e. DEMANGLE controls. */ |
164 | ||
165 | int asm_demangle = 0; | |
166 | ||
167 | /* Nonzero means that strings with character values >0x7F should be printed | |
168 | as octal escapes. Zero means just print the value (e.g. it's an | |
169 | international character, and the terminal or window can cope.) */ | |
170 | ||
171 | int sevenbit_strings = 0; | |
172 | ||
173 | /* String to be printed before error messages, if any. */ | |
174 | ||
175 | char *error_pre_print; | |
176 | ||
177 | /* String to be printed before quit messages, if any. */ | |
178 | ||
179 | char *quit_pre_print; | |
180 | ||
181 | /* String to be printed before warning messages, if any. */ | |
182 | ||
183 | char *warning_pre_print = "\nwarning: "; | |
184 | ||
185 | int pagination_enabled = 1; | |
c906108c | 186 | \f |
c5aa993b | 187 | |
c906108c SS |
188 | /* Add a new cleanup to the cleanup_chain, |
189 | and return the previous chain pointer | |
190 | to be passed later to do_cleanups or discard_cleanups. | |
191 | Args are FUNCTION to clean up with, and ARG to pass to it. */ | |
192 | ||
193 | struct cleanup * | |
e4005526 | 194 | make_cleanup (make_cleanup_ftype *function, void *arg) |
c906108c | 195 | { |
c5aa993b | 196 | return make_my_cleanup (&cleanup_chain, function, arg); |
c906108c SS |
197 | } |
198 | ||
199 | struct cleanup * | |
e4005526 | 200 | make_final_cleanup (make_cleanup_ftype *function, void *arg) |
c906108c | 201 | { |
c5aa993b | 202 | return make_my_cleanup (&final_cleanup_chain, function, arg); |
c906108c | 203 | } |
7a292a7a | 204 | |
c906108c | 205 | struct cleanup * |
e4005526 | 206 | make_run_cleanup (make_cleanup_ftype *function, void *arg) |
c906108c | 207 | { |
c5aa993b | 208 | return make_my_cleanup (&run_cleanup_chain, function, arg); |
c906108c | 209 | } |
7a292a7a | 210 | |
43ff13b4 | 211 | struct cleanup * |
e4005526 | 212 | make_exec_cleanup (make_cleanup_ftype *function, void *arg) |
43ff13b4 | 213 | { |
c5aa993b | 214 | return make_my_cleanup (&exec_cleanup_chain, function, arg); |
43ff13b4 JM |
215 | } |
216 | ||
6426a772 | 217 | struct cleanup * |
e4005526 | 218 | make_exec_error_cleanup (make_cleanup_ftype *function, void *arg) |
6426a772 JM |
219 | { |
220 | return make_my_cleanup (&exec_error_cleanup_chain, function, arg); | |
221 | } | |
222 | ||
7a292a7a | 223 | static void |
fba45db2 | 224 | do_freeargv (void *arg) |
7a292a7a | 225 | { |
c5aa993b | 226 | freeargv ((char **) arg); |
7a292a7a SS |
227 | } |
228 | ||
229 | struct cleanup * | |
fba45db2 | 230 | make_cleanup_freeargv (char **arg) |
7a292a7a SS |
231 | { |
232 | return make_my_cleanup (&cleanup_chain, do_freeargv, arg); | |
233 | } | |
234 | ||
5c65bbb6 AC |
235 | static void |
236 | do_bfd_close_cleanup (void *arg) | |
237 | { | |
238 | bfd_close (arg); | |
239 | } | |
240 | ||
241 | struct cleanup * | |
242 | make_cleanup_bfd_close (bfd *abfd) | |
243 | { | |
244 | return make_cleanup (do_bfd_close_cleanup, abfd); | |
245 | } | |
246 | ||
f5ff8c83 AC |
247 | static void |
248 | do_close_cleanup (void *arg) | |
249 | { | |
f042532c AC |
250 | int *fd = arg; |
251 | close (*fd); | |
252 | xfree (fd); | |
f5ff8c83 AC |
253 | } |
254 | ||
255 | struct cleanup * | |
256 | make_cleanup_close (int fd) | |
257 | { | |
f042532c AC |
258 | int *saved_fd = xmalloc (sizeof (fd)); |
259 | *saved_fd = fd; | |
260 | return make_cleanup (do_close_cleanup, saved_fd); | |
f5ff8c83 AC |
261 | } |
262 | ||
11cf8741 | 263 | static void |
d9fcf2fb | 264 | do_ui_file_delete (void *arg) |
11cf8741 | 265 | { |
d9fcf2fb | 266 | ui_file_delete (arg); |
11cf8741 JM |
267 | } |
268 | ||
269 | struct cleanup * | |
d9fcf2fb | 270 | make_cleanup_ui_file_delete (struct ui_file *arg) |
11cf8741 | 271 | { |
d9fcf2fb | 272 | return make_my_cleanup (&cleanup_chain, do_ui_file_delete, arg); |
11cf8741 JM |
273 | } |
274 | ||
c906108c | 275 | struct cleanup * |
e4005526 AC |
276 | make_my_cleanup (struct cleanup **pmy_chain, make_cleanup_ftype *function, |
277 | void *arg) | |
c906108c SS |
278 | { |
279 | register struct cleanup *new | |
389e51db | 280 | = (struct cleanup *) xmalloc (sizeof (struct cleanup)); |
c906108c SS |
281 | register struct cleanup *old_chain = *pmy_chain; |
282 | ||
283 | new->next = *pmy_chain; | |
284 | new->function = function; | |
285 | new->arg = arg; | |
286 | *pmy_chain = new; | |
287 | ||
288 | return old_chain; | |
289 | } | |
290 | ||
291 | /* Discard cleanups and do the actions they describe | |
292 | until we get back to the point OLD_CHAIN in the cleanup_chain. */ | |
293 | ||
294 | void | |
fba45db2 | 295 | do_cleanups (register struct cleanup *old_chain) |
c906108c | 296 | { |
c5aa993b | 297 | do_my_cleanups (&cleanup_chain, old_chain); |
c906108c SS |
298 | } |
299 | ||
300 | void | |
fba45db2 | 301 | do_final_cleanups (register struct cleanup *old_chain) |
c906108c | 302 | { |
c5aa993b | 303 | do_my_cleanups (&final_cleanup_chain, old_chain); |
c906108c SS |
304 | } |
305 | ||
306 | void | |
fba45db2 | 307 | do_run_cleanups (register struct cleanup *old_chain) |
c906108c | 308 | { |
c5aa993b | 309 | do_my_cleanups (&run_cleanup_chain, old_chain); |
c906108c SS |
310 | } |
311 | ||
43ff13b4 | 312 | void |
fba45db2 | 313 | do_exec_cleanups (register struct cleanup *old_chain) |
43ff13b4 | 314 | { |
c5aa993b | 315 | do_my_cleanups (&exec_cleanup_chain, old_chain); |
43ff13b4 JM |
316 | } |
317 | ||
6426a772 | 318 | void |
fba45db2 | 319 | do_exec_error_cleanups (register struct cleanup *old_chain) |
6426a772 JM |
320 | { |
321 | do_my_cleanups (&exec_error_cleanup_chain, old_chain); | |
322 | } | |
323 | ||
c906108c | 324 | void |
fba45db2 KB |
325 | do_my_cleanups (register struct cleanup **pmy_chain, |
326 | register struct cleanup *old_chain) | |
c906108c SS |
327 | { |
328 | register struct cleanup *ptr; | |
329 | while ((ptr = *pmy_chain) != old_chain) | |
330 | { | |
331 | *pmy_chain = ptr->next; /* Do this first incase recursion */ | |
332 | (*ptr->function) (ptr->arg); | |
b8c9b27d | 333 | xfree (ptr); |
c906108c SS |
334 | } |
335 | } | |
336 | ||
337 | /* Discard cleanups, not doing the actions they describe, | |
338 | until we get back to the point OLD_CHAIN in the cleanup_chain. */ | |
339 | ||
340 | void | |
fba45db2 | 341 | discard_cleanups (register struct cleanup *old_chain) |
c906108c | 342 | { |
c5aa993b | 343 | discard_my_cleanups (&cleanup_chain, old_chain); |
c906108c SS |
344 | } |
345 | ||
346 | void | |
fba45db2 | 347 | discard_final_cleanups (register struct cleanup *old_chain) |
c906108c | 348 | { |
c5aa993b | 349 | discard_my_cleanups (&final_cleanup_chain, old_chain); |
c906108c SS |
350 | } |
351 | ||
6426a772 | 352 | void |
fba45db2 | 353 | discard_exec_error_cleanups (register struct cleanup *old_chain) |
6426a772 JM |
354 | { |
355 | discard_my_cleanups (&exec_error_cleanup_chain, old_chain); | |
356 | } | |
357 | ||
c906108c | 358 | void |
fba45db2 KB |
359 | discard_my_cleanups (register struct cleanup **pmy_chain, |
360 | register struct cleanup *old_chain) | |
c906108c SS |
361 | { |
362 | register struct cleanup *ptr; | |
363 | while ((ptr = *pmy_chain) != old_chain) | |
364 | { | |
365 | *pmy_chain = ptr->next; | |
b8c9b27d | 366 | xfree (ptr); |
c906108c SS |
367 | } |
368 | } | |
369 | ||
370 | /* Set the cleanup_chain to 0, and return the old cleanup chain. */ | |
371 | struct cleanup * | |
fba45db2 | 372 | save_cleanups (void) |
c906108c | 373 | { |
c5aa993b | 374 | return save_my_cleanups (&cleanup_chain); |
c906108c SS |
375 | } |
376 | ||
377 | struct cleanup * | |
fba45db2 | 378 | save_final_cleanups (void) |
c906108c | 379 | { |
c5aa993b | 380 | return save_my_cleanups (&final_cleanup_chain); |
c906108c SS |
381 | } |
382 | ||
383 | struct cleanup * | |
fba45db2 | 384 | save_my_cleanups (struct cleanup **pmy_chain) |
c906108c SS |
385 | { |
386 | struct cleanup *old_chain = *pmy_chain; | |
387 | ||
388 | *pmy_chain = 0; | |
389 | return old_chain; | |
390 | } | |
391 | ||
392 | /* Restore the cleanup chain from a previously saved chain. */ | |
393 | void | |
fba45db2 | 394 | restore_cleanups (struct cleanup *chain) |
c906108c | 395 | { |
c5aa993b | 396 | restore_my_cleanups (&cleanup_chain, chain); |
c906108c SS |
397 | } |
398 | ||
399 | void | |
fba45db2 | 400 | restore_final_cleanups (struct cleanup *chain) |
c906108c | 401 | { |
c5aa993b | 402 | restore_my_cleanups (&final_cleanup_chain, chain); |
c906108c SS |
403 | } |
404 | ||
405 | void | |
fba45db2 | 406 | restore_my_cleanups (struct cleanup **pmy_chain, struct cleanup *chain) |
c906108c SS |
407 | { |
408 | *pmy_chain = chain; | |
409 | } | |
410 | ||
411 | /* This function is useful for cleanups. | |
412 | Do | |
413 | ||
c5aa993b JM |
414 | foo = xmalloc (...); |
415 | old_chain = make_cleanup (free_current_contents, &foo); | |
c906108c SS |
416 | |
417 | to arrange to free the object thus allocated. */ | |
418 | ||
419 | void | |
2f9429ae | 420 | free_current_contents (void *ptr) |
c906108c | 421 | { |
2f9429ae | 422 | void **location = ptr; |
e2f9c474 | 423 | if (location == NULL) |
8e65ff28 AC |
424 | internal_error (__FILE__, __LINE__, |
425 | "free_current_contents: NULL pointer"); | |
2f9429ae | 426 | if (*location != NULL) |
e2f9c474 | 427 | { |
b8c9b27d | 428 | xfree (*location); |
e2f9c474 AC |
429 | *location = NULL; |
430 | } | |
c906108c SS |
431 | } |
432 | ||
433 | /* Provide a known function that does nothing, to use as a base for | |
434 | for a possibly long chain of cleanups. This is useful where we | |
435 | use the cleanup chain for handling normal cleanups as well as dealing | |
436 | with cleanups that need to be done as a result of a call to error(). | |
437 | In such cases, we may not be certain where the first cleanup is, unless | |
438 | we have a do-nothing one to always use as the base. */ | |
439 | ||
440 | /* ARGSUSED */ | |
441 | void | |
e4005526 | 442 | null_cleanup (void *arg) |
c906108c SS |
443 | { |
444 | } | |
445 | ||
74f832da | 446 | /* Add a continuation to the continuation list, the global list |
c2d11a7d | 447 | cmd_continuation. The new continuation will be added at the front.*/ |
43ff13b4 | 448 | void |
74f832da KB |
449 | add_continuation (void (*continuation_hook) (struct continuation_arg *), |
450 | struct continuation_arg *arg_list) | |
43ff13b4 | 451 | { |
c5aa993b | 452 | struct continuation *continuation_ptr; |
43ff13b4 | 453 | |
c5aa993b JM |
454 | continuation_ptr = (struct continuation *) xmalloc (sizeof (struct continuation)); |
455 | continuation_ptr->continuation_hook = continuation_hook; | |
456 | continuation_ptr->arg_list = arg_list; | |
457 | continuation_ptr->next = cmd_continuation; | |
458 | cmd_continuation = continuation_ptr; | |
43ff13b4 JM |
459 | } |
460 | ||
461 | /* Walk down the cmd_continuation list, and execute all the | |
c2d11a7d JM |
462 | continuations. There is a problem though. In some cases new |
463 | continuations may be added while we are in the middle of this | |
464 | loop. If this happens they will be added in the front, and done | |
465 | before we have a chance of exhausting those that were already | |
466 | there. We need to then save the beginning of the list in a pointer | |
467 | and do the continuations from there on, instead of using the | |
468 | global beginning of list as our iteration pointer.*/ | |
c5aa993b | 469 | void |
fba45db2 | 470 | do_all_continuations (void) |
c2d11a7d JM |
471 | { |
472 | struct continuation *continuation_ptr; | |
473 | struct continuation *saved_continuation; | |
474 | ||
475 | /* Copy the list header into another pointer, and set the global | |
476 | list header to null, so that the global list can change as a side | |
477 | effect of invoking the continuations and the processing of | |
478 | the preexisting continuations will not be affected. */ | |
479 | continuation_ptr = cmd_continuation; | |
480 | cmd_continuation = NULL; | |
481 | ||
482 | /* Work now on the list we have set aside. */ | |
483 | while (continuation_ptr) | |
484 | { | |
485 | (continuation_ptr->continuation_hook) (continuation_ptr->arg_list); | |
486 | saved_continuation = continuation_ptr; | |
487 | continuation_ptr = continuation_ptr->next; | |
b8c9b27d | 488 | xfree (saved_continuation); |
c2d11a7d JM |
489 | } |
490 | } | |
491 | ||
492 | /* Walk down the cmd_continuation list, and get rid of all the | |
493 | continuations. */ | |
494 | void | |
fba45db2 | 495 | discard_all_continuations (void) |
43ff13b4 | 496 | { |
c5aa993b | 497 | struct continuation *continuation_ptr; |
43ff13b4 | 498 | |
c5aa993b JM |
499 | while (cmd_continuation) |
500 | { | |
c5aa993b JM |
501 | continuation_ptr = cmd_continuation; |
502 | cmd_continuation = continuation_ptr->next; | |
b8c9b27d | 503 | xfree (continuation_ptr); |
c5aa993b | 504 | } |
43ff13b4 | 505 | } |
c2c6d25f | 506 | |
57e687d9 | 507 | /* Add a continuation to the continuation list, the global list |
c2d11a7d JM |
508 | intermediate_continuation. The new continuation will be added at the front.*/ |
509 | void | |
74f832da KB |
510 | add_intermediate_continuation (void (*continuation_hook) |
511 | (struct continuation_arg *), | |
512 | struct continuation_arg *arg_list) | |
c2d11a7d JM |
513 | { |
514 | struct continuation *continuation_ptr; | |
515 | ||
516 | continuation_ptr = (struct continuation *) xmalloc (sizeof (struct continuation)); | |
517 | continuation_ptr->continuation_hook = continuation_hook; | |
518 | continuation_ptr->arg_list = arg_list; | |
519 | continuation_ptr->next = intermediate_continuation; | |
520 | intermediate_continuation = continuation_ptr; | |
521 | } | |
522 | ||
523 | /* Walk down the cmd_continuation list, and execute all the | |
524 | continuations. There is a problem though. In some cases new | |
525 | continuations may be added while we are in the middle of this | |
526 | loop. If this happens they will be added in the front, and done | |
527 | before we have a chance of exhausting those that were already | |
528 | there. We need to then save the beginning of the list in a pointer | |
529 | and do the continuations from there on, instead of using the | |
530 | global beginning of list as our iteration pointer.*/ | |
531 | void | |
fba45db2 | 532 | do_all_intermediate_continuations (void) |
c2d11a7d JM |
533 | { |
534 | struct continuation *continuation_ptr; | |
535 | struct continuation *saved_continuation; | |
536 | ||
537 | /* Copy the list header into another pointer, and set the global | |
538 | list header to null, so that the global list can change as a side | |
539 | effect of invoking the continuations and the processing of | |
540 | the preexisting continuations will not be affected. */ | |
541 | continuation_ptr = intermediate_continuation; | |
542 | intermediate_continuation = NULL; | |
543 | ||
544 | /* Work now on the list we have set aside. */ | |
545 | while (continuation_ptr) | |
546 | { | |
547 | (continuation_ptr->continuation_hook) (continuation_ptr->arg_list); | |
548 | saved_continuation = continuation_ptr; | |
549 | continuation_ptr = continuation_ptr->next; | |
b8c9b27d | 550 | xfree (saved_continuation); |
c2d11a7d JM |
551 | } |
552 | } | |
553 | ||
c2c6d25f JM |
554 | /* Walk down the cmd_continuation list, and get rid of all the |
555 | continuations. */ | |
556 | void | |
fba45db2 | 557 | discard_all_intermediate_continuations (void) |
c2c6d25f JM |
558 | { |
559 | struct continuation *continuation_ptr; | |
560 | ||
c2d11a7d | 561 | while (intermediate_continuation) |
c2c6d25f | 562 | { |
c2d11a7d JM |
563 | continuation_ptr = intermediate_continuation; |
564 | intermediate_continuation = continuation_ptr->next; | |
b8c9b27d | 565 | xfree (continuation_ptr); |
c2c6d25f JM |
566 | } |
567 | } | |
568 | ||
c906108c | 569 | \f |
c5aa993b | 570 | |
f5a96129 AC |
571 | /* Print a warning message. The first argument STRING is the warning |
572 | message, used as an fprintf format string, the second is the | |
573 | va_list of arguments for that string. A warning is unfiltered (not | |
574 | paginated) so that the user does not need to page through each | |
575 | screen full of warnings when there are lots of them. */ | |
c906108c SS |
576 | |
577 | void | |
f5a96129 | 578 | vwarning (const char *string, va_list args) |
c906108c | 579 | { |
f5a96129 AC |
580 | if (warning_hook) |
581 | (*warning_hook) (string, args); | |
582 | else | |
583 | { | |
584 | target_terminal_ours (); | |
585 | wrap_here (""); /* Force out any buffered output */ | |
586 | gdb_flush (gdb_stdout); | |
587 | if (warning_pre_print) | |
588 | fprintf_unfiltered (gdb_stderr, warning_pre_print); | |
589 | vfprintf_unfiltered (gdb_stderr, string, args); | |
590 | fprintf_unfiltered (gdb_stderr, "\n"); | |
591 | va_end (args); | |
592 | } | |
c906108c SS |
593 | } |
594 | ||
595 | /* Print a warning message. | |
596 | The first argument STRING is the warning message, used as a fprintf string, | |
597 | and the remaining args are passed as arguments to it. | |
598 | The primary difference between warnings and errors is that a warning | |
599 | does not force the return to command level. */ | |
600 | ||
c906108c | 601 | void |
c5aa993b | 602 | warning (const char *string,...) |
c906108c SS |
603 | { |
604 | va_list args; | |
c906108c | 605 | va_start (args, string); |
f5a96129 AC |
606 | vwarning (string, args); |
607 | va_end (args); | |
c906108c SS |
608 | } |
609 | ||
c906108c SS |
610 | /* Print an error message and return to command level. |
611 | The first argument STRING is the error message, used as a fprintf string, | |
612 | and the remaining args are passed as arguments to it. */ | |
613 | ||
4ce44c66 JM |
614 | NORETURN void |
615 | verror (const char *string, va_list args) | |
616 | { | |
fffee0be AC |
617 | struct ui_file *tmp_stream = mem_fileopen (); |
618 | make_cleanup_ui_file_delete (tmp_stream); | |
619 | vfprintf_unfiltered (tmp_stream, string, args); | |
620 | error_stream (tmp_stream); | |
4ce44c66 JM |
621 | } |
622 | ||
c906108c | 623 | NORETURN void |
c5aa993b | 624 | error (const char *string,...) |
c906108c SS |
625 | { |
626 | va_list args; | |
c906108c | 627 | va_start (args, string); |
4ce44c66 JM |
628 | verror (string, args); |
629 | va_end (args); | |
c906108c SS |
630 | } |
631 | ||
fffee0be AC |
632 | static void |
633 | do_write (void *data, const char *buffer, long length_buffer) | |
634 | { | |
635 | ui_file_write (data, buffer, length_buffer); | |
636 | } | |
637 | ||
2acceee2 | 638 | NORETURN void |
d9fcf2fb | 639 | error_stream (struct ui_file *stream) |
2acceee2 | 640 | { |
fffee0be AC |
641 | if (error_begin_hook) |
642 | error_begin_hook (); | |
643 | ||
644 | /* Copy the stream into the GDB_LASTERR buffer. */ | |
645 | ui_file_rewind (gdb_lasterr); | |
646 | ui_file_put (stream, do_write, gdb_lasterr); | |
647 | ||
648 | /* Write the message plus any error_pre_print to gdb_stderr. */ | |
649 | target_terminal_ours (); | |
650 | wrap_here (""); /* Force out any buffered output */ | |
651 | gdb_flush (gdb_stdout); | |
652 | annotate_error_begin (); | |
653 | if (error_pre_print) | |
654 | fprintf_filtered (gdb_stderr, error_pre_print); | |
655 | ui_file_put (stream, do_write, gdb_stderr); | |
656 | fprintf_filtered (gdb_stderr, "\n"); | |
657 | ||
b5a2688f | 658 | throw_exception (RETURN_ERROR); |
2acceee2 JM |
659 | } |
660 | ||
661 | /* Get the last error message issued by gdb */ | |
662 | ||
663 | char * | |
664 | error_last_message (void) | |
665 | { | |
4ce44c66 | 666 | long len; |
d9fcf2fb | 667 | return ui_file_xstrdup (gdb_lasterr, &len); |
2acceee2 | 668 | } |
4ce44c66 | 669 | |
2acceee2 JM |
670 | /* This is to be called by main() at the very beginning */ |
671 | ||
672 | void | |
673 | error_init (void) | |
674 | { | |
4ce44c66 | 675 | gdb_lasterr = mem_fileopen (); |
2acceee2 | 676 | } |
c906108c | 677 | |
dec43320 AC |
678 | /* Print a message reporting an internal error/warning. Ask the user |
679 | if they want to continue, dump core, or just exit. Return | |
680 | something to indicate a quit. */ | |
c906108c | 681 | |
dec43320 | 682 | struct internal_problem |
c906108c | 683 | { |
dec43320 AC |
684 | const char *name; |
685 | /* FIXME: cagney/2002-08-15: There should be ``maint set/show'' | |
686 | commands available for controlling these variables. */ | |
687 | enum auto_boolean should_quit; | |
688 | enum auto_boolean should_dump_core; | |
689 | }; | |
690 | ||
691 | /* Report a problem, internal to GDB, to the user. Once the problem | |
692 | has been reported, and assuming GDB didn't quit, the caller can | |
693 | either allow execution to resume or throw an error. */ | |
694 | ||
695 | static void | |
696 | internal_vproblem (struct internal_problem *problem, | |
697 | const char *file, int line, | |
698 | const char *fmt, va_list ap) | |
699 | { | |
700 | static char msg[] = "Recursive internal problem.\n"; | |
701 | static int dejavu; | |
375fc983 | 702 | int quit_p; |
7be570e7 | 703 | int dump_core_p; |
c906108c | 704 | |
dec43320 | 705 | /* Don't allow infinite error/warning recursion. */ |
96baa820 JM |
706 | switch (dejavu) |
707 | { | |
708 | case 0: | |
709 | dejavu = 1; | |
710 | break; | |
711 | case 1: | |
712 | dejavu = 2; | |
713 | fputs_unfiltered (msg, gdb_stderr); | |
5c7dd748 | 714 | abort (); /* NOTE: GDB has only three calls to abort(). */ |
96baa820 JM |
715 | default: |
716 | dejavu = 3; | |
717 | write (STDERR_FILENO, msg, sizeof (msg)); | |
718 | exit (1); | |
719 | } | |
c906108c | 720 | |
dec43320 | 721 | /* Try to get the message out and at the start of a new line. */ |
4261bedc | 722 | target_terminal_ours (); |
dec43320 AC |
723 | begin_line (); |
724 | ||
725 | /* The error/warning message. Format using a style similar to a | |
726 | compiler error message. */ | |
727 | fprintf_unfiltered (gdb_stderr, "%s:%d: %s: ", file, line, problem->name); | |
4ce44c66 | 728 | vfprintf_unfiltered (gdb_stderr, fmt, ap); |
96baa820 | 729 | fputs_unfiltered ("\n", gdb_stderr); |
c906108c | 730 | |
dec43320 AC |
731 | /* Provide more details so that the user knows that they are living |
732 | on the edge. */ | |
733 | fprintf_unfiltered (gdb_stderr, "\ | |
734 | A problem internal to GDB has been detected. Further\n\ | |
735 | debugging may prove unreliable.\n"); | |
7be570e7 | 736 | |
dec43320 AC |
737 | switch (problem->should_quit) |
738 | { | |
739 | case AUTO_BOOLEAN_AUTO: | |
740 | /* Default (yes/batch case) is to quit GDB. When in batch mode | |
741 | this lessens the likelhood of GDB going into an infinate | |
742 | loop. */ | |
743 | quit_p = query ("Quit this debugging session? "); | |
744 | break; | |
745 | case AUTO_BOOLEAN_TRUE: | |
746 | quit_p = 1; | |
747 | break; | |
748 | case AUTO_BOOLEAN_FALSE: | |
749 | quit_p = 0; | |
750 | break; | |
751 | default: | |
752 | internal_error (__FILE__, __LINE__, "bad switch"); | |
753 | } | |
754 | ||
755 | switch (problem->should_dump_core) | |
756 | { | |
757 | case AUTO_BOOLEAN_AUTO: | |
758 | /* Default (yes/batch case) is to dump core. This leaves a GDB | |
759 | `dropping' so that it is easier to see that something went | |
760 | wrong in GDB. */ | |
761 | dump_core_p = query ("Create a core file of GDB? "); | |
762 | break; | |
763 | break; | |
764 | case AUTO_BOOLEAN_TRUE: | |
765 | dump_core_p = 1; | |
766 | break; | |
767 | case AUTO_BOOLEAN_FALSE: | |
768 | dump_core_p = 0; | |
769 | break; | |
770 | default: | |
771 | internal_error (__FILE__, __LINE__, "bad switch"); | |
772 | } | |
7be570e7 | 773 | |
375fc983 | 774 | if (quit_p) |
7be570e7 JM |
775 | { |
776 | if (dump_core_p) | |
375fc983 AC |
777 | abort (); /* NOTE: GDB has only three calls to abort(). */ |
778 | else | |
779 | exit (1); | |
7be570e7 JM |
780 | } |
781 | else | |
782 | { | |
783 | if (dump_core_p) | |
375fc983 AC |
784 | { |
785 | if (fork () == 0) | |
786 | abort (); /* NOTE: GDB has only three calls to abort(). */ | |
787 | } | |
7be570e7 | 788 | } |
96baa820 JM |
789 | |
790 | dejavu = 0; | |
dec43320 AC |
791 | } |
792 | ||
793 | static struct internal_problem internal_error_problem = { | |
794 | "internal-error", AUTO_BOOLEAN_AUTO, AUTO_BOOLEAN_AUTO | |
795 | }; | |
796 | ||
797 | NORETURN void | |
798 | internal_verror (const char *file, int line, | |
799 | const char *fmt, va_list ap) | |
800 | { | |
801 | internal_vproblem (&internal_error_problem, file, line, fmt, ap); | |
b5a2688f | 802 | throw_exception (RETURN_ERROR); |
c906108c SS |
803 | } |
804 | ||
4ce44c66 | 805 | NORETURN void |
8e65ff28 | 806 | internal_error (const char *file, int line, const char *string, ...) |
4ce44c66 JM |
807 | { |
808 | va_list ap; | |
809 | va_start (ap, string); | |
8e65ff28 | 810 | internal_verror (file, line, string, ap); |
4ce44c66 JM |
811 | va_end (ap); |
812 | } | |
813 | ||
dec43320 AC |
814 | static struct internal_problem internal_warning_problem = { |
815 | "internal-error", AUTO_BOOLEAN_AUTO, AUTO_BOOLEAN_AUTO | |
816 | }; | |
817 | ||
818 | void | |
819 | internal_vwarning (const char *file, int line, | |
820 | const char *fmt, va_list ap) | |
821 | { | |
822 | internal_vproblem (&internal_warning_problem, file, line, fmt, ap); | |
823 | } | |
824 | ||
825 | void | |
826 | internal_warning (const char *file, int line, const char *string, ...) | |
827 | { | |
828 | va_list ap; | |
829 | va_start (ap, string); | |
830 | internal_vwarning (file, line, string, ap); | |
831 | va_end (ap); | |
832 | } | |
833 | ||
c906108c SS |
834 | /* The strerror() function can return NULL for errno values that are |
835 | out of range. Provide a "safe" version that always returns a | |
836 | printable string. */ | |
837 | ||
838 | char * | |
fba45db2 | 839 | safe_strerror (int errnum) |
c906108c SS |
840 | { |
841 | char *msg; | |
842 | static char buf[32]; | |
843 | ||
844 | if ((msg = strerror (errnum)) == NULL) | |
845 | { | |
846 | sprintf (buf, "(undocumented errno %d)", errnum); | |
847 | msg = buf; | |
848 | } | |
849 | return (msg); | |
850 | } | |
851 | ||
c906108c SS |
852 | /* Print the system error message for errno, and also mention STRING |
853 | as the file name for which the error was encountered. | |
854 | Then return to command level. */ | |
855 | ||
856 | NORETURN void | |
6972bc8b | 857 | perror_with_name (const char *string) |
c906108c SS |
858 | { |
859 | char *err; | |
860 | char *combined; | |
861 | ||
862 | err = safe_strerror (errno); | |
863 | combined = (char *) alloca (strlen (err) + strlen (string) + 3); | |
864 | strcpy (combined, string); | |
865 | strcat (combined, ": "); | |
866 | strcat (combined, err); | |
867 | ||
868 | /* I understand setting these is a matter of taste. Still, some people | |
869 | may clear errno but not know about bfd_error. Doing this here is not | |
870 | unreasonable. */ | |
871 | bfd_set_error (bfd_error_no_error); | |
872 | errno = 0; | |
873 | ||
c5aa993b | 874 | error ("%s.", combined); |
c906108c SS |
875 | } |
876 | ||
877 | /* Print the system error message for ERRCODE, and also mention STRING | |
878 | as the file name for which the error was encountered. */ | |
879 | ||
880 | void | |
6972bc8b | 881 | print_sys_errmsg (const char *string, int errcode) |
c906108c SS |
882 | { |
883 | char *err; | |
884 | char *combined; | |
885 | ||
886 | err = safe_strerror (errcode); | |
887 | combined = (char *) alloca (strlen (err) + strlen (string) + 3); | |
888 | strcpy (combined, string); | |
889 | strcat (combined, ": "); | |
890 | strcat (combined, err); | |
891 | ||
892 | /* We want anything which was printed on stdout to come out first, before | |
893 | this message. */ | |
894 | gdb_flush (gdb_stdout); | |
895 | fprintf_unfiltered (gdb_stderr, "%s.\n", combined); | |
896 | } | |
897 | ||
898 | /* Control C eventually causes this to be called, at a convenient time. */ | |
899 | ||
900 | void | |
fba45db2 | 901 | quit (void) |
c906108c | 902 | { |
819cc324 | 903 | struct serial *gdb_stdout_serial = serial_fdopen (1); |
c906108c SS |
904 | |
905 | target_terminal_ours (); | |
906 | ||
907 | /* We want all output to appear now, before we print "Quit". We | |
908 | have 3 levels of buffering we have to flush (it's possible that | |
909 | some of these should be changed to flush the lower-level ones | |
910 | too): */ | |
911 | ||
912 | /* 1. The _filtered buffer. */ | |
c5aa993b | 913 | wrap_here ((char *) 0); |
c906108c SS |
914 | |
915 | /* 2. The stdio buffer. */ | |
916 | gdb_flush (gdb_stdout); | |
917 | gdb_flush (gdb_stderr); | |
918 | ||
919 | /* 3. The system-level buffer. */ | |
2cd58942 AC |
920 | serial_drain_output (gdb_stdout_serial); |
921 | serial_un_fdopen (gdb_stdout_serial); | |
c906108c SS |
922 | |
923 | annotate_error_begin (); | |
924 | ||
925 | /* Don't use *_filtered; we don't want to prompt the user to continue. */ | |
926 | if (quit_pre_print) | |
927 | fprintf_unfiltered (gdb_stderr, quit_pre_print); | |
928 | ||
7be570e7 JM |
929 | #ifdef __MSDOS__ |
930 | /* No steenking SIGINT will ever be coming our way when the | |
931 | program is resumed. Don't lie. */ | |
932 | fprintf_unfiltered (gdb_stderr, "Quit\n"); | |
933 | #else | |
c906108c | 934 | if (job_control |
c5aa993b JM |
935 | /* If there is no terminal switching for this target, then we can't |
936 | possibly get screwed by the lack of job control. */ | |
c906108c SS |
937 | || current_target.to_terminal_ours == NULL) |
938 | fprintf_unfiltered (gdb_stderr, "Quit\n"); | |
939 | else | |
940 | fprintf_unfiltered (gdb_stderr, | |
c5aa993b | 941 | "Quit (expect signal SIGINT when the program is resumed)\n"); |
7be570e7 | 942 | #endif |
b5a2688f | 943 | throw_exception (RETURN_QUIT); |
c906108c SS |
944 | } |
945 | ||
c906108c | 946 | /* Control C comes here */ |
c906108c | 947 | void |
fba45db2 | 948 | request_quit (int signo) |
c906108c SS |
949 | { |
950 | quit_flag = 1; | |
951 | /* Restore the signal handler. Harmless with BSD-style signals, needed | |
952 | for System V-style signals. So just always do it, rather than worrying | |
953 | about USG defines and stuff like that. */ | |
954 | signal (signo, request_quit); | |
955 | ||
956 | #ifdef REQUEST_QUIT | |
957 | REQUEST_QUIT; | |
958 | #else | |
c5aa993b | 959 | if (immediate_quit) |
c906108c SS |
960 | quit (); |
961 | #endif | |
962 | } | |
c906108c SS |
963 | \f |
964 | /* Memory management stuff (malloc friends). */ | |
965 | ||
c906108c SS |
966 | #if !defined (USE_MMALLOC) |
967 | ||
c0e61796 AC |
968 | /* NOTE: These must use PTR so that their definition matches the |
969 | declaration found in "mmalloc.h". */ | |
ed9a39eb | 970 | |
ed1801df AC |
971 | static void * |
972 | mmalloc (void *md, size_t size) | |
c906108c | 973 | { |
c0e61796 | 974 | return malloc (size); /* NOTE: GDB's only call to malloc() */ |
c906108c SS |
975 | } |
976 | ||
ed1801df AC |
977 | static void * |
978 | mrealloc (void *md, void *ptr, size_t size) | |
c906108c | 979 | { |
c5aa993b | 980 | if (ptr == 0) /* Guard against old realloc's */ |
c0e61796 | 981 | return mmalloc (md, size); |
c906108c | 982 | else |
c0e61796 AC |
983 | return realloc (ptr, size); /* NOTE: GDB's only call to ralloc() */ |
984 | } | |
985 | ||
ed1801df AC |
986 | static void * |
987 | mcalloc (void *md, size_t number, size_t size) | |
c0e61796 AC |
988 | { |
989 | return calloc (number, size); /* NOTE: GDB's only call to calloc() */ | |
c906108c SS |
990 | } |
991 | ||
ed1801df AC |
992 | static void |
993 | mfree (void *md, void *ptr) | |
c906108c | 994 | { |
c0e61796 | 995 | free (ptr); /* NOTE: GDB's only call to free() */ |
c906108c SS |
996 | } |
997 | ||
c5aa993b | 998 | #endif /* USE_MMALLOC */ |
c906108c SS |
999 | |
1000 | #if !defined (USE_MMALLOC) || defined (NO_MMCHECK) | |
1001 | ||
1002 | void | |
082faf24 | 1003 | init_malloc (void *md) |
c906108c SS |
1004 | { |
1005 | } | |
1006 | ||
1007 | #else /* Have mmalloc and want corruption checking */ | |
1008 | ||
1009 | static void | |
fba45db2 | 1010 | malloc_botch (void) |
c906108c | 1011 | { |
96baa820 | 1012 | fprintf_unfiltered (gdb_stderr, "Memory corruption\n"); |
e1e9e218 | 1013 | internal_error (__FILE__, __LINE__, "failed internal consistency check"); |
c906108c SS |
1014 | } |
1015 | ||
1016 | /* Attempt to install hooks in mmalloc/mrealloc/mfree for the heap specified | |
1017 | by MD, to detect memory corruption. Note that MD may be NULL to specify | |
1018 | the default heap that grows via sbrk. | |
1019 | ||
1020 | Note that for freshly created regions, we must call mmcheckf prior to any | |
1021 | mallocs in the region. Otherwise, any region which was allocated prior to | |
1022 | installing the checking hooks, which is later reallocated or freed, will | |
1023 | fail the checks! The mmcheck function only allows initial hooks to be | |
1024 | installed before the first mmalloc. However, anytime after we have called | |
1025 | mmcheck the first time to install the checking hooks, we can call it again | |
1026 | to update the function pointer to the memory corruption handler. | |
1027 | ||
1028 | Returns zero on failure, non-zero on success. */ | |
1029 | ||
1030 | #ifndef MMCHECK_FORCE | |
1031 | #define MMCHECK_FORCE 0 | |
1032 | #endif | |
1033 | ||
1034 | void | |
082faf24 | 1035 | init_malloc (void *md) |
c906108c SS |
1036 | { |
1037 | if (!mmcheckf (md, malloc_botch, MMCHECK_FORCE)) | |
1038 | { | |
1039 | /* Don't use warning(), which relies on current_target being set | |
c5aa993b JM |
1040 | to something other than dummy_target, until after |
1041 | initialize_all_files(). */ | |
c906108c SS |
1042 | |
1043 | fprintf_unfiltered | |
1044 | (gdb_stderr, "warning: failed to install memory consistency checks; "); | |
1045 | fprintf_unfiltered | |
1046 | (gdb_stderr, "configuration should define NO_MMCHECK or MMCHECK_FORCE\n"); | |
1047 | } | |
1048 | ||
1049 | mmtrace (); | |
1050 | } | |
1051 | ||
1052 | #endif /* Have mmalloc and want corruption checking */ | |
1053 | ||
1054 | /* Called when a memory allocation fails, with the number of bytes of | |
1055 | memory requested in SIZE. */ | |
1056 | ||
1057 | NORETURN void | |
fba45db2 | 1058 | nomem (long size) |
c906108c SS |
1059 | { |
1060 | if (size > 0) | |
1061 | { | |
8e65ff28 AC |
1062 | internal_error (__FILE__, __LINE__, |
1063 | "virtual memory exhausted: can't allocate %ld bytes.", size); | |
c906108c SS |
1064 | } |
1065 | else | |
1066 | { | |
8e65ff28 AC |
1067 | internal_error (__FILE__, __LINE__, |
1068 | "virtual memory exhausted."); | |
c906108c SS |
1069 | } |
1070 | } | |
1071 | ||
c0e61796 | 1072 | /* The xmmalloc() family of memory management routines. |
c906108c | 1073 | |
c0e61796 AC |
1074 | These are are like the mmalloc() family except that they implement |
1075 | consistent semantics and guard against typical memory management | |
1076 | problems: if a malloc fails, an internal error is thrown; if | |
1077 | free(NULL) is called, it is ignored; if *alloc(0) is called, NULL | |
1078 | is returned. | |
1079 | ||
1080 | All these routines are implemented using the mmalloc() family. */ | |
1081 | ||
1082 | void * | |
1083 | xmmalloc (void *md, size_t size) | |
c906108c | 1084 | { |
c0e61796 | 1085 | void *val; |
c906108c SS |
1086 | |
1087 | if (size == 0) | |
1088 | { | |
1089 | val = NULL; | |
1090 | } | |
c0e61796 | 1091 | else |
c906108c | 1092 | { |
c0e61796 AC |
1093 | val = mmalloc (md, size); |
1094 | if (val == NULL) | |
1095 | nomem (size); | |
c906108c SS |
1096 | } |
1097 | return (val); | |
1098 | } | |
1099 | ||
c0e61796 AC |
1100 | void * |
1101 | xmrealloc (void *md, void *ptr, size_t size) | |
c906108c | 1102 | { |
c0e61796 | 1103 | void *val; |
c906108c | 1104 | |
d7fa9de0 | 1105 | if (size == 0) |
c906108c | 1106 | { |
d7fa9de0 KB |
1107 | if (ptr != NULL) |
1108 | mfree (md, ptr); | |
1109 | val = NULL; | |
c906108c SS |
1110 | } |
1111 | else | |
1112 | { | |
d7fa9de0 KB |
1113 | if (ptr != NULL) |
1114 | { | |
1115 | val = mrealloc (md, ptr, size); | |
1116 | } | |
1117 | else | |
1118 | { | |
1119 | val = mmalloc (md, size); | |
1120 | } | |
1121 | if (val == NULL) | |
1122 | { | |
1123 | nomem (size); | |
1124 | } | |
c906108c SS |
1125 | } |
1126 | return (val); | |
1127 | } | |
1128 | ||
c0e61796 AC |
1129 | void * |
1130 | xmcalloc (void *md, size_t number, size_t size) | |
ed9a39eb | 1131 | { |
d7fa9de0 | 1132 | void *mem; |
d7fa9de0 KB |
1133 | if (number == 0 || size == 0) |
1134 | mem = NULL; | |
1135 | else | |
1136 | { | |
c0e61796 | 1137 | mem = mcalloc (md, number, size); |
d7fa9de0 KB |
1138 | if (mem == NULL) |
1139 | nomem (number * size); | |
1140 | } | |
ed9a39eb JM |
1141 | return mem; |
1142 | } | |
1143 | ||
c0e61796 AC |
1144 | void |
1145 | xmfree (void *md, void *ptr) | |
1146 | { | |
1147 | if (ptr != NULL) | |
1148 | mfree (md, ptr); | |
1149 | } | |
1150 | ||
1151 | /* The xmalloc() (libiberty.h) family of memory management routines. | |
1152 | ||
1153 | These are like the ISO-C malloc() family except that they implement | |
1154 | consistent semantics and guard against typical memory management | |
1155 | problems. See xmmalloc() above for further information. | |
1156 | ||
1157 | All these routines are wrappers to the xmmalloc() family. */ | |
1158 | ||
1159 | /* NOTE: These are declared using PTR to ensure consistency with | |
1160 | "libiberty.h". xfree() is GDB local. */ | |
1161 | ||
1162 | PTR | |
1163 | xmalloc (size_t size) | |
1164 | { | |
1165 | return xmmalloc (NULL, size); | |
1166 | } | |
c906108c SS |
1167 | |
1168 | PTR | |
fba45db2 | 1169 | xrealloc (PTR ptr, size_t size) |
c906108c | 1170 | { |
c0e61796 | 1171 | return xmrealloc (NULL, ptr, size); |
c906108c | 1172 | } |
b8c9b27d | 1173 | |
c0e61796 AC |
1174 | PTR |
1175 | xcalloc (size_t number, size_t size) | |
1176 | { | |
1177 | return xmcalloc (NULL, number, size); | |
1178 | } | |
b8c9b27d KB |
1179 | |
1180 | void | |
1181 | xfree (void *ptr) | |
1182 | { | |
c0e61796 | 1183 | xmfree (NULL, ptr); |
b8c9b27d | 1184 | } |
c906108c | 1185 | \f |
c5aa993b | 1186 | |
76995688 AC |
1187 | /* Like asprintf/vasprintf but get an internal_error if the call |
1188 | fails. */ | |
1189 | ||
1190 | void | |
1191 | xasprintf (char **ret, const char *format, ...) | |
1192 | { | |
1193 | va_list args; | |
1194 | va_start (args, format); | |
1195 | xvasprintf (ret, format, args); | |
1196 | va_end (args); | |
1197 | } | |
1198 | ||
1199 | void | |
1200 | xvasprintf (char **ret, const char *format, va_list ap) | |
1201 | { | |
1202 | int status = vasprintf (ret, format, ap); | |
1203 | /* NULL could be returned due to a memory allocation problem; a | |
1204 | badly format string; or something else. */ | |
1205 | if ((*ret) == NULL) | |
8e65ff28 AC |
1206 | internal_error (__FILE__, __LINE__, |
1207 | "vasprintf returned NULL buffer (errno %d)", | |
1208 | errno); | |
76995688 AC |
1209 | /* A negative status with a non-NULL buffer shouldn't never |
1210 | happen. But to be sure. */ | |
1211 | if (status < 0) | |
8e65ff28 AC |
1212 | internal_error (__FILE__, __LINE__, |
1213 | "vasprintf call failed (errno %d)", | |
1214 | errno); | |
76995688 AC |
1215 | } |
1216 | ||
1217 | ||
c906108c SS |
1218 | /* My replacement for the read system call. |
1219 | Used like `read' but keeps going if `read' returns too soon. */ | |
1220 | ||
1221 | int | |
fba45db2 | 1222 | myread (int desc, char *addr, int len) |
c906108c SS |
1223 | { |
1224 | register int val; | |
1225 | int orglen = len; | |
1226 | ||
1227 | while (len > 0) | |
1228 | { | |
1229 | val = read (desc, addr, len); | |
1230 | if (val < 0) | |
1231 | return val; | |
1232 | if (val == 0) | |
1233 | return orglen - len; | |
1234 | len -= val; | |
1235 | addr += val; | |
1236 | } | |
1237 | return orglen; | |
1238 | } | |
1239 | \f | |
1240 | /* Make a copy of the string at PTR with SIZE characters | |
1241 | (and add a null character at the end in the copy). | |
1242 | Uses malloc to get the space. Returns the address of the copy. */ | |
1243 | ||
1244 | char * | |
5565b556 | 1245 | savestring (const char *ptr, size_t size) |
c906108c SS |
1246 | { |
1247 | register char *p = (char *) xmalloc (size + 1); | |
1248 | memcpy (p, ptr, size); | |
1249 | p[size] = 0; | |
1250 | return p; | |
1251 | } | |
1252 | ||
1253 | char * | |
5565b556 | 1254 | msavestring (void *md, const char *ptr, size_t size) |
c906108c SS |
1255 | { |
1256 | register char *p = (char *) xmmalloc (md, size + 1); | |
1257 | memcpy (p, ptr, size); | |
1258 | p[size] = 0; | |
1259 | return p; | |
1260 | } | |
1261 | ||
c906108c | 1262 | char * |
082faf24 | 1263 | mstrsave (void *md, const char *ptr) |
c906108c SS |
1264 | { |
1265 | return (msavestring (md, ptr, strlen (ptr))); | |
1266 | } | |
1267 | ||
1268 | void | |
fba45db2 | 1269 | print_spaces (register int n, register struct ui_file *file) |
c906108c | 1270 | { |
392a587b | 1271 | fputs_unfiltered (n_spaces (n), file); |
c906108c SS |
1272 | } |
1273 | ||
1274 | /* Print a host address. */ | |
1275 | ||
1276 | void | |
d9fcf2fb | 1277 | gdb_print_host_address (void *addr, struct ui_file *stream) |
c906108c SS |
1278 | { |
1279 | ||
1280 | /* We could use the %p conversion specifier to fprintf if we had any | |
1281 | way of knowing whether this host supports it. But the following | |
1282 | should work on the Alpha and on 32 bit machines. */ | |
1283 | ||
c5aa993b | 1284 | fprintf_filtered (stream, "0x%lx", (unsigned long) addr); |
c906108c SS |
1285 | } |
1286 | ||
1287 | /* Ask user a y-or-n question and return 1 iff answer is yes. | |
1288 | Takes three args which are given to printf to print the question. | |
1289 | The first, a control string, should end in "? ". | |
1290 | It should not say how to answer, because we do that. */ | |
1291 | ||
1292 | /* VARARGS */ | |
1293 | int | |
6972bc8b | 1294 | query (const char *ctlstr,...) |
c906108c SS |
1295 | { |
1296 | va_list args; | |
1297 | register int answer; | |
1298 | register int ans2; | |
1299 | int retval; | |
1300 | ||
c906108c | 1301 | va_start (args, ctlstr); |
c906108c SS |
1302 | |
1303 | if (query_hook) | |
1304 | { | |
1305 | return query_hook (ctlstr, args); | |
1306 | } | |
1307 | ||
1308 | /* Automatically answer "yes" if input is not from a terminal. */ | |
1309 | if (!input_from_terminal_p ()) | |
1310 | return 1; | |
c906108c SS |
1311 | |
1312 | while (1) | |
1313 | { | |
1314 | wrap_here (""); /* Flush any buffered output */ | |
1315 | gdb_flush (gdb_stdout); | |
1316 | ||
1317 | if (annotation_level > 1) | |
1318 | printf_filtered ("\n\032\032pre-query\n"); | |
1319 | ||
1320 | vfprintf_filtered (gdb_stdout, ctlstr, args); | |
1321 | printf_filtered ("(y or n) "); | |
1322 | ||
1323 | if (annotation_level > 1) | |
1324 | printf_filtered ("\n\032\032query\n"); | |
1325 | ||
c5aa993b | 1326 | wrap_here (""); |
c906108c SS |
1327 | gdb_flush (gdb_stdout); |
1328 | ||
37767e42 | 1329 | answer = fgetc (stdin); |
c906108c SS |
1330 | clearerr (stdin); /* in case of C-d */ |
1331 | if (answer == EOF) /* C-d */ | |
c5aa993b | 1332 | { |
c906108c SS |
1333 | retval = 1; |
1334 | break; | |
1335 | } | |
1336 | /* Eat rest of input line, to EOF or newline */ | |
37767e42 | 1337 | if (answer != '\n') |
c5aa993b | 1338 | do |
c906108c | 1339 | { |
37767e42 | 1340 | ans2 = fgetc (stdin); |
c906108c SS |
1341 | clearerr (stdin); |
1342 | } | |
c5aa993b | 1343 | while (ans2 != EOF && ans2 != '\n' && ans2 != '\r'); |
c906108c SS |
1344 | |
1345 | if (answer >= 'a') | |
1346 | answer -= 040; | |
1347 | if (answer == 'Y') | |
1348 | { | |
1349 | retval = 1; | |
1350 | break; | |
1351 | } | |
1352 | if (answer == 'N') | |
1353 | { | |
1354 | retval = 0; | |
1355 | break; | |
1356 | } | |
1357 | printf_filtered ("Please answer y or n.\n"); | |
1358 | } | |
1359 | ||
1360 | if (annotation_level > 1) | |
1361 | printf_filtered ("\n\032\032post-query\n"); | |
1362 | return retval; | |
1363 | } | |
c906108c | 1364 | \f |
c5aa993b | 1365 | |
234b45d4 KB |
1366 | /* Print an error message saying that we couldn't make sense of a |
1367 | \^mumble sequence in a string or character constant. START and END | |
1368 | indicate a substring of some larger string that contains the | |
1369 | erroneous backslash sequence, missing the initial backslash. */ | |
1370 | static NORETURN int | |
1371 | no_control_char_error (const char *start, const char *end) | |
1372 | { | |
1373 | int len = end - start; | |
1374 | char *copy = alloca (end - start + 1); | |
1375 | ||
1376 | memcpy (copy, start, len); | |
1377 | copy[len] = '\0'; | |
1378 | ||
1379 | error ("There is no control character `\\%s' in the `%s' character set.", | |
1380 | copy, target_charset ()); | |
1381 | } | |
1382 | ||
c906108c SS |
1383 | /* Parse a C escape sequence. STRING_PTR points to a variable |
1384 | containing a pointer to the string to parse. That pointer | |
1385 | should point to the character after the \. That pointer | |
1386 | is updated past the characters we use. The value of the | |
1387 | escape sequence is returned. | |
1388 | ||
1389 | A negative value means the sequence \ newline was seen, | |
1390 | which is supposed to be equivalent to nothing at all. | |
1391 | ||
1392 | If \ is followed by a null character, we return a negative | |
1393 | value and leave the string pointer pointing at the null character. | |
1394 | ||
1395 | If \ is followed by 000, we return 0 and leave the string pointer | |
1396 | after the zeros. A value of 0 does not mean end of string. */ | |
1397 | ||
1398 | int | |
fba45db2 | 1399 | parse_escape (char **string_ptr) |
c906108c | 1400 | { |
234b45d4 | 1401 | int target_char; |
c906108c | 1402 | register int c = *(*string_ptr)++; |
234b45d4 KB |
1403 | if (c_parse_backslash (c, &target_char)) |
1404 | return target_char; | |
1405 | else switch (c) | |
c906108c | 1406 | { |
c906108c SS |
1407 | case '\n': |
1408 | return -2; | |
1409 | case 0: | |
1410 | (*string_ptr)--; | |
1411 | return 0; | |
1412 | case '^': | |
234b45d4 KB |
1413 | { |
1414 | /* Remember where this escape sequence started, for reporting | |
1415 | errors. */ | |
1416 | char *sequence_start_pos = *string_ptr - 1; | |
1417 | ||
1418 | c = *(*string_ptr)++; | |
1419 | ||
1420 | if (c == '?') | |
1421 | { | |
1422 | /* XXXCHARSET: What is `delete' in the host character set? */ | |
1423 | c = 0177; | |
1424 | ||
1425 | if (! host_char_to_target (c, &target_char)) | |
1426 | error ("There is no character corresponding to `Delete' " | |
1427 | "in the target character set `%s'.", | |
1428 | host_charset ()); | |
1429 | ||
1430 | return target_char; | |
1431 | } | |
1432 | else if (c == '\\') | |
1433 | target_char = parse_escape (string_ptr); | |
1434 | else | |
1435 | { | |
1436 | if (! host_char_to_target (c, &target_char)) | |
1437 | no_control_char_error (sequence_start_pos, *string_ptr); | |
1438 | } | |
1439 | ||
1440 | /* Now target_char is something like `c', and we want to find | |
1441 | its control-character equivalent. */ | |
1442 | if (! target_char_to_control_char (target_char, &target_char)) | |
1443 | no_control_char_error (sequence_start_pos, *string_ptr); | |
1444 | ||
1445 | return target_char; | |
1446 | } | |
1447 | ||
1448 | /* XXXCHARSET: we need to use isdigit and value-of-digit | |
1449 | methods of the host character set here. */ | |
c5aa993b | 1450 | |
c906108c SS |
1451 | case '0': |
1452 | case '1': | |
1453 | case '2': | |
1454 | case '3': | |
1455 | case '4': | |
1456 | case '5': | |
1457 | case '6': | |
1458 | case '7': | |
1459 | { | |
1460 | register int i = c - '0'; | |
1461 | register int count = 0; | |
1462 | while (++count < 3) | |
1463 | { | |
1464 | if ((c = *(*string_ptr)++) >= '0' && c <= '7') | |
1465 | { | |
1466 | i *= 8; | |
1467 | i += c - '0'; | |
1468 | } | |
1469 | else | |
1470 | { | |
1471 | (*string_ptr)--; | |
1472 | break; | |
1473 | } | |
1474 | } | |
1475 | return i; | |
1476 | } | |
1477 | default: | |
234b45d4 KB |
1478 | if (! host_char_to_target (c, &target_char)) |
1479 | error ("The escape sequence `\%c' is equivalent to plain `%c', which" | |
1480 | " has no equivalent\n" | |
1481 | "in the `%s' character set.", | |
1482 | c, c, target_charset ()); | |
1483 | return target_char; | |
c906108c SS |
1484 | } |
1485 | } | |
1486 | \f | |
1487 | /* Print the character C on STREAM as part of the contents of a literal | |
1488 | string whose delimiter is QUOTER. Note that this routine should only | |
1489 | be call for printing things which are independent of the language | |
1490 | of the program being debugged. */ | |
1491 | ||
43e526b9 | 1492 | static void |
74f832da KB |
1493 | printchar (int c, void (*do_fputs) (const char *, struct ui_file *), |
1494 | void (*do_fprintf) (struct ui_file *, const char *, ...), | |
1495 | struct ui_file *stream, int quoter) | |
c906108c SS |
1496 | { |
1497 | ||
1498 | c &= 0xFF; /* Avoid sign bit follies */ | |
1499 | ||
c5aa993b JM |
1500 | if (c < 0x20 || /* Low control chars */ |
1501 | (c >= 0x7F && c < 0xA0) || /* DEL, High controls */ | |
1502 | (sevenbit_strings && c >= 0x80)) | |
1503 | { /* high order bit set */ | |
1504 | switch (c) | |
1505 | { | |
1506 | case '\n': | |
43e526b9 | 1507 | do_fputs ("\\n", stream); |
c5aa993b JM |
1508 | break; |
1509 | case '\b': | |
43e526b9 | 1510 | do_fputs ("\\b", stream); |
c5aa993b JM |
1511 | break; |
1512 | case '\t': | |
43e526b9 | 1513 | do_fputs ("\\t", stream); |
c5aa993b JM |
1514 | break; |
1515 | case '\f': | |
43e526b9 | 1516 | do_fputs ("\\f", stream); |
c5aa993b JM |
1517 | break; |
1518 | case '\r': | |
43e526b9 | 1519 | do_fputs ("\\r", stream); |
c5aa993b JM |
1520 | break; |
1521 | case '\033': | |
43e526b9 | 1522 | do_fputs ("\\e", stream); |
c5aa993b JM |
1523 | break; |
1524 | case '\007': | |
43e526b9 | 1525 | do_fputs ("\\a", stream); |
c5aa993b JM |
1526 | break; |
1527 | default: | |
43e526b9 | 1528 | do_fprintf (stream, "\\%.3o", (unsigned int) c); |
c5aa993b JM |
1529 | break; |
1530 | } | |
1531 | } | |
1532 | else | |
1533 | { | |
1534 | if (c == '\\' || c == quoter) | |
43e526b9 JM |
1535 | do_fputs ("\\", stream); |
1536 | do_fprintf (stream, "%c", c); | |
c5aa993b | 1537 | } |
c906108c | 1538 | } |
43e526b9 JM |
1539 | |
1540 | /* Print the character C on STREAM as part of the contents of a | |
1541 | literal string whose delimiter is QUOTER. Note that these routines | |
1542 | should only be call for printing things which are independent of | |
1543 | the language of the program being debugged. */ | |
1544 | ||
1545 | void | |
fba45db2 | 1546 | fputstr_filtered (const char *str, int quoter, struct ui_file *stream) |
43e526b9 JM |
1547 | { |
1548 | while (*str) | |
1549 | printchar (*str++, fputs_filtered, fprintf_filtered, stream, quoter); | |
1550 | } | |
1551 | ||
1552 | void | |
fba45db2 | 1553 | fputstr_unfiltered (const char *str, int quoter, struct ui_file *stream) |
43e526b9 JM |
1554 | { |
1555 | while (*str) | |
1556 | printchar (*str++, fputs_unfiltered, fprintf_unfiltered, stream, quoter); | |
1557 | } | |
1558 | ||
1559 | void | |
fba45db2 | 1560 | fputstrn_unfiltered (const char *str, int n, int quoter, struct ui_file *stream) |
43e526b9 JM |
1561 | { |
1562 | int i; | |
1563 | for (i = 0; i < n; i++) | |
1564 | printchar (str[i], fputs_unfiltered, fprintf_unfiltered, stream, quoter); | |
1565 | } | |
1566 | ||
c906108c | 1567 | \f |
c5aa993b | 1568 | |
c906108c SS |
1569 | /* Number of lines per page or UINT_MAX if paging is disabled. */ |
1570 | static unsigned int lines_per_page; | |
cbfbd72a | 1571 | /* Number of chars per line or UINT_MAX if line folding is disabled. */ |
c906108c SS |
1572 | static unsigned int chars_per_line; |
1573 | /* Current count of lines printed on this page, chars on this line. */ | |
1574 | static unsigned int lines_printed, chars_printed; | |
1575 | ||
1576 | /* Buffer and start column of buffered text, for doing smarter word- | |
1577 | wrapping. When someone calls wrap_here(), we start buffering output | |
1578 | that comes through fputs_filtered(). If we see a newline, we just | |
1579 | spit it out and forget about the wrap_here(). If we see another | |
1580 | wrap_here(), we spit it out and remember the newer one. If we see | |
1581 | the end of the line, we spit out a newline, the indent, and then | |
1582 | the buffered output. */ | |
1583 | ||
1584 | /* Malloc'd buffer with chars_per_line+2 bytes. Contains characters which | |
1585 | are waiting to be output (they have already been counted in chars_printed). | |
1586 | When wrap_buffer[0] is null, the buffer is empty. */ | |
1587 | static char *wrap_buffer; | |
1588 | ||
1589 | /* Pointer in wrap_buffer to the next character to fill. */ | |
1590 | static char *wrap_pointer; | |
1591 | ||
1592 | /* String to indent by if the wrap occurs. Must not be NULL if wrap_column | |
1593 | is non-zero. */ | |
1594 | static char *wrap_indent; | |
1595 | ||
1596 | /* Column number on the screen where wrap_buffer begins, or 0 if wrapping | |
1597 | is not in effect. */ | |
1598 | static int wrap_column; | |
c906108c | 1599 | \f |
c5aa993b | 1600 | |
c906108c SS |
1601 | /* Inialize the lines and chars per page */ |
1602 | void | |
fba45db2 | 1603 | init_page_info (void) |
c906108c SS |
1604 | { |
1605 | #if defined(TUI) | |
5ecb1806 | 1606 | if (!tui_get_command_dimension (&chars_per_line, &lines_per_page)) |
c906108c SS |
1607 | #endif |
1608 | { | |
1609 | /* These defaults will be used if we are unable to get the correct | |
1610 | values from termcap. */ | |
1611 | #if defined(__GO32__) | |
c5aa993b JM |
1612 | lines_per_page = ScreenRows (); |
1613 | chars_per_line = ScreenCols (); | |
1614 | #else | |
c906108c SS |
1615 | lines_per_page = 24; |
1616 | chars_per_line = 80; | |
1617 | ||
d036b4d9 | 1618 | #if !defined (_WIN32) |
c906108c SS |
1619 | /* No termcap under MPW, although might be cool to do something |
1620 | by looking at worksheet or console window sizes. */ | |
1621 | /* Initialize the screen height and width from termcap. */ | |
1622 | { | |
c5aa993b | 1623 | char *termtype = getenv ("TERM"); |
c906108c | 1624 | |
c5aa993b JM |
1625 | /* Positive means success, nonpositive means failure. */ |
1626 | int status; | |
c906108c | 1627 | |
c5aa993b JM |
1628 | /* 2048 is large enough for all known terminals, according to the |
1629 | GNU termcap manual. */ | |
1630 | char term_buffer[2048]; | |
c906108c | 1631 | |
c5aa993b JM |
1632 | if (termtype) |
1633 | { | |
c906108c SS |
1634 | status = tgetent (term_buffer, termtype); |
1635 | if (status > 0) | |
1636 | { | |
c5aa993b | 1637 | int val; |
c906108c | 1638 | int running_in_emacs = getenv ("EMACS") != NULL; |
c5aa993b JM |
1639 | |
1640 | val = tgetnum ("li"); | |
1641 | if (val >= 0 && !running_in_emacs) | |
1642 | lines_per_page = val; | |
1643 | else | |
1644 | /* The number of lines per page is not mentioned | |
c906108c SS |
1645 | in the terminal description. This probably means |
1646 | that paging is not useful (e.g. emacs shell window), | |
1647 | so disable paging. */ | |
c5aa993b JM |
1648 | lines_per_page = UINT_MAX; |
1649 | ||
1650 | val = tgetnum ("co"); | |
1651 | if (val >= 0) | |
1652 | chars_per_line = val; | |
c906108c | 1653 | } |
c5aa993b | 1654 | } |
c906108c SS |
1655 | } |
1656 | #endif /* MPW */ | |
1657 | ||
1658 | #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER) | |
1659 | ||
1660 | /* If there is a better way to determine the window size, use it. */ | |
1661 | SIGWINCH_HANDLER (SIGWINCH); | |
1662 | #endif | |
1663 | #endif | |
1664 | /* If the output is not a terminal, don't paginate it. */ | |
d9fcf2fb | 1665 | if (!ui_file_isatty (gdb_stdout)) |
c5aa993b JM |
1666 | lines_per_page = UINT_MAX; |
1667 | } /* the command_line_version */ | |
1668 | set_width (); | |
c906108c SS |
1669 | } |
1670 | ||
1671 | static void | |
fba45db2 | 1672 | set_width (void) |
c906108c SS |
1673 | { |
1674 | if (chars_per_line == 0) | |
c5aa993b | 1675 | init_page_info (); |
c906108c SS |
1676 | |
1677 | if (!wrap_buffer) | |
1678 | { | |
1679 | wrap_buffer = (char *) xmalloc (chars_per_line + 2); | |
1680 | wrap_buffer[0] = '\0'; | |
1681 | } | |
1682 | else | |
1683 | wrap_buffer = (char *) xrealloc (wrap_buffer, chars_per_line + 2); | |
c5aa993b | 1684 | wrap_pointer = wrap_buffer; /* Start it at the beginning */ |
c906108c SS |
1685 | } |
1686 | ||
1687 | /* ARGSUSED */ | |
c5aa993b | 1688 | static void |
fba45db2 | 1689 | set_width_command (char *args, int from_tty, struct cmd_list_element *c) |
c906108c SS |
1690 | { |
1691 | set_width (); | |
1692 | } | |
1693 | ||
1694 | /* Wait, so the user can read what's on the screen. Prompt the user | |
1695 | to continue by pressing RETURN. */ | |
1696 | ||
1697 | static void | |
fba45db2 | 1698 | prompt_for_continue (void) |
c906108c SS |
1699 | { |
1700 | char *ignore; | |
1701 | char cont_prompt[120]; | |
1702 | ||
1703 | if (annotation_level > 1) | |
1704 | printf_unfiltered ("\n\032\032pre-prompt-for-continue\n"); | |
1705 | ||
1706 | strcpy (cont_prompt, | |
1707 | "---Type <return> to continue, or q <return> to quit---"); | |
1708 | if (annotation_level > 1) | |
1709 | strcat (cont_prompt, "\n\032\032prompt-for-continue\n"); | |
1710 | ||
1711 | /* We must do this *before* we call gdb_readline, else it will eventually | |
1712 | call us -- thinking that we're trying to print beyond the end of the | |
1713 | screen. */ | |
1714 | reinitialize_more_filter (); | |
1715 | ||
1716 | immediate_quit++; | |
1717 | /* On a real operating system, the user can quit with SIGINT. | |
1718 | But not on GO32. | |
1719 | ||
1720 | 'q' is provided on all systems so users don't have to change habits | |
1721 | from system to system, and because telling them what to do in | |
1722 | the prompt is more user-friendly than expecting them to think of | |
1723 | SIGINT. */ | |
1724 | /* Call readline, not gdb_readline, because GO32 readline handles control-C | |
1725 | whereas control-C to gdb_readline will cause the user to get dumped | |
1726 | out to DOS. */ | |
b4f5539f | 1727 | ignore = gdb_readline_wrapper (cont_prompt); |
c906108c SS |
1728 | |
1729 | if (annotation_level > 1) | |
1730 | printf_unfiltered ("\n\032\032post-prompt-for-continue\n"); | |
1731 | ||
1732 | if (ignore) | |
1733 | { | |
1734 | char *p = ignore; | |
1735 | while (*p == ' ' || *p == '\t') | |
1736 | ++p; | |
1737 | if (p[0] == 'q') | |
0f71a2f6 | 1738 | { |
6426a772 | 1739 | if (!event_loop_p) |
0f71a2f6 JM |
1740 | request_quit (SIGINT); |
1741 | else | |
c5aa993b | 1742 | async_request_quit (0); |
0f71a2f6 | 1743 | } |
b8c9b27d | 1744 | xfree (ignore); |
c906108c SS |
1745 | } |
1746 | immediate_quit--; | |
1747 | ||
1748 | /* Now we have to do this again, so that GDB will know that it doesn't | |
1749 | need to save the ---Type <return>--- line at the top of the screen. */ | |
1750 | reinitialize_more_filter (); | |
1751 | ||
1752 | dont_repeat (); /* Forget prev cmd -- CR won't repeat it. */ | |
1753 | } | |
1754 | ||
1755 | /* Reinitialize filter; ie. tell it to reset to original values. */ | |
1756 | ||
1757 | void | |
fba45db2 | 1758 | reinitialize_more_filter (void) |
c906108c SS |
1759 | { |
1760 | lines_printed = 0; | |
1761 | chars_printed = 0; | |
1762 | } | |
1763 | ||
1764 | /* Indicate that if the next sequence of characters overflows the line, | |
1765 | a newline should be inserted here rather than when it hits the end. | |
1766 | If INDENT is non-null, it is a string to be printed to indent the | |
1767 | wrapped part on the next line. INDENT must remain accessible until | |
1768 | the next call to wrap_here() or until a newline is printed through | |
1769 | fputs_filtered(). | |
1770 | ||
1771 | If the line is already overfull, we immediately print a newline and | |
1772 | the indentation, and disable further wrapping. | |
1773 | ||
1774 | If we don't know the width of lines, but we know the page height, | |
1775 | we must not wrap words, but should still keep track of newlines | |
1776 | that were explicitly printed. | |
1777 | ||
1778 | INDENT should not contain tabs, as that will mess up the char count | |
1779 | on the next line. FIXME. | |
1780 | ||
1781 | This routine is guaranteed to force out any output which has been | |
1782 | squirreled away in the wrap_buffer, so wrap_here ((char *)0) can be | |
1783 | used to force out output from the wrap_buffer. */ | |
1784 | ||
1785 | void | |
fba45db2 | 1786 | wrap_here (char *indent) |
c906108c SS |
1787 | { |
1788 | /* This should have been allocated, but be paranoid anyway. */ | |
1789 | if (!wrap_buffer) | |
e1e9e218 | 1790 | internal_error (__FILE__, __LINE__, "failed internal consistency check"); |
c906108c SS |
1791 | |
1792 | if (wrap_buffer[0]) | |
1793 | { | |
1794 | *wrap_pointer = '\0'; | |
1795 | fputs_unfiltered (wrap_buffer, gdb_stdout); | |
1796 | } | |
1797 | wrap_pointer = wrap_buffer; | |
1798 | wrap_buffer[0] = '\0'; | |
c5aa993b | 1799 | if (chars_per_line == UINT_MAX) /* No line overflow checking */ |
c906108c SS |
1800 | { |
1801 | wrap_column = 0; | |
1802 | } | |
1803 | else if (chars_printed >= chars_per_line) | |
1804 | { | |
1805 | puts_filtered ("\n"); | |
1806 | if (indent != NULL) | |
1807 | puts_filtered (indent); | |
1808 | wrap_column = 0; | |
1809 | } | |
1810 | else | |
1811 | { | |
1812 | wrap_column = chars_printed; | |
1813 | if (indent == NULL) | |
1814 | wrap_indent = ""; | |
1815 | else | |
1816 | wrap_indent = indent; | |
1817 | } | |
1818 | } | |
1819 | ||
4a351cef AF |
1820 | /* Print input string to gdb_stdout, filtered, with wrap, |
1821 | arranging strings in columns of n chars. String can be | |
1822 | right or left justified in the column. Never prints | |
1823 | trailing spaces. String should never be longer than | |
1824 | width. FIXME: this could be useful for the EXAMINE | |
1825 | command, which currently doesn't tabulate very well */ | |
1826 | ||
1827 | void | |
1828 | puts_filtered_tabular (char *string, int width, int right) | |
1829 | { | |
1830 | int spaces = 0; | |
1831 | int stringlen; | |
1832 | char *spacebuf; | |
1833 | ||
1834 | gdb_assert (chars_per_line > 0); | |
1835 | if (chars_per_line == UINT_MAX) | |
1836 | { | |
1837 | fputs_filtered (string, gdb_stdout); | |
1838 | fputs_filtered ("\n", gdb_stdout); | |
1839 | return; | |
1840 | } | |
1841 | ||
1842 | if (((chars_printed - 1) / width + 2) * width >= chars_per_line) | |
1843 | fputs_filtered ("\n", gdb_stdout); | |
1844 | ||
1845 | if (width >= chars_per_line) | |
1846 | width = chars_per_line - 1; | |
1847 | ||
1848 | stringlen = strlen (string); | |
1849 | ||
1850 | if (chars_printed > 0) | |
1851 | spaces = width - (chars_printed - 1) % width - 1; | |
1852 | if (right) | |
1853 | spaces += width - stringlen; | |
1854 | ||
1855 | spacebuf = alloca (spaces + 1); | |
1856 | spacebuf[spaces] = '\0'; | |
1857 | while (spaces--) | |
1858 | spacebuf[spaces] = ' '; | |
1859 | ||
1860 | fputs_filtered (spacebuf, gdb_stdout); | |
1861 | fputs_filtered (string, gdb_stdout); | |
1862 | } | |
1863 | ||
1864 | ||
c906108c SS |
1865 | /* Ensure that whatever gets printed next, using the filtered output |
1866 | commands, starts at the beginning of the line. I.E. if there is | |
1867 | any pending output for the current line, flush it and start a new | |
1868 | line. Otherwise do nothing. */ | |
1869 | ||
1870 | void | |
fba45db2 | 1871 | begin_line (void) |
c906108c SS |
1872 | { |
1873 | if (chars_printed > 0) | |
1874 | { | |
1875 | puts_filtered ("\n"); | |
1876 | } | |
1877 | } | |
1878 | ||
ac9a91a7 | 1879 | |
c906108c SS |
1880 | /* Like fputs but if FILTER is true, pause after every screenful. |
1881 | ||
1882 | Regardless of FILTER can wrap at points other than the final | |
1883 | character of a line. | |
1884 | ||
1885 | Unlike fputs, fputs_maybe_filtered does not return a value. | |
1886 | It is OK for LINEBUFFER to be NULL, in which case just don't print | |
1887 | anything. | |
1888 | ||
1889 | Note that a longjmp to top level may occur in this routine (only if | |
1890 | FILTER is true) (since prompt_for_continue may do so) so this | |
1891 | routine should not be called when cleanups are not in place. */ | |
1892 | ||
1893 | static void | |
fba45db2 KB |
1894 | fputs_maybe_filtered (const char *linebuffer, struct ui_file *stream, |
1895 | int filter) | |
c906108c SS |
1896 | { |
1897 | const char *lineptr; | |
1898 | ||
1899 | if (linebuffer == 0) | |
1900 | return; | |
1901 | ||
1902 | /* Don't do any filtering if it is disabled. */ | |
7a292a7a | 1903 | if ((stream != gdb_stdout) || !pagination_enabled |
c5aa993b | 1904 | || (lines_per_page == UINT_MAX && chars_per_line == UINT_MAX)) |
c906108c SS |
1905 | { |
1906 | fputs_unfiltered (linebuffer, stream); | |
1907 | return; | |
1908 | } | |
1909 | ||
1910 | /* Go through and output each character. Show line extension | |
1911 | when this is necessary; prompt user for new page when this is | |
1912 | necessary. */ | |
c5aa993b | 1913 | |
c906108c SS |
1914 | lineptr = linebuffer; |
1915 | while (*lineptr) | |
1916 | { | |
1917 | /* Possible new page. */ | |
1918 | if (filter && | |
1919 | (lines_printed >= lines_per_page - 1)) | |
1920 | prompt_for_continue (); | |
1921 | ||
1922 | while (*lineptr && *lineptr != '\n') | |
1923 | { | |
1924 | /* Print a single line. */ | |
1925 | if (*lineptr == '\t') | |
1926 | { | |
1927 | if (wrap_column) | |
1928 | *wrap_pointer++ = '\t'; | |
1929 | else | |
1930 | fputc_unfiltered ('\t', stream); | |
1931 | /* Shifting right by 3 produces the number of tab stops | |
1932 | we have already passed, and then adding one and | |
c5aa993b | 1933 | shifting left 3 advances to the next tab stop. */ |
c906108c SS |
1934 | chars_printed = ((chars_printed >> 3) + 1) << 3; |
1935 | lineptr++; | |
1936 | } | |
1937 | else | |
1938 | { | |
1939 | if (wrap_column) | |
1940 | *wrap_pointer++ = *lineptr; | |
1941 | else | |
c5aa993b | 1942 | fputc_unfiltered (*lineptr, stream); |
c906108c SS |
1943 | chars_printed++; |
1944 | lineptr++; | |
1945 | } | |
c5aa993b | 1946 | |
c906108c SS |
1947 | if (chars_printed >= chars_per_line) |
1948 | { | |
1949 | unsigned int save_chars = chars_printed; | |
1950 | ||
1951 | chars_printed = 0; | |
1952 | lines_printed++; | |
1953 | /* If we aren't actually wrapping, don't output newline -- | |
c5aa993b JM |
1954 | if chars_per_line is right, we probably just overflowed |
1955 | anyway; if it's wrong, let us keep going. */ | |
c906108c SS |
1956 | if (wrap_column) |
1957 | fputc_unfiltered ('\n', stream); | |
1958 | ||
1959 | /* Possible new page. */ | |
1960 | if (lines_printed >= lines_per_page - 1) | |
1961 | prompt_for_continue (); | |
1962 | ||
1963 | /* Now output indentation and wrapped string */ | |
1964 | if (wrap_column) | |
1965 | { | |
1966 | fputs_unfiltered (wrap_indent, stream); | |
c5aa993b JM |
1967 | *wrap_pointer = '\0'; /* Null-terminate saved stuff */ |
1968 | fputs_unfiltered (wrap_buffer, stream); /* and eject it */ | |
c906108c SS |
1969 | /* FIXME, this strlen is what prevents wrap_indent from |
1970 | containing tabs. However, if we recurse to print it | |
1971 | and count its chars, we risk trouble if wrap_indent is | |
1972 | longer than (the user settable) chars_per_line. | |
1973 | Note also that this can set chars_printed > chars_per_line | |
1974 | if we are printing a long string. */ | |
1975 | chars_printed = strlen (wrap_indent) | |
c5aa993b | 1976 | + (save_chars - wrap_column); |
c906108c SS |
1977 | wrap_pointer = wrap_buffer; /* Reset buffer */ |
1978 | wrap_buffer[0] = '\0'; | |
c5aa993b JM |
1979 | wrap_column = 0; /* And disable fancy wrap */ |
1980 | } | |
c906108c SS |
1981 | } |
1982 | } | |
1983 | ||
1984 | if (*lineptr == '\n') | |
1985 | { | |
1986 | chars_printed = 0; | |
c5aa993b | 1987 | wrap_here ((char *) 0); /* Spit out chars, cancel further wraps */ |
c906108c SS |
1988 | lines_printed++; |
1989 | fputc_unfiltered ('\n', stream); | |
1990 | lineptr++; | |
1991 | } | |
1992 | } | |
1993 | } | |
1994 | ||
1995 | void | |
fba45db2 | 1996 | fputs_filtered (const char *linebuffer, struct ui_file *stream) |
c906108c SS |
1997 | { |
1998 | fputs_maybe_filtered (linebuffer, stream, 1); | |
1999 | } | |
2000 | ||
2001 | int | |
fba45db2 | 2002 | putchar_unfiltered (int c) |
c906108c | 2003 | { |
11cf8741 | 2004 | char buf = c; |
d9fcf2fb | 2005 | ui_file_write (gdb_stdout, &buf, 1); |
c906108c SS |
2006 | return c; |
2007 | } | |
2008 | ||
d1f4cff8 AC |
2009 | /* Write character C to gdb_stdout using GDB's paging mechanism and return C. |
2010 | May return nonlocally. */ | |
2011 | ||
2012 | int | |
2013 | putchar_filtered (int c) | |
2014 | { | |
2015 | return fputc_filtered (c, gdb_stdout); | |
2016 | } | |
2017 | ||
c906108c | 2018 | int |
fba45db2 | 2019 | fputc_unfiltered (int c, struct ui_file *stream) |
c906108c | 2020 | { |
11cf8741 | 2021 | char buf = c; |
d9fcf2fb | 2022 | ui_file_write (stream, &buf, 1); |
c906108c SS |
2023 | return c; |
2024 | } | |
2025 | ||
2026 | int | |
fba45db2 | 2027 | fputc_filtered (int c, struct ui_file *stream) |
c906108c SS |
2028 | { |
2029 | char buf[2]; | |
2030 | ||
2031 | buf[0] = c; | |
2032 | buf[1] = 0; | |
2033 | fputs_filtered (buf, stream); | |
2034 | return c; | |
2035 | } | |
2036 | ||
2037 | /* puts_debug is like fputs_unfiltered, except it prints special | |
2038 | characters in printable fashion. */ | |
2039 | ||
2040 | void | |
fba45db2 | 2041 | puts_debug (char *prefix, char *string, char *suffix) |
c906108c SS |
2042 | { |
2043 | int ch; | |
2044 | ||
2045 | /* Print prefix and suffix after each line. */ | |
2046 | static int new_line = 1; | |
2047 | static int return_p = 0; | |
2048 | static char *prev_prefix = ""; | |
2049 | static char *prev_suffix = ""; | |
2050 | ||
2051 | if (*string == '\n') | |
2052 | return_p = 0; | |
2053 | ||
2054 | /* If the prefix is changing, print the previous suffix, a new line, | |
2055 | and the new prefix. */ | |
c5aa993b | 2056 | if ((return_p || (strcmp (prev_prefix, prefix) != 0)) && !new_line) |
c906108c | 2057 | { |
9846de1b JM |
2058 | fputs_unfiltered (prev_suffix, gdb_stdlog); |
2059 | fputs_unfiltered ("\n", gdb_stdlog); | |
2060 | fputs_unfiltered (prefix, gdb_stdlog); | |
c906108c SS |
2061 | } |
2062 | ||
2063 | /* Print prefix if we printed a newline during the previous call. */ | |
2064 | if (new_line) | |
2065 | { | |
2066 | new_line = 0; | |
9846de1b | 2067 | fputs_unfiltered (prefix, gdb_stdlog); |
c906108c SS |
2068 | } |
2069 | ||
2070 | prev_prefix = prefix; | |
2071 | prev_suffix = suffix; | |
2072 | ||
2073 | /* Output characters in a printable format. */ | |
2074 | while ((ch = *string++) != '\0') | |
2075 | { | |
2076 | switch (ch) | |
c5aa993b | 2077 | { |
c906108c SS |
2078 | default: |
2079 | if (isprint (ch)) | |
9846de1b | 2080 | fputc_unfiltered (ch, gdb_stdlog); |
c906108c SS |
2081 | |
2082 | else | |
9846de1b | 2083 | fprintf_unfiltered (gdb_stdlog, "\\x%02x", ch & 0xff); |
c906108c SS |
2084 | break; |
2085 | ||
c5aa993b JM |
2086 | case '\\': |
2087 | fputs_unfiltered ("\\\\", gdb_stdlog); | |
2088 | break; | |
2089 | case '\b': | |
2090 | fputs_unfiltered ("\\b", gdb_stdlog); | |
2091 | break; | |
2092 | case '\f': | |
2093 | fputs_unfiltered ("\\f", gdb_stdlog); | |
2094 | break; | |
2095 | case '\n': | |
2096 | new_line = 1; | |
2097 | fputs_unfiltered ("\\n", gdb_stdlog); | |
2098 | break; | |
2099 | case '\r': | |
2100 | fputs_unfiltered ("\\r", gdb_stdlog); | |
2101 | break; | |
2102 | case '\t': | |
2103 | fputs_unfiltered ("\\t", gdb_stdlog); | |
2104 | break; | |
2105 | case '\v': | |
2106 | fputs_unfiltered ("\\v", gdb_stdlog); | |
2107 | break; | |
2108 | } | |
c906108c SS |
2109 | |
2110 | return_p = ch == '\r'; | |
2111 | } | |
2112 | ||
2113 | /* Print suffix if we printed a newline. */ | |
2114 | if (new_line) | |
2115 | { | |
9846de1b JM |
2116 | fputs_unfiltered (suffix, gdb_stdlog); |
2117 | fputs_unfiltered ("\n", gdb_stdlog); | |
c906108c SS |
2118 | } |
2119 | } | |
2120 | ||
2121 | ||
2122 | /* Print a variable number of ARGS using format FORMAT. If this | |
2123 | information is going to put the amount written (since the last call | |
2124 | to REINITIALIZE_MORE_FILTER or the last page break) over the page size, | |
2125 | call prompt_for_continue to get the users permision to continue. | |
2126 | ||
2127 | Unlike fprintf, this function does not return a value. | |
2128 | ||
2129 | We implement three variants, vfprintf (takes a vararg list and stream), | |
2130 | fprintf (takes a stream to write on), and printf (the usual). | |
2131 | ||
2132 | Note also that a longjmp to top level may occur in this routine | |
2133 | (since prompt_for_continue may do so) so this routine should not be | |
2134 | called when cleanups are not in place. */ | |
2135 | ||
2136 | static void | |
fba45db2 KB |
2137 | vfprintf_maybe_filtered (struct ui_file *stream, const char *format, |
2138 | va_list args, int filter) | |
c906108c SS |
2139 | { |
2140 | char *linebuffer; | |
2141 | struct cleanup *old_cleanups; | |
2142 | ||
76995688 | 2143 | xvasprintf (&linebuffer, format, args); |
b8c9b27d | 2144 | old_cleanups = make_cleanup (xfree, linebuffer); |
c906108c SS |
2145 | fputs_maybe_filtered (linebuffer, stream, filter); |
2146 | do_cleanups (old_cleanups); | |
2147 | } | |
2148 | ||
2149 | ||
2150 | void | |
fba45db2 | 2151 | vfprintf_filtered (struct ui_file *stream, const char *format, va_list args) |
c906108c SS |
2152 | { |
2153 | vfprintf_maybe_filtered (stream, format, args, 1); | |
2154 | } | |
2155 | ||
2156 | void | |
fba45db2 | 2157 | vfprintf_unfiltered (struct ui_file *stream, const char *format, va_list args) |
c906108c SS |
2158 | { |
2159 | char *linebuffer; | |
2160 | struct cleanup *old_cleanups; | |
2161 | ||
76995688 | 2162 | xvasprintf (&linebuffer, format, args); |
b8c9b27d | 2163 | old_cleanups = make_cleanup (xfree, linebuffer); |
c906108c SS |
2164 | fputs_unfiltered (linebuffer, stream); |
2165 | do_cleanups (old_cleanups); | |
2166 | } | |
2167 | ||
2168 | void | |
fba45db2 | 2169 | vprintf_filtered (const char *format, va_list args) |
c906108c SS |
2170 | { |
2171 | vfprintf_maybe_filtered (gdb_stdout, format, args, 1); | |
2172 | } | |
2173 | ||
2174 | void | |
fba45db2 | 2175 | vprintf_unfiltered (const char *format, va_list args) |
c906108c SS |
2176 | { |
2177 | vfprintf_unfiltered (gdb_stdout, format, args); | |
2178 | } | |
2179 | ||
c906108c | 2180 | void |
d9fcf2fb | 2181 | fprintf_filtered (struct ui_file * stream, const char *format,...) |
c906108c SS |
2182 | { |
2183 | va_list args; | |
c906108c | 2184 | va_start (args, format); |
c906108c SS |
2185 | vfprintf_filtered (stream, format, args); |
2186 | va_end (args); | |
2187 | } | |
2188 | ||
c906108c | 2189 | void |
d9fcf2fb | 2190 | fprintf_unfiltered (struct ui_file * stream, const char *format,...) |
c906108c SS |
2191 | { |
2192 | va_list args; | |
c906108c | 2193 | va_start (args, format); |
c906108c SS |
2194 | vfprintf_unfiltered (stream, format, args); |
2195 | va_end (args); | |
2196 | } | |
2197 | ||
2198 | /* Like fprintf_filtered, but prints its result indented. | |
2199 | Called as fprintfi_filtered (spaces, stream, format, ...); */ | |
2200 | ||
c906108c | 2201 | void |
d9fcf2fb | 2202 | fprintfi_filtered (int spaces, struct ui_file * stream, const char *format,...) |
c906108c SS |
2203 | { |
2204 | va_list args; | |
c906108c | 2205 | va_start (args, format); |
c906108c SS |
2206 | print_spaces_filtered (spaces, stream); |
2207 | ||
2208 | vfprintf_filtered (stream, format, args); | |
2209 | va_end (args); | |
2210 | } | |
2211 | ||
2212 | ||
c906108c | 2213 | void |
c5aa993b | 2214 | printf_filtered (const char *format,...) |
c906108c SS |
2215 | { |
2216 | va_list args; | |
c906108c | 2217 | va_start (args, format); |
c906108c SS |
2218 | vfprintf_filtered (gdb_stdout, format, args); |
2219 | va_end (args); | |
2220 | } | |
2221 | ||
2222 | ||
c906108c | 2223 | void |
c5aa993b | 2224 | printf_unfiltered (const char *format,...) |
c906108c SS |
2225 | { |
2226 | va_list args; | |
c906108c | 2227 | va_start (args, format); |
c906108c SS |
2228 | vfprintf_unfiltered (gdb_stdout, format, args); |
2229 | va_end (args); | |
2230 | } | |
2231 | ||
2232 | /* Like printf_filtered, but prints it's result indented. | |
2233 | Called as printfi_filtered (spaces, format, ...); */ | |
2234 | ||
c906108c | 2235 | void |
c5aa993b | 2236 | printfi_filtered (int spaces, const char *format,...) |
c906108c SS |
2237 | { |
2238 | va_list args; | |
c906108c | 2239 | va_start (args, format); |
c906108c SS |
2240 | print_spaces_filtered (spaces, gdb_stdout); |
2241 | vfprintf_filtered (gdb_stdout, format, args); | |
2242 | va_end (args); | |
2243 | } | |
2244 | ||
2245 | /* Easy -- but watch out! | |
2246 | ||
2247 | This routine is *not* a replacement for puts()! puts() appends a newline. | |
2248 | This one doesn't, and had better not! */ | |
2249 | ||
2250 | void | |
fba45db2 | 2251 | puts_filtered (const char *string) |
c906108c SS |
2252 | { |
2253 | fputs_filtered (string, gdb_stdout); | |
2254 | } | |
2255 | ||
2256 | void | |
fba45db2 | 2257 | puts_unfiltered (const char *string) |
c906108c SS |
2258 | { |
2259 | fputs_unfiltered (string, gdb_stdout); | |
2260 | } | |
2261 | ||
2262 | /* Return a pointer to N spaces and a null. The pointer is good | |
2263 | until the next call to here. */ | |
2264 | char * | |
fba45db2 | 2265 | n_spaces (int n) |
c906108c | 2266 | { |
392a587b JM |
2267 | char *t; |
2268 | static char *spaces = 0; | |
2269 | static int max_spaces = -1; | |
c906108c SS |
2270 | |
2271 | if (n > max_spaces) | |
2272 | { | |
2273 | if (spaces) | |
b8c9b27d | 2274 | xfree (spaces); |
c5aa993b JM |
2275 | spaces = (char *) xmalloc (n + 1); |
2276 | for (t = spaces + n; t != spaces;) | |
c906108c SS |
2277 | *--t = ' '; |
2278 | spaces[n] = '\0'; | |
2279 | max_spaces = n; | |
2280 | } | |
2281 | ||
2282 | return spaces + max_spaces - n; | |
2283 | } | |
2284 | ||
2285 | /* Print N spaces. */ | |
2286 | void | |
fba45db2 | 2287 | print_spaces_filtered (int n, struct ui_file *stream) |
c906108c SS |
2288 | { |
2289 | fputs_filtered (n_spaces (n), stream); | |
2290 | } | |
2291 | \f | |
4a351cef | 2292 | /* C++/ObjC demangler stuff. */ |
c906108c | 2293 | |
389e51db AC |
2294 | /* fprintf_symbol_filtered attempts to demangle NAME, a symbol in language |
2295 | LANG, using demangling args ARG_MODE, and print it filtered to STREAM. | |
2296 | If the name is not mangled, or the language for the name is unknown, or | |
2297 | demangling is off, the name is printed in its "raw" form. */ | |
c906108c SS |
2298 | |
2299 | void | |
389e51db | 2300 | fprintf_symbol_filtered (struct ui_file *stream, char *name, enum language lang, |
fba45db2 | 2301 | int arg_mode) |
c906108c SS |
2302 | { |
2303 | char *demangled; | |
2304 | ||
2305 | if (name != NULL) | |
2306 | { | |
2307 | /* If user wants to see raw output, no problem. */ | |
2308 | if (!demangle) | |
2309 | { | |
2310 | fputs_filtered (name, stream); | |
2311 | } | |
2312 | else | |
2313 | { | |
2314 | switch (lang) | |
2315 | { | |
2316 | case language_cplus: | |
2317 | demangled = cplus_demangle (name, arg_mode); | |
2318 | break; | |
2319 | case language_java: | |
2320 | demangled = cplus_demangle (name, arg_mode | DMGL_JAVA); | |
2321 | break; | |
4a351cef AF |
2322 | case language_objc: |
2323 | /* Commented out until ObjC handling is enabled. */ | |
2324 | /*demangled = objc_demangle (name);*/ | |
2325 | /*break;*/ | |
db034ac5 AC |
2326 | #if 0 |
2327 | /* OBSOLETE case language_chill: */ | |
2328 | /* OBSOLETE demangled = chill_demangle (name); */ | |
2329 | /* OBSOLETE break; */ | |
2330 | #endif | |
c906108c SS |
2331 | default: |
2332 | demangled = NULL; | |
2333 | break; | |
2334 | } | |
2335 | fputs_filtered (demangled ? demangled : name, stream); | |
2336 | if (demangled != NULL) | |
2337 | { | |
b8c9b27d | 2338 | xfree (demangled); |
c906108c SS |
2339 | } |
2340 | } | |
2341 | } | |
2342 | } | |
2343 | ||
2344 | /* Do a strcmp() type operation on STRING1 and STRING2, ignoring any | |
2345 | differences in whitespace. Returns 0 if they match, non-zero if they | |
2346 | don't (slightly different than strcmp()'s range of return values). | |
c5aa993b | 2347 | |
c906108c SS |
2348 | As an extra hack, string1=="FOO(ARGS)" matches string2=="FOO". |
2349 | This "feature" is useful when searching for matching C++ function names | |
2350 | (such as if the user types 'break FOO', where FOO is a mangled C++ | |
2351 | function). */ | |
2352 | ||
2353 | int | |
fba45db2 | 2354 | strcmp_iw (const char *string1, const char *string2) |
c906108c SS |
2355 | { |
2356 | while ((*string1 != '\0') && (*string2 != '\0')) | |
2357 | { | |
2358 | while (isspace (*string1)) | |
2359 | { | |
2360 | string1++; | |
2361 | } | |
2362 | while (isspace (*string2)) | |
2363 | { | |
2364 | string2++; | |
2365 | } | |
2366 | if (*string1 != *string2) | |
2367 | { | |
2368 | break; | |
2369 | } | |
2370 | if (*string1 != '\0') | |
2371 | { | |
2372 | string1++; | |
2373 | string2++; | |
2374 | } | |
2375 | } | |
2376 | return (*string1 != '\0' && *string1 != '(') || (*string2 != '\0'); | |
2377 | } | |
c906108c | 2378 | \f |
c5aa993b | 2379 | |
c906108c | 2380 | /* |
c5aa993b JM |
2381 | ** subset_compare() |
2382 | ** Answer whether string_to_compare is a full or partial match to | |
2383 | ** template_string. The partial match must be in sequence starting | |
2384 | ** at index 0. | |
2385 | */ | |
c906108c | 2386 | int |
fba45db2 | 2387 | subset_compare (char *string_to_compare, char *template_string) |
7a292a7a SS |
2388 | { |
2389 | int match; | |
c5aa993b JM |
2390 | if (template_string != (char *) NULL && string_to_compare != (char *) NULL && |
2391 | strlen (string_to_compare) <= strlen (template_string)) | |
2392 | match = (strncmp (template_string, | |
2393 | string_to_compare, | |
2394 | strlen (string_to_compare)) == 0); | |
7a292a7a SS |
2395 | else |
2396 | match = 0; | |
2397 | return match; | |
2398 | } | |
c906108c SS |
2399 | |
2400 | ||
a14ed312 | 2401 | static void pagination_on_command (char *arg, int from_tty); |
7a292a7a | 2402 | static void |
fba45db2 | 2403 | pagination_on_command (char *arg, int from_tty) |
c906108c SS |
2404 | { |
2405 | pagination_enabled = 1; | |
2406 | } | |
2407 | ||
a14ed312 | 2408 | static void pagination_on_command (char *arg, int from_tty); |
7a292a7a | 2409 | static void |
fba45db2 | 2410 | pagination_off_command (char *arg, int from_tty) |
c906108c SS |
2411 | { |
2412 | pagination_enabled = 0; | |
2413 | } | |
c906108c | 2414 | \f |
c5aa993b | 2415 | |
c906108c | 2416 | void |
fba45db2 | 2417 | initialize_utils (void) |
c906108c SS |
2418 | { |
2419 | struct cmd_list_element *c; | |
2420 | ||
c5aa993b JM |
2421 | c = add_set_cmd ("width", class_support, var_uinteger, |
2422 | (char *) &chars_per_line, | |
2423 | "Set number of characters gdb thinks are in a line.", | |
2424 | &setlist); | |
c906108c | 2425 | add_show_from_set (c, &showlist); |
9f60d481 | 2426 | set_cmd_sfunc (c, set_width_command); |
c906108c SS |
2427 | |
2428 | add_show_from_set | |
2429 | (add_set_cmd ("height", class_support, | |
c5aa993b | 2430 | var_uinteger, (char *) &lines_per_page, |
c906108c SS |
2431 | "Set number of lines gdb thinks are in a page.", &setlist), |
2432 | &showlist); | |
c5aa993b | 2433 | |
c906108c SS |
2434 | init_page_info (); |
2435 | ||
2436 | /* If the output is not a terminal, don't paginate it. */ | |
d9fcf2fb | 2437 | if (!ui_file_isatty (gdb_stdout)) |
c906108c SS |
2438 | lines_per_page = UINT_MAX; |
2439 | ||
c5aa993b | 2440 | set_width_command ((char *) NULL, 0, c); |
c906108c SS |
2441 | |
2442 | add_show_from_set | |
c5aa993b JM |
2443 | (add_set_cmd ("demangle", class_support, var_boolean, |
2444 | (char *) &demangle, | |
4a351cef | 2445 | "Set demangling of encoded C++/ObjC names when displaying symbols.", |
c906108c SS |
2446 | &setprintlist), |
2447 | &showprintlist); | |
2448 | ||
2449 | add_show_from_set | |
2450 | (add_set_cmd ("pagination", class_support, | |
c5aa993b | 2451 | var_boolean, (char *) &pagination_enabled, |
c906108c SS |
2452 | "Set state of pagination.", &setlist), |
2453 | &showlist); | |
4261bedc | 2454 | |
c906108c SS |
2455 | if (xdb_commands) |
2456 | { | |
c5aa993b JM |
2457 | add_com ("am", class_support, pagination_on_command, |
2458 | "Enable pagination"); | |
2459 | add_com ("sm", class_support, pagination_off_command, | |
2460 | "Disable pagination"); | |
c906108c SS |
2461 | } |
2462 | ||
2463 | add_show_from_set | |
c5aa993b JM |
2464 | (add_set_cmd ("sevenbit-strings", class_support, var_boolean, |
2465 | (char *) &sevenbit_strings, | |
2466 | "Set printing of 8-bit characters in strings as \\nnn.", | |
c906108c SS |
2467 | &setprintlist), |
2468 | &showprintlist); | |
2469 | ||
2470 | add_show_from_set | |
c5aa993b JM |
2471 | (add_set_cmd ("asm-demangle", class_support, var_boolean, |
2472 | (char *) &asm_demangle, | |
4a351cef | 2473 | "Set demangling of C++/ObjC names in disassembly listings.", |
c906108c SS |
2474 | &setprintlist), |
2475 | &showprintlist); | |
2476 | } | |
2477 | ||
2478 | /* Machine specific function to handle SIGWINCH signal. */ | |
2479 | ||
2480 | #ifdef SIGWINCH_HANDLER_BODY | |
c5aa993b | 2481 | SIGWINCH_HANDLER_BODY |
c906108c | 2482 | #endif |
39424bef | 2483 | |
5683e87a AC |
2484 | /* print routines to handle variable size regs, etc. */ |
2485 | ||
c906108c SS |
2486 | /* temporary storage using circular buffer */ |
2487 | #define NUMCELLS 16 | |
2488 | #define CELLSIZE 32 | |
c5aa993b | 2489 | static char * |
fba45db2 | 2490 | get_cell (void) |
c906108c SS |
2491 | { |
2492 | static char buf[NUMCELLS][CELLSIZE]; | |
c5aa993b JM |
2493 | static int cell = 0; |
2494 | if (++cell >= NUMCELLS) | |
2495 | cell = 0; | |
c906108c SS |
2496 | return buf[cell]; |
2497 | } | |
2498 | ||
d4f3574e SS |
2499 | int |
2500 | strlen_paddr (void) | |
2501 | { | |
79496e2f | 2502 | return (TARGET_ADDR_BIT / 8 * 2); |
d4f3574e SS |
2503 | } |
2504 | ||
c5aa993b | 2505 | char * |
104c1213 | 2506 | paddr (CORE_ADDR addr) |
c906108c | 2507 | { |
79496e2f | 2508 | return phex (addr, TARGET_ADDR_BIT / 8); |
c906108c SS |
2509 | } |
2510 | ||
c5aa993b | 2511 | char * |
104c1213 | 2512 | paddr_nz (CORE_ADDR addr) |
c906108c | 2513 | { |
79496e2f | 2514 | return phex_nz (addr, TARGET_ADDR_BIT / 8); |
c906108c SS |
2515 | } |
2516 | ||
104c1213 JM |
2517 | static void |
2518 | decimal2str (char *paddr_str, char *sign, ULONGEST addr) | |
2519 | { | |
2520 | /* steal code from valprint.c:print_decimal(). Should this worry | |
2521 | about the real size of addr as the above does? */ | |
2522 | unsigned long temp[3]; | |
2523 | int i = 0; | |
2524 | do | |
2525 | { | |
2526 | temp[i] = addr % (1000 * 1000 * 1000); | |
2527 | addr /= (1000 * 1000 * 1000); | |
2528 | i++; | |
2529 | } | |
2530 | while (addr != 0 && i < (sizeof (temp) / sizeof (temp[0]))); | |
2531 | switch (i) | |
2532 | { | |
2533 | case 1: | |
2534 | sprintf (paddr_str, "%s%lu", | |
2535 | sign, temp[0]); | |
2536 | break; | |
2537 | case 2: | |
2538 | sprintf (paddr_str, "%s%lu%09lu", | |
2539 | sign, temp[1], temp[0]); | |
2540 | break; | |
2541 | case 3: | |
2542 | sprintf (paddr_str, "%s%lu%09lu%09lu", | |
2543 | sign, temp[2], temp[1], temp[0]); | |
2544 | break; | |
2545 | default: | |
e1e9e218 | 2546 | internal_error (__FILE__, __LINE__, "failed internal consistency check"); |
104c1213 JM |
2547 | } |
2548 | } | |
2549 | ||
2550 | char * | |
2551 | paddr_u (CORE_ADDR addr) | |
2552 | { | |
2553 | char *paddr_str = get_cell (); | |
2554 | decimal2str (paddr_str, "", addr); | |
2555 | return paddr_str; | |
2556 | } | |
2557 | ||
2558 | char * | |
2559 | paddr_d (LONGEST addr) | |
2560 | { | |
2561 | char *paddr_str = get_cell (); | |
2562 | if (addr < 0) | |
2563 | decimal2str (paddr_str, "-", -addr); | |
2564 | else | |
2565 | decimal2str (paddr_str, "", addr); | |
2566 | return paddr_str; | |
2567 | } | |
2568 | ||
5683e87a AC |
2569 | /* eliminate warning from compiler on 32-bit systems */ |
2570 | static int thirty_two = 32; | |
2571 | ||
104c1213 | 2572 | char * |
5683e87a | 2573 | phex (ULONGEST l, int sizeof_l) |
104c1213 | 2574 | { |
45a1e866 | 2575 | char *str; |
5683e87a | 2576 | switch (sizeof_l) |
104c1213 JM |
2577 | { |
2578 | case 8: | |
45a1e866 | 2579 | str = get_cell (); |
5683e87a AC |
2580 | sprintf (str, "%08lx%08lx", |
2581 | (unsigned long) (l >> thirty_two), | |
2582 | (unsigned long) (l & 0xffffffff)); | |
104c1213 JM |
2583 | break; |
2584 | case 4: | |
45a1e866 | 2585 | str = get_cell (); |
5683e87a | 2586 | sprintf (str, "%08lx", (unsigned long) l); |
104c1213 JM |
2587 | break; |
2588 | case 2: | |
45a1e866 | 2589 | str = get_cell (); |
5683e87a | 2590 | sprintf (str, "%04x", (unsigned short) (l & 0xffff)); |
104c1213 JM |
2591 | break; |
2592 | default: | |
45a1e866 | 2593 | str = phex (l, sizeof (l)); |
5683e87a | 2594 | break; |
104c1213 | 2595 | } |
5683e87a | 2596 | return str; |
104c1213 JM |
2597 | } |
2598 | ||
c5aa993b | 2599 | char * |
5683e87a | 2600 | phex_nz (ULONGEST l, int sizeof_l) |
c906108c | 2601 | { |
faf833ca | 2602 | char *str; |
5683e87a | 2603 | switch (sizeof_l) |
c906108c | 2604 | { |
c5aa993b JM |
2605 | case 8: |
2606 | { | |
5683e87a | 2607 | unsigned long high = (unsigned long) (l >> thirty_two); |
faf833ca | 2608 | str = get_cell (); |
c5aa993b | 2609 | if (high == 0) |
5683e87a | 2610 | sprintf (str, "%lx", (unsigned long) (l & 0xffffffff)); |
c5aa993b | 2611 | else |
5683e87a AC |
2612 | sprintf (str, "%lx%08lx", |
2613 | high, (unsigned long) (l & 0xffffffff)); | |
c906108c | 2614 | break; |
c5aa993b JM |
2615 | } |
2616 | case 4: | |
faf833ca | 2617 | str = get_cell (); |
5683e87a | 2618 | sprintf (str, "%lx", (unsigned long) l); |
c5aa993b JM |
2619 | break; |
2620 | case 2: | |
faf833ca | 2621 | str = get_cell (); |
5683e87a | 2622 | sprintf (str, "%x", (unsigned short) (l & 0xffff)); |
c5aa993b JM |
2623 | break; |
2624 | default: | |
faf833ca | 2625 | str = phex_nz (l, sizeof (l)); |
5683e87a | 2626 | break; |
c906108c | 2627 | } |
5683e87a | 2628 | return str; |
c906108c | 2629 | } |
ac2e2ef7 AC |
2630 | |
2631 | ||
2632 | /* Convert to / from the hosts pointer to GDB's internal CORE_ADDR | |
2633 | using the target's conversion routines. */ | |
2634 | CORE_ADDR | |
2635 | host_pointer_to_address (void *ptr) | |
2636 | { | |
c6caf090 | 2637 | gdb_assert (sizeof (ptr) == TYPE_LENGTH (builtin_type_void_data_ptr)); |
090a2205 | 2638 | return POINTER_TO_ADDRESS (builtin_type_void_data_ptr, &ptr); |
ac2e2ef7 AC |
2639 | } |
2640 | ||
2641 | void * | |
2642 | address_to_host_pointer (CORE_ADDR addr) | |
2643 | { | |
2644 | void *ptr; | |
c6caf090 KB |
2645 | |
2646 | gdb_assert (sizeof (ptr) == TYPE_LENGTH (builtin_type_void_data_ptr)); | |
090a2205 | 2647 | ADDRESS_TO_POINTER (builtin_type_void_data_ptr, &ptr, addr); |
ac2e2ef7 AC |
2648 | return ptr; |
2649 | } | |
03dd37c3 AC |
2650 | |
2651 | /* Convert a CORE_ADDR into a string. */ | |
2652 | const char * | |
2653 | core_addr_to_string (const CORE_ADDR addr) | |
49b563f9 KS |
2654 | { |
2655 | char *str = get_cell (); | |
2656 | strcpy (str, "0x"); | |
2657 | strcat (str, phex (addr, sizeof (addr))); | |
2658 | return str; | |
2659 | } | |
2660 | ||
2661 | const char * | |
2662 | core_addr_to_string_nz (const CORE_ADDR addr) | |
03dd37c3 AC |
2663 | { |
2664 | char *str = get_cell (); | |
2665 | strcpy (str, "0x"); | |
2666 | strcat (str, phex_nz (addr, sizeof (addr))); | |
2667 | return str; | |
2668 | } | |
2669 | ||
2670 | /* Convert a string back into a CORE_ADDR. */ | |
2671 | CORE_ADDR | |
2672 | string_to_core_addr (const char *my_string) | |
2673 | { | |
2674 | CORE_ADDR addr = 0; | |
2675 | if (my_string[0] == '0' && tolower (my_string[1]) == 'x') | |
2676 | { | |
2677 | /* Assume that it is in decimal. */ | |
2678 | int i; | |
2679 | for (i = 2; my_string[i] != '\0'; i++) | |
2680 | { | |
2681 | if (isdigit (my_string[i])) | |
2682 | addr = (my_string[i] - '0') + (addr * 16); | |
2683 | else if (isxdigit (my_string[i])) | |
2684 | addr = (tolower (my_string[i]) - 'a' + 0xa) + (addr * 16); | |
2685 | else | |
2686 | internal_error (__FILE__, __LINE__, "invalid hex"); | |
2687 | } | |
2688 | } | |
2689 | else | |
2690 | { | |
2691 | /* Assume that it is in decimal. */ | |
2692 | int i; | |
2693 | for (i = 0; my_string[i] != '\0'; i++) | |
2694 | { | |
2695 | if (isdigit (my_string[i])) | |
2696 | addr = (my_string[i] - '0') + (addr * 10); | |
2697 | else | |
2698 | internal_error (__FILE__, __LINE__, "invalid decimal"); | |
2699 | } | |
2700 | } | |
d5dc7960 MH |
2701 | if (INTEGER_TO_ADDRESS_P ()) |
2702 | addr = INTEGER_TO_ADDRESS (builtin_type_void_data_ptr, &addr); | |
03dd37c3 AC |
2703 | return addr; |
2704 | } | |
58d370e0 TT |
2705 | |
2706 | char * | |
2707 | gdb_realpath (const char *filename) | |
2708 | { | |
a4db0f07 RH |
2709 | #if defined(HAVE_REALPATH) |
2710 | # if defined (PATH_MAX) | |
58d370e0 | 2711 | char buf[PATH_MAX]; |
a4db0f07 RH |
2712 | # define USE_REALPATH |
2713 | # elif defined (MAXPATHLEN) | |
2d1b2124 | 2714 | char buf[MAXPATHLEN]; |
a4db0f07 RH |
2715 | # define USE_REALPATH |
2716 | # elif defined (HAVE_UNISTD_H) && defined(HAVE_ALLOCA) | |
b84911e8 | 2717 | char *buf = alloca ((size_t)pathconf ("/", _PC_PATH_MAX)); |
a4db0f07 RH |
2718 | # define USE_REALPATH |
2719 | # endif | |
2720 | #endif /* HAVE_REALPATH */ | |
2721 | ||
2722 | #if defined(USE_REALPATH) | |
58d370e0 TT |
2723 | char *rp = realpath (filename, buf); |
2724 | return xstrdup (rp ? rp : filename); | |
a4db0f07 | 2725 | #elif defined(HAVE_CANONICALIZE_FILE_NAME) |
520f6ade AC |
2726 | char *rp = canonicalize_file_name (filename); |
2727 | if (rp == NULL) | |
2728 | return xstrdup (filename); | |
2729 | else | |
2730 | return rp; | |
58d370e0 TT |
2731 | #else |
2732 | return xstrdup (filename); | |
2733 | #endif | |
2734 | } | |
303c8ebd JB |
2735 | |
2736 | /* Return a copy of FILENAME, with its directory prefix canonicalized | |
2737 | by gdb_realpath. */ | |
2738 | ||
2739 | char * | |
2740 | xfullpath (const char *filename) | |
2741 | { | |
2742 | const char *base_name = lbasename (filename); | |
2743 | char *dir_name; | |
2744 | char *real_path; | |
2745 | char *result; | |
2746 | ||
2747 | /* Extract the basename of filename, and return immediately | |
2748 | a copy of filename if it does not contain any directory prefix. */ | |
2749 | if (base_name == filename) | |
2750 | return xstrdup (filename); | |
2751 | ||
2752 | dir_name = alloca ((size_t) (base_name - filename + 2)); | |
2753 | /* Allocate enough space to store the dir_name + plus one extra | |
2754 | character sometimes needed under Windows (see below), and | |
2755 | then the closing \000 character */ | |
2756 | strncpy (dir_name, filename, base_name - filename); | |
2757 | dir_name[base_name - filename] = '\000'; | |
2758 | ||
2759 | #ifdef HAVE_DOS_BASED_FILE_SYSTEM | |
2760 | /* We need to be careful when filename is of the form 'd:foo', which | |
2761 | is equivalent of d:./foo, which is totally different from d:/foo. */ | |
2762 | if (strlen (dir_name) == 2 && | |
2763 | isalpha (dir_name[0]) && dir_name[1] == ':') | |
2764 | { | |
2765 | dir_name[2] = '.'; | |
2766 | dir_name[3] = '\000'; | |
2767 | } | |
2768 | #endif | |
2769 | ||
2770 | /* Canonicalize the directory prefix, and build the resulting | |
2771 | filename. If the dirname realpath already contains an ending | |
2772 | directory separator, avoid doubling it. */ | |
2773 | real_path = gdb_realpath (dir_name); | |
2774 | if (IS_DIR_SEPARATOR (real_path[strlen (real_path) - 1])) | |
2775 | result = concat (real_path, base_name, NULL); | |
2776 | else | |
2777 | result = concat (real_path, SLASH_STRING, base_name, NULL); | |
2778 | ||
2779 | xfree (real_path); | |
2780 | return result; | |
2781 | } |