1 /* General utility routines for GDB, the GNU debugger.
2 Copyright 1986, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995,
3 1996, 1997, 1998, 1999, 2000, 2001, 2002
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. */
23 /* FIXME: cagney/2002-02-28: The GDB coding standard indicates that
24 "defs.h" should be included first. Unfortunatly some systems
25 (currently Debian GNU/Linux) include the <stdbool.h> via <curses.h>
26 and they clash with "bfd.h"'s definiton of true/false. The correct
27 fix is to remove true/false from "bfd.h", however, until that
28 happens, hack around it by including "config.h" and <curses.h>
41 #include "gdb_assert.h"
43 #include "gdb_string.h"
44 #include "event-top.h"
50 /* SunOS's curses.h has a '#define reg register' in it. Thank you Sun. */
61 #include "expression.h"
65 #include "inferior.h" /* for signed_pointer_to_address */
67 #include <sys/param.h> /* For MAXPATHLEN */
69 #include <readline/readline.h>
75 #ifdef NEED_DECLARATION_MALLOC
78 #ifdef NEED_DECLARATION_REALLOC
79 extern PTR
realloc ();
81 #ifdef NEED_DECLARATION_FREE
86 #define XMALLOC(TYPE) ((TYPE*) xmalloc (sizeof (TYPE)))
88 /* readline defines this. */
91 void (*error_begin_hook
) (void);
93 /* Holds the last error message issued by gdb */
95 static struct ui_file
*gdb_lasterr
;
97 /* Prototypes for local functions */
99 static void vfprintf_maybe_filtered (struct ui_file
*, const char *,
102 static void fputs_maybe_filtered (const char *, struct ui_file
*, int);
104 #if defined (USE_MMALLOC) && !defined (NO_MMCHECK)
105 static void malloc_botch (void);
108 static void prompt_for_continue (void);
110 static void set_width_command (char *, int, struct cmd_list_element
*);
112 static void set_width (void);
114 /* Chain of cleanup actions established with make_cleanup,
115 to be executed if an error happens. */
117 static struct cleanup
*cleanup_chain
; /* cleaned up after a failed command */
118 static struct cleanup
*final_cleanup_chain
; /* cleaned up when gdb exits */
119 static struct cleanup
*run_cleanup_chain
; /* cleaned up on each 'run' */
120 static struct cleanup
*exec_cleanup_chain
; /* cleaned up on each execution command */
121 /* cleaned up on each error from within an execution command */
122 static struct cleanup
*exec_error_cleanup_chain
;
124 /* Pointer to what is left to do for an execution command after the
125 target stops. Used only in asynchronous mode, by targets that
126 support async execution. The finish and until commands use it. So
127 does the target extended-remote command. */
128 struct continuation
*cmd_continuation
;
129 struct continuation
*intermediate_continuation
;
131 /* Nonzero if we have job control. */
135 /* Nonzero means a quit has been requested. */
139 /* Nonzero means quit immediately if Control-C is typed now, rather
140 than waiting until QUIT is executed. Be careful in setting this;
141 code which executes with immediate_quit set has to be very careful
142 about being able to deal with being interrupted at any time. It is
143 almost always better to use QUIT; the only exception I can think of
144 is being able to quit out of a system call (using EINTR loses if
145 the SIGINT happens between the previous QUIT and the system call).
146 To immediately quit in the case in which a SIGINT happens between
147 the previous QUIT and setting immediate_quit (desirable anytime we
148 expect to block), call QUIT after setting immediate_quit. */
152 /* Nonzero means that encoded C++ names should be printed out in their
153 C++ form rather than raw. */
157 /* Nonzero means that encoded C++ names should be printed out in their
158 C++ form even in assembler language displays. If this is set, but
159 DEMANGLE is zero, names are printed raw, i.e. DEMANGLE controls. */
161 int asm_demangle
= 0;
163 /* Nonzero means that strings with character values >0x7F should be printed
164 as octal escapes. Zero means just print the value (e.g. it's an
165 international character, and the terminal or window can cope.) */
167 int sevenbit_strings
= 0;
169 /* String to be printed before error messages, if any. */
171 char *error_pre_print
;
173 /* String to be printed before quit messages, if any. */
175 char *quit_pre_print
;
177 /* String to be printed before warning messages, if any. */
179 char *warning_pre_print
= "\nwarning: ";
181 int pagination_enabled
= 1;
184 /* Add a new cleanup to the cleanup_chain,
185 and return the previous chain pointer
186 to be passed later to do_cleanups or discard_cleanups.
187 Args are FUNCTION to clean up with, and ARG to pass to it. */
190 make_cleanup (make_cleanup_ftype
*function
, void *arg
)
192 return make_my_cleanup (&cleanup_chain
, function
, arg
);
196 make_final_cleanup (make_cleanup_ftype
*function
, void *arg
)
198 return make_my_cleanup (&final_cleanup_chain
, function
, arg
);
202 make_run_cleanup (make_cleanup_ftype
*function
, void *arg
)
204 return make_my_cleanup (&run_cleanup_chain
, function
, arg
);
208 make_exec_cleanup (make_cleanup_ftype
*function
, void *arg
)
210 return make_my_cleanup (&exec_cleanup_chain
, function
, arg
);
214 make_exec_error_cleanup (make_cleanup_ftype
*function
, void *arg
)
216 return make_my_cleanup (&exec_error_cleanup_chain
, function
, arg
);
220 do_freeargv (void *arg
)
222 freeargv ((char **) arg
);
226 make_cleanup_freeargv (char **arg
)
228 return make_my_cleanup (&cleanup_chain
, do_freeargv
, arg
);
232 do_bfd_close_cleanup (void *arg
)
238 make_cleanup_bfd_close (bfd
*abfd
)
240 return make_cleanup (do_bfd_close_cleanup
, abfd
);
244 do_close_cleanup (void *arg
)
252 make_cleanup_close (int fd
)
254 int *saved_fd
= xmalloc (sizeof (fd
));
256 return make_cleanup (do_close_cleanup
, saved_fd
);
260 do_ui_file_delete (void *arg
)
262 ui_file_delete (arg
);
266 make_cleanup_ui_file_delete (struct ui_file
*arg
)
268 return make_my_cleanup (&cleanup_chain
, do_ui_file_delete
, arg
);
272 make_my_cleanup (struct cleanup
**pmy_chain
, make_cleanup_ftype
*function
,
275 register struct cleanup
*new
276 = (struct cleanup
*) xmalloc (sizeof (struct cleanup
));
277 register struct cleanup
*old_chain
= *pmy_chain
;
279 new->next
= *pmy_chain
;
280 new->function
= function
;
287 /* Discard cleanups and do the actions they describe
288 until we get back to the point OLD_CHAIN in the cleanup_chain. */
291 do_cleanups (register struct cleanup
*old_chain
)
293 do_my_cleanups (&cleanup_chain
, old_chain
);
297 do_final_cleanups (register struct cleanup
*old_chain
)
299 do_my_cleanups (&final_cleanup_chain
, old_chain
);
303 do_run_cleanups (register struct cleanup
*old_chain
)
305 do_my_cleanups (&run_cleanup_chain
, old_chain
);
309 do_exec_cleanups (register struct cleanup
*old_chain
)
311 do_my_cleanups (&exec_cleanup_chain
, old_chain
);
315 do_exec_error_cleanups (register struct cleanup
*old_chain
)
317 do_my_cleanups (&exec_error_cleanup_chain
, old_chain
);
321 do_my_cleanups (register struct cleanup
**pmy_chain
,
322 register struct cleanup
*old_chain
)
324 register struct cleanup
*ptr
;
325 while ((ptr
= *pmy_chain
) != old_chain
)
327 *pmy_chain
= ptr
->next
; /* Do this first incase recursion */
328 (*ptr
->function
) (ptr
->arg
);
333 /* Discard cleanups, not doing the actions they describe,
334 until we get back to the point OLD_CHAIN in the cleanup_chain. */
337 discard_cleanups (register struct cleanup
*old_chain
)
339 discard_my_cleanups (&cleanup_chain
, old_chain
);
343 discard_final_cleanups (register struct cleanup
*old_chain
)
345 discard_my_cleanups (&final_cleanup_chain
, old_chain
);
349 discard_exec_error_cleanups (register struct cleanup
*old_chain
)
351 discard_my_cleanups (&exec_error_cleanup_chain
, old_chain
);
355 discard_my_cleanups (register struct cleanup
**pmy_chain
,
356 register struct cleanup
*old_chain
)
358 register struct cleanup
*ptr
;
359 while ((ptr
= *pmy_chain
) != old_chain
)
361 *pmy_chain
= ptr
->next
;
366 /* Set the cleanup_chain to 0, and return the old cleanup chain. */
370 return save_my_cleanups (&cleanup_chain
);
374 save_final_cleanups (void)
376 return save_my_cleanups (&final_cleanup_chain
);
380 save_my_cleanups (struct cleanup
**pmy_chain
)
382 struct cleanup
*old_chain
= *pmy_chain
;
388 /* Restore the cleanup chain from a previously saved chain. */
390 restore_cleanups (struct cleanup
*chain
)
392 restore_my_cleanups (&cleanup_chain
, chain
);
396 restore_final_cleanups (struct cleanup
*chain
)
398 restore_my_cleanups (&final_cleanup_chain
, chain
);
402 restore_my_cleanups (struct cleanup
**pmy_chain
, struct cleanup
*chain
)
407 /* This function is useful for cleanups.
411 old_chain = make_cleanup (free_current_contents, &foo);
413 to arrange to free the object thus allocated. */
416 free_current_contents (void *ptr
)
418 void **location
= ptr
;
419 if (location
== NULL
)
420 internal_error (__FILE__
, __LINE__
,
421 "free_current_contents: NULL pointer");
422 if (*location
!= NULL
)
429 /* Provide a known function that does nothing, to use as a base for
430 for a possibly long chain of cleanups. This is useful where we
431 use the cleanup chain for handling normal cleanups as well as dealing
432 with cleanups that need to be done as a result of a call to error().
433 In such cases, we may not be certain where the first cleanup is, unless
434 we have a do-nothing one to always use as the base. */
438 null_cleanup (void *arg
)
442 /* Add a continuation to the continuation list, the global list
443 cmd_continuation. The new continuation will be added at the front.*/
445 add_continuation (void (*continuation_hook
) (struct continuation_arg
*),
446 struct continuation_arg
*arg_list
)
448 struct continuation
*continuation_ptr
;
450 continuation_ptr
= (struct continuation
*) xmalloc (sizeof (struct continuation
));
451 continuation_ptr
->continuation_hook
= continuation_hook
;
452 continuation_ptr
->arg_list
= arg_list
;
453 continuation_ptr
->next
= cmd_continuation
;
454 cmd_continuation
= continuation_ptr
;
457 /* Walk down the cmd_continuation list, and execute all the
458 continuations. There is a problem though. In some cases new
459 continuations may be added while we are in the middle of this
460 loop. If this happens they will be added in the front, and done
461 before we have a chance of exhausting those that were already
462 there. We need to then save the beginning of the list in a pointer
463 and do the continuations from there on, instead of using the
464 global beginning of list as our iteration pointer.*/
466 do_all_continuations (void)
468 struct continuation
*continuation_ptr
;
469 struct continuation
*saved_continuation
;
471 /* Copy the list header into another pointer, and set the global
472 list header to null, so that the global list can change as a side
473 effect of invoking the continuations and the processing of
474 the preexisting continuations will not be affected. */
475 continuation_ptr
= cmd_continuation
;
476 cmd_continuation
= NULL
;
478 /* Work now on the list we have set aside. */
479 while (continuation_ptr
)
481 (continuation_ptr
->continuation_hook
) (continuation_ptr
->arg_list
);
482 saved_continuation
= continuation_ptr
;
483 continuation_ptr
= continuation_ptr
->next
;
484 xfree (saved_continuation
);
488 /* Walk down the cmd_continuation list, and get rid of all the
491 discard_all_continuations (void)
493 struct continuation
*continuation_ptr
;
495 while (cmd_continuation
)
497 continuation_ptr
= cmd_continuation
;
498 cmd_continuation
= continuation_ptr
->next
;
499 xfree (continuation_ptr
);
503 /* Add a continuation to the continuation list, the global list
504 intermediate_continuation. The new continuation will be added at the front.*/
506 add_intermediate_continuation (void (*continuation_hook
)
507 (struct continuation_arg
*),
508 struct continuation_arg
*arg_list
)
510 struct continuation
*continuation_ptr
;
512 continuation_ptr
= (struct continuation
*) xmalloc (sizeof (struct continuation
));
513 continuation_ptr
->continuation_hook
= continuation_hook
;
514 continuation_ptr
->arg_list
= arg_list
;
515 continuation_ptr
->next
= intermediate_continuation
;
516 intermediate_continuation
= continuation_ptr
;
519 /* Walk down the cmd_continuation list, and execute all the
520 continuations. There is a problem though. In some cases new
521 continuations may be added while we are in the middle of this
522 loop. If this happens they will be added in the front, and done
523 before we have a chance of exhausting those that were already
524 there. We need to then save the beginning of the list in a pointer
525 and do the continuations from there on, instead of using the
526 global beginning of list as our iteration pointer.*/
528 do_all_intermediate_continuations (void)
530 struct continuation
*continuation_ptr
;
531 struct continuation
*saved_continuation
;
533 /* Copy the list header into another pointer, and set the global
534 list header to null, so that the global list can change as a side
535 effect of invoking the continuations and the processing of
536 the preexisting continuations will not be affected. */
537 continuation_ptr
= intermediate_continuation
;
538 intermediate_continuation
= NULL
;
540 /* Work now on the list we have set aside. */
541 while (continuation_ptr
)
543 (continuation_ptr
->continuation_hook
) (continuation_ptr
->arg_list
);
544 saved_continuation
= continuation_ptr
;
545 continuation_ptr
= continuation_ptr
->next
;
546 xfree (saved_continuation
);
550 /* Walk down the cmd_continuation list, and get rid of all the
553 discard_all_intermediate_continuations (void)
555 struct continuation
*continuation_ptr
;
557 while (intermediate_continuation
)
559 continuation_ptr
= intermediate_continuation
;
560 intermediate_continuation
= continuation_ptr
->next
;
561 xfree (continuation_ptr
);
567 /* Print a warning message. The first argument STRING is the warning
568 message, used as an fprintf format string, the second is the
569 va_list of arguments for that string. A warning is unfiltered (not
570 paginated) so that the user does not need to page through each
571 screen full of warnings when there are lots of them. */
574 vwarning (const char *string
, va_list args
)
577 (*warning_hook
) (string
, args
);
580 target_terminal_ours ();
581 wrap_here (""); /* Force out any buffered output */
582 gdb_flush (gdb_stdout
);
583 if (warning_pre_print
)
584 fprintf_unfiltered (gdb_stderr
, warning_pre_print
);
585 vfprintf_unfiltered (gdb_stderr
, string
, args
);
586 fprintf_unfiltered (gdb_stderr
, "\n");
591 /* Print a warning message.
592 The first argument STRING is the warning message, used as a fprintf string,
593 and the remaining args are passed as arguments to it.
594 The primary difference between warnings and errors is that a warning
595 does not force the return to command level. */
598 warning (const char *string
,...)
601 va_start (args
, string
);
602 vwarning (string
, args
);
606 /* Print an error message and return to command level.
607 The first argument STRING is the error message, used as a fprintf string,
608 and the remaining args are passed as arguments to it. */
611 verror (const char *string
, va_list args
)
613 struct ui_file
*tmp_stream
= mem_fileopen ();
614 make_cleanup_ui_file_delete (tmp_stream
);
615 vfprintf_unfiltered (tmp_stream
, string
, args
);
616 error_stream (tmp_stream
);
620 error (const char *string
,...)
623 va_start (args
, string
);
624 verror (string
, args
);
629 do_write (void *data
, const char *buffer
, long length_buffer
)
631 ui_file_write (data
, buffer
, length_buffer
);
635 error_stream (struct ui_file
*stream
)
637 if (error_begin_hook
)
640 /* Copy the stream into the GDB_LASTERR buffer. */
641 ui_file_rewind (gdb_lasterr
);
642 ui_file_put (stream
, do_write
, gdb_lasterr
);
644 /* Write the message plus any error_pre_print to gdb_stderr. */
645 target_terminal_ours ();
646 wrap_here (""); /* Force out any buffered output */
647 gdb_flush (gdb_stdout
);
648 annotate_error_begin ();
650 fprintf_filtered (gdb_stderr
, error_pre_print
);
651 ui_file_put (stream
, do_write
, gdb_stderr
);
652 fprintf_filtered (gdb_stderr
, "\n");
654 throw_exception (RETURN_ERROR
);
657 /* Get the last error message issued by gdb */
660 error_last_message (void)
663 return ui_file_xstrdup (gdb_lasterr
, &len
);
666 /* This is to be called by main() at the very beginning */
671 gdb_lasterr
= mem_fileopen ();
674 /* Print a message reporting an internal error. Ask the user if they
675 want to continue, dump core, or just exit. */
678 internal_verror (const char *file
, int line
,
679 const char *fmt
, va_list ap
)
681 static char msg
[] = "Internal GDB error: recursive internal error.\n";
682 static int dejavu
= 0;
686 /* don't allow infinite error recursion. */
694 fputs_unfiltered (msg
, gdb_stderr
);
695 abort (); /* NOTE: GDB has only three calls to abort(). */
698 write (STDERR_FILENO
, msg
, sizeof (msg
));
702 /* Try to get the message out */
703 target_terminal_ours ();
704 fprintf_unfiltered (gdb_stderr
, "%s:%d: gdb-internal-error: ", file
, line
);
705 vfprintf_unfiltered (gdb_stderr
, fmt
, ap
);
706 fputs_unfiltered ("\n", gdb_stderr
);
708 /* Default (yes/batch case) is to quit GDB. When in batch mode this
709 lessens the likelhood of GDB going into an infinate loop. */
711 An internal GDB error was detected. This may make further\n\
712 debugging unreliable. Quit this debugging session? ");
714 /* Default (yes/batch case) is to dump core. This leaves a GDB
715 dropping so that it is easier to see that something went wrong to
717 dump_core_p
= query ("\
718 Create a core file containing the current state of GDB? ");
723 abort (); /* NOTE: GDB has only three calls to abort(). */
732 abort (); /* NOTE: GDB has only three calls to abort(). */
737 throw_exception (RETURN_ERROR
);
741 internal_error (const char *file
, int line
, const char *string
, ...)
744 va_start (ap
, string
);
746 internal_verror (file
, line
, string
, ap
);
750 /* The strerror() function can return NULL for errno values that are
751 out of range. Provide a "safe" version that always returns a
755 safe_strerror (int errnum
)
760 if ((msg
= strerror (errnum
)) == NULL
)
762 sprintf (buf
, "(undocumented errno %d)", errnum
);
768 /* Print the system error message for errno, and also mention STRING
769 as the file name for which the error was encountered.
770 Then return to command level. */
773 perror_with_name (const char *string
)
778 err
= safe_strerror (errno
);
779 combined
= (char *) alloca (strlen (err
) + strlen (string
) + 3);
780 strcpy (combined
, string
);
781 strcat (combined
, ": ");
782 strcat (combined
, err
);
784 /* I understand setting these is a matter of taste. Still, some people
785 may clear errno but not know about bfd_error. Doing this here is not
787 bfd_set_error (bfd_error_no_error
);
790 error ("%s.", combined
);
793 /* Print the system error message for ERRCODE, and also mention STRING
794 as the file name for which the error was encountered. */
797 print_sys_errmsg (const char *string
, int errcode
)
802 err
= safe_strerror (errcode
);
803 combined
= (char *) alloca (strlen (err
) + strlen (string
) + 3);
804 strcpy (combined
, string
);
805 strcat (combined
, ": ");
806 strcat (combined
, err
);
808 /* We want anything which was printed on stdout to come out first, before
810 gdb_flush (gdb_stdout
);
811 fprintf_unfiltered (gdb_stderr
, "%s.\n", combined
);
814 /* Control C eventually causes this to be called, at a convenient time. */
819 struct serial
*gdb_stdout_serial
= serial_fdopen (1);
821 target_terminal_ours ();
823 /* We want all output to appear now, before we print "Quit". We
824 have 3 levels of buffering we have to flush (it's possible that
825 some of these should be changed to flush the lower-level ones
828 /* 1. The _filtered buffer. */
829 wrap_here ((char *) 0);
831 /* 2. The stdio buffer. */
832 gdb_flush (gdb_stdout
);
833 gdb_flush (gdb_stderr
);
835 /* 3. The system-level buffer. */
836 serial_drain_output (gdb_stdout_serial
);
837 serial_un_fdopen (gdb_stdout_serial
);
839 annotate_error_begin ();
841 /* Don't use *_filtered; we don't want to prompt the user to continue. */
843 fprintf_unfiltered (gdb_stderr
, quit_pre_print
);
846 /* No steenking SIGINT will ever be coming our way when the
847 program is resumed. Don't lie. */
848 fprintf_unfiltered (gdb_stderr
, "Quit\n");
851 /* If there is no terminal switching for this target, then we can't
852 possibly get screwed by the lack of job control. */
853 || current_target
.to_terminal_ours
== NULL
)
854 fprintf_unfiltered (gdb_stderr
, "Quit\n");
856 fprintf_unfiltered (gdb_stderr
,
857 "Quit (expect signal SIGINT when the program is resumed)\n");
859 throw_exception (RETURN_QUIT
);
862 /* Control C comes here */
864 request_quit (int signo
)
867 /* Restore the signal handler. Harmless with BSD-style signals, needed
868 for System V-style signals. So just always do it, rather than worrying
869 about USG defines and stuff like that. */
870 signal (signo
, request_quit
);
880 /* Memory management stuff (malloc friends). */
882 #if !defined (USE_MMALLOC)
884 /* NOTE: These must use PTR so that their definition matches the
885 declaration found in "mmalloc.h". */
888 mmalloc (void *md
, size_t size
)
890 return malloc (size
); /* NOTE: GDB's only call to malloc() */
894 mrealloc (void *md
, void *ptr
, size_t size
)
896 if (ptr
== 0) /* Guard against old realloc's */
897 return mmalloc (md
, size
);
899 return realloc (ptr
, size
); /* NOTE: GDB's only call to ralloc() */
903 mcalloc (void *md
, size_t number
, size_t size
)
905 return calloc (number
, size
); /* NOTE: GDB's only call to calloc() */
909 mfree (void *md
, void *ptr
)
911 free (ptr
); /* NOTE: GDB's only call to free() */
914 #endif /* USE_MMALLOC */
916 #if !defined (USE_MMALLOC) || defined (NO_MMCHECK)
919 init_malloc (void *md
)
923 #else /* Have mmalloc and want corruption checking */
928 fprintf_unfiltered (gdb_stderr
, "Memory corruption\n");
929 internal_error (__FILE__
, __LINE__
, "failed internal consistency check");
932 /* Attempt to install hooks in mmalloc/mrealloc/mfree for the heap specified
933 by MD, to detect memory corruption. Note that MD may be NULL to specify
934 the default heap that grows via sbrk.
936 Note that for freshly created regions, we must call mmcheckf prior to any
937 mallocs in the region. Otherwise, any region which was allocated prior to
938 installing the checking hooks, which is later reallocated or freed, will
939 fail the checks! The mmcheck function only allows initial hooks to be
940 installed before the first mmalloc. However, anytime after we have called
941 mmcheck the first time to install the checking hooks, we can call it again
942 to update the function pointer to the memory corruption handler.
944 Returns zero on failure, non-zero on success. */
946 #ifndef MMCHECK_FORCE
947 #define MMCHECK_FORCE 0
951 init_malloc (void *md
)
953 if (!mmcheckf (md
, malloc_botch
, MMCHECK_FORCE
))
955 /* Don't use warning(), which relies on current_target being set
956 to something other than dummy_target, until after
957 initialize_all_files(). */
960 (gdb_stderr
, "warning: failed to install memory consistency checks; ");
962 (gdb_stderr
, "configuration should define NO_MMCHECK or MMCHECK_FORCE\n");
968 #endif /* Have mmalloc and want corruption checking */
970 /* Called when a memory allocation fails, with the number of bytes of
971 memory requested in SIZE. */
978 internal_error (__FILE__
, __LINE__
,
979 "virtual memory exhausted: can't allocate %ld bytes.", size
);
983 internal_error (__FILE__
, __LINE__
,
984 "virtual memory exhausted.");
988 /* The xmmalloc() family of memory management routines.
990 These are are like the mmalloc() family except that they implement
991 consistent semantics and guard against typical memory management
992 problems: if a malloc fails, an internal error is thrown; if
993 free(NULL) is called, it is ignored; if *alloc(0) is called, NULL
996 All these routines are implemented using the mmalloc() family. */
999 xmmalloc (void *md
, size_t size
)
1009 val
= mmalloc (md
, size
);
1017 xmrealloc (void *md
, void *ptr
, size_t size
)
1031 val
= mrealloc (md
, ptr
, size
);
1035 val
= mmalloc (md
, size
);
1046 xmcalloc (void *md
, size_t number
, size_t size
)
1049 if (number
== 0 || size
== 0)
1053 mem
= mcalloc (md
, number
, size
);
1055 nomem (number
* size
);
1061 xmfree (void *md
, void *ptr
)
1067 /* The xmalloc() (libiberty.h) family of memory management routines.
1069 These are like the ISO-C malloc() family except that they implement
1070 consistent semantics and guard against typical memory management
1071 problems. See xmmalloc() above for further information.
1073 All these routines are wrappers to the xmmalloc() family. */
1075 /* NOTE: These are declared using PTR to ensure consistency with
1076 "libiberty.h". xfree() is GDB local. */
1079 xmalloc (size_t size
)
1081 return xmmalloc (NULL
, size
);
1085 xrealloc (PTR ptr
, size_t size
)
1087 return xmrealloc (NULL
, ptr
, size
);
1091 xcalloc (size_t number
, size_t size
)
1093 return xmcalloc (NULL
, number
, size
);
1103 /* Like asprintf/vasprintf but get an internal_error if the call
1107 xasprintf (char **ret
, const char *format
, ...)
1110 va_start (args
, format
);
1111 xvasprintf (ret
, format
, args
);
1116 xvasprintf (char **ret
, const char *format
, va_list ap
)
1118 int status
= vasprintf (ret
, format
, ap
);
1119 /* NULL could be returned due to a memory allocation problem; a
1120 badly format string; or something else. */
1122 internal_error (__FILE__
, __LINE__
,
1123 "vasprintf returned NULL buffer (errno %d)",
1125 /* A negative status with a non-NULL buffer shouldn't never
1126 happen. But to be sure. */
1128 internal_error (__FILE__
, __LINE__
,
1129 "vasprintf call failed (errno %d)",
1134 /* My replacement for the read system call.
1135 Used like `read' but keeps going if `read' returns too soon. */
1138 myread (int desc
, char *addr
, int len
)
1145 val
= read (desc
, addr
, len
);
1149 return orglen
- len
;
1156 /* Make a copy of the string at PTR with SIZE characters
1157 (and add a null character at the end in the copy).
1158 Uses malloc to get the space. Returns the address of the copy. */
1161 savestring (const char *ptr
, size_t size
)
1163 register char *p
= (char *) xmalloc (size
+ 1);
1164 memcpy (p
, ptr
, size
);
1170 msavestring (void *md
, const char *ptr
, size_t size
)
1172 register char *p
= (char *) xmmalloc (md
, size
+ 1);
1173 memcpy (p
, ptr
, size
);
1179 mstrsave (void *md
, const char *ptr
)
1181 return (msavestring (md
, ptr
, strlen (ptr
)));
1185 print_spaces (register int n
, register struct ui_file
*file
)
1187 fputs_unfiltered (n_spaces (n
), file
);
1190 /* Print a host address. */
1193 gdb_print_host_address (void *addr
, struct ui_file
*stream
)
1196 /* We could use the %p conversion specifier to fprintf if we had any
1197 way of knowing whether this host supports it. But the following
1198 should work on the Alpha and on 32 bit machines. */
1200 fprintf_filtered (stream
, "0x%lx", (unsigned long) addr
);
1203 /* Ask user a y-or-n question and return 1 iff answer is yes.
1204 Takes three args which are given to printf to print the question.
1205 The first, a control string, should end in "? ".
1206 It should not say how to answer, because we do that. */
1210 query (const char *ctlstr
,...)
1213 register int answer
;
1217 va_start (args
, ctlstr
);
1221 return query_hook (ctlstr
, args
);
1224 /* Automatically answer "yes" if input is not from a terminal. */
1225 if (!input_from_terminal_p ())
1230 wrap_here (""); /* Flush any buffered output */
1231 gdb_flush (gdb_stdout
);
1233 if (annotation_level
> 1)
1234 printf_filtered ("\n\032\032pre-query\n");
1236 vfprintf_filtered (gdb_stdout
, ctlstr
, args
);
1237 printf_filtered ("(y or n) ");
1239 if (annotation_level
> 1)
1240 printf_filtered ("\n\032\032query\n");
1243 gdb_flush (gdb_stdout
);
1245 answer
= fgetc (stdin
);
1246 clearerr (stdin
); /* in case of C-d */
1247 if (answer
== EOF
) /* C-d */
1252 /* Eat rest of input line, to EOF or newline */
1256 ans2
= fgetc (stdin
);
1259 while (ans2
!= EOF
&& ans2
!= '\n' && ans2
!= '\r');
1273 printf_filtered ("Please answer y or n.\n");
1276 if (annotation_level
> 1)
1277 printf_filtered ("\n\032\032post-query\n");
1282 /* Parse a C escape sequence. STRING_PTR points to a variable
1283 containing a pointer to the string to parse. That pointer
1284 should point to the character after the \. That pointer
1285 is updated past the characters we use. The value of the
1286 escape sequence is returned.
1288 A negative value means the sequence \ newline was seen,
1289 which is supposed to be equivalent to nothing at all.
1291 If \ is followed by a null character, we return a negative
1292 value and leave the string pointer pointing at the null character.
1294 If \ is followed by 000, we return 0 and leave the string pointer
1295 after the zeros. A value of 0 does not mean end of string. */
1298 parse_escape (char **string_ptr
)
1300 register int c
= *(*string_ptr
)++;
1304 return 007; /* Bell (alert) char */
1307 case 'e': /* Escape character */
1325 c
= *(*string_ptr
)++;
1327 c
= parse_escape (string_ptr
);
1330 return (c
& 0200) | (c
& 037);
1341 register int i
= c
- '0';
1342 register int count
= 0;
1345 if ((c
= *(*string_ptr
)++) >= '0' && c
<= '7')
1363 /* Print the character C on STREAM as part of the contents of a literal
1364 string whose delimiter is QUOTER. Note that this routine should only
1365 be call for printing things which are independent of the language
1366 of the program being debugged. */
1369 printchar (int c
, void (*do_fputs
) (const char *, struct ui_file
*),
1370 void (*do_fprintf
) (struct ui_file
*, const char *, ...),
1371 struct ui_file
*stream
, int quoter
)
1374 c
&= 0xFF; /* Avoid sign bit follies */
1376 if (c
< 0x20 || /* Low control chars */
1377 (c
>= 0x7F && c
< 0xA0) || /* DEL, High controls */
1378 (sevenbit_strings
&& c
>= 0x80))
1379 { /* high order bit set */
1383 do_fputs ("\\n", stream
);
1386 do_fputs ("\\b", stream
);
1389 do_fputs ("\\t", stream
);
1392 do_fputs ("\\f", stream
);
1395 do_fputs ("\\r", stream
);
1398 do_fputs ("\\e", stream
);
1401 do_fputs ("\\a", stream
);
1404 do_fprintf (stream
, "\\%.3o", (unsigned int) c
);
1410 if (c
== '\\' || c
== quoter
)
1411 do_fputs ("\\", stream
);
1412 do_fprintf (stream
, "%c", c
);
1416 /* Print the character C on STREAM as part of the contents of a
1417 literal string whose delimiter is QUOTER. Note that these routines
1418 should only be call for printing things which are independent of
1419 the language of the program being debugged. */
1422 fputstr_filtered (const char *str
, int quoter
, struct ui_file
*stream
)
1425 printchar (*str
++, fputs_filtered
, fprintf_filtered
, stream
, quoter
);
1429 fputstr_unfiltered (const char *str
, int quoter
, struct ui_file
*stream
)
1432 printchar (*str
++, fputs_unfiltered
, fprintf_unfiltered
, stream
, quoter
);
1436 fputstrn_unfiltered (const char *str
, int n
, int quoter
, struct ui_file
*stream
)
1439 for (i
= 0; i
< n
; i
++)
1440 printchar (str
[i
], fputs_unfiltered
, fprintf_unfiltered
, stream
, quoter
);
1445 /* Number of lines per page or UINT_MAX if paging is disabled. */
1446 static unsigned int lines_per_page
;
1447 /* Number of chars per line or UINT_MAX if line folding is disabled. */
1448 static unsigned int chars_per_line
;
1449 /* Current count of lines printed on this page, chars on this line. */
1450 static unsigned int lines_printed
, chars_printed
;
1452 /* Buffer and start column of buffered text, for doing smarter word-
1453 wrapping. When someone calls wrap_here(), we start buffering output
1454 that comes through fputs_filtered(). If we see a newline, we just
1455 spit it out and forget about the wrap_here(). If we see another
1456 wrap_here(), we spit it out and remember the newer one. If we see
1457 the end of the line, we spit out a newline, the indent, and then
1458 the buffered output. */
1460 /* Malloc'd buffer with chars_per_line+2 bytes. Contains characters which
1461 are waiting to be output (they have already been counted in chars_printed).
1462 When wrap_buffer[0] is null, the buffer is empty. */
1463 static char *wrap_buffer
;
1465 /* Pointer in wrap_buffer to the next character to fill. */
1466 static char *wrap_pointer
;
1468 /* String to indent by if the wrap occurs. Must not be NULL if wrap_column
1470 static char *wrap_indent
;
1472 /* Column number on the screen where wrap_buffer begins, or 0 if wrapping
1473 is not in effect. */
1474 static int wrap_column
;
1477 /* Inialize the lines and chars per page */
1479 init_page_info (void)
1482 if (!tui_get_command_dimension (&chars_per_line
, &lines_per_page
))
1485 /* These defaults will be used if we are unable to get the correct
1486 values from termcap. */
1487 #if defined(__GO32__)
1488 lines_per_page
= ScreenRows ();
1489 chars_per_line
= ScreenCols ();
1491 lines_per_page
= 24;
1492 chars_per_line
= 80;
1494 #if !defined (_WIN32)
1495 /* No termcap under MPW, although might be cool to do something
1496 by looking at worksheet or console window sizes. */
1497 /* Initialize the screen height and width from termcap. */
1499 char *termtype
= getenv ("TERM");
1501 /* Positive means success, nonpositive means failure. */
1504 /* 2048 is large enough for all known terminals, according to the
1505 GNU termcap manual. */
1506 char term_buffer
[2048];
1510 status
= tgetent (term_buffer
, termtype
);
1514 int running_in_emacs
= getenv ("EMACS") != NULL
;
1516 val
= tgetnum ("li");
1517 if (val
>= 0 && !running_in_emacs
)
1518 lines_per_page
= val
;
1520 /* The number of lines per page is not mentioned
1521 in the terminal description. This probably means
1522 that paging is not useful (e.g. emacs shell window),
1523 so disable paging. */
1524 lines_per_page
= UINT_MAX
;
1526 val
= tgetnum ("co");
1528 chars_per_line
= val
;
1534 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1536 /* If there is a better way to determine the window size, use it. */
1537 SIGWINCH_HANDLER (SIGWINCH
);
1540 /* If the output is not a terminal, don't paginate it. */
1541 if (!ui_file_isatty (gdb_stdout
))
1542 lines_per_page
= UINT_MAX
;
1543 } /* the command_line_version */
1550 if (chars_per_line
== 0)
1555 wrap_buffer
= (char *) xmalloc (chars_per_line
+ 2);
1556 wrap_buffer
[0] = '\0';
1559 wrap_buffer
= (char *) xrealloc (wrap_buffer
, chars_per_line
+ 2);
1560 wrap_pointer
= wrap_buffer
; /* Start it at the beginning */
1565 set_width_command (char *args
, int from_tty
, struct cmd_list_element
*c
)
1570 /* Wait, so the user can read what's on the screen. Prompt the user
1571 to continue by pressing RETURN. */
1574 prompt_for_continue (void)
1577 char cont_prompt
[120];
1579 if (annotation_level
> 1)
1580 printf_unfiltered ("\n\032\032pre-prompt-for-continue\n");
1582 strcpy (cont_prompt
,
1583 "---Type <return> to continue, or q <return> to quit---");
1584 if (annotation_level
> 1)
1585 strcat (cont_prompt
, "\n\032\032prompt-for-continue\n");
1587 /* We must do this *before* we call gdb_readline, else it will eventually
1588 call us -- thinking that we're trying to print beyond the end of the
1590 reinitialize_more_filter ();
1593 /* On a real operating system, the user can quit with SIGINT.
1596 'q' is provided on all systems so users don't have to change habits
1597 from system to system, and because telling them what to do in
1598 the prompt is more user-friendly than expecting them to think of
1600 /* Call readline, not gdb_readline, because GO32 readline handles control-C
1601 whereas control-C to gdb_readline will cause the user to get dumped
1603 ignore
= readline (cont_prompt
);
1605 if (annotation_level
> 1)
1606 printf_unfiltered ("\n\032\032post-prompt-for-continue\n");
1611 while (*p
== ' ' || *p
== '\t')
1616 request_quit (SIGINT
);
1618 async_request_quit (0);
1624 /* Now we have to do this again, so that GDB will know that it doesn't
1625 need to save the ---Type <return>--- line at the top of the screen. */
1626 reinitialize_more_filter ();
1628 dont_repeat (); /* Forget prev cmd -- CR won't repeat it. */
1631 /* Reinitialize filter; ie. tell it to reset to original values. */
1634 reinitialize_more_filter (void)
1640 /* Indicate that if the next sequence of characters overflows the line,
1641 a newline should be inserted here rather than when it hits the end.
1642 If INDENT is non-null, it is a string to be printed to indent the
1643 wrapped part on the next line. INDENT must remain accessible until
1644 the next call to wrap_here() or until a newline is printed through
1647 If the line is already overfull, we immediately print a newline and
1648 the indentation, and disable further wrapping.
1650 If we don't know the width of lines, but we know the page height,
1651 we must not wrap words, but should still keep track of newlines
1652 that were explicitly printed.
1654 INDENT should not contain tabs, as that will mess up the char count
1655 on the next line. FIXME.
1657 This routine is guaranteed to force out any output which has been
1658 squirreled away in the wrap_buffer, so wrap_here ((char *)0) can be
1659 used to force out output from the wrap_buffer. */
1662 wrap_here (char *indent
)
1664 /* This should have been allocated, but be paranoid anyway. */
1666 internal_error (__FILE__
, __LINE__
, "failed internal consistency check");
1670 *wrap_pointer
= '\0';
1671 fputs_unfiltered (wrap_buffer
, gdb_stdout
);
1673 wrap_pointer
= wrap_buffer
;
1674 wrap_buffer
[0] = '\0';
1675 if (chars_per_line
== UINT_MAX
) /* No line overflow checking */
1679 else if (chars_printed
>= chars_per_line
)
1681 puts_filtered ("\n");
1683 puts_filtered (indent
);
1688 wrap_column
= chars_printed
;
1692 wrap_indent
= indent
;
1696 /* Ensure that whatever gets printed next, using the filtered output
1697 commands, starts at the beginning of the line. I.E. if there is
1698 any pending output for the current line, flush it and start a new
1699 line. Otherwise do nothing. */
1704 if (chars_printed
> 0)
1706 puts_filtered ("\n");
1711 /* Like fputs but if FILTER is true, pause after every screenful.
1713 Regardless of FILTER can wrap at points other than the final
1714 character of a line.
1716 Unlike fputs, fputs_maybe_filtered does not return a value.
1717 It is OK for LINEBUFFER to be NULL, in which case just don't print
1720 Note that a longjmp to top level may occur in this routine (only if
1721 FILTER is true) (since prompt_for_continue may do so) so this
1722 routine should not be called when cleanups are not in place. */
1725 fputs_maybe_filtered (const char *linebuffer
, struct ui_file
*stream
,
1728 const char *lineptr
;
1730 if (linebuffer
== 0)
1733 /* Don't do any filtering if it is disabled. */
1734 if ((stream
!= gdb_stdout
) || !pagination_enabled
1735 || (lines_per_page
== UINT_MAX
&& chars_per_line
== UINT_MAX
))
1737 fputs_unfiltered (linebuffer
, stream
);
1741 /* Go through and output each character. Show line extension
1742 when this is necessary; prompt user for new page when this is
1745 lineptr
= linebuffer
;
1748 /* Possible new page. */
1750 (lines_printed
>= lines_per_page
- 1))
1751 prompt_for_continue ();
1753 while (*lineptr
&& *lineptr
!= '\n')
1755 /* Print a single line. */
1756 if (*lineptr
== '\t')
1759 *wrap_pointer
++ = '\t';
1761 fputc_unfiltered ('\t', stream
);
1762 /* Shifting right by 3 produces the number of tab stops
1763 we have already passed, and then adding one and
1764 shifting left 3 advances to the next tab stop. */
1765 chars_printed
= ((chars_printed
>> 3) + 1) << 3;
1771 *wrap_pointer
++ = *lineptr
;
1773 fputc_unfiltered (*lineptr
, stream
);
1778 if (chars_printed
>= chars_per_line
)
1780 unsigned int save_chars
= chars_printed
;
1784 /* If we aren't actually wrapping, don't output newline --
1785 if chars_per_line is right, we probably just overflowed
1786 anyway; if it's wrong, let us keep going. */
1788 fputc_unfiltered ('\n', stream
);
1790 /* Possible new page. */
1791 if (lines_printed
>= lines_per_page
- 1)
1792 prompt_for_continue ();
1794 /* Now output indentation and wrapped string */
1797 fputs_unfiltered (wrap_indent
, stream
);
1798 *wrap_pointer
= '\0'; /* Null-terminate saved stuff */
1799 fputs_unfiltered (wrap_buffer
, stream
); /* and eject it */
1800 /* FIXME, this strlen is what prevents wrap_indent from
1801 containing tabs. However, if we recurse to print it
1802 and count its chars, we risk trouble if wrap_indent is
1803 longer than (the user settable) chars_per_line.
1804 Note also that this can set chars_printed > chars_per_line
1805 if we are printing a long string. */
1806 chars_printed
= strlen (wrap_indent
)
1807 + (save_chars
- wrap_column
);
1808 wrap_pointer
= wrap_buffer
; /* Reset buffer */
1809 wrap_buffer
[0] = '\0';
1810 wrap_column
= 0; /* And disable fancy wrap */
1815 if (*lineptr
== '\n')
1818 wrap_here ((char *) 0); /* Spit out chars, cancel further wraps */
1820 fputc_unfiltered ('\n', stream
);
1827 fputs_filtered (const char *linebuffer
, struct ui_file
*stream
)
1829 fputs_maybe_filtered (linebuffer
, stream
, 1);
1833 putchar_unfiltered (int c
)
1836 ui_file_write (gdb_stdout
, &buf
, 1);
1840 /* Write character C to gdb_stdout using GDB's paging mechanism and return C.
1841 May return nonlocally. */
1844 putchar_filtered (int c
)
1846 return fputc_filtered (c
, gdb_stdout
);
1850 fputc_unfiltered (int c
, struct ui_file
*stream
)
1853 ui_file_write (stream
, &buf
, 1);
1858 fputc_filtered (int c
, struct ui_file
*stream
)
1864 fputs_filtered (buf
, stream
);
1868 /* puts_debug is like fputs_unfiltered, except it prints special
1869 characters in printable fashion. */
1872 puts_debug (char *prefix
, char *string
, char *suffix
)
1876 /* Print prefix and suffix after each line. */
1877 static int new_line
= 1;
1878 static int return_p
= 0;
1879 static char *prev_prefix
= "";
1880 static char *prev_suffix
= "";
1882 if (*string
== '\n')
1885 /* If the prefix is changing, print the previous suffix, a new line,
1886 and the new prefix. */
1887 if ((return_p
|| (strcmp (prev_prefix
, prefix
) != 0)) && !new_line
)
1889 fputs_unfiltered (prev_suffix
, gdb_stdlog
);
1890 fputs_unfiltered ("\n", gdb_stdlog
);
1891 fputs_unfiltered (prefix
, gdb_stdlog
);
1894 /* Print prefix if we printed a newline during the previous call. */
1898 fputs_unfiltered (prefix
, gdb_stdlog
);
1901 prev_prefix
= prefix
;
1902 prev_suffix
= suffix
;
1904 /* Output characters in a printable format. */
1905 while ((ch
= *string
++) != '\0')
1911 fputc_unfiltered (ch
, gdb_stdlog
);
1914 fprintf_unfiltered (gdb_stdlog
, "\\x%02x", ch
& 0xff);
1918 fputs_unfiltered ("\\\\", gdb_stdlog
);
1921 fputs_unfiltered ("\\b", gdb_stdlog
);
1924 fputs_unfiltered ("\\f", gdb_stdlog
);
1928 fputs_unfiltered ("\\n", gdb_stdlog
);
1931 fputs_unfiltered ("\\r", gdb_stdlog
);
1934 fputs_unfiltered ("\\t", gdb_stdlog
);
1937 fputs_unfiltered ("\\v", gdb_stdlog
);
1941 return_p
= ch
== '\r';
1944 /* Print suffix if we printed a newline. */
1947 fputs_unfiltered (suffix
, gdb_stdlog
);
1948 fputs_unfiltered ("\n", gdb_stdlog
);
1953 /* Print a variable number of ARGS using format FORMAT. If this
1954 information is going to put the amount written (since the last call
1955 to REINITIALIZE_MORE_FILTER or the last page break) over the page size,
1956 call prompt_for_continue to get the users permision to continue.
1958 Unlike fprintf, this function does not return a value.
1960 We implement three variants, vfprintf (takes a vararg list and stream),
1961 fprintf (takes a stream to write on), and printf (the usual).
1963 Note also that a longjmp to top level may occur in this routine
1964 (since prompt_for_continue may do so) so this routine should not be
1965 called when cleanups are not in place. */
1968 vfprintf_maybe_filtered (struct ui_file
*stream
, const char *format
,
1969 va_list args
, int filter
)
1972 struct cleanup
*old_cleanups
;
1974 xvasprintf (&linebuffer
, format
, args
);
1975 old_cleanups
= make_cleanup (xfree
, linebuffer
);
1976 fputs_maybe_filtered (linebuffer
, stream
, filter
);
1977 do_cleanups (old_cleanups
);
1982 vfprintf_filtered (struct ui_file
*stream
, const char *format
, va_list args
)
1984 vfprintf_maybe_filtered (stream
, format
, args
, 1);
1988 vfprintf_unfiltered (struct ui_file
*stream
, const char *format
, va_list args
)
1991 struct cleanup
*old_cleanups
;
1993 xvasprintf (&linebuffer
, format
, args
);
1994 old_cleanups
= make_cleanup (xfree
, linebuffer
);
1995 fputs_unfiltered (linebuffer
, stream
);
1996 do_cleanups (old_cleanups
);
2000 vprintf_filtered (const char *format
, va_list args
)
2002 vfprintf_maybe_filtered (gdb_stdout
, format
, args
, 1);
2006 vprintf_unfiltered (const char *format
, va_list args
)
2008 vfprintf_unfiltered (gdb_stdout
, format
, args
);
2012 fprintf_filtered (struct ui_file
* stream
, const char *format
,...)
2015 va_start (args
, format
);
2016 vfprintf_filtered (stream
, format
, args
);
2021 fprintf_unfiltered (struct ui_file
* stream
, const char *format
,...)
2024 va_start (args
, format
);
2025 vfprintf_unfiltered (stream
, format
, args
);
2029 /* Like fprintf_filtered, but prints its result indented.
2030 Called as fprintfi_filtered (spaces, stream, format, ...); */
2033 fprintfi_filtered (int spaces
, struct ui_file
* stream
, const char *format
,...)
2036 va_start (args
, format
);
2037 print_spaces_filtered (spaces
, stream
);
2039 vfprintf_filtered (stream
, format
, args
);
2045 printf_filtered (const char *format
,...)
2048 va_start (args
, format
);
2049 vfprintf_filtered (gdb_stdout
, format
, args
);
2055 printf_unfiltered (const char *format
,...)
2058 va_start (args
, format
);
2059 vfprintf_unfiltered (gdb_stdout
, format
, args
);
2063 /* Like printf_filtered, but prints it's result indented.
2064 Called as printfi_filtered (spaces, format, ...); */
2067 printfi_filtered (int spaces
, const char *format
,...)
2070 va_start (args
, format
);
2071 print_spaces_filtered (spaces
, gdb_stdout
);
2072 vfprintf_filtered (gdb_stdout
, format
, args
);
2076 /* Easy -- but watch out!
2078 This routine is *not* a replacement for puts()! puts() appends a newline.
2079 This one doesn't, and had better not! */
2082 puts_filtered (const char *string
)
2084 fputs_filtered (string
, gdb_stdout
);
2088 puts_unfiltered (const char *string
)
2090 fputs_unfiltered (string
, gdb_stdout
);
2093 /* Return a pointer to N spaces and a null. The pointer is good
2094 until the next call to here. */
2099 static char *spaces
= 0;
2100 static int max_spaces
= -1;
2106 spaces
= (char *) xmalloc (n
+ 1);
2107 for (t
= spaces
+ n
; t
!= spaces
;)
2113 return spaces
+ max_spaces
- n
;
2116 /* Print N spaces. */
2118 print_spaces_filtered (int n
, struct ui_file
*stream
)
2120 fputs_filtered (n_spaces (n
), stream
);
2123 /* C++ demangler stuff. */
2125 /* fprintf_symbol_filtered attempts to demangle NAME, a symbol in language
2126 LANG, using demangling args ARG_MODE, and print it filtered to STREAM.
2127 If the name is not mangled, or the language for the name is unknown, or
2128 demangling is off, the name is printed in its "raw" form. */
2131 fprintf_symbol_filtered (struct ui_file
*stream
, char *name
, enum language lang
,
2138 /* If user wants to see raw output, no problem. */
2141 fputs_filtered (name
, stream
);
2147 case language_cplus
:
2148 demangled
= cplus_demangle (name
, arg_mode
);
2151 demangled
= cplus_demangle (name
, arg_mode
| DMGL_JAVA
);
2153 case language_chill
:
2154 demangled
= chill_demangle (name
);
2160 fputs_filtered (demangled
? demangled
: name
, stream
);
2161 if (demangled
!= NULL
)
2169 /* Do a strcmp() type operation on STRING1 and STRING2, ignoring any
2170 differences in whitespace. Returns 0 if they match, non-zero if they
2171 don't (slightly different than strcmp()'s range of return values).
2173 As an extra hack, string1=="FOO(ARGS)" matches string2=="FOO".
2174 This "feature" is useful when searching for matching C++ function names
2175 (such as if the user types 'break FOO', where FOO is a mangled C++
2179 strcmp_iw (const char *string1
, const char *string2
)
2181 while ((*string1
!= '\0') && (*string2
!= '\0'))
2183 while (isspace (*string1
))
2187 while (isspace (*string2
))
2191 if (*string1
!= *string2
)
2195 if (*string1
!= '\0')
2201 return (*string1
!= '\0' && *string1
!= '(') || (*string2
!= '\0');
2207 ** Answer whether string_to_compare is a full or partial match to
2208 ** template_string. The partial match must be in sequence starting
2212 subset_compare (char *string_to_compare
, char *template_string
)
2215 if (template_string
!= (char *) NULL
&& string_to_compare
!= (char *) NULL
&&
2216 strlen (string_to_compare
) <= strlen (template_string
))
2217 match
= (strncmp (template_string
,
2219 strlen (string_to_compare
)) == 0);
2226 static void pagination_on_command (char *arg
, int from_tty
);
2228 pagination_on_command (char *arg
, int from_tty
)
2230 pagination_enabled
= 1;
2233 static void pagination_on_command (char *arg
, int from_tty
);
2235 pagination_off_command (char *arg
, int from_tty
)
2237 pagination_enabled
= 0;
2242 initialize_utils (void)
2244 struct cmd_list_element
*c
;
2246 c
= add_set_cmd ("width", class_support
, var_uinteger
,
2247 (char *) &chars_per_line
,
2248 "Set number of characters gdb thinks are in a line.",
2250 add_show_from_set (c
, &showlist
);
2251 set_cmd_sfunc (c
, set_width_command
);
2254 (add_set_cmd ("height", class_support
,
2255 var_uinteger
, (char *) &lines_per_page
,
2256 "Set number of lines gdb thinks are in a page.", &setlist
),
2261 /* If the output is not a terminal, don't paginate it. */
2262 if (!ui_file_isatty (gdb_stdout
))
2263 lines_per_page
= UINT_MAX
;
2265 set_width_command ((char *) NULL
, 0, c
);
2268 (add_set_cmd ("demangle", class_support
, var_boolean
,
2270 "Set demangling of encoded C++ names when displaying symbols.",
2275 (add_set_cmd ("pagination", class_support
,
2276 var_boolean
, (char *) &pagination_enabled
,
2277 "Set state of pagination.", &setlist
),
2282 add_com ("am", class_support
, pagination_on_command
,
2283 "Enable pagination");
2284 add_com ("sm", class_support
, pagination_off_command
,
2285 "Disable pagination");
2289 (add_set_cmd ("sevenbit-strings", class_support
, var_boolean
,
2290 (char *) &sevenbit_strings
,
2291 "Set printing of 8-bit characters in strings as \\nnn.",
2296 (add_set_cmd ("asm-demangle", class_support
, var_boolean
,
2297 (char *) &asm_demangle
,
2298 "Set demangling of C++ names in disassembly listings.",
2303 /* Machine specific function to handle SIGWINCH signal. */
2305 #ifdef SIGWINCH_HANDLER_BODY
2306 SIGWINCH_HANDLER_BODY
2309 /* print routines to handle variable size regs, etc. */
2311 /* temporary storage using circular buffer */
2317 static char buf
[NUMCELLS
][CELLSIZE
];
2318 static int cell
= 0;
2319 if (++cell
>= NUMCELLS
)
2327 return (TARGET_ADDR_BIT
/ 8 * 2);
2331 paddr (CORE_ADDR addr
)
2333 return phex (addr
, TARGET_ADDR_BIT
/ 8);
2337 paddr_nz (CORE_ADDR addr
)
2339 return phex_nz (addr
, TARGET_ADDR_BIT
/ 8);
2343 decimal2str (char *paddr_str
, char *sign
, ULONGEST addr
)
2345 /* steal code from valprint.c:print_decimal(). Should this worry
2346 about the real size of addr as the above does? */
2347 unsigned long temp
[3];
2351 temp
[i
] = addr
% (1000 * 1000 * 1000);
2352 addr
/= (1000 * 1000 * 1000);
2355 while (addr
!= 0 && i
< (sizeof (temp
) / sizeof (temp
[0])));
2359 sprintf (paddr_str
, "%s%lu",
2363 sprintf (paddr_str
, "%s%lu%09lu",
2364 sign
, temp
[1], temp
[0]);
2367 sprintf (paddr_str
, "%s%lu%09lu%09lu",
2368 sign
, temp
[2], temp
[1], temp
[0]);
2371 internal_error (__FILE__
, __LINE__
, "failed internal consistency check");
2376 paddr_u (CORE_ADDR addr
)
2378 char *paddr_str
= get_cell ();
2379 decimal2str (paddr_str
, "", addr
);
2384 paddr_d (LONGEST addr
)
2386 char *paddr_str
= get_cell ();
2388 decimal2str (paddr_str
, "-", -addr
);
2390 decimal2str (paddr_str
, "", addr
);
2394 /* eliminate warning from compiler on 32-bit systems */
2395 static int thirty_two
= 32;
2398 phex (ULONGEST l
, int sizeof_l
)
2405 sprintf (str
, "%08lx%08lx",
2406 (unsigned long) (l
>> thirty_two
),
2407 (unsigned long) (l
& 0xffffffff));
2411 sprintf (str
, "%08lx", (unsigned long) l
);
2415 sprintf (str
, "%04x", (unsigned short) (l
& 0xffff));
2418 str
= phex (l
, sizeof (l
));
2425 phex_nz (ULONGEST l
, int sizeof_l
)
2432 unsigned long high
= (unsigned long) (l
>> thirty_two
);
2435 sprintf (str
, "%lx", (unsigned long) (l
& 0xffffffff));
2437 sprintf (str
, "%lx%08lx",
2438 high
, (unsigned long) (l
& 0xffffffff));
2443 sprintf (str
, "%lx", (unsigned long) l
);
2447 sprintf (str
, "%x", (unsigned short) (l
& 0xffff));
2450 str
= phex_nz (l
, sizeof (l
));
2457 /* Convert to / from the hosts pointer to GDB's internal CORE_ADDR
2458 using the target's conversion routines. */
2460 host_pointer_to_address (void *ptr
)
2462 if (sizeof (ptr
) != TYPE_LENGTH (builtin_type_void_data_ptr
))
2463 internal_error (__FILE__
, __LINE__
,
2464 "core_addr_to_void_ptr: bad cast");
2465 return POINTER_TO_ADDRESS (builtin_type_void_data_ptr
, &ptr
);
2469 address_to_host_pointer (CORE_ADDR addr
)
2472 if (sizeof (ptr
) != TYPE_LENGTH (builtin_type_void_data_ptr
))
2473 internal_error (__FILE__
, __LINE__
,
2474 "core_addr_to_void_ptr: bad cast");
2475 ADDRESS_TO_POINTER (builtin_type_void_data_ptr
, &ptr
, addr
);
2479 /* Convert a CORE_ADDR into a string. */
2481 core_addr_to_string (const CORE_ADDR addr
)
2483 char *str
= get_cell ();
2485 strcat (str
, phex (addr
, sizeof (addr
)));
2490 core_addr_to_string_nz (const CORE_ADDR addr
)
2492 char *str
= get_cell ();
2494 strcat (str
, phex_nz (addr
, sizeof (addr
)));
2498 /* Convert a string back into a CORE_ADDR. */
2500 string_to_core_addr (const char *my_string
)
2503 if (my_string
[0] == '0' && tolower (my_string
[1]) == 'x')
2505 /* Assume that it is in decimal. */
2507 for (i
= 2; my_string
[i
] != '\0'; i
++)
2509 if (isdigit (my_string
[i
]))
2510 addr
= (my_string
[i
] - '0') + (addr
* 16);
2511 else if (isxdigit (my_string
[i
]))
2512 addr
= (tolower (my_string
[i
]) - 'a' + 0xa) + (addr
* 16);
2514 internal_error (__FILE__
, __LINE__
, "invalid hex");
2519 /* Assume that it is in decimal. */
2521 for (i
= 0; my_string
[i
] != '\0'; i
++)
2523 if (isdigit (my_string
[i
]))
2524 addr
= (my_string
[i
] - '0') + (addr
* 10);
2526 internal_error (__FILE__
, __LINE__
, "invalid decimal");
2533 gdb_realpath (const char *filename
)
2535 #ifdef HAVE_CANONICALIZE_FILE_NAME
2536 return canonicalize_file_name (filename
);
2537 #elif defined (HAVE_REALPATH)
2538 #if defined (PATH_MAX)
2540 #elif defined (MAXPATHLEN)
2541 char buf
[MAXPATHLEN
];
2542 #elif defined (HAVE_UNISTD_H) && defined(HAVE_ALLOCA)
2543 char *buf
= alloca ((size_t)pathconf ("/", _PC_PATH_MAX
));
2545 #error "Neither PATH_MAX nor MAXPATHLEN defined"
2547 char *rp
= realpath (filename
, buf
);
2548 return xstrdup (rp
? rp
: filename
);
2550 return xstrdup (filename
);