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>
63 #ifndef MALLOC_INCOMPATIBLE
64 #ifdef NEED_DECLARATION_MALLOC
67 #ifdef NEED_DECLARATION_REALLOC
68 extern PTR
realloc ();
70 #ifdef NEED_DECLARATION_FREE
76 #define XMALLOC(TYPE) ((TYPE*) xmalloc (sizeof (TYPE)))
78 /* readline defines this. */
81 void (*error_begin_hook
) (void);
83 /* Holds the last error message issued by gdb */
85 static struct ui_file
*gdb_lasterr
;
87 /* Prototypes for local functions */
89 static void vfprintf_maybe_filtered (struct ui_file
*, const char *,
92 static void fputs_maybe_filtered (const char *, struct ui_file
*, int);
94 #if defined (USE_MMALLOC) && !defined (NO_MMCHECK)
95 static void malloc_botch (void);
98 static void prompt_for_continue (void);
100 static void set_width_command (char *, int, struct cmd_list_element
*);
102 static void set_width (void);
104 /* Chain of cleanup actions established with make_cleanup,
105 to be executed if an error happens. */
107 static struct cleanup
*cleanup_chain
; /* cleaned up after a failed command */
108 static struct cleanup
*final_cleanup_chain
; /* cleaned up when gdb exits */
109 static struct cleanup
*run_cleanup_chain
; /* cleaned up on each 'run' */
110 static struct cleanup
*exec_cleanup_chain
; /* cleaned up on each execution command */
111 /* cleaned up on each error from within an execution command */
112 static struct cleanup
*exec_error_cleanup_chain
;
114 /* Pointer to what is left to do for an execution command after the
115 target stops. Used only in asynchronous mode, by targets that
116 support async execution. The finish and until commands use it. So
117 does the target extended-remote command. */
118 struct continuation
*cmd_continuation
;
119 struct continuation
*intermediate_continuation
;
121 /* Nonzero if we have job control. */
125 /* Nonzero means a quit has been requested. */
129 /* Nonzero means quit immediately if Control-C is typed now, rather
130 than waiting until QUIT is executed. Be careful in setting this;
131 code which executes with immediate_quit set has to be very careful
132 about being able to deal with being interrupted at any time. It is
133 almost always better to use QUIT; the only exception I can think of
134 is being able to quit out of a system call (using EINTR loses if
135 the SIGINT happens between the previous QUIT and the system call).
136 To immediately quit in the case in which a SIGINT happens between
137 the previous QUIT and setting immediate_quit (desirable anytime we
138 expect to block), call QUIT after setting immediate_quit. */
142 /* Nonzero means that encoded C++ names should be printed out in their
143 C++ form rather than raw. */
147 /* Nonzero means that encoded C++ names should be printed out in their
148 C++ form even in assembler language displays. If this is set, but
149 DEMANGLE is zero, names are printed raw, i.e. DEMANGLE controls. */
151 int asm_demangle
= 0;
153 /* Nonzero means that strings with character values >0x7F should be printed
154 as octal escapes. Zero means just print the value (e.g. it's an
155 international character, and the terminal or window can cope.) */
157 int sevenbit_strings
= 0;
159 /* String to be printed before error messages, if any. */
161 char *error_pre_print
;
163 /* String to be printed before quit messages, if any. */
165 char *quit_pre_print
;
167 /* String to be printed before warning messages, if any. */
169 char *warning_pre_print
= "\nwarning: ";
171 int pagination_enabled
= 1;
174 /* Add a new cleanup to the cleanup_chain,
175 and return the previous chain pointer
176 to be passed later to do_cleanups or discard_cleanups.
177 Args are FUNCTION to clean up with, and ARG to pass to it. */
180 make_cleanup (make_cleanup_ftype
*function
, void *arg
)
182 return make_my_cleanup (&cleanup_chain
, function
, arg
);
186 make_final_cleanup (make_cleanup_ftype
*function
, void *arg
)
188 return make_my_cleanup (&final_cleanup_chain
, function
, arg
);
192 make_run_cleanup (make_cleanup_ftype
*function
, void *arg
)
194 return make_my_cleanup (&run_cleanup_chain
, function
, arg
);
198 make_exec_cleanup (make_cleanup_ftype
*function
, void *arg
)
200 return make_my_cleanup (&exec_cleanup_chain
, function
, arg
);
204 make_exec_error_cleanup (make_cleanup_ftype
*function
, void *arg
)
206 return make_my_cleanup (&exec_error_cleanup_chain
, function
, arg
);
210 do_freeargv (void *arg
)
212 freeargv ((char **) arg
);
216 make_cleanup_freeargv (char **arg
)
218 return make_my_cleanup (&cleanup_chain
, do_freeargv
, arg
);
222 do_bfd_close_cleanup (void *arg
)
228 make_cleanup_bfd_close (bfd
*abfd
)
230 return make_cleanup (do_bfd_close_cleanup
, abfd
);
234 do_close_cleanup (void *arg
)
242 make_cleanup_close (int fd
)
244 int *saved_fd
= xmalloc (sizeof (fd
));
246 return make_cleanup (do_close_cleanup
, saved_fd
);
250 do_ui_file_delete (void *arg
)
252 ui_file_delete (arg
);
256 make_cleanup_ui_file_delete (struct ui_file
*arg
)
258 return make_my_cleanup (&cleanup_chain
, do_ui_file_delete
, arg
);
262 make_my_cleanup (struct cleanup
**pmy_chain
, make_cleanup_ftype
*function
,
265 register struct cleanup
*new
266 = (struct cleanup
*) xmalloc (sizeof (struct cleanup
));
267 register struct cleanup
*old_chain
= *pmy_chain
;
269 new->next
= *pmy_chain
;
270 new->function
= function
;
277 /* Discard cleanups and do the actions they describe
278 until we get back to the point OLD_CHAIN in the cleanup_chain. */
281 do_cleanups (register struct cleanup
*old_chain
)
283 do_my_cleanups (&cleanup_chain
, old_chain
);
287 do_final_cleanups (register struct cleanup
*old_chain
)
289 do_my_cleanups (&final_cleanup_chain
, old_chain
);
293 do_run_cleanups (register struct cleanup
*old_chain
)
295 do_my_cleanups (&run_cleanup_chain
, old_chain
);
299 do_exec_cleanups (register struct cleanup
*old_chain
)
301 do_my_cleanups (&exec_cleanup_chain
, old_chain
);
305 do_exec_error_cleanups (register struct cleanup
*old_chain
)
307 do_my_cleanups (&exec_error_cleanup_chain
, old_chain
);
311 do_my_cleanups (register struct cleanup
**pmy_chain
,
312 register struct cleanup
*old_chain
)
314 register struct cleanup
*ptr
;
315 while ((ptr
= *pmy_chain
) != old_chain
)
317 *pmy_chain
= ptr
->next
; /* Do this first incase recursion */
318 (*ptr
->function
) (ptr
->arg
);
323 /* Discard cleanups, not doing the actions they describe,
324 until we get back to the point OLD_CHAIN in the cleanup_chain. */
327 discard_cleanups (register struct cleanup
*old_chain
)
329 discard_my_cleanups (&cleanup_chain
, old_chain
);
333 discard_final_cleanups (register struct cleanup
*old_chain
)
335 discard_my_cleanups (&final_cleanup_chain
, old_chain
);
339 discard_exec_error_cleanups (register struct cleanup
*old_chain
)
341 discard_my_cleanups (&exec_error_cleanup_chain
, old_chain
);
345 discard_my_cleanups (register struct cleanup
**pmy_chain
,
346 register struct cleanup
*old_chain
)
348 register struct cleanup
*ptr
;
349 while ((ptr
= *pmy_chain
) != old_chain
)
351 *pmy_chain
= ptr
->next
;
356 /* Set the cleanup_chain to 0, and return the old cleanup chain. */
360 return save_my_cleanups (&cleanup_chain
);
364 save_final_cleanups (void)
366 return save_my_cleanups (&final_cleanup_chain
);
370 save_my_cleanups (struct cleanup
**pmy_chain
)
372 struct cleanup
*old_chain
= *pmy_chain
;
378 /* Restore the cleanup chain from a previously saved chain. */
380 restore_cleanups (struct cleanup
*chain
)
382 restore_my_cleanups (&cleanup_chain
, chain
);
386 restore_final_cleanups (struct cleanup
*chain
)
388 restore_my_cleanups (&final_cleanup_chain
, chain
);
392 restore_my_cleanups (struct cleanup
**pmy_chain
, struct cleanup
*chain
)
397 /* This function is useful for cleanups.
401 old_chain = make_cleanup (free_current_contents, &foo);
403 to arrange to free the object thus allocated. */
406 free_current_contents (void *ptr
)
408 void **location
= ptr
;
409 if (location
== NULL
)
410 internal_error (__FILE__
, __LINE__
,
411 "free_current_contents: NULL pointer");
412 if (*location
!= NULL
)
419 /* Provide a known function that does nothing, to use as a base for
420 for a possibly long chain of cleanups. This is useful where we
421 use the cleanup chain for handling normal cleanups as well as dealing
422 with cleanups that need to be done as a result of a call to error().
423 In such cases, we may not be certain where the first cleanup is, unless
424 we have a do-nothing one to always use as the base. */
428 null_cleanup (void *arg
)
432 /* Add a continuation to the continuation list, the global list
433 cmd_continuation. The new continuation will be added at the front.*/
435 add_continuation (void (*continuation_hook
) (struct continuation_arg
*),
436 struct continuation_arg
*arg_list
)
438 struct continuation
*continuation_ptr
;
440 continuation_ptr
= (struct continuation
*) xmalloc (sizeof (struct continuation
));
441 continuation_ptr
->continuation_hook
= continuation_hook
;
442 continuation_ptr
->arg_list
= arg_list
;
443 continuation_ptr
->next
= cmd_continuation
;
444 cmd_continuation
= continuation_ptr
;
447 /* Walk down the cmd_continuation list, and execute all the
448 continuations. There is a problem though. In some cases new
449 continuations may be added while we are in the middle of this
450 loop. If this happens they will be added in the front, and done
451 before we have a chance of exhausting those that were already
452 there. We need to then save the beginning of the list in a pointer
453 and do the continuations from there on, instead of using the
454 global beginning of list as our iteration pointer.*/
456 do_all_continuations (void)
458 struct continuation
*continuation_ptr
;
459 struct continuation
*saved_continuation
;
461 /* Copy the list header into another pointer, and set the global
462 list header to null, so that the global list can change as a side
463 effect of invoking the continuations and the processing of
464 the preexisting continuations will not be affected. */
465 continuation_ptr
= cmd_continuation
;
466 cmd_continuation
= NULL
;
468 /* Work now on the list we have set aside. */
469 while (continuation_ptr
)
471 (continuation_ptr
->continuation_hook
) (continuation_ptr
->arg_list
);
472 saved_continuation
= continuation_ptr
;
473 continuation_ptr
= continuation_ptr
->next
;
474 xfree (saved_continuation
);
478 /* Walk down the cmd_continuation list, and get rid of all the
481 discard_all_continuations (void)
483 struct continuation
*continuation_ptr
;
485 while (cmd_continuation
)
487 continuation_ptr
= cmd_continuation
;
488 cmd_continuation
= continuation_ptr
->next
;
489 xfree (continuation_ptr
);
493 /* Add a continuation to the continuation list, the global list
494 intermediate_continuation. The new continuation will be added at the front.*/
496 add_intermediate_continuation (void (*continuation_hook
)
497 (struct continuation_arg
*),
498 struct continuation_arg
*arg_list
)
500 struct continuation
*continuation_ptr
;
502 continuation_ptr
= (struct continuation
*) xmalloc (sizeof (struct continuation
));
503 continuation_ptr
->continuation_hook
= continuation_hook
;
504 continuation_ptr
->arg_list
= arg_list
;
505 continuation_ptr
->next
= intermediate_continuation
;
506 intermediate_continuation
= continuation_ptr
;
509 /* Walk down the cmd_continuation list, and execute all the
510 continuations. There is a problem though. In some cases new
511 continuations may be added while we are in the middle of this
512 loop. If this happens they will be added in the front, and done
513 before we have a chance of exhausting those that were already
514 there. We need to then save the beginning of the list in a pointer
515 and do the continuations from there on, instead of using the
516 global beginning of list as our iteration pointer.*/
518 do_all_intermediate_continuations (void)
520 struct continuation
*continuation_ptr
;
521 struct continuation
*saved_continuation
;
523 /* Copy the list header into another pointer, and set the global
524 list header to null, so that the global list can change as a side
525 effect of invoking the continuations and the processing of
526 the preexisting continuations will not be affected. */
527 continuation_ptr
= intermediate_continuation
;
528 intermediate_continuation
= NULL
;
530 /* Work now on the list we have set aside. */
531 while (continuation_ptr
)
533 (continuation_ptr
->continuation_hook
) (continuation_ptr
->arg_list
);
534 saved_continuation
= continuation_ptr
;
535 continuation_ptr
= continuation_ptr
->next
;
536 xfree (saved_continuation
);
540 /* Walk down the cmd_continuation list, and get rid of all the
543 discard_all_intermediate_continuations (void)
545 struct continuation
*continuation_ptr
;
547 while (intermediate_continuation
)
549 continuation_ptr
= intermediate_continuation
;
550 intermediate_continuation
= continuation_ptr
->next
;
551 xfree (continuation_ptr
);
557 /* Print a warning message. Way to use this is to call warning_begin,
558 output the warning message (use unfiltered output to gdb_stderr),
559 ending in a newline. There is not currently a warning_end that you
560 call afterwards, but such a thing might be added if it is useful
561 for a GUI to separate warning messages from other output.
563 FIXME: Why do warnings use unfiltered output and errors filtered?
564 Is this anything other than a historical accident? */
569 target_terminal_ours ();
570 wrap_here (""); /* Force out any buffered output */
571 gdb_flush (gdb_stdout
);
572 if (warning_pre_print
)
573 fprintf_unfiltered (gdb_stderr
, warning_pre_print
);
576 /* Print a warning message.
577 The first argument STRING is the warning message, used as a fprintf string,
578 and the remaining args are passed as arguments to it.
579 The primary difference between warnings and errors is that a warning
580 does not force the return to command level. */
583 warning (const char *string
,...)
586 va_start (args
, string
);
588 (*warning_hook
) (string
, args
);
592 vfprintf_unfiltered (gdb_stderr
, string
, args
);
593 fprintf_unfiltered (gdb_stderr
, "\n");
598 /* Start the printing of an error message. Way to use this is to call
599 this, output the error message (use filtered output to gdb_stderr
600 (FIXME: Some callers, like memory_error, use gdb_stdout)), ending
601 in a newline, and then call return_to_top_level (RETURN_ERROR).
602 error() provides a convenient way to do this for the special case
603 that the error message can be formatted with a single printf call,
604 but this is more general. */
608 if (error_begin_hook
)
611 target_terminal_ours ();
612 wrap_here (""); /* Force out any buffered output */
613 gdb_flush (gdb_stdout
);
615 annotate_error_begin ();
618 fprintf_filtered (gdb_stderr
, error_pre_print
);
621 /* Print an error message and return to command level.
622 The first argument STRING is the error message, used as a fprintf string,
623 and the remaining args are passed as arguments to it. */
626 verror (const char *string
, va_list args
)
629 struct cleanup
*err_string_cleanup
;
630 /* FIXME: cagney/1999-11-10: All error calls should come here.
631 Unfortunately some code uses the sequence: error_begin(); print
632 error message; return_to_top_level. That code should be
635 /* NOTE: It's tempting to just do the following...
636 vfprintf_filtered (gdb_stderr, string, args);
637 and then follow with a similar looking statement to cause the message
638 to also go to gdb_lasterr. But if we do this, we'll be traversing the
639 va_list twice which works on some platforms and fails miserably on
641 /* Save it as the last error */
642 ui_file_rewind (gdb_lasterr
);
643 vfprintf_filtered (gdb_lasterr
, string
, args
);
644 /* Retrieve the last error and print it to gdb_stderr */
645 err_string
= error_last_message ();
646 err_string_cleanup
= make_cleanup (xfree
, err_string
);
647 fputs_filtered (err_string
, gdb_stderr
);
648 fprintf_filtered (gdb_stderr
, "\n");
649 do_cleanups (err_string_cleanup
);
650 return_to_top_level (RETURN_ERROR
);
654 error (const char *string
,...)
657 va_start (args
, string
);
658 verror (string
, args
);
663 error_stream (struct ui_file
*stream
)
666 char *msg
= ui_file_xstrdup (stream
, &size
);
667 make_cleanup (xfree
, msg
);
671 /* Get the last error message issued by gdb */
674 error_last_message (void)
677 return ui_file_xstrdup (gdb_lasterr
, &len
);
680 /* This is to be called by main() at the very beginning */
685 gdb_lasterr
= mem_fileopen ();
688 /* Print a message reporting an internal error. Ask the user if they
689 want to continue, dump core, or just exit. */
692 internal_verror (const char *file
, int line
,
693 const char *fmt
, va_list ap
)
695 static char msg
[] = "Internal GDB error: recursive internal error.\n";
696 static int dejavu
= 0;
700 /* don't allow infinite error recursion. */
708 fputs_unfiltered (msg
, gdb_stderr
);
709 abort (); /* NOTE: GDB has only three calls to abort(). */
712 write (STDERR_FILENO
, msg
, sizeof (msg
));
716 /* Try to get the message out */
717 target_terminal_ours ();
718 fprintf_unfiltered (gdb_stderr
, "%s:%d: gdb-internal-error: ", file
, line
);
719 vfprintf_unfiltered (gdb_stderr
, fmt
, ap
);
720 fputs_unfiltered ("\n", gdb_stderr
);
722 /* Default (no case) is to quit GDB. When in batch mode this
723 lessens the likelhood of GDB going into an infinate loop. */
724 continue_p
= query ("\
725 An internal GDB error was detected. This may make further\n\
726 debugging unreliable. Continue this debugging session? ");
728 /* Default (no case) is to not dump core. Lessen the chance of GDB
729 leaving random core files around. */
730 dump_core_p
= query ("\
731 Create a core file containing the current state of GDB? ");
738 abort (); /* NOTE: GDB has only three calls to abort(). */
744 abort (); /* NOTE: GDB has only three calls to abort(). */
750 return_to_top_level (RETURN_ERROR
);
754 internal_error (const char *file
, int line
, const char *string
, ...)
757 va_start (ap
, string
);
759 internal_verror (file
, line
, string
, ap
);
763 /* The strerror() function can return NULL for errno values that are
764 out of range. Provide a "safe" version that always returns a
768 safe_strerror (int errnum
)
773 if ((msg
= strerror (errnum
)) == NULL
)
775 sprintf (buf
, "(undocumented errno %d)", errnum
);
781 /* Print the system error message for errno, and also mention STRING
782 as the file name for which the error was encountered.
783 Then return to command level. */
786 perror_with_name (char *string
)
791 err
= safe_strerror (errno
);
792 combined
= (char *) alloca (strlen (err
) + strlen (string
) + 3);
793 strcpy (combined
, string
);
794 strcat (combined
, ": ");
795 strcat (combined
, err
);
797 /* I understand setting these is a matter of taste. Still, some people
798 may clear errno but not know about bfd_error. Doing this here is not
800 bfd_set_error (bfd_error_no_error
);
803 error ("%s.", combined
);
806 /* Print the system error message for ERRCODE, and also mention STRING
807 as the file name for which the error was encountered. */
810 print_sys_errmsg (char *string
, int errcode
)
815 err
= safe_strerror (errcode
);
816 combined
= (char *) alloca (strlen (err
) + strlen (string
) + 3);
817 strcpy (combined
, string
);
818 strcat (combined
, ": ");
819 strcat (combined
, err
);
821 /* We want anything which was printed on stdout to come out first, before
823 gdb_flush (gdb_stdout
);
824 fprintf_unfiltered (gdb_stderr
, "%s.\n", combined
);
827 /* Control C eventually causes this to be called, at a convenient time. */
832 struct serial
*gdb_stdout_serial
= serial_fdopen (1);
834 target_terminal_ours ();
836 /* We want all output to appear now, before we print "Quit". We
837 have 3 levels of buffering we have to flush (it's possible that
838 some of these should be changed to flush the lower-level ones
841 /* 1. The _filtered buffer. */
842 wrap_here ((char *) 0);
844 /* 2. The stdio buffer. */
845 gdb_flush (gdb_stdout
);
846 gdb_flush (gdb_stderr
);
848 /* 3. The system-level buffer. */
849 serial_drain_output (gdb_stdout_serial
);
850 serial_un_fdopen (gdb_stdout_serial
);
852 annotate_error_begin ();
854 /* Don't use *_filtered; we don't want to prompt the user to continue. */
856 fprintf_unfiltered (gdb_stderr
, quit_pre_print
);
859 /* No steenking SIGINT will ever be coming our way when the
860 program is resumed. Don't lie. */
861 fprintf_unfiltered (gdb_stderr
, "Quit\n");
864 /* If there is no terminal switching for this target, then we can't
865 possibly get screwed by the lack of job control. */
866 || current_target
.to_terminal_ours
== NULL
)
867 fprintf_unfiltered (gdb_stderr
, "Quit\n");
869 fprintf_unfiltered (gdb_stderr
,
870 "Quit (expect signal SIGINT when the program is resumed)\n");
872 return_to_top_level (RETURN_QUIT
);
875 /* Control C comes here */
877 request_quit (int signo
)
880 /* Restore the signal handler. Harmless with BSD-style signals, needed
881 for System V-style signals. So just always do it, rather than worrying
882 about USG defines and stuff like that. */
883 signal (signo
, request_quit
);
893 /* Memory management stuff (malloc friends). */
895 #if !defined (USE_MMALLOC)
897 /* NOTE: These must use PTR so that their definition matches the
898 declaration found in "mmalloc.h". */
901 mmalloc (void *md
, size_t size
)
903 return malloc (size
); /* NOTE: GDB's only call to malloc() */
907 mrealloc (void *md
, void *ptr
, size_t size
)
909 if (ptr
== 0) /* Guard against old realloc's */
910 return mmalloc (md
, size
);
912 return realloc (ptr
, size
); /* NOTE: GDB's only call to ralloc() */
916 mcalloc (void *md
, size_t number
, size_t size
)
918 return calloc (number
, size
); /* NOTE: GDB's only call to calloc() */
922 mfree (void *md
, void *ptr
)
924 free (ptr
); /* NOTE: GDB's only call to free() */
927 #endif /* USE_MMALLOC */
929 #if !defined (USE_MMALLOC) || defined (NO_MMCHECK)
932 init_malloc (void *md
)
936 #else /* Have mmalloc and want corruption checking */
941 fprintf_unfiltered (gdb_stderr
, "Memory corruption\n");
942 internal_error (__FILE__
, __LINE__
, "failed internal consistency check");
945 /* Attempt to install hooks in mmalloc/mrealloc/mfree for the heap specified
946 by MD, to detect memory corruption. Note that MD may be NULL to specify
947 the default heap that grows via sbrk.
949 Note that for freshly created regions, we must call mmcheckf prior to any
950 mallocs in the region. Otherwise, any region which was allocated prior to
951 installing the checking hooks, which is later reallocated or freed, will
952 fail the checks! The mmcheck function only allows initial hooks to be
953 installed before the first mmalloc. However, anytime after we have called
954 mmcheck the first time to install the checking hooks, we can call it again
955 to update the function pointer to the memory corruption handler.
957 Returns zero on failure, non-zero on success. */
959 #ifndef MMCHECK_FORCE
960 #define MMCHECK_FORCE 0
964 init_malloc (void *md
)
966 if (!mmcheckf (md
, malloc_botch
, MMCHECK_FORCE
))
968 /* Don't use warning(), which relies on current_target being set
969 to something other than dummy_target, until after
970 initialize_all_files(). */
973 (gdb_stderr
, "warning: failed to install memory consistency checks; ");
975 (gdb_stderr
, "configuration should define NO_MMCHECK or MMCHECK_FORCE\n");
981 #endif /* Have mmalloc and want corruption checking */
983 /* Called when a memory allocation fails, with the number of bytes of
984 memory requested in SIZE. */
991 internal_error (__FILE__
, __LINE__
,
992 "virtual memory exhausted: can't allocate %ld bytes.", size
);
996 internal_error (__FILE__
, __LINE__
,
997 "virtual memory exhausted.");
1001 /* The xmmalloc() family of memory management routines.
1003 These are are like the mmalloc() family except that they implement
1004 consistent semantics and guard against typical memory management
1005 problems: if a malloc fails, an internal error is thrown; if
1006 free(NULL) is called, it is ignored; if *alloc(0) is called, NULL
1009 All these routines are implemented using the mmalloc() family. */
1012 xmmalloc (void *md
, size_t size
)
1022 val
= mmalloc (md
, size
);
1030 xmrealloc (void *md
, void *ptr
, size_t size
)
1044 val
= mrealloc (md
, ptr
, size
);
1048 val
= mmalloc (md
, size
);
1059 xmcalloc (void *md
, size_t number
, size_t size
)
1062 if (number
== 0 || size
== 0)
1066 mem
= mcalloc (md
, number
, size
);
1068 nomem (number
* size
);
1074 xmfree (void *md
, void *ptr
)
1080 /* The xmalloc() (libiberty.h) family of memory management routines.
1082 These are like the ISO-C malloc() family except that they implement
1083 consistent semantics and guard against typical memory management
1084 problems. See xmmalloc() above for further information.
1086 All these routines are wrappers to the xmmalloc() family. */
1088 /* NOTE: These are declared using PTR to ensure consistency with
1089 "libiberty.h". xfree() is GDB local. */
1092 xmalloc (size_t size
)
1094 return xmmalloc (NULL
, size
);
1098 xrealloc (PTR ptr
, size_t size
)
1100 return xmrealloc (NULL
, ptr
, size
);
1104 xcalloc (size_t number
, size_t size
)
1106 return xmcalloc (NULL
, number
, size
);
1116 /* Like asprintf/vasprintf but get an internal_error if the call
1120 xasprintf (char **ret
, const char *format
, ...)
1123 va_start (args
, format
);
1124 xvasprintf (ret
, format
, args
);
1129 xvasprintf (char **ret
, const char *format
, va_list ap
)
1131 int status
= vasprintf (ret
, format
, ap
);
1132 /* NULL could be returned due to a memory allocation problem; a
1133 badly format string; or something else. */
1135 internal_error (__FILE__
, __LINE__
,
1136 "vasprintf returned NULL buffer (errno %d)",
1138 /* A negative status with a non-NULL buffer shouldn't never
1139 happen. But to be sure. */
1141 internal_error (__FILE__
, __LINE__
,
1142 "vasprintf call failed (errno %d)",
1147 /* My replacement for the read system call.
1148 Used like `read' but keeps going if `read' returns too soon. */
1151 myread (int desc
, char *addr
, int len
)
1158 val
= read (desc
, addr
, len
);
1162 return orglen
- len
;
1169 /* Make a copy of the string at PTR with SIZE characters
1170 (and add a null character at the end in the copy).
1171 Uses malloc to get the space. Returns the address of the copy. */
1174 savestring (const char *ptr
, size_t size
)
1176 register char *p
= (char *) xmalloc (size
+ 1);
1177 memcpy (p
, ptr
, size
);
1183 msavestring (void *md
, const char *ptr
, size_t size
)
1185 register char *p
= (char *) xmmalloc (md
, size
+ 1);
1186 memcpy (p
, ptr
, size
);
1192 mstrsave (void *md
, const char *ptr
)
1194 return (msavestring (md
, ptr
, strlen (ptr
)));
1198 print_spaces (register int n
, register struct ui_file
*file
)
1200 fputs_unfiltered (n_spaces (n
), file
);
1203 /* Print a host address. */
1206 gdb_print_host_address (void *addr
, struct ui_file
*stream
)
1209 /* We could use the %p conversion specifier to fprintf if we had any
1210 way of knowing whether this host supports it. But the following
1211 should work on the Alpha and on 32 bit machines. */
1213 fprintf_filtered (stream
, "0x%lx", (unsigned long) addr
);
1216 /* Ask user a y-or-n question and return 1 iff answer is yes.
1217 Takes three args which are given to printf to print the question.
1218 The first, a control string, should end in "? ".
1219 It should not say how to answer, because we do that. */
1223 query (char *ctlstr
,...)
1226 register int answer
;
1230 va_start (args
, ctlstr
);
1234 return query_hook (ctlstr
, args
);
1237 /* Automatically answer "yes" if input is not from a terminal. */
1238 if (!input_from_terminal_p ())
1240 /* OBSOLETE #ifdef MPW */
1241 /* OBSOLETE *//* FIXME Automatically answer "yes" if called from MacGDB. */
1242 /* OBSOLETE if (mac_app) */
1243 /* OBSOLETE return 1; */
1244 /* OBSOLETE #endif *//* MPW */
1248 wrap_here (""); /* Flush any buffered output */
1249 gdb_flush (gdb_stdout
);
1251 if (annotation_level
> 1)
1252 printf_filtered ("\n\032\032pre-query\n");
1254 vfprintf_filtered (gdb_stdout
, ctlstr
, args
);
1255 printf_filtered ("(y or n) ");
1257 if (annotation_level
> 1)
1258 printf_filtered ("\n\032\032query\n");
1260 /* OBSOLETE #ifdef MPW */
1261 /* OBSOLETE *//* If not in MacGDB, move to a new line so the entered line doesn't */
1262 /* OBSOLETE have a prompt on the front of it. */
1263 /* OBSOLETE if (!mac_app) */
1264 /* OBSOLETE fputs_unfiltered ("\n", gdb_stdout); */
1265 /* OBSOLETE #endif *//* MPW */
1268 gdb_flush (gdb_stdout
);
1270 answer
= fgetc (stdin
);
1271 clearerr (stdin
); /* in case of C-d */
1272 if (answer
== EOF
) /* C-d */
1277 /* Eat rest of input line, to EOF or newline */
1281 ans2
= fgetc (stdin
);
1284 while (ans2
!= EOF
&& ans2
!= '\n' && ans2
!= '\r');
1298 printf_filtered ("Please answer y or n.\n");
1301 if (annotation_level
> 1)
1302 printf_filtered ("\n\032\032post-query\n");
1307 /* Parse a C escape sequence. STRING_PTR points to a variable
1308 containing a pointer to the string to parse. That pointer
1309 should point to the character after the \. That pointer
1310 is updated past the characters we use. The value of the
1311 escape sequence is returned.
1313 A negative value means the sequence \ newline was seen,
1314 which is supposed to be equivalent to nothing at all.
1316 If \ is followed by a null character, we return a negative
1317 value and leave the string pointer pointing at the null character.
1319 If \ is followed by 000, we return 0 and leave the string pointer
1320 after the zeros. A value of 0 does not mean end of string. */
1323 parse_escape (char **string_ptr
)
1325 register int c
= *(*string_ptr
)++;
1329 return 007; /* Bell (alert) char */
1332 case 'e': /* Escape character */
1350 c
= *(*string_ptr
)++;
1352 c
= parse_escape (string_ptr
);
1355 return (c
& 0200) | (c
& 037);
1366 register int i
= c
- '0';
1367 register int count
= 0;
1370 if ((c
= *(*string_ptr
)++) >= '0' && c
<= '7')
1388 /* Print the character C on STREAM as part of the contents of a literal
1389 string whose delimiter is QUOTER. Note that this routine should only
1390 be call for printing things which are independent of the language
1391 of the program being debugged. */
1394 printchar (int c
, void (*do_fputs
) (const char *, struct ui_file
*),
1395 void (*do_fprintf
) (struct ui_file
*, const char *, ...),
1396 struct ui_file
*stream
, int quoter
)
1399 c
&= 0xFF; /* Avoid sign bit follies */
1401 if (c
< 0x20 || /* Low control chars */
1402 (c
>= 0x7F && c
< 0xA0) || /* DEL, High controls */
1403 (sevenbit_strings
&& c
>= 0x80))
1404 { /* high order bit set */
1408 do_fputs ("\\n", stream
);
1411 do_fputs ("\\b", stream
);
1414 do_fputs ("\\t", stream
);
1417 do_fputs ("\\f", stream
);
1420 do_fputs ("\\r", stream
);
1423 do_fputs ("\\e", stream
);
1426 do_fputs ("\\a", stream
);
1429 do_fprintf (stream
, "\\%.3o", (unsigned int) c
);
1435 if (c
== '\\' || c
== quoter
)
1436 do_fputs ("\\", stream
);
1437 do_fprintf (stream
, "%c", c
);
1441 /* Print the character C on STREAM as part of the contents of a
1442 literal string whose delimiter is QUOTER. Note that these routines
1443 should only be call for printing things which are independent of
1444 the language of the program being debugged. */
1447 fputstr_filtered (const char *str
, int quoter
, struct ui_file
*stream
)
1450 printchar (*str
++, fputs_filtered
, fprintf_filtered
, stream
, quoter
);
1454 fputstr_unfiltered (const char *str
, int quoter
, struct ui_file
*stream
)
1457 printchar (*str
++, fputs_unfiltered
, fprintf_unfiltered
, stream
, quoter
);
1461 fputstrn_unfiltered (const char *str
, int n
, int quoter
, struct ui_file
*stream
)
1464 for (i
= 0; i
< n
; i
++)
1465 printchar (str
[i
], fputs_unfiltered
, fprintf_unfiltered
, stream
, quoter
);
1470 /* Number of lines per page or UINT_MAX if paging is disabled. */
1471 static unsigned int lines_per_page
;
1472 /* Number of chars per line or UINT_MAX if line folding is disabled. */
1473 static unsigned int chars_per_line
;
1474 /* Current count of lines printed on this page, chars on this line. */
1475 static unsigned int lines_printed
, chars_printed
;
1477 /* Buffer and start column of buffered text, for doing smarter word-
1478 wrapping. When someone calls wrap_here(), we start buffering output
1479 that comes through fputs_filtered(). If we see a newline, we just
1480 spit it out and forget about the wrap_here(). If we see another
1481 wrap_here(), we spit it out and remember the newer one. If we see
1482 the end of the line, we spit out a newline, the indent, and then
1483 the buffered output. */
1485 /* Malloc'd buffer with chars_per_line+2 bytes. Contains characters which
1486 are waiting to be output (they have already been counted in chars_printed).
1487 When wrap_buffer[0] is null, the buffer is empty. */
1488 static char *wrap_buffer
;
1490 /* Pointer in wrap_buffer to the next character to fill. */
1491 static char *wrap_pointer
;
1493 /* String to indent by if the wrap occurs. Must not be NULL if wrap_column
1495 static char *wrap_indent
;
1497 /* Column number on the screen where wrap_buffer begins, or 0 if wrapping
1498 is not in effect. */
1499 static int wrap_column
;
1502 /* Inialize the lines and chars per page */
1504 init_page_info (void)
1507 if (!tui_get_command_dimension (&chars_per_line
, &lines_per_page
))
1510 /* These defaults will be used if we are unable to get the correct
1511 values from termcap. */
1512 #if defined(__GO32__)
1513 lines_per_page
= ScreenRows ();
1514 chars_per_line
= ScreenCols ();
1516 lines_per_page
= 24;
1517 chars_per_line
= 80;
1519 #if !defined (_WIN32)
1520 /* No termcap under MPW, although might be cool to do something
1521 by looking at worksheet or console window sizes. */
1522 /* Initialize the screen height and width from termcap. */
1524 char *termtype
= getenv ("TERM");
1526 /* Positive means success, nonpositive means failure. */
1529 /* 2048 is large enough for all known terminals, according to the
1530 GNU termcap manual. */
1531 char term_buffer
[2048];
1535 status
= tgetent (term_buffer
, termtype
);
1539 int running_in_emacs
= getenv ("EMACS") != NULL
;
1541 val
= tgetnum ("li");
1542 if (val
>= 0 && !running_in_emacs
)
1543 lines_per_page
= val
;
1545 /* The number of lines per page is not mentioned
1546 in the terminal description. This probably means
1547 that paging is not useful (e.g. emacs shell window),
1548 so disable paging. */
1549 lines_per_page
= UINT_MAX
;
1551 val
= tgetnum ("co");
1553 chars_per_line
= val
;
1559 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1561 /* If there is a better way to determine the window size, use it. */
1562 SIGWINCH_HANDLER (SIGWINCH
);
1565 /* If the output is not a terminal, don't paginate it. */
1566 if (!ui_file_isatty (gdb_stdout
))
1567 lines_per_page
= UINT_MAX
;
1568 } /* the command_line_version */
1575 if (chars_per_line
== 0)
1580 wrap_buffer
= (char *) xmalloc (chars_per_line
+ 2);
1581 wrap_buffer
[0] = '\0';
1584 wrap_buffer
= (char *) xrealloc (wrap_buffer
, chars_per_line
+ 2);
1585 wrap_pointer
= wrap_buffer
; /* Start it at the beginning */
1590 set_width_command (char *args
, int from_tty
, struct cmd_list_element
*c
)
1595 /* Wait, so the user can read what's on the screen. Prompt the user
1596 to continue by pressing RETURN. */
1599 prompt_for_continue (void)
1602 char cont_prompt
[120];
1604 if (annotation_level
> 1)
1605 printf_unfiltered ("\n\032\032pre-prompt-for-continue\n");
1607 strcpy (cont_prompt
,
1608 "---Type <return> to continue, or q <return> to quit---");
1609 if (annotation_level
> 1)
1610 strcat (cont_prompt
, "\n\032\032prompt-for-continue\n");
1612 /* We must do this *before* we call gdb_readline, else it will eventually
1613 call us -- thinking that we're trying to print beyond the end of the
1615 reinitialize_more_filter ();
1618 /* On a real operating system, the user can quit with SIGINT.
1621 'q' is provided on all systems so users don't have to change habits
1622 from system to system, and because telling them what to do in
1623 the prompt is more user-friendly than expecting them to think of
1625 /* Call readline, not gdb_readline, because GO32 readline handles control-C
1626 whereas control-C to gdb_readline will cause the user to get dumped
1628 ignore
= readline (cont_prompt
);
1630 if (annotation_level
> 1)
1631 printf_unfiltered ("\n\032\032post-prompt-for-continue\n");
1636 while (*p
== ' ' || *p
== '\t')
1641 request_quit (SIGINT
);
1643 async_request_quit (0);
1649 /* Now we have to do this again, so that GDB will know that it doesn't
1650 need to save the ---Type <return>--- line at the top of the screen. */
1651 reinitialize_more_filter ();
1653 dont_repeat (); /* Forget prev cmd -- CR won't repeat it. */
1656 /* Reinitialize filter; ie. tell it to reset to original values. */
1659 reinitialize_more_filter (void)
1665 /* Indicate that if the next sequence of characters overflows the line,
1666 a newline should be inserted here rather than when it hits the end.
1667 If INDENT is non-null, it is a string to be printed to indent the
1668 wrapped part on the next line. INDENT must remain accessible until
1669 the next call to wrap_here() or until a newline is printed through
1672 If the line is already overfull, we immediately print a newline and
1673 the indentation, and disable further wrapping.
1675 If we don't know the width of lines, but we know the page height,
1676 we must not wrap words, but should still keep track of newlines
1677 that were explicitly printed.
1679 INDENT should not contain tabs, as that will mess up the char count
1680 on the next line. FIXME.
1682 This routine is guaranteed to force out any output which has been
1683 squirreled away in the wrap_buffer, so wrap_here ((char *)0) can be
1684 used to force out output from the wrap_buffer. */
1687 wrap_here (char *indent
)
1689 /* This should have been allocated, but be paranoid anyway. */
1691 internal_error (__FILE__
, __LINE__
, "failed internal consistency check");
1695 *wrap_pointer
= '\0';
1696 fputs_unfiltered (wrap_buffer
, gdb_stdout
);
1698 wrap_pointer
= wrap_buffer
;
1699 wrap_buffer
[0] = '\0';
1700 if (chars_per_line
== UINT_MAX
) /* No line overflow checking */
1704 else if (chars_printed
>= chars_per_line
)
1706 puts_filtered ("\n");
1708 puts_filtered (indent
);
1713 wrap_column
= chars_printed
;
1717 wrap_indent
= indent
;
1721 /* Ensure that whatever gets printed next, using the filtered output
1722 commands, starts at the beginning of the line. I.E. if there is
1723 any pending output for the current line, flush it and start a new
1724 line. Otherwise do nothing. */
1729 if (chars_printed
> 0)
1731 puts_filtered ("\n");
1736 /* Like fputs but if FILTER is true, pause after every screenful.
1738 Regardless of FILTER can wrap at points other than the final
1739 character of a line.
1741 Unlike fputs, fputs_maybe_filtered does not return a value.
1742 It is OK for LINEBUFFER to be NULL, in which case just don't print
1745 Note that a longjmp to top level may occur in this routine (only if
1746 FILTER is true) (since prompt_for_continue may do so) so this
1747 routine should not be called when cleanups are not in place. */
1750 fputs_maybe_filtered (const char *linebuffer
, struct ui_file
*stream
,
1753 const char *lineptr
;
1755 if (linebuffer
== 0)
1758 /* Don't do any filtering if it is disabled. */
1759 if ((stream
!= gdb_stdout
) || !pagination_enabled
1760 || (lines_per_page
== UINT_MAX
&& chars_per_line
== UINT_MAX
))
1762 fputs_unfiltered (linebuffer
, stream
);
1766 /* Go through and output each character. Show line extension
1767 when this is necessary; prompt user for new page when this is
1770 lineptr
= linebuffer
;
1773 /* Possible new page. */
1775 (lines_printed
>= lines_per_page
- 1))
1776 prompt_for_continue ();
1778 while (*lineptr
&& *lineptr
!= '\n')
1780 /* Print a single line. */
1781 if (*lineptr
== '\t')
1784 *wrap_pointer
++ = '\t';
1786 fputc_unfiltered ('\t', stream
);
1787 /* Shifting right by 3 produces the number of tab stops
1788 we have already passed, and then adding one and
1789 shifting left 3 advances to the next tab stop. */
1790 chars_printed
= ((chars_printed
>> 3) + 1) << 3;
1796 *wrap_pointer
++ = *lineptr
;
1798 fputc_unfiltered (*lineptr
, stream
);
1803 if (chars_printed
>= chars_per_line
)
1805 unsigned int save_chars
= chars_printed
;
1809 /* If we aren't actually wrapping, don't output newline --
1810 if chars_per_line is right, we probably just overflowed
1811 anyway; if it's wrong, let us keep going. */
1813 fputc_unfiltered ('\n', stream
);
1815 /* Possible new page. */
1816 if (lines_printed
>= lines_per_page
- 1)
1817 prompt_for_continue ();
1819 /* Now output indentation and wrapped string */
1822 fputs_unfiltered (wrap_indent
, stream
);
1823 *wrap_pointer
= '\0'; /* Null-terminate saved stuff */
1824 fputs_unfiltered (wrap_buffer
, stream
); /* and eject it */
1825 /* FIXME, this strlen is what prevents wrap_indent from
1826 containing tabs. However, if we recurse to print it
1827 and count its chars, we risk trouble if wrap_indent is
1828 longer than (the user settable) chars_per_line.
1829 Note also that this can set chars_printed > chars_per_line
1830 if we are printing a long string. */
1831 chars_printed
= strlen (wrap_indent
)
1832 + (save_chars
- wrap_column
);
1833 wrap_pointer
= wrap_buffer
; /* Reset buffer */
1834 wrap_buffer
[0] = '\0';
1835 wrap_column
= 0; /* And disable fancy wrap */
1840 if (*lineptr
== '\n')
1843 wrap_here ((char *) 0); /* Spit out chars, cancel further wraps */
1845 fputc_unfiltered ('\n', stream
);
1852 fputs_filtered (const char *linebuffer
, struct ui_file
*stream
)
1854 fputs_maybe_filtered (linebuffer
, stream
, 1);
1858 putchar_unfiltered (int c
)
1861 ui_file_write (gdb_stdout
, &buf
, 1);
1865 /* Write character C to gdb_stdout using GDB's paging mechanism and return C.
1866 May return nonlocally. */
1869 putchar_filtered (int c
)
1871 return fputc_filtered (c
, gdb_stdout
);
1875 fputc_unfiltered (int c
, struct ui_file
*stream
)
1878 ui_file_write (stream
, &buf
, 1);
1883 fputc_filtered (int c
, struct ui_file
*stream
)
1889 fputs_filtered (buf
, stream
);
1893 /* puts_debug is like fputs_unfiltered, except it prints special
1894 characters in printable fashion. */
1897 puts_debug (char *prefix
, char *string
, char *suffix
)
1901 /* Print prefix and suffix after each line. */
1902 static int new_line
= 1;
1903 static int return_p
= 0;
1904 static char *prev_prefix
= "";
1905 static char *prev_suffix
= "";
1907 if (*string
== '\n')
1910 /* If the prefix is changing, print the previous suffix, a new line,
1911 and the new prefix. */
1912 if ((return_p
|| (strcmp (prev_prefix
, prefix
) != 0)) && !new_line
)
1914 fputs_unfiltered (prev_suffix
, gdb_stdlog
);
1915 fputs_unfiltered ("\n", gdb_stdlog
);
1916 fputs_unfiltered (prefix
, gdb_stdlog
);
1919 /* Print prefix if we printed a newline during the previous call. */
1923 fputs_unfiltered (prefix
, gdb_stdlog
);
1926 prev_prefix
= prefix
;
1927 prev_suffix
= suffix
;
1929 /* Output characters in a printable format. */
1930 while ((ch
= *string
++) != '\0')
1936 fputc_unfiltered (ch
, gdb_stdlog
);
1939 fprintf_unfiltered (gdb_stdlog
, "\\x%02x", ch
& 0xff);
1943 fputs_unfiltered ("\\\\", gdb_stdlog
);
1946 fputs_unfiltered ("\\b", gdb_stdlog
);
1949 fputs_unfiltered ("\\f", gdb_stdlog
);
1953 fputs_unfiltered ("\\n", gdb_stdlog
);
1956 fputs_unfiltered ("\\r", gdb_stdlog
);
1959 fputs_unfiltered ("\\t", gdb_stdlog
);
1962 fputs_unfiltered ("\\v", gdb_stdlog
);
1966 return_p
= ch
== '\r';
1969 /* Print suffix if we printed a newline. */
1972 fputs_unfiltered (suffix
, gdb_stdlog
);
1973 fputs_unfiltered ("\n", gdb_stdlog
);
1978 /* Print a variable number of ARGS using format FORMAT. If this
1979 information is going to put the amount written (since the last call
1980 to REINITIALIZE_MORE_FILTER or the last page break) over the page size,
1981 call prompt_for_continue to get the users permision to continue.
1983 Unlike fprintf, this function does not return a value.
1985 We implement three variants, vfprintf (takes a vararg list and stream),
1986 fprintf (takes a stream to write on), and printf (the usual).
1988 Note also that a longjmp to top level may occur in this routine
1989 (since prompt_for_continue may do so) so this routine should not be
1990 called when cleanups are not in place. */
1993 vfprintf_maybe_filtered (struct ui_file
*stream
, const char *format
,
1994 va_list args
, int filter
)
1997 struct cleanup
*old_cleanups
;
1999 xvasprintf (&linebuffer
, format
, args
);
2000 old_cleanups
= make_cleanup (xfree
, linebuffer
);
2001 fputs_maybe_filtered (linebuffer
, stream
, filter
);
2002 do_cleanups (old_cleanups
);
2007 vfprintf_filtered (struct ui_file
*stream
, const char *format
, va_list args
)
2009 vfprintf_maybe_filtered (stream
, format
, args
, 1);
2013 vfprintf_unfiltered (struct ui_file
*stream
, const char *format
, va_list args
)
2016 struct cleanup
*old_cleanups
;
2018 xvasprintf (&linebuffer
, format
, args
);
2019 old_cleanups
= make_cleanup (xfree
, linebuffer
);
2020 fputs_unfiltered (linebuffer
, stream
);
2021 do_cleanups (old_cleanups
);
2025 vprintf_filtered (const char *format
, va_list args
)
2027 vfprintf_maybe_filtered (gdb_stdout
, format
, args
, 1);
2031 vprintf_unfiltered (const char *format
, va_list args
)
2033 vfprintf_unfiltered (gdb_stdout
, format
, args
);
2037 fprintf_filtered (struct ui_file
* stream
, const char *format
,...)
2040 va_start (args
, format
);
2041 vfprintf_filtered (stream
, format
, args
);
2046 fprintf_unfiltered (struct ui_file
* stream
, const char *format
,...)
2049 va_start (args
, format
);
2050 vfprintf_unfiltered (stream
, format
, args
);
2054 /* Like fprintf_filtered, but prints its result indented.
2055 Called as fprintfi_filtered (spaces, stream, format, ...); */
2058 fprintfi_filtered (int spaces
, struct ui_file
* stream
, const char *format
,...)
2061 va_start (args
, format
);
2062 print_spaces_filtered (spaces
, stream
);
2064 vfprintf_filtered (stream
, format
, args
);
2070 printf_filtered (const char *format
,...)
2073 va_start (args
, format
);
2074 vfprintf_filtered (gdb_stdout
, format
, args
);
2080 printf_unfiltered (const char *format
,...)
2083 va_start (args
, format
);
2084 vfprintf_unfiltered (gdb_stdout
, format
, args
);
2088 /* Like printf_filtered, but prints it's result indented.
2089 Called as printfi_filtered (spaces, format, ...); */
2092 printfi_filtered (int spaces
, const char *format
,...)
2095 va_start (args
, format
);
2096 print_spaces_filtered (spaces
, gdb_stdout
);
2097 vfprintf_filtered (gdb_stdout
, format
, args
);
2101 /* Easy -- but watch out!
2103 This routine is *not* a replacement for puts()! puts() appends a newline.
2104 This one doesn't, and had better not! */
2107 puts_filtered (const char *string
)
2109 fputs_filtered (string
, gdb_stdout
);
2113 puts_unfiltered (const char *string
)
2115 fputs_unfiltered (string
, gdb_stdout
);
2118 /* Return a pointer to N spaces and a null. The pointer is good
2119 until the next call to here. */
2124 static char *spaces
= 0;
2125 static int max_spaces
= -1;
2131 spaces
= (char *) xmalloc (n
+ 1);
2132 for (t
= spaces
+ n
; t
!= spaces
;)
2138 return spaces
+ max_spaces
- n
;
2141 /* Print N spaces. */
2143 print_spaces_filtered (int n
, struct ui_file
*stream
)
2145 fputs_filtered (n_spaces (n
), stream
);
2148 /* C++ demangler stuff. */
2150 /* fprintf_symbol_filtered attempts to demangle NAME, a symbol in language
2151 LANG, using demangling args ARG_MODE, and print it filtered to STREAM.
2152 If the name is not mangled, or the language for the name is unknown, or
2153 demangling is off, the name is printed in its "raw" form. */
2156 fprintf_symbol_filtered (struct ui_file
*stream
, char *name
, enum language lang
,
2163 /* If user wants to see raw output, no problem. */
2166 fputs_filtered (name
, stream
);
2172 case language_cplus
:
2173 demangled
= cplus_demangle (name
, arg_mode
);
2176 demangled
= cplus_demangle (name
, arg_mode
| DMGL_JAVA
);
2178 case language_chill
:
2179 demangled
= chill_demangle (name
);
2185 fputs_filtered (demangled
? demangled
: name
, stream
);
2186 if (demangled
!= NULL
)
2194 /* Do a strcmp() type operation on STRING1 and STRING2, ignoring any
2195 differences in whitespace. Returns 0 if they match, non-zero if they
2196 don't (slightly different than strcmp()'s range of return values).
2198 As an extra hack, string1=="FOO(ARGS)" matches string2=="FOO".
2199 This "feature" is useful when searching for matching C++ function names
2200 (such as if the user types 'break FOO', where FOO is a mangled C++
2204 strcmp_iw (const char *string1
, const char *string2
)
2206 while ((*string1
!= '\0') && (*string2
!= '\0'))
2208 while (isspace (*string1
))
2212 while (isspace (*string2
))
2216 if (*string1
!= *string2
)
2220 if (*string1
!= '\0')
2226 return (*string1
!= '\0' && *string1
!= '(') || (*string2
!= '\0');
2232 ** Answer whether string_to_compare is a full or partial match to
2233 ** template_string. The partial match must be in sequence starting
2237 subset_compare (char *string_to_compare
, char *template_string
)
2240 if (template_string
!= (char *) NULL
&& string_to_compare
!= (char *) NULL
&&
2241 strlen (string_to_compare
) <= strlen (template_string
))
2242 match
= (strncmp (template_string
,
2244 strlen (string_to_compare
)) == 0);
2251 static void pagination_on_command (char *arg
, int from_tty
);
2253 pagination_on_command (char *arg
, int from_tty
)
2255 pagination_enabled
= 1;
2258 static void pagination_on_command (char *arg
, int from_tty
);
2260 pagination_off_command (char *arg
, int from_tty
)
2262 pagination_enabled
= 0;
2267 initialize_utils (void)
2269 struct cmd_list_element
*c
;
2271 c
= add_set_cmd ("width", class_support
, var_uinteger
,
2272 (char *) &chars_per_line
,
2273 "Set number of characters gdb thinks are in a line.",
2275 add_show_from_set (c
, &showlist
);
2276 c
->function
.sfunc
= set_width_command
;
2279 (add_set_cmd ("height", class_support
,
2280 var_uinteger
, (char *) &lines_per_page
,
2281 "Set number of lines gdb thinks are in a page.", &setlist
),
2286 /* If the output is not a terminal, don't paginate it. */
2287 if (!ui_file_isatty (gdb_stdout
))
2288 lines_per_page
= UINT_MAX
;
2290 set_width_command ((char *) NULL
, 0, c
);
2293 (add_set_cmd ("demangle", class_support
, var_boolean
,
2295 "Set demangling of encoded C++ names when displaying symbols.",
2300 (add_set_cmd ("pagination", class_support
,
2301 var_boolean
, (char *) &pagination_enabled
,
2302 "Set state of pagination.", &setlist
),
2307 add_com ("am", class_support
, pagination_on_command
,
2308 "Enable pagination");
2309 add_com ("sm", class_support
, pagination_off_command
,
2310 "Disable pagination");
2314 (add_set_cmd ("sevenbit-strings", class_support
, var_boolean
,
2315 (char *) &sevenbit_strings
,
2316 "Set printing of 8-bit characters in strings as \\nnn.",
2321 (add_set_cmd ("asm-demangle", class_support
, var_boolean
,
2322 (char *) &asm_demangle
,
2323 "Set demangling of C++ names in disassembly listings.",
2328 /* Machine specific function to handle SIGWINCH signal. */
2330 #ifdef SIGWINCH_HANDLER_BODY
2331 SIGWINCH_HANDLER_BODY
2334 /* print routines to handle variable size regs, etc. */
2336 /* temporary storage using circular buffer */
2342 static char buf
[NUMCELLS
][CELLSIZE
];
2343 static int cell
= 0;
2344 if (++cell
>= NUMCELLS
)
2352 return (TARGET_ADDR_BIT
/ 8 * 2);
2356 paddr (CORE_ADDR addr
)
2358 return phex (addr
, TARGET_ADDR_BIT
/ 8);
2362 paddr_nz (CORE_ADDR addr
)
2364 return phex_nz (addr
, TARGET_ADDR_BIT
/ 8);
2368 decimal2str (char *paddr_str
, char *sign
, ULONGEST addr
)
2370 /* steal code from valprint.c:print_decimal(). Should this worry
2371 about the real size of addr as the above does? */
2372 unsigned long temp
[3];
2376 temp
[i
] = addr
% (1000 * 1000 * 1000);
2377 addr
/= (1000 * 1000 * 1000);
2380 while (addr
!= 0 && i
< (sizeof (temp
) / sizeof (temp
[0])));
2384 sprintf (paddr_str
, "%s%lu",
2388 sprintf (paddr_str
, "%s%lu%09lu",
2389 sign
, temp
[1], temp
[0]);
2392 sprintf (paddr_str
, "%s%lu%09lu%09lu",
2393 sign
, temp
[2], temp
[1], temp
[0]);
2396 internal_error (__FILE__
, __LINE__
, "failed internal consistency check");
2401 paddr_u (CORE_ADDR addr
)
2403 char *paddr_str
= get_cell ();
2404 decimal2str (paddr_str
, "", addr
);
2409 paddr_d (LONGEST addr
)
2411 char *paddr_str
= get_cell ();
2413 decimal2str (paddr_str
, "-", -addr
);
2415 decimal2str (paddr_str
, "", addr
);
2419 /* eliminate warning from compiler on 32-bit systems */
2420 static int thirty_two
= 32;
2423 phex (ULONGEST l
, int sizeof_l
)
2430 sprintf (str
, "%08lx%08lx",
2431 (unsigned long) (l
>> thirty_two
),
2432 (unsigned long) (l
& 0xffffffff));
2436 sprintf (str
, "%08lx", (unsigned long) l
);
2440 sprintf (str
, "%04x", (unsigned short) (l
& 0xffff));
2443 str
= phex (l
, sizeof (l
));
2450 phex_nz (ULONGEST l
, int sizeof_l
)
2457 unsigned long high
= (unsigned long) (l
>> thirty_two
);
2460 sprintf (str
, "%lx", (unsigned long) (l
& 0xffffffff));
2462 sprintf (str
, "%lx%08lx",
2463 high
, (unsigned long) (l
& 0xffffffff));
2468 sprintf (str
, "%lx", (unsigned long) l
);
2472 sprintf (str
, "%x", (unsigned short) (l
& 0xffff));
2475 str
= phex_nz (l
, sizeof (l
));
2482 /* Convert to / from the hosts pointer to GDB's internal CORE_ADDR
2483 using the target's conversion routines. */
2485 host_pointer_to_address (void *ptr
)
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 return POINTER_TO_ADDRESS (builtin_type_void_data_ptr
, &ptr
);
2494 address_to_host_pointer (CORE_ADDR addr
)
2497 if (sizeof (ptr
) != TYPE_LENGTH (builtin_type_void_data_ptr
))
2498 internal_error (__FILE__
, __LINE__
,
2499 "core_addr_to_void_ptr: bad cast");
2500 ADDRESS_TO_POINTER (builtin_type_void_data_ptr
, &ptr
, addr
);
2504 /* Convert a CORE_ADDR into a string. */
2506 core_addr_to_string (const CORE_ADDR addr
)
2508 char *str
= get_cell ();
2510 strcat (str
, phex_nz (addr
, sizeof (addr
)));
2514 /* Convert a string back into a CORE_ADDR. */
2516 string_to_core_addr (const char *my_string
)
2519 if (my_string
[0] == '0' && tolower (my_string
[1]) == 'x')
2521 /* Assume that it is in decimal. */
2523 for (i
= 2; my_string
[i
] != '\0'; i
++)
2525 if (isdigit (my_string
[i
]))
2526 addr
= (my_string
[i
] - '0') + (addr
* 16);
2527 else if (isxdigit (my_string
[i
]))
2528 addr
= (tolower (my_string
[i
]) - 'a' + 0xa) + (addr
* 16);
2530 internal_error (__FILE__
, __LINE__
, "invalid hex");
2535 /* Assume that it is in decimal. */
2537 for (i
= 0; my_string
[i
] != '\0'; i
++)
2539 if (isdigit (my_string
[i
]))
2540 addr
= (my_string
[i
] - '0') + (addr
* 10);
2542 internal_error (__FILE__
, __LINE__
, "invalid decimal");