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