1 /* General utility routines for GDB, the GNU debugger.
2 Copyright 1986, 1989, 1990-1992, 1995, 1996, 1998, 2000
3 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
24 #include "gdb_string.h"
25 #include "event-top.h"
38 /* SunOS's curses.h has a '#define reg register' in it. Thank you Sun. */
49 #include "expression.h"
53 #include <readline/readline.h>
56 #define XMALLOC(TYPE) ((TYPE*) xmalloc (sizeof (TYPE)))
58 /* readline defines this. */
61 void (*error_begin_hook
) PARAMS ((void));
63 /* Holds the last error message issued by gdb */
65 static struct ui_file
*gdb_lasterr
;
67 /* Prototypes for local functions */
69 static void vfprintf_maybe_filtered (struct ui_file
*, const char *,
72 static void fputs_maybe_filtered (const char *, struct ui_file
*, int);
74 #if defined (USE_MMALLOC) && !defined (NO_MMCHECK)
75 static void malloc_botch
PARAMS ((void));
79 prompt_for_continue
PARAMS ((void));
82 set_width_command
PARAMS ((char *, int, struct cmd_list_element
*));
85 set_width
PARAMS ((void));
87 /* Chain of cleanup actions established with make_cleanup,
88 to be executed if an error happens. */
90 static struct cleanup
*cleanup_chain
; /* cleaned up after a failed command */
91 static struct cleanup
*final_cleanup_chain
; /* cleaned up when gdb exits */
92 static struct cleanup
*run_cleanup_chain
; /* cleaned up on each 'run' */
93 static struct cleanup
*exec_cleanup_chain
; /* cleaned up on each execution command */
94 /* cleaned up on each error from within an execution command */
95 static struct cleanup
*exec_error_cleanup_chain
;
97 /* Pointer to what is left to do for an execution command after the
98 target stops. Used only in asynchronous mode, by targets that
99 support async execution. The finish and until commands use it. So
100 does the target extended-remote command. */
101 struct continuation
*cmd_continuation
;
102 struct continuation
*intermediate_continuation
;
104 /* Nonzero if we have job control. */
108 /* Nonzero means a quit has been requested. */
112 /* Nonzero means quit immediately if Control-C is typed now, rather
113 than waiting until QUIT is executed. Be careful in setting this;
114 code which executes with immediate_quit set has to be very careful
115 about being able to deal with being interrupted at any time. It is
116 almost always better to use QUIT; the only exception I can think of
117 is being able to quit out of a system call (using EINTR loses if
118 the SIGINT happens between the previous QUIT and the system call).
119 To immediately quit in the case in which a SIGINT happens between
120 the previous QUIT and setting immediate_quit (desirable anytime we
121 expect to block), call QUIT after setting immediate_quit. */
125 /* Nonzero means that encoded C++ names should be printed out in their
126 C++ form rather than raw. */
130 /* Nonzero means that encoded C++ names should be printed out in their
131 C++ form even in assembler language displays. If this is set, but
132 DEMANGLE is zero, names are printed raw, i.e. DEMANGLE controls. */
134 int asm_demangle
= 0;
136 /* Nonzero means that strings with character values >0x7F should be printed
137 as octal escapes. Zero means just print the value (e.g. it's an
138 international character, and the terminal or window can cope.) */
140 int sevenbit_strings
= 0;
142 /* String to be printed before error messages, if any. */
144 char *error_pre_print
;
146 /* String to be printed before quit messages, if any. */
148 char *quit_pre_print
;
150 /* String to be printed before warning messages, if any. */
152 char *warning_pre_print
= "\nwarning: ";
154 int pagination_enabled
= 1;
157 /* Add a new cleanup to the cleanup_chain,
158 and return the previous chain pointer
159 to be passed later to do_cleanups or discard_cleanups.
160 Args are FUNCTION to clean up with, and ARG to pass to it. */
163 make_cleanup (make_cleanup_ftype
*function
, void *arg
)
165 return make_my_cleanup (&cleanup_chain
, function
, arg
);
169 make_final_cleanup (make_cleanup_ftype
*function
, void *arg
)
171 return make_my_cleanup (&final_cleanup_chain
, function
, arg
);
175 make_run_cleanup (make_cleanup_ftype
*function
, void *arg
)
177 return make_my_cleanup (&run_cleanup_chain
, function
, arg
);
181 make_exec_cleanup (make_cleanup_ftype
*function
, void *arg
)
183 return make_my_cleanup (&exec_cleanup_chain
, function
, arg
);
187 make_exec_error_cleanup (make_cleanup_ftype
*function
, void *arg
)
189 return make_my_cleanup (&exec_error_cleanup_chain
, function
, arg
);
196 freeargv ((char **) arg
);
200 make_cleanup_freeargv (arg
)
203 return make_my_cleanup (&cleanup_chain
, do_freeargv
, arg
);
207 do_ui_file_delete (void *arg
)
209 ui_file_delete (arg
);
213 make_cleanup_ui_file_delete (struct ui_file
*arg
)
215 return make_my_cleanup (&cleanup_chain
, do_ui_file_delete
, arg
);
219 make_my_cleanup (struct cleanup
**pmy_chain
, make_cleanup_ftype
*function
,
222 register struct cleanup
*new
223 = (struct cleanup
*) xmalloc (sizeof (struct cleanup
));
224 register struct cleanup
*old_chain
= *pmy_chain
;
226 new->next
= *pmy_chain
;
227 new->function
= function
;
234 /* Discard cleanups and do the actions they describe
235 until we get back to the point OLD_CHAIN in the cleanup_chain. */
238 do_cleanups (old_chain
)
239 register struct cleanup
*old_chain
;
241 do_my_cleanups (&cleanup_chain
, old_chain
);
245 do_final_cleanups (old_chain
)
246 register struct cleanup
*old_chain
;
248 do_my_cleanups (&final_cleanup_chain
, old_chain
);
252 do_run_cleanups (old_chain
)
253 register struct cleanup
*old_chain
;
255 do_my_cleanups (&run_cleanup_chain
, old_chain
);
259 do_exec_cleanups (old_chain
)
260 register struct cleanup
*old_chain
;
262 do_my_cleanups (&exec_cleanup_chain
, old_chain
);
266 do_exec_error_cleanups (old_chain
)
267 register struct cleanup
*old_chain
;
269 do_my_cleanups (&exec_error_cleanup_chain
, old_chain
);
273 do_my_cleanups (pmy_chain
, old_chain
)
274 register struct cleanup
**pmy_chain
;
275 register struct cleanup
*old_chain
;
277 register struct cleanup
*ptr
;
278 while ((ptr
= *pmy_chain
) != old_chain
)
280 *pmy_chain
= ptr
->next
; /* Do this first incase recursion */
281 (*ptr
->function
) (ptr
->arg
);
286 /* Discard cleanups, not doing the actions they describe,
287 until we get back to the point OLD_CHAIN in the cleanup_chain. */
290 discard_cleanups (old_chain
)
291 register struct cleanup
*old_chain
;
293 discard_my_cleanups (&cleanup_chain
, old_chain
);
297 discard_final_cleanups (old_chain
)
298 register struct cleanup
*old_chain
;
300 discard_my_cleanups (&final_cleanup_chain
, old_chain
);
304 discard_exec_error_cleanups (old_chain
)
305 register struct cleanup
*old_chain
;
307 discard_my_cleanups (&exec_error_cleanup_chain
, old_chain
);
311 discard_my_cleanups (pmy_chain
, old_chain
)
312 register struct cleanup
**pmy_chain
;
313 register struct cleanup
*old_chain
;
315 register struct cleanup
*ptr
;
316 while ((ptr
= *pmy_chain
) != old_chain
)
318 *pmy_chain
= ptr
->next
;
323 /* Set the cleanup_chain to 0, and return the old cleanup chain. */
327 return save_my_cleanups (&cleanup_chain
);
331 save_final_cleanups ()
333 return save_my_cleanups (&final_cleanup_chain
);
337 save_my_cleanups (pmy_chain
)
338 struct cleanup
**pmy_chain
;
340 struct cleanup
*old_chain
= *pmy_chain
;
346 /* Restore the cleanup chain from a previously saved chain. */
348 restore_cleanups (chain
)
349 struct cleanup
*chain
;
351 restore_my_cleanups (&cleanup_chain
, chain
);
355 restore_final_cleanups (chain
)
356 struct cleanup
*chain
;
358 restore_my_cleanups (&final_cleanup_chain
, chain
);
362 restore_my_cleanups (pmy_chain
, chain
)
363 struct cleanup
**pmy_chain
;
364 struct cleanup
*chain
;
369 /* This function is useful for cleanups.
373 old_chain = make_cleanup (free_current_contents, &foo);
375 to arrange to free the object thus allocated. */
378 free_current_contents (void *ptr
)
380 void **location
= ptr
;
381 if (*location
!= NULL
)
385 /* Provide a known function that does nothing, to use as a base for
386 for a possibly long chain of cleanups. This is useful where we
387 use the cleanup chain for handling normal cleanups as well as dealing
388 with cleanups that need to be done as a result of a call to error().
389 In such cases, we may not be certain where the first cleanup is, unless
390 we have a do-nothing one to always use as the base. */
394 null_cleanup (void *arg
)
398 /* Add a continuation to the continuation list, the gloabl list
399 cmd_continuation. The new continuation will be added at the front.*/
401 add_continuation (continuation_hook
, arg_list
)
402 void (*continuation_hook
) PARAMS ((struct continuation_arg
*));
403 struct continuation_arg
*arg_list
;
405 struct continuation
*continuation_ptr
;
407 continuation_ptr
= (struct continuation
*) xmalloc (sizeof (struct continuation
));
408 continuation_ptr
->continuation_hook
= continuation_hook
;
409 continuation_ptr
->arg_list
= arg_list
;
410 continuation_ptr
->next
= cmd_continuation
;
411 cmd_continuation
= continuation_ptr
;
414 /* Walk down the cmd_continuation list, and execute all the
415 continuations. There is a problem though. In some cases new
416 continuations may be added while we are in the middle of this
417 loop. If this happens they will be added in the front, and done
418 before we have a chance of exhausting those that were already
419 there. We need to then save the beginning of the list in a pointer
420 and do the continuations from there on, instead of using the
421 global beginning of list as our iteration pointer.*/
423 do_all_continuations ()
425 struct continuation
*continuation_ptr
;
426 struct continuation
*saved_continuation
;
428 /* Copy the list header into another pointer, and set the global
429 list header to null, so that the global list can change as a side
430 effect of invoking the continuations and the processing of
431 the preexisting continuations will not be affected. */
432 continuation_ptr
= cmd_continuation
;
433 cmd_continuation
= NULL
;
435 /* Work now on the list we have set aside. */
436 while (continuation_ptr
)
438 (continuation_ptr
->continuation_hook
) (continuation_ptr
->arg_list
);
439 saved_continuation
= continuation_ptr
;
440 continuation_ptr
= continuation_ptr
->next
;
441 free (saved_continuation
);
445 /* Walk down the cmd_continuation list, and get rid of all the
448 discard_all_continuations ()
450 struct continuation
*continuation_ptr
;
452 while (cmd_continuation
)
454 continuation_ptr
= cmd_continuation
;
455 cmd_continuation
= continuation_ptr
->next
;
456 free (continuation_ptr
);
460 /* Add a continuation to the continuation list, the global list
461 intermediate_continuation. The new continuation will be added at the front.*/
463 add_intermediate_continuation (continuation_hook
, arg_list
)
464 void (*continuation_hook
) PARAMS ((struct continuation_arg
*));
465 struct continuation_arg
*arg_list
;
467 struct continuation
*continuation_ptr
;
469 continuation_ptr
= (struct continuation
*) xmalloc (sizeof (struct continuation
));
470 continuation_ptr
->continuation_hook
= continuation_hook
;
471 continuation_ptr
->arg_list
= arg_list
;
472 continuation_ptr
->next
= intermediate_continuation
;
473 intermediate_continuation
= continuation_ptr
;
476 /* Walk down the cmd_continuation list, and execute all the
477 continuations. There is a problem though. In some cases new
478 continuations may be added while we are in the middle of this
479 loop. If this happens they will be added in the front, and done
480 before we have a chance of exhausting those that were already
481 there. We need to then save the beginning of the list in a pointer
482 and do the continuations from there on, instead of using the
483 global beginning of list as our iteration pointer.*/
485 do_all_intermediate_continuations ()
487 struct continuation
*continuation_ptr
;
488 struct continuation
*saved_continuation
;
490 /* Copy the list header into another pointer, and set the global
491 list header to null, so that the global list can change as a side
492 effect of invoking the continuations and the processing of
493 the preexisting continuations will not be affected. */
494 continuation_ptr
= intermediate_continuation
;
495 intermediate_continuation
= NULL
;
497 /* Work now on the list we have set aside. */
498 while (continuation_ptr
)
500 (continuation_ptr
->continuation_hook
) (continuation_ptr
->arg_list
);
501 saved_continuation
= continuation_ptr
;
502 continuation_ptr
= continuation_ptr
->next
;
503 free (saved_continuation
);
507 /* Walk down the cmd_continuation list, and get rid of all the
510 discard_all_intermediate_continuations ()
512 struct continuation
*continuation_ptr
;
514 while (intermediate_continuation
)
516 continuation_ptr
= intermediate_continuation
;
517 intermediate_continuation
= continuation_ptr
->next
;
518 free (continuation_ptr
);
524 /* Print a warning message. Way to use this is to call warning_begin,
525 output the warning message (use unfiltered output to gdb_stderr),
526 ending in a newline. There is not currently a warning_end that you
527 call afterwards, but such a thing might be added if it is useful
528 for a GUI to separate warning messages from other output.
530 FIXME: Why do warnings use unfiltered output and errors filtered?
531 Is this anything other than a historical accident? */
536 target_terminal_ours ();
537 wrap_here (""); /* Force out any buffered output */
538 gdb_flush (gdb_stdout
);
539 if (warning_pre_print
)
540 fprintf_unfiltered (gdb_stderr
, warning_pre_print
);
543 /* Print a warning message.
544 The first argument STRING is the warning message, used as a fprintf string,
545 and the remaining args are passed as arguments to it.
546 The primary difference between warnings and errors is that a warning
547 does not force the return to command level. */
550 warning (const char *string
,...)
553 va_start (args
, string
);
555 (*warning_hook
) (string
, args
);
559 vfprintf_unfiltered (gdb_stderr
, string
, args
);
560 fprintf_unfiltered (gdb_stderr
, "\n");
565 /* Start the printing of an error message. Way to use this is to call
566 this, output the error message (use filtered output to gdb_stderr
567 (FIXME: Some callers, like memory_error, use gdb_stdout)), ending
568 in a newline, and then call return_to_top_level (RETURN_ERROR).
569 error() provides a convenient way to do this for the special case
570 that the error message can be formatted with a single printf call,
571 but this is more general. */
575 if (error_begin_hook
)
578 target_terminal_ours ();
579 wrap_here (""); /* Force out any buffered output */
580 gdb_flush (gdb_stdout
);
582 annotate_error_begin ();
585 fprintf_filtered (gdb_stderr
, error_pre_print
);
588 /* Print an error message and return to command level.
589 The first argument STRING is the error message, used as a fprintf string,
590 and the remaining args are passed as arguments to it. */
593 verror (const char *string
, va_list args
)
596 struct cleanup
*err_string_cleanup
;
597 /* FIXME: cagney/1999-11-10: All error calls should come here.
598 Unfortunatly some code uses the sequence: error_begin(); print
599 error message; return_to_top_level. That code should be
602 /* NOTE: It's tempting to just do the following...
603 vfprintf_filtered (gdb_stderr, string, args);
604 and then follow with a similar looking statement to cause the message
605 to also go to gdb_lasterr. But if we do this, we'll be traversing the
606 va_list twice which works on some platforms and fails miserably on
608 /* Save it as the last error */
609 ui_file_rewind (gdb_lasterr
);
610 vfprintf_filtered (gdb_lasterr
, string
, args
);
611 /* Retrieve the last error and print it to gdb_stderr */
612 err_string
= error_last_message ();
613 err_string_cleanup
= make_cleanup (free
, err_string
);
614 fputs_filtered (err_string
, gdb_stderr
);
615 fprintf_filtered (gdb_stderr
, "\n");
616 do_cleanups (err_string_cleanup
);
617 return_to_top_level (RETURN_ERROR
);
621 error (const char *string
,...)
624 va_start (args
, string
);
625 verror (string
, args
);
630 error_stream (struct ui_file
*stream
)
633 char *msg
= ui_file_xstrdup (stream
, &size
);
634 make_cleanup (free
, msg
);
638 /* Get the last error message issued by gdb */
641 error_last_message (void)
644 return ui_file_xstrdup (gdb_lasterr
, &len
);
647 /* This is to be called by main() at the very beginning */
652 gdb_lasterr
= mem_fileopen ();
655 /* Print a message reporting an internal error. Ask the user if they
656 want to continue, dump core, or just exit. */
659 internal_verror (const char *fmt
, va_list ap
)
661 static char msg
[] = "Internal GDB error: recursive internal error.\n";
662 static int dejavu
= 0;
666 /* don't allow infinite error recursion. */
674 fputs_unfiltered (msg
, gdb_stderr
);
678 write (STDERR_FILENO
, msg
, sizeof (msg
));
682 /* Try to get the message out */
683 fputs_unfiltered ("gdb-internal-error: ", gdb_stderr
);
684 vfprintf_unfiltered (gdb_stderr
, fmt
, ap
);
685 fputs_unfiltered ("\n", gdb_stderr
);
687 /* Default (no case) is to quit GDB. When in batch mode this
688 lessens the likelhood of GDB going into an infinate loop. */
689 continue_p
= query ("\
690 An internal GDB error was detected. This may make make further\n\
691 debugging unreliable. Continue this debugging session? ");
693 /* Default (no case) is to not dump core. Lessen the chance of GDB
694 leaving random core files around. */
695 dump_core_p
= query ("\
696 Create a core file containing the current state of GDB? ");
715 return_to_top_level (RETURN_ERROR
);
719 internal_error (char *string
, ...)
722 va_start (ap
, string
);
723 internal_verror (string
, ap
);
727 /* The strerror() function can return NULL for errno values that are
728 out of range. Provide a "safe" version that always returns a
732 safe_strerror (errnum
)
738 if ((msg
= strerror (errnum
)) == NULL
)
740 sprintf (buf
, "(undocumented errno %d)", errnum
);
746 /* The strsignal() function can return NULL for signal values that are
747 out of range. Provide a "safe" version that always returns a
751 safe_strsignal (signo
)
757 if ((msg
= strsignal (signo
)) == NULL
)
759 sprintf (buf
, "(undocumented signal %d)", signo
);
766 /* Print the system error message for errno, and also mention STRING
767 as the file name for which the error was encountered.
768 Then return to command level. */
771 perror_with_name (string
)
777 err
= safe_strerror (errno
);
778 combined
= (char *) alloca (strlen (err
) + strlen (string
) + 3);
779 strcpy (combined
, string
);
780 strcat (combined
, ": ");
781 strcat (combined
, err
);
783 /* I understand setting these is a matter of taste. Still, some people
784 may clear errno but not know about bfd_error. Doing this here is not
786 bfd_set_error (bfd_error_no_error
);
789 error ("%s.", combined
);
792 /* Print the system error message for ERRCODE, and also mention STRING
793 as the file name for which the error was encountered. */
796 print_sys_errmsg (string
, errcode
)
803 err
= safe_strerror (errcode
);
804 combined
= (char *) alloca (strlen (err
) + strlen (string
) + 3);
805 strcpy (combined
, string
);
806 strcat (combined
, ": ");
807 strcat (combined
, err
);
809 /* We want anything which was printed on stdout to come out first, before
811 gdb_flush (gdb_stdout
);
812 fprintf_unfiltered (gdb_stderr
, "%s.\n", combined
);
815 /* Control C eventually causes this to be called, at a convenient time. */
820 serial_t gdb_stdout_serial
= serial_fdopen (1);
822 target_terminal_ours ();
824 /* We want all output to appear now, before we print "Quit". We
825 have 3 levels of buffering we have to flush (it's possible that
826 some of these should be changed to flush the lower-level ones
829 /* 1. The _filtered buffer. */
830 wrap_here ((char *) 0);
832 /* 2. The stdio buffer. */
833 gdb_flush (gdb_stdout
);
834 gdb_flush (gdb_stderr
);
836 /* 3. The system-level buffer. */
837 SERIAL_DRAIN_OUTPUT (gdb_stdout_serial
);
838 SERIAL_UN_FDOPEN (gdb_stdout_serial
);
840 annotate_error_begin ();
842 /* Don't use *_filtered; we don't want to prompt the user to continue. */
844 fprintf_unfiltered (gdb_stderr
, quit_pre_print
);
847 /* No steenking SIGINT will ever be coming our way when the
848 program is resumed. Don't lie. */
849 fprintf_unfiltered (gdb_stderr
, "Quit\n");
852 /* If there is no terminal switching for this target, then we can't
853 possibly get screwed by the lack of job control. */
854 || current_target
.to_terminal_ours
== NULL
)
855 fprintf_unfiltered (gdb_stderr
, "Quit\n");
857 fprintf_unfiltered (gdb_stderr
,
858 "Quit (expect signal SIGINT when the program is resumed)\n");
860 return_to_top_level (RETURN_QUIT
);
864 #if defined(_MSC_VER) /* should test for wingdb instead? */
867 * Windows translates all keyboard and mouse events
868 * into a message which is appended to the message
869 * queue for the process.
875 int k
= win32pollquit ();
882 #else /* !defined(_MSC_VER) */
887 /* Done by signals */
890 #endif /* !defined(_MSC_VER) */
892 /* Control C comes here */
898 /* Restore the signal handler. Harmless with BSD-style signals, needed
899 for System V-style signals. So just always do it, rather than worrying
900 about USG defines and stuff like that. */
901 signal (signo
, request_quit
);
911 /* Memory management stuff (malloc friends). */
913 /* Make a substitute size_t for non-ANSI compilers. */
915 #ifndef HAVE_STDDEF_H
917 #define size_t unsigned int
921 #if !defined (USE_MMALLOC)
924 mcalloc (PTR md
, size_t number
, size_t size
)
926 return calloc (number
, size
);
934 return malloc (size
);
938 mrealloc (md
, ptr
, size
)
943 if (ptr
== 0) /* Guard against old realloc's */
944 return malloc (size
);
946 return realloc (ptr
, size
);
957 #endif /* USE_MMALLOC */
959 #if !defined (USE_MMALLOC) || defined (NO_MMCHECK)
962 init_malloc (void *md
)
966 #else /* Have mmalloc and want corruption checking */
971 fprintf_unfiltered (gdb_stderr
, "Memory corruption\n");
975 /* Attempt to install hooks in mmalloc/mrealloc/mfree for the heap specified
976 by MD, to detect memory corruption. Note that MD may be NULL to specify
977 the default heap that grows via sbrk.
979 Note that for freshly created regions, we must call mmcheckf prior to any
980 mallocs in the region. Otherwise, any region which was allocated prior to
981 installing the checking hooks, which is later reallocated or freed, will
982 fail the checks! The mmcheck function only allows initial hooks to be
983 installed before the first mmalloc. However, anytime after we have called
984 mmcheck the first time to install the checking hooks, we can call it again
985 to update the function pointer to the memory corruption handler.
987 Returns zero on failure, non-zero on success. */
989 #ifndef MMCHECK_FORCE
990 #define MMCHECK_FORCE 0
994 init_malloc (void *md
)
996 if (!mmcheckf (md
, malloc_botch
, MMCHECK_FORCE
))
998 /* Don't use warning(), which relies on current_target being set
999 to something other than dummy_target, until after
1000 initialize_all_files(). */
1003 (gdb_stderr
, "warning: failed to install memory consistency checks; ");
1005 (gdb_stderr
, "configuration should define NO_MMCHECK or MMCHECK_FORCE\n");
1011 #endif /* Have mmalloc and want corruption checking */
1013 /* Called when a memory allocation fails, with the number of bytes of
1014 memory requested in SIZE. */
1022 internal_error ("virtual memory exhausted: can't allocate %ld bytes.", size
);
1026 internal_error ("virtual memory exhausted.");
1030 /* Like mmalloc but get error if no storage available, and protect against
1031 the caller wanting to allocate zero bytes. Whether to return NULL for
1032 a zero byte request, or translate the request into a request for one
1033 byte of zero'd storage, is a religious issue. */
1046 else if ((val
= mmalloc (md
, size
)) == NULL
)
1053 /* Like mrealloc but get error if no storage available. */
1056 xmrealloc (md
, ptr
, size
)
1065 val
= mrealloc (md
, ptr
, size
);
1069 val
= mmalloc (md
, size
);
1078 /* Like malloc but get error if no storage available, and protect against
1079 the caller wanting to allocate zero bytes. */
1085 return (xmmalloc ((PTR
) NULL
, size
));
1088 /* Like calloc but get error if no storage available */
1091 xcalloc (size_t number
, size_t size
)
1093 void *mem
= mcalloc (NULL
, number
, size
);
1095 nomem (number
* size
);
1099 /* Like mrealloc but get error if no storage available. */
1102 xrealloc (ptr
, size
)
1106 return (xmrealloc ((PTR
) NULL
, ptr
, size
));
1110 /* My replacement for the read system call.
1111 Used like `read' but keeps going if `read' returns too soon. */
1114 myread (desc
, addr
, len
)
1124 val
= read (desc
, addr
, len
);
1128 return orglen
- len
;
1135 /* Make a copy of the string at PTR with SIZE characters
1136 (and add a null character at the end in the copy).
1137 Uses malloc to get the space. Returns the address of the copy. */
1140 savestring (ptr
, size
)
1144 register char *p
= (char *) xmalloc (size
+ 1);
1145 memcpy (p
, ptr
, size
);
1151 msavestring (void *md
, const char *ptr
, int size
)
1153 register char *p
= (char *) xmmalloc (md
, size
+ 1);
1154 memcpy (p
, ptr
, size
);
1159 /* The "const" is so it compiles under DGUX (which prototypes strsave
1160 in <string.h>. FIXME: This should be named "xstrsave", shouldn't it?
1161 Doesn't real strsave return NULL if out of memory? */
1166 return savestring (ptr
, strlen (ptr
));
1170 mstrsave (void *md
, const char *ptr
)
1172 return (msavestring (md
, ptr
, strlen (ptr
)));
1176 print_spaces (n
, file
)
1178 register struct ui_file
*file
;
1180 fputs_unfiltered (n_spaces (n
), file
);
1183 /* Print a host address. */
1186 gdb_print_host_address (void *addr
, struct ui_file
*stream
)
1189 /* We could use the %p conversion specifier to fprintf if we had any
1190 way of knowing whether this host supports it. But the following
1191 should work on the Alpha and on 32 bit machines. */
1193 fprintf_filtered (stream
, "0x%lx", (unsigned long) addr
);
1196 /* Ask user a y-or-n question and return 1 iff answer is yes.
1197 Takes three args which are given to printf to print the question.
1198 The first, a control string, should end in "? ".
1199 It should not say how to answer, because we do that. */
1203 query (char *ctlstr
,...)
1206 register int answer
;
1210 va_start (args
, ctlstr
);
1214 return query_hook (ctlstr
, args
);
1217 /* Automatically answer "yes" if input is not from a terminal. */
1218 if (!input_from_terminal_p ())
1221 /* FIXME Automatically answer "yes" if called from MacGDB. */
1228 wrap_here (""); /* Flush any buffered output */
1229 gdb_flush (gdb_stdout
);
1231 if (annotation_level
> 1)
1232 printf_filtered ("\n\032\032pre-query\n");
1234 vfprintf_filtered (gdb_stdout
, ctlstr
, args
);
1235 printf_filtered ("(y or n) ");
1237 if (annotation_level
> 1)
1238 printf_filtered ("\n\032\032query\n");
1241 /* If not in MacGDB, move to a new line so the entered line doesn't
1242 have a prompt on the front of it. */
1244 fputs_unfiltered ("\n", gdb_stdout
);
1248 gdb_flush (gdb_stdout
);
1251 if (!tui_version
|| cmdWin
== tuiWinWithFocus ())
1253 answer
= fgetc (stdin
);
1256 answer
= (unsigned char) tuiBufferGetc ();
1259 clearerr (stdin
); /* in case of C-d */
1260 if (answer
== EOF
) /* C-d */
1265 /* Eat rest of input line, to EOF or newline */
1266 if ((answer
!= '\n') || (tui_version
&& answer
!= '\r'))
1270 if (!tui_version
|| cmdWin
== tuiWinWithFocus ())
1272 ans2
= fgetc (stdin
);
1275 ans2
= (unsigned char) tuiBufferGetc ();
1279 while (ans2
!= EOF
&& ans2
!= '\n' && ans2
!= '\r');
1280 TUIDO (((TuiOpaqueFuncPtr
) tui_vStartNewLines
, 1));
1294 printf_filtered ("Please answer y or n.\n");
1297 if (annotation_level
> 1)
1298 printf_filtered ("\n\032\032post-query\n");
1303 /* Parse a C escape sequence. STRING_PTR points to a variable
1304 containing a pointer to the string to parse. That pointer
1305 should point to the character after the \. That pointer
1306 is updated past the characters we use. The value of the
1307 escape sequence is returned.
1309 A negative value means the sequence \ newline was seen,
1310 which is supposed to be equivalent to nothing at all.
1312 If \ is followed by a null character, we return a negative
1313 value and leave the string pointer pointing at the null character.
1315 If \ is followed by 000, we return 0 and leave the string pointer
1316 after the zeros. A value of 0 does not mean end of string. */
1319 parse_escape (string_ptr
)
1322 register int c
= *(*string_ptr
)++;
1326 return 007; /* Bell (alert) char */
1329 case 'e': /* Escape character */
1347 c
= *(*string_ptr
)++;
1349 c
= parse_escape (string_ptr
);
1352 return (c
& 0200) | (c
& 037);
1363 register int i
= c
- '0';
1364 register int count
= 0;
1367 if ((c
= *(*string_ptr
)++) >= '0' && c
<= '7')
1385 /* Print the character C on STREAM as part of the contents of a literal
1386 string whose delimiter is QUOTER. Note that this routine should only
1387 be call for printing things which are independent of the language
1388 of the program being debugged. */
1390 static void printchar (int c
, void (*do_fputs
) (const char *, struct ui_file
*), void (*do_fprintf
) (struct ui_file
*, const char *, ...), struct ui_file
*stream
, int quoter
);
1393 printchar (c
, do_fputs
, do_fprintf
, stream
, quoter
)
1395 void (*do_fputs
) PARAMS ((const char *, struct ui_file
*));
1396 void (*do_fprintf
) PARAMS ((struct ui_file
*, const char *, ...));
1397 struct ui_file
*stream
;
1401 c
&= 0xFF; /* Avoid sign bit follies */
1403 if (c
< 0x20 || /* Low control chars */
1404 (c
>= 0x7F && c
< 0xA0) || /* DEL, High controls */
1405 (sevenbit_strings
&& c
>= 0x80))
1406 { /* high order bit set */
1410 do_fputs ("\\n", stream
);
1413 do_fputs ("\\b", stream
);
1416 do_fputs ("\\t", stream
);
1419 do_fputs ("\\f", stream
);
1422 do_fputs ("\\r", stream
);
1425 do_fputs ("\\e", stream
);
1428 do_fputs ("\\a", stream
);
1431 do_fprintf (stream
, "\\%.3o", (unsigned int) c
);
1437 if (c
== '\\' || c
== quoter
)
1438 do_fputs ("\\", stream
);
1439 do_fprintf (stream
, "%c", c
);
1443 /* Print the character C on STREAM as part of the contents of a
1444 literal string whose delimiter is QUOTER. Note that these routines
1445 should only be call for printing things which are independent of
1446 the language of the program being debugged. */
1449 fputstr_filtered (str
, quoter
, stream
)
1452 struct ui_file
*stream
;
1455 printchar (*str
++, fputs_filtered
, fprintf_filtered
, stream
, quoter
);
1459 fputstr_unfiltered (str
, quoter
, stream
)
1462 struct ui_file
*stream
;
1465 printchar (*str
++, fputs_unfiltered
, fprintf_unfiltered
, stream
, quoter
);
1469 fputstrn_unfiltered (str
, n
, quoter
, stream
)
1473 struct ui_file
*stream
;
1476 for (i
= 0; i
< n
; i
++)
1477 printchar (str
[i
], fputs_unfiltered
, fprintf_unfiltered
, stream
, quoter
);
1482 /* Number of lines per page or UINT_MAX if paging is disabled. */
1483 static unsigned int lines_per_page
;
1484 /* Number of chars per line or UNIT_MAX if line folding is disabled. */
1485 static unsigned int chars_per_line
;
1486 /* Current count of lines printed on this page, chars on this line. */
1487 static unsigned int lines_printed
, chars_printed
;
1489 /* Buffer and start column of buffered text, for doing smarter word-
1490 wrapping. When someone calls wrap_here(), we start buffering output
1491 that comes through fputs_filtered(). If we see a newline, we just
1492 spit it out and forget about the wrap_here(). If we see another
1493 wrap_here(), we spit it out and remember the newer one. If we see
1494 the end of the line, we spit out a newline, the indent, and then
1495 the buffered output. */
1497 /* Malloc'd buffer with chars_per_line+2 bytes. Contains characters which
1498 are waiting to be output (they have already been counted in chars_printed).
1499 When wrap_buffer[0] is null, the buffer is empty. */
1500 static char *wrap_buffer
;
1502 /* Pointer in wrap_buffer to the next character to fill. */
1503 static char *wrap_pointer
;
1505 /* String to indent by if the wrap occurs. Must not be NULL if wrap_column
1507 static char *wrap_indent
;
1509 /* Column number on the screen where wrap_buffer begins, or 0 if wrapping
1510 is not in effect. */
1511 static int wrap_column
;
1514 /* Inialize the lines and chars per page */
1519 if (tui_version
&& m_winPtrNotNull (cmdWin
))
1521 lines_per_page
= cmdWin
->generic
.height
;
1522 chars_per_line
= cmdWin
->generic
.width
;
1527 /* These defaults will be used if we are unable to get the correct
1528 values from termcap. */
1529 #if defined(__GO32__)
1530 lines_per_page
= ScreenRows ();
1531 chars_per_line
= ScreenCols ();
1533 lines_per_page
= 24;
1534 chars_per_line
= 80;
1536 #if !defined (MPW) && !defined (_WIN32)
1537 /* No termcap under MPW, although might be cool to do something
1538 by looking at worksheet or console window sizes. */
1539 /* Initialize the screen height and width from termcap. */
1541 char *termtype
= getenv ("TERM");
1543 /* Positive means success, nonpositive means failure. */
1546 /* 2048 is large enough for all known terminals, according to the
1547 GNU termcap manual. */
1548 char term_buffer
[2048];
1552 status
= tgetent (term_buffer
, termtype
);
1556 int running_in_emacs
= getenv ("EMACS") != NULL
;
1558 val
= tgetnum ("li");
1559 if (val
>= 0 && !running_in_emacs
)
1560 lines_per_page
= val
;
1562 /* The number of lines per page is not mentioned
1563 in the terminal description. This probably means
1564 that paging is not useful (e.g. emacs shell window),
1565 so disable paging. */
1566 lines_per_page
= UINT_MAX
;
1568 val
= tgetnum ("co");
1570 chars_per_line
= val
;
1576 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1578 /* If there is a better way to determine the window size, use it. */
1579 SIGWINCH_HANDLER (SIGWINCH
);
1582 /* If the output is not a terminal, don't paginate it. */
1583 if (!ui_file_isatty (gdb_stdout
))
1584 lines_per_page
= UINT_MAX
;
1585 } /* the command_line_version */
1592 if (chars_per_line
== 0)
1597 wrap_buffer
= (char *) xmalloc (chars_per_line
+ 2);
1598 wrap_buffer
[0] = '\0';
1601 wrap_buffer
= (char *) xrealloc (wrap_buffer
, chars_per_line
+ 2);
1602 wrap_pointer
= wrap_buffer
; /* Start it at the beginning */
1607 set_width_command (args
, from_tty
, c
)
1610 struct cmd_list_element
*c
;
1615 /* Wait, so the user can read what's on the screen. Prompt the user
1616 to continue by pressing RETURN. */
1619 prompt_for_continue ()
1622 char cont_prompt
[120];
1624 if (annotation_level
> 1)
1625 printf_unfiltered ("\n\032\032pre-prompt-for-continue\n");
1627 strcpy (cont_prompt
,
1628 "---Type <return> to continue, or q <return> to quit---");
1629 if (annotation_level
> 1)
1630 strcat (cont_prompt
, "\n\032\032prompt-for-continue\n");
1632 /* We must do this *before* we call gdb_readline, else it will eventually
1633 call us -- thinking that we're trying to print beyond the end of the
1635 reinitialize_more_filter ();
1638 /* On a real operating system, the user can quit with SIGINT.
1641 'q' is provided on all systems so users don't have to change habits
1642 from system to system, and because telling them what to do in
1643 the prompt is more user-friendly than expecting them to think of
1645 /* Call readline, not gdb_readline, because GO32 readline handles control-C
1646 whereas control-C to gdb_readline will cause the user to get dumped
1648 ignore
= readline (cont_prompt
);
1650 if (annotation_level
> 1)
1651 printf_unfiltered ("\n\032\032post-prompt-for-continue\n");
1656 while (*p
== ' ' || *p
== '\t')
1661 request_quit (SIGINT
);
1663 async_request_quit (0);
1669 /* Now we have to do this again, so that GDB will know that it doesn't
1670 need to save the ---Type <return>--- line at the top of the screen. */
1671 reinitialize_more_filter ();
1673 dont_repeat (); /* Forget prev cmd -- CR won't repeat it. */
1676 /* Reinitialize filter; ie. tell it to reset to original values. */
1679 reinitialize_more_filter ()
1685 /* Indicate that if the next sequence of characters overflows the line,
1686 a newline should be inserted here rather than when it hits the end.
1687 If INDENT is non-null, it is a string to be printed to indent the
1688 wrapped part on the next line. INDENT must remain accessible until
1689 the next call to wrap_here() or until a newline is printed through
1692 If the line is already overfull, we immediately print a newline and
1693 the indentation, and disable further wrapping.
1695 If we don't know the width of lines, but we know the page height,
1696 we must not wrap words, but should still keep track of newlines
1697 that were explicitly printed.
1699 INDENT should not contain tabs, as that will mess up the char count
1700 on the next line. FIXME.
1702 This routine is guaranteed to force out any output which has been
1703 squirreled away in the wrap_buffer, so wrap_here ((char *)0) can be
1704 used to force out output from the wrap_buffer. */
1710 /* This should have been allocated, but be paranoid anyway. */
1716 *wrap_pointer
= '\0';
1717 fputs_unfiltered (wrap_buffer
, gdb_stdout
);
1719 wrap_pointer
= wrap_buffer
;
1720 wrap_buffer
[0] = '\0';
1721 if (chars_per_line
== UINT_MAX
) /* No line overflow checking */
1725 else if (chars_printed
>= chars_per_line
)
1727 puts_filtered ("\n");
1729 puts_filtered (indent
);
1734 wrap_column
= chars_printed
;
1738 wrap_indent
= indent
;
1742 /* Ensure that whatever gets printed next, using the filtered output
1743 commands, starts at the beginning of the line. I.E. if there is
1744 any pending output for the current line, flush it and start a new
1745 line. Otherwise do nothing. */
1750 if (chars_printed
> 0)
1752 puts_filtered ("\n");
1757 /* Like fputs but if FILTER is true, pause after every screenful.
1759 Regardless of FILTER can wrap at points other than the final
1760 character of a line.
1762 Unlike fputs, fputs_maybe_filtered does not return a value.
1763 It is OK for LINEBUFFER to be NULL, in which case just don't print
1766 Note that a longjmp to top level may occur in this routine (only if
1767 FILTER is true) (since prompt_for_continue may do so) so this
1768 routine should not be called when cleanups are not in place. */
1771 fputs_maybe_filtered (linebuffer
, stream
, filter
)
1772 const char *linebuffer
;
1773 struct ui_file
*stream
;
1776 const char *lineptr
;
1778 if (linebuffer
== 0)
1781 /* Don't do any filtering if it is disabled. */
1782 if ((stream
!= gdb_stdout
) || !pagination_enabled
1783 || (lines_per_page
== UINT_MAX
&& chars_per_line
== UINT_MAX
))
1785 fputs_unfiltered (linebuffer
, stream
);
1789 /* Go through and output each character. Show line extension
1790 when this is necessary; prompt user for new page when this is
1793 lineptr
= linebuffer
;
1796 /* Possible new page. */
1798 (lines_printed
>= lines_per_page
- 1))
1799 prompt_for_continue ();
1801 while (*lineptr
&& *lineptr
!= '\n')
1803 /* Print a single line. */
1804 if (*lineptr
== '\t')
1807 *wrap_pointer
++ = '\t';
1809 fputc_unfiltered ('\t', stream
);
1810 /* Shifting right by 3 produces the number of tab stops
1811 we have already passed, and then adding one and
1812 shifting left 3 advances to the next tab stop. */
1813 chars_printed
= ((chars_printed
>> 3) + 1) << 3;
1819 *wrap_pointer
++ = *lineptr
;
1821 fputc_unfiltered (*lineptr
, stream
);
1826 if (chars_printed
>= chars_per_line
)
1828 unsigned int save_chars
= chars_printed
;
1832 /* If we aren't actually wrapping, don't output newline --
1833 if chars_per_line is right, we probably just overflowed
1834 anyway; if it's wrong, let us keep going. */
1836 fputc_unfiltered ('\n', stream
);
1838 /* Possible new page. */
1839 if (lines_printed
>= lines_per_page
- 1)
1840 prompt_for_continue ();
1842 /* Now output indentation and wrapped string */
1845 fputs_unfiltered (wrap_indent
, stream
);
1846 *wrap_pointer
= '\0'; /* Null-terminate saved stuff */
1847 fputs_unfiltered (wrap_buffer
, stream
); /* and eject it */
1848 /* FIXME, this strlen is what prevents wrap_indent from
1849 containing tabs. However, if we recurse to print it
1850 and count its chars, we risk trouble if wrap_indent is
1851 longer than (the user settable) chars_per_line.
1852 Note also that this can set chars_printed > chars_per_line
1853 if we are printing a long string. */
1854 chars_printed
= strlen (wrap_indent
)
1855 + (save_chars
- wrap_column
);
1856 wrap_pointer
= wrap_buffer
; /* Reset buffer */
1857 wrap_buffer
[0] = '\0';
1858 wrap_column
= 0; /* And disable fancy wrap */
1863 if (*lineptr
== '\n')
1866 wrap_here ((char *) 0); /* Spit out chars, cancel further wraps */
1868 fputc_unfiltered ('\n', stream
);
1875 fputs_filtered (linebuffer
, stream
)
1876 const char *linebuffer
;
1877 struct ui_file
*stream
;
1879 fputs_maybe_filtered (linebuffer
, stream
, 1);
1883 putchar_unfiltered (c
)
1887 ui_file_write (gdb_stdout
, &buf
, 1);
1892 fputc_unfiltered (c
, stream
)
1894 struct ui_file
*stream
;
1897 ui_file_write (stream
, &buf
, 1);
1902 fputc_filtered (c
, stream
)
1904 struct ui_file
*stream
;
1910 fputs_filtered (buf
, stream
);
1914 /* puts_debug is like fputs_unfiltered, except it prints special
1915 characters in printable fashion. */
1918 puts_debug (prefix
, string
, suffix
)
1925 /* Print prefix and suffix after each line. */
1926 static int new_line
= 1;
1927 static int return_p
= 0;
1928 static char *prev_prefix
= "";
1929 static char *prev_suffix
= "";
1931 if (*string
== '\n')
1934 /* If the prefix is changing, print the previous suffix, a new line,
1935 and the new prefix. */
1936 if ((return_p
|| (strcmp (prev_prefix
, prefix
) != 0)) && !new_line
)
1938 fputs_unfiltered (prev_suffix
, gdb_stdlog
);
1939 fputs_unfiltered ("\n", gdb_stdlog
);
1940 fputs_unfiltered (prefix
, gdb_stdlog
);
1943 /* Print prefix if we printed a newline during the previous call. */
1947 fputs_unfiltered (prefix
, gdb_stdlog
);
1950 prev_prefix
= prefix
;
1951 prev_suffix
= suffix
;
1953 /* Output characters in a printable format. */
1954 while ((ch
= *string
++) != '\0')
1960 fputc_unfiltered (ch
, gdb_stdlog
);
1963 fprintf_unfiltered (gdb_stdlog
, "\\x%02x", ch
& 0xff);
1967 fputs_unfiltered ("\\\\", gdb_stdlog
);
1970 fputs_unfiltered ("\\b", gdb_stdlog
);
1973 fputs_unfiltered ("\\f", gdb_stdlog
);
1977 fputs_unfiltered ("\\n", gdb_stdlog
);
1980 fputs_unfiltered ("\\r", gdb_stdlog
);
1983 fputs_unfiltered ("\\t", gdb_stdlog
);
1986 fputs_unfiltered ("\\v", gdb_stdlog
);
1990 return_p
= ch
== '\r';
1993 /* Print suffix if we printed a newline. */
1996 fputs_unfiltered (suffix
, gdb_stdlog
);
1997 fputs_unfiltered ("\n", gdb_stdlog
);
2002 /* Print a variable number of ARGS using format FORMAT. If this
2003 information is going to put the amount written (since the last call
2004 to REINITIALIZE_MORE_FILTER or the last page break) over the page size,
2005 call prompt_for_continue to get the users permision to continue.
2007 Unlike fprintf, this function does not return a value.
2009 We implement three variants, vfprintf (takes a vararg list and stream),
2010 fprintf (takes a stream to write on), and printf (the usual).
2012 Note also that a longjmp to top level may occur in this routine
2013 (since prompt_for_continue may do so) so this routine should not be
2014 called when cleanups are not in place. */
2017 vfprintf_maybe_filtered (stream
, format
, args
, filter
)
2018 struct ui_file
*stream
;
2024 struct cleanup
*old_cleanups
;
2026 vasprintf (&linebuffer
, format
, args
);
2027 if (linebuffer
== NULL
)
2029 fputs_unfiltered ("\ngdb: virtual memory exhausted.\n", gdb_stderr
);
2032 old_cleanups
= make_cleanup (free
, linebuffer
);
2033 fputs_maybe_filtered (linebuffer
, stream
, filter
);
2034 do_cleanups (old_cleanups
);
2039 vfprintf_filtered (stream
, format
, args
)
2040 struct ui_file
*stream
;
2044 vfprintf_maybe_filtered (stream
, format
, args
, 1);
2048 vfprintf_unfiltered (stream
, format
, args
)
2049 struct ui_file
*stream
;
2054 struct cleanup
*old_cleanups
;
2056 vasprintf (&linebuffer
, format
, args
);
2057 if (linebuffer
== NULL
)
2059 fputs_unfiltered ("\ngdb: virtual memory exhausted.\n", gdb_stderr
);
2062 old_cleanups
= make_cleanup (free
, linebuffer
);
2063 fputs_unfiltered (linebuffer
, stream
);
2064 do_cleanups (old_cleanups
);
2068 vprintf_filtered (format
, args
)
2072 vfprintf_maybe_filtered (gdb_stdout
, format
, args
, 1);
2076 vprintf_unfiltered (format
, args
)
2080 vfprintf_unfiltered (gdb_stdout
, format
, args
);
2084 fprintf_filtered (struct ui_file
* stream
, const char *format
,...)
2087 va_start (args
, format
);
2088 vfprintf_filtered (stream
, format
, args
);
2093 fprintf_unfiltered (struct ui_file
* stream
, const char *format
,...)
2096 va_start (args
, format
);
2097 vfprintf_unfiltered (stream
, format
, args
);
2101 /* Like fprintf_filtered, but prints its result indented.
2102 Called as fprintfi_filtered (spaces, stream, format, ...); */
2105 fprintfi_filtered (int spaces
, struct ui_file
* stream
, const char *format
,...)
2108 va_start (args
, format
);
2109 print_spaces_filtered (spaces
, stream
);
2111 vfprintf_filtered (stream
, format
, args
);
2117 printf_filtered (const char *format
,...)
2120 va_start (args
, format
);
2121 vfprintf_filtered (gdb_stdout
, format
, args
);
2127 printf_unfiltered (const char *format
,...)
2130 va_start (args
, format
);
2131 vfprintf_unfiltered (gdb_stdout
, format
, args
);
2135 /* Like printf_filtered, but prints it's result indented.
2136 Called as printfi_filtered (spaces, format, ...); */
2139 printfi_filtered (int spaces
, const char *format
,...)
2142 va_start (args
, format
);
2143 print_spaces_filtered (spaces
, gdb_stdout
);
2144 vfprintf_filtered (gdb_stdout
, format
, args
);
2148 /* Easy -- but watch out!
2150 This routine is *not* a replacement for puts()! puts() appends a newline.
2151 This one doesn't, and had better not! */
2154 puts_filtered (string
)
2157 fputs_filtered (string
, gdb_stdout
);
2161 puts_unfiltered (string
)
2164 fputs_unfiltered (string
, gdb_stdout
);
2167 /* Return a pointer to N spaces and a null. The pointer is good
2168 until the next call to here. */
2174 static char *spaces
= 0;
2175 static int max_spaces
= -1;
2181 spaces
= (char *) xmalloc (n
+ 1);
2182 for (t
= spaces
+ n
; t
!= spaces
;)
2188 return spaces
+ max_spaces
- n
;
2191 /* Print N spaces. */
2193 print_spaces_filtered (n
, stream
)
2195 struct ui_file
*stream
;
2197 fputs_filtered (n_spaces (n
), stream
);
2200 /* C++ demangler stuff. */
2202 /* fprintf_symbol_filtered attempts to demangle NAME, a symbol in language
2203 LANG, using demangling args ARG_MODE, and print it filtered to STREAM.
2204 If the name is not mangled, or the language for the name is unknown, or
2205 demangling is off, the name is printed in its "raw" form. */
2208 fprintf_symbol_filtered (stream
, name
, lang
, arg_mode
)
2209 struct ui_file
*stream
;
2218 /* If user wants to see raw output, no problem. */
2221 fputs_filtered (name
, stream
);
2227 case language_cplus
:
2228 demangled
= cplus_demangle (name
, arg_mode
);
2231 demangled
= cplus_demangle (name
, arg_mode
| DMGL_JAVA
);
2233 case language_chill
:
2234 demangled
= chill_demangle (name
);
2240 fputs_filtered (demangled
? demangled
: name
, stream
);
2241 if (demangled
!= NULL
)
2249 /* Do a strcmp() type operation on STRING1 and STRING2, ignoring any
2250 differences in whitespace. Returns 0 if they match, non-zero if they
2251 don't (slightly different than strcmp()'s range of return values).
2253 As an extra hack, string1=="FOO(ARGS)" matches string2=="FOO".
2254 This "feature" is useful when searching for matching C++ function names
2255 (such as if the user types 'break FOO', where FOO is a mangled C++
2259 strcmp_iw (string1
, string2
)
2260 const char *string1
;
2261 const char *string2
;
2263 while ((*string1
!= '\0') && (*string2
!= '\0'))
2265 while (isspace (*string1
))
2269 while (isspace (*string2
))
2273 if (*string1
!= *string2
)
2277 if (*string1
!= '\0')
2283 return (*string1
!= '\0' && *string1
!= '(') || (*string2
!= '\0');
2289 ** Answer whether string_to_compare is a full or partial match to
2290 ** template_string. The partial match must be in sequence starting
2294 subset_compare (string_to_compare
, template_string
)
2295 char *string_to_compare
;
2296 char *template_string
;
2299 if (template_string
!= (char *) NULL
&& string_to_compare
!= (char *) NULL
&&
2300 strlen (string_to_compare
) <= strlen (template_string
))
2301 match
= (strncmp (template_string
,
2303 strlen (string_to_compare
)) == 0);
2310 static void pagination_on_command
PARAMS ((char *arg
, int from_tty
));
2312 pagination_on_command (arg
, from_tty
)
2316 pagination_enabled
= 1;
2319 static void pagination_on_command
PARAMS ((char *arg
, int from_tty
));
2321 pagination_off_command (arg
, from_tty
)
2325 pagination_enabled
= 0;
2332 struct cmd_list_element
*c
;
2334 c
= add_set_cmd ("width", class_support
, var_uinteger
,
2335 (char *) &chars_per_line
,
2336 "Set number of characters gdb thinks are in a line.",
2338 add_show_from_set (c
, &showlist
);
2339 c
->function
.sfunc
= set_width_command
;
2342 (add_set_cmd ("height", class_support
,
2343 var_uinteger
, (char *) &lines_per_page
,
2344 "Set number of lines gdb thinks are in a page.", &setlist
),
2349 /* If the output is not a terminal, don't paginate it. */
2350 if (!ui_file_isatty (gdb_stdout
))
2351 lines_per_page
= UINT_MAX
;
2353 set_width_command ((char *) NULL
, 0, c
);
2356 (add_set_cmd ("demangle", class_support
, var_boolean
,
2358 "Set demangling of encoded C++ names when displaying symbols.",
2363 (add_set_cmd ("pagination", class_support
,
2364 var_boolean
, (char *) &pagination_enabled
,
2365 "Set state of pagination.", &setlist
),
2369 add_com ("am", class_support
, pagination_on_command
,
2370 "Enable pagination");
2371 add_com ("sm", class_support
, pagination_off_command
,
2372 "Disable pagination");
2376 (add_set_cmd ("sevenbit-strings", class_support
, var_boolean
,
2377 (char *) &sevenbit_strings
,
2378 "Set printing of 8-bit characters in strings as \\nnn.",
2383 (add_set_cmd ("asm-demangle", class_support
, var_boolean
,
2384 (char *) &asm_demangle
,
2385 "Set demangling of C++ names in disassembly listings.",
2390 /* Machine specific function to handle SIGWINCH signal. */
2392 #ifdef SIGWINCH_HANDLER_BODY
2393 SIGWINCH_HANDLER_BODY
2396 /* Support for converting target fp numbers into host DOUBLEST format. */
2398 /* XXX - This code should really be in libiberty/floatformat.c, however
2399 configuration issues with libiberty made this very difficult to do in the
2402 #include "floatformat.h"
2403 #include <math.h> /* ldexp */
2405 /* The odds that CHAR_BIT will be anything but 8 are low enough that I'm not
2406 going to bother with trying to muck around with whether it is defined in
2407 a system header, what we do if not, etc. */
2408 #define FLOATFORMAT_CHAR_BIT 8
2410 static unsigned long get_field
PARAMS ((unsigned char *,
2411 enum floatformat_byteorders
,
2416 /* Extract a field which starts at START and is LEN bytes long. DATA and
2417 TOTAL_LEN are the thing we are extracting it from, in byteorder ORDER. */
2418 static unsigned long
2419 get_field (data
, order
, total_len
, start
, len
)
2420 unsigned char *data
;
2421 enum floatformat_byteorders order
;
2422 unsigned int total_len
;
2426 unsigned long result
;
2427 unsigned int cur_byte
;
2430 /* Start at the least significant part of the field. */
2431 if (order
== floatformat_little
|| order
== floatformat_littlebyte_bigword
)
2433 /* We start counting from the other end (i.e, from the high bytes
2434 rather than the low bytes). As such, we need to be concerned
2435 with what happens if bit 0 doesn't start on a byte boundary.
2436 I.e, we need to properly handle the case where total_len is
2437 not evenly divisible by 8. So we compute ``excess'' which
2438 represents the number of bits from the end of our starting
2439 byte needed to get to bit 0. */
2440 int excess
= FLOATFORMAT_CHAR_BIT
- (total_len
% FLOATFORMAT_CHAR_BIT
);
2441 cur_byte
= (total_len
/ FLOATFORMAT_CHAR_BIT
)
2442 - ((start
+ len
+ excess
) / FLOATFORMAT_CHAR_BIT
);
2443 cur_bitshift
= ((start
+ len
+ excess
) % FLOATFORMAT_CHAR_BIT
)
2444 - FLOATFORMAT_CHAR_BIT
;
2448 cur_byte
= (start
+ len
) / FLOATFORMAT_CHAR_BIT
;
2450 ((start
+ len
) % FLOATFORMAT_CHAR_BIT
) - FLOATFORMAT_CHAR_BIT
;
2452 if (cur_bitshift
> -FLOATFORMAT_CHAR_BIT
)
2453 result
= *(data
+ cur_byte
) >> (-cur_bitshift
);
2456 cur_bitshift
+= FLOATFORMAT_CHAR_BIT
;
2457 if (order
== floatformat_little
|| order
== floatformat_littlebyte_bigword
)
2462 /* Move towards the most significant part of the field. */
2463 while (cur_bitshift
< len
)
2465 result
|= (unsigned long)*(data
+ cur_byte
) << cur_bitshift
;
2466 cur_bitshift
+= FLOATFORMAT_CHAR_BIT
;
2467 if (order
== floatformat_little
|| order
== floatformat_littlebyte_bigword
)
2472 if (len
< sizeof(result
) * FLOATFORMAT_CHAR_BIT
)
2473 /* Mask out bits which are not part of the field */
2474 result
&= ((1UL << len
) - 1);
2478 /* Convert from FMT to a DOUBLEST.
2479 FROM is the address of the extended float.
2480 Store the DOUBLEST in *TO. */
2483 floatformat_to_doublest (fmt
, from
, to
)
2484 const struct floatformat
*fmt
;
2488 unsigned char *ufrom
= (unsigned char *) from
;
2492 unsigned int mant_bits
, mant_off
;
2494 int special_exponent
; /* It's a NaN, denorm or zero */
2496 /* If the mantissa bits are not contiguous from one end of the
2497 mantissa to the other, we need to make a private copy of the
2498 source bytes that is in the right order since the unpacking
2499 algorithm assumes that the bits are contiguous.
2501 Swap the bytes individually rather than accessing them through
2502 "long *" since we have no guarantee that they start on a long
2503 alignment, and also sizeof(long) for the host could be different
2504 than sizeof(long) for the target. FIXME: Assumes sizeof(long)
2505 for the target is 4. */
2507 if (fmt
->byteorder
== floatformat_littlebyte_bigword
)
2509 static unsigned char *newfrom
;
2510 unsigned char *swapin
, *swapout
;
2513 longswaps
= fmt
->totalsize
/ FLOATFORMAT_CHAR_BIT
;
2516 if (newfrom
== NULL
)
2518 newfrom
= (unsigned char *) xmalloc (fmt
->totalsize
);
2523 while (longswaps
-- > 0)
2525 /* This is ugly, but efficient */
2526 *swapout
++ = swapin
[4];
2527 *swapout
++ = swapin
[5];
2528 *swapout
++ = swapin
[6];
2529 *swapout
++ = swapin
[7];
2530 *swapout
++ = swapin
[0];
2531 *swapout
++ = swapin
[1];
2532 *swapout
++ = swapin
[2];
2533 *swapout
++ = swapin
[3];
2538 exponent
= get_field (ufrom
, fmt
->byteorder
, fmt
->totalsize
,
2539 fmt
->exp_start
, fmt
->exp_len
);
2540 /* Note that if exponent indicates a NaN, we can't really do anything useful
2541 (not knowing if the host has NaN's, or how to build one). So it will
2542 end up as an infinity or something close; that is OK. */
2544 mant_bits_left
= fmt
->man_len
;
2545 mant_off
= fmt
->man_start
;
2548 special_exponent
= exponent
== 0 || exponent
== fmt
->exp_nan
;
2550 /* Don't bias NaNs. Use minimum exponent for denorms. For simplicity,
2551 we don't check for zero as the exponent doesn't matter. */
2552 if (!special_exponent
)
2553 exponent
-= fmt
->exp_bias
;
2554 else if (exponent
== 0)
2555 exponent
= 1 - fmt
->exp_bias
;
2557 /* Build the result algebraically. Might go infinite, underflow, etc;
2560 /* If this format uses a hidden bit, explicitly add it in now. Otherwise,
2561 increment the exponent by one to account for the integer bit. */
2563 if (!special_exponent
)
2565 if (fmt
->intbit
== floatformat_intbit_no
)
2566 dto
= ldexp (1.0, exponent
);
2571 while (mant_bits_left
> 0)
2573 mant_bits
= min (mant_bits_left
, 32);
2575 mant
= get_field (ufrom
, fmt
->byteorder
, fmt
->totalsize
,
2576 mant_off
, mant_bits
);
2578 dto
+= ldexp ((double) mant
, exponent
- mant_bits
);
2579 exponent
-= mant_bits
;
2580 mant_off
+= mant_bits
;
2581 mant_bits_left
-= mant_bits
;
2584 /* Negate it if negative. */
2585 if (get_field (ufrom
, fmt
->byteorder
, fmt
->totalsize
, fmt
->sign_start
, 1))
2590 static void put_field
PARAMS ((unsigned char *, enum floatformat_byteorders
,
2596 /* Set a field which starts at START and is LEN bytes long. DATA and
2597 TOTAL_LEN are the thing we are extracting it from, in byteorder ORDER. */
2599 put_field (data
, order
, total_len
, start
, len
, stuff_to_put
)
2600 unsigned char *data
;
2601 enum floatformat_byteorders order
;
2602 unsigned int total_len
;
2605 unsigned long stuff_to_put
;
2607 unsigned int cur_byte
;
2610 /* Start at the least significant part of the field. */
2611 if (order
== floatformat_little
|| order
== floatformat_littlebyte_bigword
)
2613 int excess
= FLOATFORMAT_CHAR_BIT
- (total_len
% FLOATFORMAT_CHAR_BIT
);
2614 cur_byte
= (total_len
/ FLOATFORMAT_CHAR_BIT
)
2615 - ((start
+ len
+ excess
) / FLOATFORMAT_CHAR_BIT
);
2616 cur_bitshift
= ((start
+ len
+ excess
) % FLOATFORMAT_CHAR_BIT
)
2617 - FLOATFORMAT_CHAR_BIT
;
2621 cur_byte
= (start
+ len
) / FLOATFORMAT_CHAR_BIT
;
2623 ((start
+ len
) % FLOATFORMAT_CHAR_BIT
) - FLOATFORMAT_CHAR_BIT
;
2625 if (cur_bitshift
> -FLOATFORMAT_CHAR_BIT
)
2627 *(data
+ cur_byte
) &=
2628 ~(((1 << ((start
+ len
) % FLOATFORMAT_CHAR_BIT
)) - 1)
2629 << (-cur_bitshift
));
2630 *(data
+ cur_byte
) |=
2631 (stuff_to_put
& ((1 << FLOATFORMAT_CHAR_BIT
) - 1)) << (-cur_bitshift
);
2633 cur_bitshift
+= FLOATFORMAT_CHAR_BIT
;
2634 if (order
== floatformat_little
|| order
== floatformat_littlebyte_bigword
)
2639 /* Move towards the most significant part of the field. */
2640 while (cur_bitshift
< len
)
2642 if (len
- cur_bitshift
< FLOATFORMAT_CHAR_BIT
)
2644 /* This is the last byte. */
2645 *(data
+ cur_byte
) &=
2646 ~((1 << (len
- cur_bitshift
)) - 1);
2647 *(data
+ cur_byte
) |= (stuff_to_put
>> cur_bitshift
);
2650 *(data
+ cur_byte
) = ((stuff_to_put
>> cur_bitshift
)
2651 & ((1 << FLOATFORMAT_CHAR_BIT
) - 1));
2652 cur_bitshift
+= FLOATFORMAT_CHAR_BIT
;
2653 if (order
== floatformat_little
|| order
== floatformat_littlebyte_bigword
)
2660 #ifdef HAVE_LONG_DOUBLE
2661 /* Return the fractional part of VALUE, and put the exponent of VALUE in *EPTR.
2662 The range of the returned value is >= 0.5 and < 1.0. This is equivalent to
2663 frexp, but operates on the long double data type. */
2665 static long double ldfrexp
PARAMS ((long double value
, int *eptr
));
2668 ldfrexp (value
, eptr
)
2675 /* Unfortunately, there are no portable functions for extracting the exponent
2676 of a long double, so we have to do it iteratively by multiplying or dividing
2677 by two until the fraction is between 0.5 and 1.0. */
2685 if (value
>= tmp
) /* Value >= 1.0 */
2686 while (value
>= tmp
)
2691 else if (value
!= 0.0l) /* Value < 1.0 and > 0.0 */
2705 #endif /* HAVE_LONG_DOUBLE */
2708 /* The converse: convert the DOUBLEST *FROM to an extended float
2709 and store where TO points. Neither FROM nor TO have any alignment
2713 floatformat_from_doublest (fmt
, from
, to
)
2714 CONST
struct floatformat
*fmt
;
2721 unsigned int mant_bits
, mant_off
;
2723 unsigned char *uto
= (unsigned char *) to
;
2725 memcpy (&dfrom
, from
, sizeof (dfrom
));
2726 memset (uto
, 0, (fmt
->totalsize
+ FLOATFORMAT_CHAR_BIT
- 1)
2727 / FLOATFORMAT_CHAR_BIT
);
2729 return; /* Result is zero */
2730 if (dfrom
!= dfrom
) /* Result is NaN */
2733 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->exp_start
,
2734 fmt
->exp_len
, fmt
->exp_nan
);
2735 /* Be sure it's not infinity, but NaN value is irrel */
2736 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->man_start
,
2741 /* If negative, set the sign bit. */
2744 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->sign_start
, 1, 1);
2748 if (dfrom
+ dfrom
== dfrom
&& dfrom
!= 0.0) /* Result is Infinity */
2750 /* Infinity exponent is same as NaN's. */
2751 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->exp_start
,
2752 fmt
->exp_len
, fmt
->exp_nan
);
2753 /* Infinity mantissa is all zeroes. */
2754 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->man_start
,
2759 #ifdef HAVE_LONG_DOUBLE
2760 mant
= ldfrexp (dfrom
, &exponent
);
2762 mant
= frexp (dfrom
, &exponent
);
2765 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->exp_start
, fmt
->exp_len
,
2766 exponent
+ fmt
->exp_bias
- 1);
2768 mant_bits_left
= fmt
->man_len
;
2769 mant_off
= fmt
->man_start
;
2770 while (mant_bits_left
> 0)
2772 unsigned long mant_long
;
2773 mant_bits
= mant_bits_left
< 32 ? mant_bits_left
: 32;
2775 mant
*= 4294967296.0;
2776 mant_long
= ((unsigned long) mant
) & 0xffffffffL
;
2779 /* If the integer bit is implicit, then we need to discard it.
2780 If we are discarding a zero, we should be (but are not) creating
2781 a denormalized number which means adjusting the exponent
2783 if (mant_bits_left
== fmt
->man_len
2784 && fmt
->intbit
== floatformat_intbit_no
)
2787 mant_long
&= 0xffffffffL
;
2793 /* The bits we want are in the most significant MANT_BITS bits of
2794 mant_long. Move them to the least significant. */
2795 mant_long
>>= 32 - mant_bits
;
2798 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
,
2799 mant_off
, mant_bits
, mant_long
);
2800 mant_off
+= mant_bits
;
2801 mant_bits_left
-= mant_bits
;
2803 if (fmt
->byteorder
== floatformat_littlebyte_bigword
)
2806 unsigned char *swaplow
= uto
;
2807 unsigned char *swaphigh
= uto
+ 4;
2810 for (count
= 0; count
< 4; count
++)
2813 *swaplow
++ = *swaphigh
;
2819 /* temporary storage using circular buffer */
2825 static char buf
[NUMCELLS
][CELLSIZE
];
2826 static int cell
= 0;
2827 if (++cell
>= NUMCELLS
)
2832 /* print routines to handle variable size regs, etc.
2834 FIXME: Note that t_addr is a bfd_vma, which is currently either an
2835 unsigned long or unsigned long long, determined at configure time.
2836 If t_addr is an unsigned long long and sizeof (unsigned long long)
2837 is greater than sizeof (unsigned long), then I believe this code will
2838 probably lose, at least for little endian machines. I believe that
2839 it would also be better to eliminate the switch on the absolute size
2840 of t_addr and replace it with a sequence of if statements that compare
2841 sizeof t_addr with sizeof the various types and do the right thing,
2842 which includes knowing whether or not the host supports long long.
2850 return (TARGET_PTR_BIT
/ 8 * 2);
2854 /* eliminate warning from compiler on 32-bit systems */
2855 static int thirty_two
= 32;
2858 paddr (CORE_ADDR addr
)
2860 char *paddr_str
= get_cell ();
2861 switch (TARGET_PTR_BIT
/ 8)
2864 sprintf (paddr_str
, "%08lx%08lx",
2865 (unsigned long) (addr
>> thirty_two
), (unsigned long) (addr
& 0xffffffff));
2868 sprintf (paddr_str
, "%08lx", (unsigned long) addr
);
2871 sprintf (paddr_str
, "%04x", (unsigned short) (addr
& 0xffff));
2874 sprintf (paddr_str
, "%lx", (unsigned long) addr
);
2880 paddr_nz (CORE_ADDR addr
)
2882 char *paddr_str
= get_cell ();
2883 switch (TARGET_PTR_BIT
/ 8)
2887 unsigned long high
= (unsigned long) (addr
>> thirty_two
);
2889 sprintf (paddr_str
, "%lx", (unsigned long) (addr
& 0xffffffff));
2891 sprintf (paddr_str
, "%lx%08lx",
2892 high
, (unsigned long) (addr
& 0xffffffff));
2896 sprintf (paddr_str
, "%lx", (unsigned long) addr
);
2899 sprintf (paddr_str
, "%x", (unsigned short) (addr
& 0xffff));
2902 sprintf (paddr_str
, "%lx", (unsigned long) addr
);
2908 decimal2str (char *paddr_str
, char *sign
, ULONGEST addr
)
2910 /* steal code from valprint.c:print_decimal(). Should this worry
2911 about the real size of addr as the above does? */
2912 unsigned long temp
[3];
2916 temp
[i
] = addr
% (1000 * 1000 * 1000);
2917 addr
/= (1000 * 1000 * 1000);
2920 while (addr
!= 0 && i
< (sizeof (temp
) / sizeof (temp
[0])));
2924 sprintf (paddr_str
, "%s%lu",
2928 sprintf (paddr_str
, "%s%lu%09lu",
2929 sign
, temp
[1], temp
[0]);
2932 sprintf (paddr_str
, "%s%lu%09lu%09lu",
2933 sign
, temp
[2], temp
[1], temp
[0]);
2941 paddr_u (CORE_ADDR addr
)
2943 char *paddr_str
= get_cell ();
2944 decimal2str (paddr_str
, "", addr
);
2949 paddr_d (LONGEST addr
)
2951 char *paddr_str
= get_cell ();
2953 decimal2str (paddr_str
, "-", -addr
);
2955 decimal2str (paddr_str
, "", addr
);
2963 char *preg_str
= get_cell ();
2964 switch (sizeof (t_reg
))
2967 sprintf (preg_str
, "%08lx%08lx",
2968 (unsigned long) (reg
>> thirty_two
), (unsigned long) (reg
& 0xffffffff));
2971 sprintf (preg_str
, "%08lx", (unsigned long) reg
);
2974 sprintf (preg_str
, "%04x", (unsigned short) (reg
& 0xffff));
2977 sprintf (preg_str
, "%lx", (unsigned long) reg
);
2986 char *preg_str
= get_cell ();
2987 switch (sizeof (t_reg
))
2991 unsigned long high
= (unsigned long) (reg
>> thirty_two
);
2993 sprintf (preg_str
, "%lx", (unsigned long) (reg
& 0xffffffff));
2995 sprintf (preg_str
, "%lx%08lx",
2996 high
, (unsigned long) (reg
& 0xffffffff));
3000 sprintf (preg_str
, "%lx", (unsigned long) reg
);
3003 sprintf (preg_str
, "%x", (unsigned short) (reg
& 0xffff));
3006 sprintf (preg_str
, "%lx", (unsigned long) reg
);
3011 /* Helper functions for INNER_THAN */
3013 core_addr_lessthan (lhs
, rhs
)
3021 core_addr_greaterthan (lhs
, rhs
)