1 /* General utility routines for GDB, the GNU debugger.
2 Copyright 1986, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
3 1997, 1998, 1999, 2000, 2001
4 Free Software Foundation, Inc.
6 This file is part of GDB.
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.
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.
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. */
24 #include "gdb_assert.h"
26 #include "gdb_string.h"
27 #include "event-top.h"
40 /* SunOS's curses.h has a '#define reg register' in it. Thank you Sun. */
51 #include "expression.h"
55 #include "inferior.h" /* for signed_pointer_to_address */
57 #include <readline/readline.h>
59 #ifndef MALLOC_INCOMPATIBLE
60 #ifdef NEED_DECLARATION_MALLOC
63 #ifdef NEED_DECLARATION_REALLOC
64 extern PTR
realloc ();
66 #ifdef NEED_DECLARATION_FREE
72 #define XMALLOC(TYPE) ((TYPE*) xmalloc (sizeof (TYPE)))
74 /* readline defines this. */
77 void (*error_begin_hook
) (void);
79 /* Holds the last error message issued by gdb */
81 static struct ui_file
*gdb_lasterr
;
83 /* Prototypes for local functions */
85 static void vfprintf_maybe_filtered (struct ui_file
*, const char *,
88 static void fputs_maybe_filtered (const char *, struct ui_file
*, int);
90 #if defined (USE_MMALLOC) && !defined (NO_MMCHECK)
91 static void malloc_botch (void);
94 static void prompt_for_continue (void);
96 static void set_width_command (char *, int, struct cmd_list_element
*);
98 static void set_width (void);
100 /* Chain of cleanup actions established with make_cleanup,
101 to be executed if an error happens. */
103 static struct cleanup
*cleanup_chain
; /* cleaned up after a failed command */
104 static struct cleanup
*final_cleanup_chain
; /* cleaned up when gdb exits */
105 static struct cleanup
*run_cleanup_chain
; /* cleaned up on each 'run' */
106 static struct cleanup
*exec_cleanup_chain
; /* cleaned up on each execution command */
107 /* cleaned up on each error from within an execution command */
108 static struct cleanup
*exec_error_cleanup_chain
;
110 /* Pointer to what is left to do for an execution command after the
111 target stops. Used only in asynchronous mode, by targets that
112 support async execution. The finish and until commands use it. So
113 does the target extended-remote command. */
114 struct continuation
*cmd_continuation
;
115 struct continuation
*intermediate_continuation
;
117 /* Nonzero if we have job control. */
121 /* Nonzero means a quit has been requested. */
125 /* Nonzero means quit immediately if Control-C is typed now, rather
126 than waiting until QUIT is executed. Be careful in setting this;
127 code which executes with immediate_quit set has to be very careful
128 about being able to deal with being interrupted at any time. It is
129 almost always better to use QUIT; the only exception I can think of
130 is being able to quit out of a system call (using EINTR loses if
131 the SIGINT happens between the previous QUIT and the system call).
132 To immediately quit in the case in which a SIGINT happens between
133 the previous QUIT and setting immediate_quit (desirable anytime we
134 expect to block), call QUIT after setting immediate_quit. */
138 /* Nonzero means that encoded C++ names should be printed out in their
139 C++ form rather than raw. */
143 /* Nonzero means that encoded C++ names should be printed out in their
144 C++ form even in assembler language displays. If this is set, but
145 DEMANGLE is zero, names are printed raw, i.e. DEMANGLE controls. */
147 int asm_demangle
= 0;
149 /* Nonzero means that strings with character values >0x7F should be printed
150 as octal escapes. Zero means just print the value (e.g. it's an
151 international character, and the terminal or window can cope.) */
153 int sevenbit_strings
= 0;
155 /* String to be printed before error messages, if any. */
157 char *error_pre_print
;
159 /* String to be printed before quit messages, if any. */
161 char *quit_pre_print
;
163 /* String to be printed before warning messages, if any. */
165 char *warning_pre_print
= "\nwarning: ";
167 int pagination_enabled
= 1;
170 /* Add a new cleanup to the cleanup_chain,
171 and return the previous chain pointer
172 to be passed later to do_cleanups or discard_cleanups.
173 Args are FUNCTION to clean up with, and ARG to pass to it. */
176 make_cleanup (make_cleanup_ftype
*function
, void *arg
)
178 return make_my_cleanup (&cleanup_chain
, function
, arg
);
182 make_final_cleanup (make_cleanup_ftype
*function
, void *arg
)
184 return make_my_cleanup (&final_cleanup_chain
, function
, arg
);
188 make_run_cleanup (make_cleanup_ftype
*function
, void *arg
)
190 return make_my_cleanup (&run_cleanup_chain
, function
, arg
);
194 make_exec_cleanup (make_cleanup_ftype
*function
, void *arg
)
196 return make_my_cleanup (&exec_cleanup_chain
, function
, arg
);
200 make_exec_error_cleanup (make_cleanup_ftype
*function
, void *arg
)
202 return make_my_cleanup (&exec_error_cleanup_chain
, function
, arg
);
206 do_freeargv (void *arg
)
208 freeargv ((char **) arg
);
212 make_cleanup_freeargv (char **arg
)
214 return make_my_cleanup (&cleanup_chain
, do_freeargv
, arg
);
218 do_bfd_close_cleanup (void *arg
)
224 make_cleanup_bfd_close (bfd
*abfd
)
226 return make_cleanup (do_bfd_close_cleanup
, abfd
);
230 do_close_cleanup (void *arg
)
238 make_cleanup_close (int fd
)
240 int *saved_fd
= xmalloc (sizeof (fd
));
242 return make_cleanup (do_close_cleanup
, saved_fd
);
246 do_ui_file_delete (void *arg
)
248 ui_file_delete (arg
);
252 make_cleanup_ui_file_delete (struct ui_file
*arg
)
254 return make_my_cleanup (&cleanup_chain
, do_ui_file_delete
, arg
);
258 make_my_cleanup (struct cleanup
**pmy_chain
, make_cleanup_ftype
*function
,
261 register struct cleanup
*new
262 = (struct cleanup
*) xmalloc (sizeof (struct cleanup
));
263 register struct cleanup
*old_chain
= *pmy_chain
;
265 new->next
= *pmy_chain
;
266 new->function
= function
;
273 /* Discard cleanups and do the actions they describe
274 until we get back to the point OLD_CHAIN in the cleanup_chain. */
277 do_cleanups (register struct cleanup
*old_chain
)
279 do_my_cleanups (&cleanup_chain
, old_chain
);
283 do_final_cleanups (register struct cleanup
*old_chain
)
285 do_my_cleanups (&final_cleanup_chain
, old_chain
);
289 do_run_cleanups (register struct cleanup
*old_chain
)
291 do_my_cleanups (&run_cleanup_chain
, old_chain
);
295 do_exec_cleanups (register struct cleanup
*old_chain
)
297 do_my_cleanups (&exec_cleanup_chain
, old_chain
);
301 do_exec_error_cleanups (register struct cleanup
*old_chain
)
303 do_my_cleanups (&exec_error_cleanup_chain
, old_chain
);
307 do_my_cleanups (register struct cleanup
**pmy_chain
,
308 register struct cleanup
*old_chain
)
310 register struct cleanup
*ptr
;
311 while ((ptr
= *pmy_chain
) != old_chain
)
313 *pmy_chain
= ptr
->next
; /* Do this first incase recursion */
314 (*ptr
->function
) (ptr
->arg
);
319 /* Discard cleanups, not doing the actions they describe,
320 until we get back to the point OLD_CHAIN in the cleanup_chain. */
323 discard_cleanups (register struct cleanup
*old_chain
)
325 discard_my_cleanups (&cleanup_chain
, old_chain
);
329 discard_final_cleanups (register struct cleanup
*old_chain
)
331 discard_my_cleanups (&final_cleanup_chain
, old_chain
);
335 discard_exec_error_cleanups (register struct cleanup
*old_chain
)
337 discard_my_cleanups (&exec_error_cleanup_chain
, old_chain
);
341 discard_my_cleanups (register struct cleanup
**pmy_chain
,
342 register struct cleanup
*old_chain
)
344 register struct cleanup
*ptr
;
345 while ((ptr
= *pmy_chain
) != old_chain
)
347 *pmy_chain
= ptr
->next
;
352 /* Set the cleanup_chain to 0, and return the old cleanup chain. */
356 return save_my_cleanups (&cleanup_chain
);
360 save_final_cleanups (void)
362 return save_my_cleanups (&final_cleanup_chain
);
366 save_my_cleanups (struct cleanup
**pmy_chain
)
368 struct cleanup
*old_chain
= *pmy_chain
;
374 /* Restore the cleanup chain from a previously saved chain. */
376 restore_cleanups (struct cleanup
*chain
)
378 restore_my_cleanups (&cleanup_chain
, chain
);
382 restore_final_cleanups (struct cleanup
*chain
)
384 restore_my_cleanups (&final_cleanup_chain
, chain
);
388 restore_my_cleanups (struct cleanup
**pmy_chain
, struct cleanup
*chain
)
393 /* This function is useful for cleanups.
397 old_chain = make_cleanup (free_current_contents, &foo);
399 to arrange to free the object thus allocated. */
402 free_current_contents (void *ptr
)
404 void **location
= ptr
;
405 if (location
== NULL
)
406 internal_error (__FILE__
, __LINE__
,
407 "free_current_contents: NULL pointer");
408 if (*location
!= NULL
)
415 /* Provide a known function that does nothing, to use as a base for
416 for a possibly long chain of cleanups. This is useful where we
417 use the cleanup chain for handling normal cleanups as well as dealing
418 with cleanups that need to be done as a result of a call to error().
419 In such cases, we may not be certain where the first cleanup is, unless
420 we have a do-nothing one to always use as the base. */
424 null_cleanup (void *arg
)
428 /* Add a continuation to the continuation list, the global list
429 cmd_continuation. The new continuation will be added at the front.*/
431 add_continuation (void (*continuation_hook
) (struct continuation_arg
*),
432 struct continuation_arg
*arg_list
)
434 struct continuation
*continuation_ptr
;
436 continuation_ptr
= (struct continuation
*) xmalloc (sizeof (struct continuation
));
437 continuation_ptr
->continuation_hook
= continuation_hook
;
438 continuation_ptr
->arg_list
= arg_list
;
439 continuation_ptr
->next
= cmd_continuation
;
440 cmd_continuation
= continuation_ptr
;
443 /* Walk down the cmd_continuation list, and execute all the
444 continuations. There is a problem though. In some cases new
445 continuations may be added while we are in the middle of this
446 loop. If this happens they will be added in the front, and done
447 before we have a chance of exhausting those that were already
448 there. We need to then save the beginning of the list in a pointer
449 and do the continuations from there on, instead of using the
450 global beginning of list as our iteration pointer.*/
452 do_all_continuations (void)
454 struct continuation
*continuation_ptr
;
455 struct continuation
*saved_continuation
;
457 /* Copy the list header into another pointer, and set the global
458 list header to null, so that the global list can change as a side
459 effect of invoking the continuations and the processing of
460 the preexisting continuations will not be affected. */
461 continuation_ptr
= cmd_continuation
;
462 cmd_continuation
= NULL
;
464 /* Work now on the list we have set aside. */
465 while (continuation_ptr
)
467 (continuation_ptr
->continuation_hook
) (continuation_ptr
->arg_list
);
468 saved_continuation
= continuation_ptr
;
469 continuation_ptr
= continuation_ptr
->next
;
470 xfree (saved_continuation
);
474 /* Walk down the cmd_continuation list, and get rid of all the
477 discard_all_continuations (void)
479 struct continuation
*continuation_ptr
;
481 while (cmd_continuation
)
483 continuation_ptr
= cmd_continuation
;
484 cmd_continuation
= continuation_ptr
->next
;
485 xfree (continuation_ptr
);
489 /* Add a continuation to the continuation list, the global list
490 intermediate_continuation. The new continuation will be added at the front.*/
492 add_intermediate_continuation (void (*continuation_hook
)
493 (struct continuation_arg
*),
494 struct continuation_arg
*arg_list
)
496 struct continuation
*continuation_ptr
;
498 continuation_ptr
= (struct continuation
*) xmalloc (sizeof (struct continuation
));
499 continuation_ptr
->continuation_hook
= continuation_hook
;
500 continuation_ptr
->arg_list
= arg_list
;
501 continuation_ptr
->next
= intermediate_continuation
;
502 intermediate_continuation
= continuation_ptr
;
505 /* Walk down the cmd_continuation list, and execute all the
506 continuations. There is a problem though. In some cases new
507 continuations may be added while we are in the middle of this
508 loop. If this happens they will be added in the front, and done
509 before we have a chance of exhausting those that were already
510 there. We need to then save the beginning of the list in a pointer
511 and do the continuations from there on, instead of using the
512 global beginning of list as our iteration pointer.*/
514 do_all_intermediate_continuations (void)
516 struct continuation
*continuation_ptr
;
517 struct continuation
*saved_continuation
;
519 /* Copy the list header into another pointer, and set the global
520 list header to null, so that the global list can change as a side
521 effect of invoking the continuations and the processing of
522 the preexisting continuations will not be affected. */
523 continuation_ptr
= intermediate_continuation
;
524 intermediate_continuation
= NULL
;
526 /* Work now on the list we have set aside. */
527 while (continuation_ptr
)
529 (continuation_ptr
->continuation_hook
) (continuation_ptr
->arg_list
);
530 saved_continuation
= continuation_ptr
;
531 continuation_ptr
= continuation_ptr
->next
;
532 xfree (saved_continuation
);
536 /* Walk down the cmd_continuation list, and get rid of all the
539 discard_all_intermediate_continuations (void)
541 struct continuation
*continuation_ptr
;
543 while (intermediate_continuation
)
545 continuation_ptr
= intermediate_continuation
;
546 intermediate_continuation
= continuation_ptr
->next
;
547 xfree (continuation_ptr
);
553 /* Print a warning message. Way to use this is to call warning_begin,
554 output the warning message (use unfiltered output to gdb_stderr),
555 ending in a newline. There is not currently a warning_end that you
556 call afterwards, but such a thing might be added if it is useful
557 for a GUI to separate warning messages from other output.
559 FIXME: Why do warnings use unfiltered output and errors filtered?
560 Is this anything other than a historical accident? */
565 target_terminal_ours ();
566 wrap_here (""); /* Force out any buffered output */
567 gdb_flush (gdb_stdout
);
568 if (warning_pre_print
)
569 fprintf_unfiltered (gdb_stderr
, warning_pre_print
);
572 /* Print a warning message.
573 The first argument STRING is the warning message, used as a fprintf string,
574 and the remaining args are passed as arguments to it.
575 The primary difference between warnings and errors is that a warning
576 does not force the return to command level. */
579 warning (const char *string
,...)
582 va_start (args
, string
);
584 (*warning_hook
) (string
, args
);
588 vfprintf_unfiltered (gdb_stderr
, string
, args
);
589 fprintf_unfiltered (gdb_stderr
, "\n");
594 /* Start the printing of an error message. Way to use this is to call
595 this, output the error message (use filtered output to gdb_stderr
596 (FIXME: Some callers, like memory_error, use gdb_stdout)), ending
597 in a newline, and then call return_to_top_level (RETURN_ERROR).
598 error() provides a convenient way to do this for the special case
599 that the error message can be formatted with a single printf call,
600 but this is more general. */
604 if (error_begin_hook
)
607 target_terminal_ours ();
608 wrap_here (""); /* Force out any buffered output */
609 gdb_flush (gdb_stdout
);
611 annotate_error_begin ();
614 fprintf_filtered (gdb_stderr
, error_pre_print
);
617 /* Print an error message and return to command level.
618 The first argument STRING is the error message, used as a fprintf string,
619 and the remaining args are passed as arguments to it. */
622 verror (const char *string
, va_list args
)
625 struct cleanup
*err_string_cleanup
;
626 /* FIXME: cagney/1999-11-10: All error calls should come here.
627 Unfortunately some code uses the sequence: error_begin(); print
628 error message; return_to_top_level. That code should be
631 /* NOTE: It's tempting to just do the following...
632 vfprintf_filtered (gdb_stderr, string, args);
633 and then follow with a similar looking statement to cause the message
634 to also go to gdb_lasterr. But if we do this, we'll be traversing the
635 va_list twice which works on some platforms and fails miserably on
637 /* Save it as the last error */
638 ui_file_rewind (gdb_lasterr
);
639 vfprintf_filtered (gdb_lasterr
, string
, args
);
640 /* Retrieve the last error and print it to gdb_stderr */
641 err_string
= error_last_message ();
642 err_string_cleanup
= make_cleanup (xfree
, err_string
);
643 fputs_filtered (err_string
, gdb_stderr
);
644 fprintf_filtered (gdb_stderr
, "\n");
645 do_cleanups (err_string_cleanup
);
646 return_to_top_level (RETURN_ERROR
);
650 error (const char *string
,...)
653 va_start (args
, string
);
654 verror (string
, args
);
659 error_stream (struct ui_file
*stream
)
662 char *msg
= ui_file_xstrdup (stream
, &size
);
663 make_cleanup (xfree
, msg
);
667 /* Get the last error message issued by gdb */
670 error_last_message (void)
673 return ui_file_xstrdup (gdb_lasterr
, &len
);
676 /* This is to be called by main() at the very beginning */
681 gdb_lasterr
= mem_fileopen ();
684 /* Print a message reporting an internal error. Ask the user if they
685 want to continue, dump core, or just exit. */
688 internal_verror (const char *file
, int line
,
689 const char *fmt
, va_list ap
)
691 static char msg
[] = "Internal GDB error: recursive internal error.\n";
692 static int dejavu
= 0;
696 /* don't allow infinite error recursion. */
704 fputs_unfiltered (msg
, gdb_stderr
);
705 internal_error (__FILE__
, __LINE__
, "failed internal consistency check");
708 write (STDERR_FILENO
, msg
, sizeof (msg
));
712 /* Try to get the message out */
713 target_terminal_ours ();
714 fprintf_unfiltered (gdb_stderr
, "%s:%d: gdb-internal-error: ", file
, line
);
715 vfprintf_unfiltered (gdb_stderr
, fmt
, ap
);
716 fputs_unfiltered ("\n", gdb_stderr
);
718 /* Default (no case) is to quit GDB. When in batch mode this
719 lessens the likelhood of GDB going into an infinate loop. */
720 continue_p
= query ("\
721 An internal GDB error was detected. This may make further\n\
722 debugging unreliable. Continue this debugging session? ");
724 /* Default (no case) is to not dump core. Lessen the chance of GDB
725 leaving random core files around. */
726 dump_core_p
= query ("\
727 Create a core file containing the current state of GDB? ");
734 internal_error (__FILE__
, __LINE__
, "failed internal consistency check");
740 internal_error (__FILE__
, __LINE__
, "failed internal consistency check");
746 return_to_top_level (RETURN_ERROR
);
750 internal_error (const char *file
, int line
, const char *string
, ...)
753 va_start (ap
, string
);
755 internal_verror (file
, line
, string
, ap
);
759 /* The strerror() function can return NULL for errno values that are
760 out of range. Provide a "safe" version that always returns a
764 safe_strerror (int errnum
)
769 if ((msg
= strerror (errnum
)) == NULL
)
771 sprintf (buf
, "(undocumented errno %d)", errnum
);
777 /* Print the system error message for errno, and also mention STRING
778 as the file name for which the error was encountered.
779 Then return to command level. */
782 perror_with_name (char *string
)
787 err
= safe_strerror (errno
);
788 combined
= (char *) alloca (strlen (err
) + strlen (string
) + 3);
789 strcpy (combined
, string
);
790 strcat (combined
, ": ");
791 strcat (combined
, err
);
793 /* I understand setting these is a matter of taste. Still, some people
794 may clear errno but not know about bfd_error. Doing this here is not
796 bfd_set_error (bfd_error_no_error
);
799 error ("%s.", combined
);
802 /* Print the system error message for ERRCODE, and also mention STRING
803 as the file name for which the error was encountered. */
806 print_sys_errmsg (char *string
, int errcode
)
811 err
= safe_strerror (errcode
);
812 combined
= (char *) alloca (strlen (err
) + strlen (string
) + 3);
813 strcpy (combined
, string
);
814 strcat (combined
, ": ");
815 strcat (combined
, err
);
817 /* We want anything which was printed on stdout to come out first, before
819 gdb_flush (gdb_stdout
);
820 fprintf_unfiltered (gdb_stderr
, "%s.\n", combined
);
823 /* Control C eventually causes this to be called, at a convenient time. */
828 struct serial
*gdb_stdout_serial
= serial_fdopen (1);
830 target_terminal_ours ();
832 /* We want all output to appear now, before we print "Quit". We
833 have 3 levels of buffering we have to flush (it's possible that
834 some of these should be changed to flush the lower-level ones
837 /* 1. The _filtered buffer. */
838 wrap_here ((char *) 0);
840 /* 2. The stdio buffer. */
841 gdb_flush (gdb_stdout
);
842 gdb_flush (gdb_stderr
);
844 /* 3. The system-level buffer. */
845 serial_drain_output (gdb_stdout_serial
);
846 serial_un_fdopen (gdb_stdout_serial
);
848 annotate_error_begin ();
850 /* Don't use *_filtered; we don't want to prompt the user to continue. */
852 fprintf_unfiltered (gdb_stderr
, quit_pre_print
);
855 /* No steenking SIGINT will ever be coming our way when the
856 program is resumed. Don't lie. */
857 fprintf_unfiltered (gdb_stderr
, "Quit\n");
860 /* If there is no terminal switching for this target, then we can't
861 possibly get screwed by the lack of job control. */
862 || current_target
.to_terminal_ours
== NULL
)
863 fprintf_unfiltered (gdb_stderr
, "Quit\n");
865 fprintf_unfiltered (gdb_stderr
,
866 "Quit (expect signal SIGINT when the program is resumed)\n");
868 return_to_top_level (RETURN_QUIT
);
871 /* Control C comes here */
873 request_quit (int signo
)
876 /* Restore the signal handler. Harmless with BSD-style signals, needed
877 for System V-style signals. So just always do it, rather than worrying
878 about USG defines and stuff like that. */
879 signal (signo
, request_quit
);
889 /* Memory management stuff (malloc friends). */
891 #if !defined (USE_MMALLOC)
893 /* NOTE: These must use PTR so that their definition matches the
894 declaration found in "mmalloc.h". */
897 mmalloc (PTR md
, size_t size
)
899 return malloc (size
); /* NOTE: GDB's only call to malloc() */
903 mrealloc (PTR md
, PTR ptr
, size_t size
)
905 if (ptr
== 0) /* Guard against old realloc's */
906 return mmalloc (md
, size
);
908 return realloc (ptr
, size
); /* NOTE: GDB's only call to ralloc() */
912 mcalloc (PTR md
, size_t number
, size_t size
)
914 return calloc (number
, size
); /* NOTE: GDB's only call to calloc() */
918 mfree (PTR md
, PTR ptr
)
920 free (ptr
); /* NOTE: GDB's only call to free() */
923 #endif /* USE_MMALLOC */
925 #if !defined (USE_MMALLOC) || defined (NO_MMCHECK)
928 init_malloc (void *md
)
932 #else /* Have mmalloc and want corruption checking */
937 fprintf_unfiltered (gdb_stderr
, "Memory corruption\n");
938 internal_error (__FILE__
, __LINE__
, "failed internal consistency check");
941 /* Attempt to install hooks in mmalloc/mrealloc/mfree for the heap specified
942 by MD, to detect memory corruption. Note that MD may be NULL to specify
943 the default heap that grows via sbrk.
945 Note that for freshly created regions, we must call mmcheckf prior to any
946 mallocs in the region. Otherwise, any region which was allocated prior to
947 installing the checking hooks, which is later reallocated or freed, will
948 fail the checks! The mmcheck function only allows initial hooks to be
949 installed before the first mmalloc. However, anytime after we have called
950 mmcheck the first time to install the checking hooks, we can call it again
951 to update the function pointer to the memory corruption handler.
953 Returns zero on failure, non-zero on success. */
955 #ifndef MMCHECK_FORCE
956 #define MMCHECK_FORCE 0
960 init_malloc (void *md
)
962 if (!mmcheckf (md
, malloc_botch
, MMCHECK_FORCE
))
964 /* Don't use warning(), which relies on current_target being set
965 to something other than dummy_target, until after
966 initialize_all_files(). */
969 (gdb_stderr
, "warning: failed to install memory consistency checks; ");
971 (gdb_stderr
, "configuration should define NO_MMCHECK or MMCHECK_FORCE\n");
977 #endif /* Have mmalloc and want corruption checking */
979 /* Called when a memory allocation fails, with the number of bytes of
980 memory requested in SIZE. */
987 internal_error (__FILE__
, __LINE__
,
988 "virtual memory exhausted: can't allocate %ld bytes.", size
);
992 internal_error (__FILE__
, __LINE__
,
993 "virtual memory exhausted.");
997 /* The xmmalloc() family of memory management routines.
999 These are are like the mmalloc() family except that they implement
1000 consistent semantics and guard against typical memory management
1001 problems: if a malloc fails, an internal error is thrown; if
1002 free(NULL) is called, it is ignored; if *alloc(0) is called, NULL
1005 All these routines are implemented using the mmalloc() family. */
1008 xmmalloc (void *md
, size_t size
)
1018 val
= mmalloc (md
, size
);
1026 xmrealloc (void *md
, void *ptr
, size_t size
)
1040 val
= mrealloc (md
, ptr
, size
);
1044 val
= mmalloc (md
, size
);
1055 xmcalloc (void *md
, size_t number
, size_t size
)
1058 if (number
== 0 || size
== 0)
1062 mem
= mcalloc (md
, number
, size
);
1064 nomem (number
* size
);
1070 xmfree (void *md
, void *ptr
)
1076 /* The xmalloc() (libiberty.h) family of memory management routines.
1078 These are like the ISO-C malloc() family except that they implement
1079 consistent semantics and guard against typical memory management
1080 problems. See xmmalloc() above for further information.
1082 All these routines are wrappers to the xmmalloc() family. */
1084 /* NOTE: These are declared using PTR to ensure consistency with
1085 "libiberty.h". xfree() is GDB local. */
1088 xmalloc (size_t size
)
1090 return xmmalloc (NULL
, size
);
1094 xrealloc (PTR ptr
, size_t size
)
1096 return xmrealloc (NULL
, ptr
, size
);
1100 xcalloc (size_t number
, size_t size
)
1102 return xmcalloc (NULL
, number
, size
);
1112 /* Like asprintf/vasprintf but get an internal_error if the call
1116 xasprintf (char **ret
, const char *format
, ...)
1119 va_start (args
, format
);
1120 xvasprintf (ret
, format
, args
);
1125 xvasprintf (char **ret
, const char *format
, va_list ap
)
1127 int status
= vasprintf (ret
, format
, ap
);
1128 /* NULL could be returned due to a memory allocation problem; a
1129 badly format string; or something else. */
1131 internal_error (__FILE__
, __LINE__
,
1132 "vasprintf returned NULL buffer (errno %d)",
1134 /* A negative status with a non-NULL buffer shouldn't never
1135 happen. But to be sure. */
1137 internal_error (__FILE__
, __LINE__
,
1138 "vasprintf call failed (errno %d)",
1143 /* My replacement for the read system call.
1144 Used like `read' but keeps going if `read' returns too soon. */
1147 myread (int desc
, char *addr
, int len
)
1154 val
= read (desc
, addr
, len
);
1158 return orglen
- len
;
1165 /* Make a copy of the string at PTR with SIZE characters
1166 (and add a null character at the end in the copy).
1167 Uses malloc to get the space. Returns the address of the copy. */
1170 savestring (const char *ptr
, size_t size
)
1172 register char *p
= (char *) xmalloc (size
+ 1);
1173 memcpy (p
, ptr
, size
);
1179 msavestring (void *md
, const char *ptr
, size_t size
)
1181 register char *p
= (char *) xmmalloc (md
, size
+ 1);
1182 memcpy (p
, ptr
, size
);
1188 mstrsave (void *md
, const char *ptr
)
1190 return (msavestring (md
, ptr
, strlen (ptr
)));
1194 print_spaces (register int n
, register struct ui_file
*file
)
1196 fputs_unfiltered (n_spaces (n
), file
);
1199 /* Print a host address. */
1202 gdb_print_host_address (void *addr
, struct ui_file
*stream
)
1205 /* We could use the %p conversion specifier to fprintf if we had any
1206 way of knowing whether this host supports it. But the following
1207 should work on the Alpha and on 32 bit machines. */
1209 fprintf_filtered (stream
, "0x%lx", (unsigned long) addr
);
1212 /* Ask user a y-or-n question and return 1 iff answer is yes.
1213 Takes three args which are given to printf to print the question.
1214 The first, a control string, should end in "? ".
1215 It should not say how to answer, because we do that. */
1219 query (char *ctlstr
,...)
1222 register int answer
;
1226 va_start (args
, ctlstr
);
1230 return query_hook (ctlstr
, args
);
1233 /* Automatically answer "yes" if input is not from a terminal. */
1234 if (!input_from_terminal_p ())
1236 /* OBSOLETE #ifdef MPW */
1237 /* OBSOLETE *//* FIXME Automatically answer "yes" if called from MacGDB. */
1238 /* OBSOLETE if (mac_app) */
1239 /* OBSOLETE return 1; */
1240 /* OBSOLETE #endif *//* MPW */
1244 wrap_here (""); /* Flush any buffered output */
1245 gdb_flush (gdb_stdout
);
1247 if (annotation_level
> 1)
1248 printf_filtered ("\n\032\032pre-query\n");
1250 vfprintf_filtered (gdb_stdout
, ctlstr
, args
);
1251 printf_filtered ("(y or n) ");
1253 if (annotation_level
> 1)
1254 printf_filtered ("\n\032\032query\n");
1256 /* OBSOLETE #ifdef MPW */
1257 /* OBSOLETE *//* If not in MacGDB, move to a new line so the entered line doesn't */
1258 /* OBSOLETE have a prompt on the front of it. */
1259 /* OBSOLETE if (!mac_app) */
1260 /* OBSOLETE fputs_unfiltered ("\n", gdb_stdout); */
1261 /* OBSOLETE #endif *//* MPW */
1264 gdb_flush (gdb_stdout
);
1266 answer
= fgetc (stdin
);
1267 clearerr (stdin
); /* in case of C-d */
1268 if (answer
== EOF
) /* C-d */
1273 /* Eat rest of input line, to EOF or newline */
1277 ans2
= fgetc (stdin
);
1280 while (ans2
!= EOF
&& ans2
!= '\n' && ans2
!= '\r');
1294 printf_filtered ("Please answer y or n.\n");
1297 if (annotation_level
> 1)
1298 printf_filtered ("\n\032\032post-query\n");
1303 /* Parse a C escape sequence. STRING_PTR points to a variable
1304 containing a pointer to the string to parse. That pointer
1305 should point to the character after the \. That pointer
1306 is updated past the characters we use. The value of the
1307 escape sequence is returned.
1309 A negative value means the sequence \ newline was seen,
1310 which is supposed to be equivalent to nothing at all.
1312 If \ is followed by a null character, we return a negative
1313 value and leave the string pointer pointing at the null character.
1315 If \ is followed by 000, we return 0 and leave the string pointer
1316 after the zeros. A value of 0 does not mean end of string. */
1319 parse_escape (char **string_ptr
)
1321 register int c
= *(*string_ptr
)++;
1325 return 007; /* Bell (alert) char */
1328 case 'e': /* Escape character */
1346 c
= *(*string_ptr
)++;
1348 c
= parse_escape (string_ptr
);
1351 return (c
& 0200) | (c
& 037);
1362 register int i
= c
- '0';
1363 register int count
= 0;
1366 if ((c
= *(*string_ptr
)++) >= '0' && c
<= '7')
1384 /* Print the character C on STREAM as part of the contents of a literal
1385 string whose delimiter is QUOTER. Note that this routine should only
1386 be call for printing things which are independent of the language
1387 of the program being debugged. */
1390 printchar (int c
, void (*do_fputs
) (const char *, struct ui_file
*),
1391 void (*do_fprintf
) (struct ui_file
*, const char *, ...),
1392 struct ui_file
*stream
, int quoter
)
1395 c
&= 0xFF; /* Avoid sign bit follies */
1397 if (c
< 0x20 || /* Low control chars */
1398 (c
>= 0x7F && c
< 0xA0) || /* DEL, High controls */
1399 (sevenbit_strings
&& c
>= 0x80))
1400 { /* high order bit set */
1404 do_fputs ("\\n", stream
);
1407 do_fputs ("\\b", stream
);
1410 do_fputs ("\\t", stream
);
1413 do_fputs ("\\f", stream
);
1416 do_fputs ("\\r", stream
);
1419 do_fputs ("\\e", stream
);
1422 do_fputs ("\\a", stream
);
1425 do_fprintf (stream
, "\\%.3o", (unsigned int) c
);
1431 if (c
== '\\' || c
== quoter
)
1432 do_fputs ("\\", stream
);
1433 do_fprintf (stream
, "%c", c
);
1437 /* Print the character C on STREAM as part of the contents of a
1438 literal string whose delimiter is QUOTER. Note that these routines
1439 should only be call for printing things which are independent of
1440 the language of the program being debugged. */
1443 fputstr_filtered (const char *str
, int quoter
, struct ui_file
*stream
)
1446 printchar (*str
++, fputs_filtered
, fprintf_filtered
, stream
, quoter
);
1450 fputstr_unfiltered (const char *str
, int quoter
, struct ui_file
*stream
)
1453 printchar (*str
++, fputs_unfiltered
, fprintf_unfiltered
, stream
, quoter
);
1457 fputstrn_unfiltered (const char *str
, int n
, int quoter
, struct ui_file
*stream
)
1460 for (i
= 0; i
< n
; i
++)
1461 printchar (str
[i
], fputs_unfiltered
, fprintf_unfiltered
, stream
, quoter
);
1466 /* Number of lines per page or UINT_MAX if paging is disabled. */
1467 static unsigned int lines_per_page
;
1468 /* Number of chars per line or UINT_MAX if line folding is disabled. */
1469 static unsigned int chars_per_line
;
1470 /* Current count of lines printed on this page, chars on this line. */
1471 static unsigned int lines_printed
, chars_printed
;
1473 /* Buffer and start column of buffered text, for doing smarter word-
1474 wrapping. When someone calls wrap_here(), we start buffering output
1475 that comes through fputs_filtered(). If we see a newline, we just
1476 spit it out and forget about the wrap_here(). If we see another
1477 wrap_here(), we spit it out and remember the newer one. If we see
1478 the end of the line, we spit out a newline, the indent, and then
1479 the buffered output. */
1481 /* Malloc'd buffer with chars_per_line+2 bytes. Contains characters which
1482 are waiting to be output (they have already been counted in chars_printed).
1483 When wrap_buffer[0] is null, the buffer is empty. */
1484 static char *wrap_buffer
;
1486 /* Pointer in wrap_buffer to the next character to fill. */
1487 static char *wrap_pointer
;
1489 /* String to indent by if the wrap occurs. Must not be NULL if wrap_column
1491 static char *wrap_indent
;
1493 /* Column number on the screen where wrap_buffer begins, or 0 if wrapping
1494 is not in effect. */
1495 static int wrap_column
;
1498 /* Inialize the lines and chars per page */
1500 init_page_info (void)
1503 if (!tui_get_command_dimension (&chars_per_line
, &lines_per_page
))
1506 /* These defaults will be used if we are unable to get the correct
1507 values from termcap. */
1508 #if defined(__GO32__)
1509 lines_per_page
= ScreenRows ();
1510 chars_per_line
= ScreenCols ();
1512 lines_per_page
= 24;
1513 chars_per_line
= 80;
1515 #if !defined (_WIN32)
1516 /* No termcap under MPW, although might be cool to do something
1517 by looking at worksheet or console window sizes. */
1518 /* Initialize the screen height and width from termcap. */
1520 char *termtype
= getenv ("TERM");
1522 /* Positive means success, nonpositive means failure. */
1525 /* 2048 is large enough for all known terminals, according to the
1526 GNU termcap manual. */
1527 char term_buffer
[2048];
1531 status
= tgetent (term_buffer
, termtype
);
1535 int running_in_emacs
= getenv ("EMACS") != NULL
;
1537 val
= tgetnum ("li");
1538 if (val
>= 0 && !running_in_emacs
)
1539 lines_per_page
= val
;
1541 /* The number of lines per page is not mentioned
1542 in the terminal description. This probably means
1543 that paging is not useful (e.g. emacs shell window),
1544 so disable paging. */
1545 lines_per_page
= UINT_MAX
;
1547 val
= tgetnum ("co");
1549 chars_per_line
= val
;
1555 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1557 /* If there is a better way to determine the window size, use it. */
1558 SIGWINCH_HANDLER (SIGWINCH
);
1561 /* If the output is not a terminal, don't paginate it. */
1562 if (!ui_file_isatty (gdb_stdout
))
1563 lines_per_page
= UINT_MAX
;
1564 } /* the command_line_version */
1571 if (chars_per_line
== 0)
1576 wrap_buffer
= (char *) xmalloc (chars_per_line
+ 2);
1577 wrap_buffer
[0] = '\0';
1580 wrap_buffer
= (char *) xrealloc (wrap_buffer
, chars_per_line
+ 2);
1581 wrap_pointer
= wrap_buffer
; /* Start it at the beginning */
1586 set_width_command (char *args
, int from_tty
, struct cmd_list_element
*c
)
1591 /* Wait, so the user can read what's on the screen. Prompt the user
1592 to continue by pressing RETURN. */
1595 prompt_for_continue (void)
1598 char cont_prompt
[120];
1600 if (annotation_level
> 1)
1601 printf_unfiltered ("\n\032\032pre-prompt-for-continue\n");
1603 strcpy (cont_prompt
,
1604 "---Type <return> to continue, or q <return> to quit---");
1605 if (annotation_level
> 1)
1606 strcat (cont_prompt
, "\n\032\032prompt-for-continue\n");
1608 /* We must do this *before* we call gdb_readline, else it will eventually
1609 call us -- thinking that we're trying to print beyond the end of the
1611 reinitialize_more_filter ();
1614 /* On a real operating system, the user can quit with SIGINT.
1617 'q' is provided on all systems so users don't have to change habits
1618 from system to system, and because telling them what to do in
1619 the prompt is more user-friendly than expecting them to think of
1621 /* Call readline, not gdb_readline, because GO32 readline handles control-C
1622 whereas control-C to gdb_readline will cause the user to get dumped
1624 ignore
= readline (cont_prompt
);
1626 if (annotation_level
> 1)
1627 printf_unfiltered ("\n\032\032post-prompt-for-continue\n");
1632 while (*p
== ' ' || *p
== '\t')
1637 request_quit (SIGINT
);
1639 async_request_quit (0);
1645 /* Now we have to do this again, so that GDB will know that it doesn't
1646 need to save the ---Type <return>--- line at the top of the screen. */
1647 reinitialize_more_filter ();
1649 dont_repeat (); /* Forget prev cmd -- CR won't repeat it. */
1652 /* Reinitialize filter; ie. tell it to reset to original values. */
1655 reinitialize_more_filter (void)
1661 /* Indicate that if the next sequence of characters overflows the line,
1662 a newline should be inserted here rather than when it hits the end.
1663 If INDENT is non-null, it is a string to be printed to indent the
1664 wrapped part on the next line. INDENT must remain accessible until
1665 the next call to wrap_here() or until a newline is printed through
1668 If the line is already overfull, we immediately print a newline and
1669 the indentation, and disable further wrapping.
1671 If we don't know the width of lines, but we know the page height,
1672 we must not wrap words, but should still keep track of newlines
1673 that were explicitly printed.
1675 INDENT should not contain tabs, as that will mess up the char count
1676 on the next line. FIXME.
1678 This routine is guaranteed to force out any output which has been
1679 squirreled away in the wrap_buffer, so wrap_here ((char *)0) can be
1680 used to force out output from the wrap_buffer. */
1683 wrap_here (char *indent
)
1685 /* This should have been allocated, but be paranoid anyway. */
1687 internal_error (__FILE__
, __LINE__
, "failed internal consistency check");
1691 *wrap_pointer
= '\0';
1692 fputs_unfiltered (wrap_buffer
, gdb_stdout
);
1694 wrap_pointer
= wrap_buffer
;
1695 wrap_buffer
[0] = '\0';
1696 if (chars_per_line
== UINT_MAX
) /* No line overflow checking */
1700 else if (chars_printed
>= chars_per_line
)
1702 puts_filtered ("\n");
1704 puts_filtered (indent
);
1709 wrap_column
= chars_printed
;
1713 wrap_indent
= indent
;
1717 /* Ensure that whatever gets printed next, using the filtered output
1718 commands, starts at the beginning of the line. I.E. if there is
1719 any pending output for the current line, flush it and start a new
1720 line. Otherwise do nothing. */
1725 if (chars_printed
> 0)
1727 puts_filtered ("\n");
1732 /* Like fputs but if FILTER is true, pause after every screenful.
1734 Regardless of FILTER can wrap at points other than the final
1735 character of a line.
1737 Unlike fputs, fputs_maybe_filtered does not return a value.
1738 It is OK for LINEBUFFER to be NULL, in which case just don't print
1741 Note that a longjmp to top level may occur in this routine (only if
1742 FILTER is true) (since prompt_for_continue may do so) so this
1743 routine should not be called when cleanups are not in place. */
1746 fputs_maybe_filtered (const char *linebuffer
, struct ui_file
*stream
,
1749 const char *lineptr
;
1751 if (linebuffer
== 0)
1754 /* Don't do any filtering if it is disabled. */
1755 if ((stream
!= gdb_stdout
) || !pagination_enabled
1756 || (lines_per_page
== UINT_MAX
&& chars_per_line
== UINT_MAX
))
1758 fputs_unfiltered (linebuffer
, stream
);
1762 /* Go through and output each character. Show line extension
1763 when this is necessary; prompt user for new page when this is
1766 lineptr
= linebuffer
;
1769 /* Possible new page. */
1771 (lines_printed
>= lines_per_page
- 1))
1772 prompt_for_continue ();
1774 while (*lineptr
&& *lineptr
!= '\n')
1776 /* Print a single line. */
1777 if (*lineptr
== '\t')
1780 *wrap_pointer
++ = '\t';
1782 fputc_unfiltered ('\t', stream
);
1783 /* Shifting right by 3 produces the number of tab stops
1784 we have already passed, and then adding one and
1785 shifting left 3 advances to the next tab stop. */
1786 chars_printed
= ((chars_printed
>> 3) + 1) << 3;
1792 *wrap_pointer
++ = *lineptr
;
1794 fputc_unfiltered (*lineptr
, stream
);
1799 if (chars_printed
>= chars_per_line
)
1801 unsigned int save_chars
= chars_printed
;
1805 /* If we aren't actually wrapping, don't output newline --
1806 if chars_per_line is right, we probably just overflowed
1807 anyway; if it's wrong, let us keep going. */
1809 fputc_unfiltered ('\n', stream
);
1811 /* Possible new page. */
1812 if (lines_printed
>= lines_per_page
- 1)
1813 prompt_for_continue ();
1815 /* Now output indentation and wrapped string */
1818 fputs_unfiltered (wrap_indent
, stream
);
1819 *wrap_pointer
= '\0'; /* Null-terminate saved stuff */
1820 fputs_unfiltered (wrap_buffer
, stream
); /* and eject it */
1821 /* FIXME, this strlen is what prevents wrap_indent from
1822 containing tabs. However, if we recurse to print it
1823 and count its chars, we risk trouble if wrap_indent is
1824 longer than (the user settable) chars_per_line.
1825 Note also that this can set chars_printed > chars_per_line
1826 if we are printing a long string. */
1827 chars_printed
= strlen (wrap_indent
)
1828 + (save_chars
- wrap_column
);
1829 wrap_pointer
= wrap_buffer
; /* Reset buffer */
1830 wrap_buffer
[0] = '\0';
1831 wrap_column
= 0; /* And disable fancy wrap */
1836 if (*lineptr
== '\n')
1839 wrap_here ((char *) 0); /* Spit out chars, cancel further wraps */
1841 fputc_unfiltered ('\n', stream
);
1848 fputs_filtered (const char *linebuffer
, struct ui_file
*stream
)
1850 fputs_maybe_filtered (linebuffer
, stream
, 1);
1854 putchar_unfiltered (int c
)
1857 ui_file_write (gdb_stdout
, &buf
, 1);
1861 /* Write character C to gdb_stdout using GDB's paging mechanism and return C.
1862 May return nonlocally. */
1865 putchar_filtered (int c
)
1867 return fputc_filtered (c
, gdb_stdout
);
1871 fputc_unfiltered (int c
, struct ui_file
*stream
)
1874 ui_file_write (stream
, &buf
, 1);
1879 fputc_filtered (int c
, struct ui_file
*stream
)
1885 fputs_filtered (buf
, stream
);
1889 /* puts_debug is like fputs_unfiltered, except it prints special
1890 characters in printable fashion. */
1893 puts_debug (char *prefix
, char *string
, char *suffix
)
1897 /* Print prefix and suffix after each line. */
1898 static int new_line
= 1;
1899 static int return_p
= 0;
1900 static char *prev_prefix
= "";
1901 static char *prev_suffix
= "";
1903 if (*string
== '\n')
1906 /* If the prefix is changing, print the previous suffix, a new line,
1907 and the new prefix. */
1908 if ((return_p
|| (strcmp (prev_prefix
, prefix
) != 0)) && !new_line
)
1910 fputs_unfiltered (prev_suffix
, gdb_stdlog
);
1911 fputs_unfiltered ("\n", gdb_stdlog
);
1912 fputs_unfiltered (prefix
, gdb_stdlog
);
1915 /* Print prefix if we printed a newline during the previous call. */
1919 fputs_unfiltered (prefix
, gdb_stdlog
);
1922 prev_prefix
= prefix
;
1923 prev_suffix
= suffix
;
1925 /* Output characters in a printable format. */
1926 while ((ch
= *string
++) != '\0')
1932 fputc_unfiltered (ch
, gdb_stdlog
);
1935 fprintf_unfiltered (gdb_stdlog
, "\\x%02x", ch
& 0xff);
1939 fputs_unfiltered ("\\\\", gdb_stdlog
);
1942 fputs_unfiltered ("\\b", gdb_stdlog
);
1945 fputs_unfiltered ("\\f", gdb_stdlog
);
1949 fputs_unfiltered ("\\n", gdb_stdlog
);
1952 fputs_unfiltered ("\\r", gdb_stdlog
);
1955 fputs_unfiltered ("\\t", gdb_stdlog
);
1958 fputs_unfiltered ("\\v", gdb_stdlog
);
1962 return_p
= ch
== '\r';
1965 /* Print suffix if we printed a newline. */
1968 fputs_unfiltered (suffix
, gdb_stdlog
);
1969 fputs_unfiltered ("\n", gdb_stdlog
);
1974 /* Print a variable number of ARGS using format FORMAT. If this
1975 information is going to put the amount written (since the last call
1976 to REINITIALIZE_MORE_FILTER or the last page break) over the page size,
1977 call prompt_for_continue to get the users permision to continue.
1979 Unlike fprintf, this function does not return a value.
1981 We implement three variants, vfprintf (takes a vararg list and stream),
1982 fprintf (takes a stream to write on), and printf (the usual).
1984 Note also that a longjmp to top level may occur in this routine
1985 (since prompt_for_continue may do so) so this routine should not be
1986 called when cleanups are not in place. */
1989 vfprintf_maybe_filtered (struct ui_file
*stream
, const char *format
,
1990 va_list args
, int filter
)
1993 struct cleanup
*old_cleanups
;
1995 xvasprintf (&linebuffer
, format
, args
);
1996 old_cleanups
= make_cleanup (xfree
, linebuffer
);
1997 fputs_maybe_filtered (linebuffer
, stream
, filter
);
1998 do_cleanups (old_cleanups
);
2003 vfprintf_filtered (struct ui_file
*stream
, const char *format
, va_list args
)
2005 vfprintf_maybe_filtered (stream
, format
, args
, 1);
2009 vfprintf_unfiltered (struct ui_file
*stream
, const char *format
, va_list args
)
2012 struct cleanup
*old_cleanups
;
2014 xvasprintf (&linebuffer
, format
, args
);
2015 old_cleanups
= make_cleanup (xfree
, linebuffer
);
2016 fputs_unfiltered (linebuffer
, stream
);
2017 do_cleanups (old_cleanups
);
2021 vprintf_filtered (const char *format
, va_list args
)
2023 vfprintf_maybe_filtered (gdb_stdout
, format
, args
, 1);
2027 vprintf_unfiltered (const char *format
, va_list args
)
2029 vfprintf_unfiltered (gdb_stdout
, format
, args
);
2033 fprintf_filtered (struct ui_file
* stream
, const char *format
,...)
2036 va_start (args
, format
);
2037 vfprintf_filtered (stream
, format
, args
);
2042 fprintf_unfiltered (struct ui_file
* stream
, const char *format
,...)
2045 va_start (args
, format
);
2046 vfprintf_unfiltered (stream
, format
, args
);
2050 /* Like fprintf_filtered, but prints its result indented.
2051 Called as fprintfi_filtered (spaces, stream, format, ...); */
2054 fprintfi_filtered (int spaces
, struct ui_file
* stream
, const char *format
,...)
2057 va_start (args
, format
);
2058 print_spaces_filtered (spaces
, stream
);
2060 vfprintf_filtered (stream
, format
, args
);
2066 printf_filtered (const char *format
,...)
2069 va_start (args
, format
);
2070 vfprintf_filtered (gdb_stdout
, format
, args
);
2076 printf_unfiltered (const char *format
,...)
2079 va_start (args
, format
);
2080 vfprintf_unfiltered (gdb_stdout
, format
, args
);
2084 /* Like printf_filtered, but prints it's result indented.
2085 Called as printfi_filtered (spaces, format, ...); */
2088 printfi_filtered (int spaces
, const char *format
,...)
2091 va_start (args
, format
);
2092 print_spaces_filtered (spaces
, gdb_stdout
);
2093 vfprintf_filtered (gdb_stdout
, format
, args
);
2097 /* Easy -- but watch out!
2099 This routine is *not* a replacement for puts()! puts() appends a newline.
2100 This one doesn't, and had better not! */
2103 puts_filtered (const char *string
)
2105 fputs_filtered (string
, gdb_stdout
);
2109 puts_unfiltered (const char *string
)
2111 fputs_unfiltered (string
, gdb_stdout
);
2114 /* Return a pointer to N spaces and a null. The pointer is good
2115 until the next call to here. */
2120 static char *spaces
= 0;
2121 static int max_spaces
= -1;
2127 spaces
= (char *) xmalloc (n
+ 1);
2128 for (t
= spaces
+ n
; t
!= spaces
;)
2134 return spaces
+ max_spaces
- n
;
2137 /* Print N spaces. */
2139 print_spaces_filtered (int n
, struct ui_file
*stream
)
2141 fputs_filtered (n_spaces (n
), stream
);
2144 /* C++ demangler stuff. */
2146 /* fprintf_symbol_filtered attempts to demangle NAME, a symbol in language
2147 LANG, using demangling args ARG_MODE, and print it filtered to STREAM.
2148 If the name is not mangled, or the language for the name is unknown, or
2149 demangling is off, the name is printed in its "raw" form. */
2152 fprintf_symbol_filtered (struct ui_file
*stream
, char *name
, enum language lang
,
2159 /* If user wants to see raw output, no problem. */
2162 fputs_filtered (name
, stream
);
2168 case language_cplus
:
2169 demangled
= cplus_demangle (name
, arg_mode
);
2172 demangled
= cplus_demangle (name
, arg_mode
| DMGL_JAVA
);
2174 case language_chill
:
2175 demangled
= chill_demangle (name
);
2181 fputs_filtered (demangled
? demangled
: name
, stream
);
2182 if (demangled
!= NULL
)
2190 /* Do a strcmp() type operation on STRING1 and STRING2, ignoring any
2191 differences in whitespace. Returns 0 if they match, non-zero if they
2192 don't (slightly different than strcmp()'s range of return values).
2194 As an extra hack, string1=="FOO(ARGS)" matches string2=="FOO".
2195 This "feature" is useful when searching for matching C++ function names
2196 (such as if the user types 'break FOO', where FOO is a mangled C++
2200 strcmp_iw (const char *string1
, const char *string2
)
2202 while ((*string1
!= '\0') && (*string2
!= '\0'))
2204 while (isspace (*string1
))
2208 while (isspace (*string2
))
2212 if (*string1
!= *string2
)
2216 if (*string1
!= '\0')
2222 return (*string1
!= '\0' && *string1
!= '(') || (*string2
!= '\0');
2228 ** Answer whether string_to_compare is a full or partial match to
2229 ** template_string. The partial match must be in sequence starting
2233 subset_compare (char *string_to_compare
, char *template_string
)
2236 if (template_string
!= (char *) NULL
&& string_to_compare
!= (char *) NULL
&&
2237 strlen (string_to_compare
) <= strlen (template_string
))
2238 match
= (strncmp (template_string
,
2240 strlen (string_to_compare
)) == 0);
2247 static void pagination_on_command (char *arg
, int from_tty
);
2249 pagination_on_command (char *arg
, int from_tty
)
2251 pagination_enabled
= 1;
2254 static void pagination_on_command (char *arg
, int from_tty
);
2256 pagination_off_command (char *arg
, int from_tty
)
2258 pagination_enabled
= 0;
2263 initialize_utils (void)
2265 struct cmd_list_element
*c
;
2267 c
= add_set_cmd ("width", class_support
, var_uinteger
,
2268 (char *) &chars_per_line
,
2269 "Set number of characters gdb thinks are in a line.",
2271 add_show_from_set (c
, &showlist
);
2272 c
->function
.sfunc
= set_width_command
;
2275 (add_set_cmd ("height", class_support
,
2276 var_uinteger
, (char *) &lines_per_page
,
2277 "Set number of lines gdb thinks are in a page.", &setlist
),
2282 /* If the output is not a terminal, don't paginate it. */
2283 if (!ui_file_isatty (gdb_stdout
))
2284 lines_per_page
= UINT_MAX
;
2286 set_width_command ((char *) NULL
, 0, c
);
2289 (add_set_cmd ("demangle", class_support
, var_boolean
,
2291 "Set demangling of encoded C++ names when displaying symbols.",
2296 (add_set_cmd ("pagination", class_support
,
2297 var_boolean
, (char *) &pagination_enabled
,
2298 "Set state of pagination.", &setlist
),
2303 add_com ("am", class_support
, pagination_on_command
,
2304 "Enable pagination");
2305 add_com ("sm", class_support
, pagination_off_command
,
2306 "Disable pagination");
2310 (add_set_cmd ("sevenbit-strings", class_support
, var_boolean
,
2311 (char *) &sevenbit_strings
,
2312 "Set printing of 8-bit characters in strings as \\nnn.",
2317 (add_set_cmd ("asm-demangle", class_support
, var_boolean
,
2318 (char *) &asm_demangle
,
2319 "Set demangling of C++ names in disassembly listings.",
2324 /* Machine specific function to handle SIGWINCH signal. */
2326 #ifdef SIGWINCH_HANDLER_BODY
2327 SIGWINCH_HANDLER_BODY
2330 /* print routines to handle variable size regs, etc. */
2332 /* temporary storage using circular buffer */
2338 static char buf
[NUMCELLS
][CELLSIZE
];
2339 static int cell
= 0;
2340 if (++cell
>= NUMCELLS
)
2348 return (TARGET_ADDR_BIT
/ 8 * 2);
2352 paddr (CORE_ADDR addr
)
2354 return phex (addr
, TARGET_ADDR_BIT
/ 8);
2358 paddr_nz (CORE_ADDR addr
)
2360 return phex_nz (addr
, TARGET_ADDR_BIT
/ 8);
2364 decimal2str (char *paddr_str
, char *sign
, ULONGEST addr
)
2366 /* steal code from valprint.c:print_decimal(). Should this worry
2367 about the real size of addr as the above does? */
2368 unsigned long temp
[3];
2372 temp
[i
] = addr
% (1000 * 1000 * 1000);
2373 addr
/= (1000 * 1000 * 1000);
2376 while (addr
!= 0 && i
< (sizeof (temp
) / sizeof (temp
[0])));
2380 sprintf (paddr_str
, "%s%lu",
2384 sprintf (paddr_str
, "%s%lu%09lu",
2385 sign
, temp
[1], temp
[0]);
2388 sprintf (paddr_str
, "%s%lu%09lu%09lu",
2389 sign
, temp
[2], temp
[1], temp
[0]);
2392 internal_error (__FILE__
, __LINE__
, "failed internal consistency check");
2397 paddr_u (CORE_ADDR addr
)
2399 char *paddr_str
= get_cell ();
2400 decimal2str (paddr_str
, "", addr
);
2405 paddr_d (LONGEST addr
)
2407 char *paddr_str
= get_cell ();
2409 decimal2str (paddr_str
, "-", -addr
);
2411 decimal2str (paddr_str
, "", addr
);
2415 /* eliminate warning from compiler on 32-bit systems */
2416 static int thirty_two
= 32;
2419 phex (ULONGEST l
, int sizeof_l
)
2421 char *str
= get_cell ();
2425 sprintf (str
, "%08lx%08lx",
2426 (unsigned long) (l
>> thirty_two
),
2427 (unsigned long) (l
& 0xffffffff));
2430 sprintf (str
, "%08lx", (unsigned long) l
);
2433 sprintf (str
, "%04x", (unsigned short) (l
& 0xffff));
2436 phex (l
, sizeof (l
));
2443 phex_nz (ULONGEST l
, int sizeof_l
)
2445 char *str
= get_cell ();
2450 unsigned long high
= (unsigned long) (l
>> thirty_two
);
2452 sprintf (str
, "%lx", (unsigned long) (l
& 0xffffffff));
2454 sprintf (str
, "%lx%08lx",
2455 high
, (unsigned long) (l
& 0xffffffff));
2459 sprintf (str
, "%lx", (unsigned long) l
);
2462 sprintf (str
, "%x", (unsigned short) (l
& 0xffff));
2465 phex_nz (l
, sizeof (l
));
2472 /* Convert to / from the hosts pointer to GDB's internal CORE_ADDR
2473 using the target's conversion routines. */
2475 host_pointer_to_address (void *ptr
)
2477 if (sizeof (ptr
) != TYPE_LENGTH (builtin_type_void_data_ptr
))
2478 internal_error (__FILE__
, __LINE__
,
2479 "core_addr_to_void_ptr: bad cast");
2480 return POINTER_TO_ADDRESS (builtin_type_void_data_ptr
, &ptr
);
2484 address_to_host_pointer (CORE_ADDR addr
)
2487 if (sizeof (ptr
) != TYPE_LENGTH (builtin_type_void_data_ptr
))
2488 internal_error (__FILE__
, __LINE__
,
2489 "core_addr_to_void_ptr: bad cast");
2490 ADDRESS_TO_POINTER (builtin_type_void_data_ptr
, &ptr
, addr
);
2494 /* Convert a CORE_ADDR into a string. */
2496 core_addr_to_string (const CORE_ADDR addr
)
2498 char *str
= get_cell ();
2500 strcat (str
, phex_nz (addr
, sizeof (addr
)));
2504 /* Convert a string back into a CORE_ADDR. */
2506 string_to_core_addr (const char *my_string
)
2509 if (my_string
[0] == '0' && tolower (my_string
[1]) == 'x')
2511 /* Assume that it is in decimal. */
2513 for (i
= 2; my_string
[i
] != '\0'; i
++)
2515 if (isdigit (my_string
[i
]))
2516 addr
= (my_string
[i
] - '0') + (addr
* 16);
2517 else if (isxdigit (my_string
[i
]))
2518 addr
= (tolower (my_string
[i
]) - 'a' + 0xa) + (addr
* 16);
2520 internal_error (__FILE__
, __LINE__
, "invalid hex");
2525 /* Assume that it is in decimal. */
2527 for (i
= 0; my_string
[i
] != '\0'; i
++)
2529 if (isdigit (my_string
[i
]))
2530 addr
= (my_string
[i
] - '0') + (addr
* 10);
2532 internal_error (__FILE__
, __LINE__
, "invalid decimal");