1 /* General utility routines for GDB, the GNU debugger.
3 Copyright 1986, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995,
4 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005 Free
5 Software Foundation, Inc.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 2 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program; if not, write to the Free Software
21 Foundation, Inc., 59 Temple Place - Suite 330,
22 Boston, MA 02111-1307, USA. */
25 #include "gdb_assert.h"
27 #include "gdb_string.h"
28 #include "event-top.h"
29 #include "exceptions.h"
32 #include "tui/tui.h" /* For tui_get_command_dimension. */
39 /* SunOS's curses.h has a '#define reg register' in it. Thank you Sun. */
50 #include "expression.h"
54 #include "filenames.h"
57 #include "inferior.h" /* for signed_pointer_to_address */
59 #include <sys/param.h> /* For MAXPATHLEN */
61 #include "gdb_curses.h"
63 #include "readline/readline.h"
66 extern PTR malloc (); /* OK: PTR */
68 #if !HAVE_DECL_REALLOC
69 extern PTR realloc (); /* OK: PTR */
75 /* readline defines this. */
78 void (*deprecated_error_begin_hook) (void);
80 /* Prototypes for local functions */
82 static void vfprintf_maybe_filtered (struct ui_file *, const char *,
85 static void fputs_maybe_filtered (const char *, struct ui_file *, int);
87 static void do_my_cleanups (struct cleanup **, struct cleanup *);
89 static void prompt_for_continue (void);
91 static void set_screen_size (void);
92 static void set_width (void);
94 /* Chain of cleanup actions established with make_cleanup,
95 to be executed if an error happens. */
97 static struct cleanup *cleanup_chain; /* cleaned up after a failed command */
98 static struct cleanup *final_cleanup_chain; /* cleaned up when gdb exits */
99 static struct cleanup *run_cleanup_chain; /* cleaned up on each 'run' */
100 static struct cleanup *exec_cleanup_chain; /* cleaned up on each execution command */
101 /* cleaned up on each error from within an execution command */
102 static struct cleanup *exec_error_cleanup_chain;
104 /* Pointer to what is left to do for an execution command after the
105 target stops. Used only in asynchronous mode, by targets that
106 support async execution. The finish and until commands use it. So
107 does the target extended-remote command. */
108 struct continuation *cmd_continuation;
109 struct continuation *intermediate_continuation;
111 /* Nonzero if we have job control. */
115 /* Nonzero means a quit has been requested. */
119 /* Nonzero means quit immediately if Control-C is typed now, rather
120 than waiting until QUIT is executed. Be careful in setting this;
121 code which executes with immediate_quit set has to be very careful
122 about being able to deal with being interrupted at any time. It is
123 almost always better to use QUIT; the only exception I can think of
124 is being able to quit out of a system call (using EINTR loses if
125 the SIGINT happens between the previous QUIT and the system call).
126 To immediately quit in the case in which a SIGINT happens between
127 the previous QUIT and setting immediate_quit (desirable anytime we
128 expect to block), call QUIT after setting immediate_quit. */
132 /* Nonzero means that encoded C++/ObjC names should be printed out in their
133 C++/ObjC form rather than raw. */
137 show_demangle (struct ui_file *file, int from_tty,
138 struct cmd_list_element *c, const char *value)
140 fprintf_filtered (file, _("\
141 Demangling of encoded C++/ObjC names when displaying symbols is %s.\n"),
145 /* Nonzero means that encoded C++/ObjC names should be printed out in their
146 C++/ObjC form even in assembler language displays. If this is set, but
147 DEMANGLE is zero, names are printed raw, i.e. DEMANGLE controls. */
149 int asm_demangle = 0;
151 show_asm_demangle (struct ui_file *file, int from_tty,
152 struct cmd_list_element *c, const char *value)
154 fprintf_filtered (file, _("\
155 Demangling of C++/ObjC names in disassembly listings is %s.\n"),
159 /* Nonzero means that strings with character values >0x7F should be printed
160 as octal escapes. Zero means just print the value (e.g. it's an
161 international character, and the terminal or window can cope.) */
163 int sevenbit_strings = 0;
165 show_sevenbit_strings (struct ui_file *file, int from_tty,
166 struct cmd_list_element *c, const char *value)
168 fprintf_filtered (file, _("\
169 Printing of 8-bit characters in strings as \\nnn is %s.\n"),
173 /* String to be printed before error messages, if any. */
175 char *error_pre_print;
177 /* String to be printed before quit messages, if any. */
179 char *quit_pre_print;
181 /* String to be printed before warning messages, if any. */
183 char *warning_pre_print = "\nwarning: ";
185 int pagination_enabled = 1;
187 show_pagination_enabled (struct ui_file *file, int from_tty,
188 struct cmd_list_element *c, const char *value)
190 fprintf_filtered (file, _("State of pagination is %s.\n"), value);
195 /* Add a new cleanup to the cleanup_chain,
196 and return the previous chain pointer
197 to be passed later to do_cleanups or discard_cleanups.
198 Args are FUNCTION to clean up with, and ARG to pass to it. */
201 make_cleanup (make_cleanup_ftype *function, void *arg)
203 return make_my_cleanup (&cleanup_chain, function, arg);
207 make_final_cleanup (make_cleanup_ftype *function, void *arg)
209 return make_my_cleanup (&final_cleanup_chain, function, arg);
213 make_run_cleanup (make_cleanup_ftype *function, void *arg)
215 return make_my_cleanup (&run_cleanup_chain, function, arg);
219 make_exec_cleanup (make_cleanup_ftype *function, void *arg)
221 return make_my_cleanup (&exec_cleanup_chain, function, arg);
225 make_exec_error_cleanup (make_cleanup_ftype *function, void *arg)
227 return make_my_cleanup (&exec_error_cleanup_chain, function, arg);
231 do_freeargv (void *arg)
233 freeargv ((char **) arg);
237 make_cleanup_freeargv (char **arg)
239 return make_my_cleanup (&cleanup_chain, do_freeargv, arg);
243 do_bfd_close_cleanup (void *arg)
249 make_cleanup_bfd_close (bfd *abfd)
251 return make_cleanup (do_bfd_close_cleanup, abfd);
255 do_close_cleanup (void *arg)
263 make_cleanup_close (int fd)
265 int *saved_fd = xmalloc (sizeof (fd));
267 return make_cleanup (do_close_cleanup, saved_fd);
271 do_ui_file_delete (void *arg)
273 ui_file_delete (arg);
277 make_cleanup_ui_file_delete (struct ui_file *arg)
279 return make_my_cleanup (&cleanup_chain, do_ui_file_delete, arg);
283 do_free_section_addr_info (void *arg)
285 free_section_addr_info (arg);
289 make_cleanup_free_section_addr_info (struct section_addr_info *addrs)
291 return make_my_cleanup (&cleanup_chain, do_free_section_addr_info, addrs);
296 make_my_cleanup (struct cleanup **pmy_chain, make_cleanup_ftype *function,
300 = (struct cleanup *) xmalloc (sizeof (struct cleanup));
301 struct cleanup *old_chain = *pmy_chain;
303 new->next = *pmy_chain;
304 new->function = function;
311 /* Discard cleanups and do the actions they describe
312 until we get back to the point OLD_CHAIN in the cleanup_chain. */
315 do_cleanups (struct cleanup *old_chain)
317 do_my_cleanups (&cleanup_chain, old_chain);
321 do_final_cleanups (struct cleanup *old_chain)
323 do_my_cleanups (&final_cleanup_chain, old_chain);
327 do_run_cleanups (struct cleanup *old_chain)
329 do_my_cleanups (&run_cleanup_chain, old_chain);
333 do_exec_cleanups (struct cleanup *old_chain)
335 do_my_cleanups (&exec_cleanup_chain, old_chain);
339 do_exec_error_cleanups (struct cleanup *old_chain)
341 do_my_cleanups (&exec_error_cleanup_chain, old_chain);
345 do_my_cleanups (struct cleanup **pmy_chain,
346 struct cleanup *old_chain)
349 while ((ptr = *pmy_chain) != old_chain)
351 *pmy_chain = ptr->next; /* Do this first incase recursion */
352 (*ptr->function) (ptr->arg);
357 /* Discard cleanups, not doing the actions they describe,
358 until we get back to the point OLD_CHAIN in the cleanup_chain. */
361 discard_cleanups (struct cleanup *old_chain)
363 discard_my_cleanups (&cleanup_chain, old_chain);
367 discard_final_cleanups (struct cleanup *old_chain)
369 discard_my_cleanups (&final_cleanup_chain, old_chain);
373 discard_exec_error_cleanups (struct cleanup *old_chain)
375 discard_my_cleanups (&exec_error_cleanup_chain, old_chain);
379 discard_my_cleanups (struct cleanup **pmy_chain,
380 struct cleanup *old_chain)
383 while ((ptr = *pmy_chain) != old_chain)
385 *pmy_chain = ptr->next;
390 /* Set the cleanup_chain to 0, and return the old cleanup chain. */
394 return save_my_cleanups (&cleanup_chain);
398 save_final_cleanups (void)
400 return save_my_cleanups (&final_cleanup_chain);
404 save_my_cleanups (struct cleanup **pmy_chain)
406 struct cleanup *old_chain = *pmy_chain;
412 /* Restore the cleanup chain from a previously saved chain. */
414 restore_cleanups (struct cleanup *chain)
416 restore_my_cleanups (&cleanup_chain, chain);
420 restore_final_cleanups (struct cleanup *chain)
422 restore_my_cleanups (&final_cleanup_chain, chain);
426 restore_my_cleanups (struct cleanup **pmy_chain, struct cleanup *chain)
431 /* This function is useful for cleanups.
435 old_chain = make_cleanup (free_current_contents, &foo);
437 to arrange to free the object thus allocated. */
440 free_current_contents (void *ptr)
442 void **location = ptr;
443 if (location == NULL)
444 internal_error (__FILE__, __LINE__,
445 _("free_current_contents: NULL pointer"));
446 if (*location != NULL)
453 /* Provide a known function that does nothing, to use as a base for
454 for a possibly long chain of cleanups. This is useful where we
455 use the cleanup chain for handling normal cleanups as well as dealing
456 with cleanups that need to be done as a result of a call to error().
457 In such cases, we may not be certain where the first cleanup is, unless
458 we have a do-nothing one to always use as the base. */
461 null_cleanup (void *arg)
465 /* Add a continuation to the continuation list, the global list
466 cmd_continuation. The new continuation will be added at the front.*/
468 add_continuation (void (*continuation_hook) (struct continuation_arg *),
469 struct continuation_arg *arg_list)
471 struct continuation *continuation_ptr;
474 (struct continuation *) xmalloc (sizeof (struct continuation));
475 continuation_ptr->continuation_hook = continuation_hook;
476 continuation_ptr->arg_list = arg_list;
477 continuation_ptr->next = cmd_continuation;
478 cmd_continuation = continuation_ptr;
481 /* Walk down the cmd_continuation list, and execute all the
482 continuations. There is a problem though. In some cases new
483 continuations may be added while we are in the middle of this
484 loop. If this happens they will be added in the front, and done
485 before we have a chance of exhausting those that were already
486 there. We need to then save the beginning of the list in a pointer
487 and do the continuations from there on, instead of using the
488 global beginning of list as our iteration pointer. */
490 do_all_continuations (void)
492 struct continuation *continuation_ptr;
493 struct continuation *saved_continuation;
495 /* Copy the list header into another pointer, and set the global
496 list header to null, so that the global list can change as a side
497 effect of invoking the continuations and the processing of
498 the preexisting continuations will not be affected. */
499 continuation_ptr = cmd_continuation;
500 cmd_continuation = NULL;
502 /* Work now on the list we have set aside. */
503 while (continuation_ptr)
505 (continuation_ptr->continuation_hook) (continuation_ptr->arg_list);
506 saved_continuation = continuation_ptr;
507 continuation_ptr = continuation_ptr->next;
508 xfree (saved_continuation);
512 /* Walk down the cmd_continuation list, and get rid of all the
515 discard_all_continuations (void)
517 struct continuation *continuation_ptr;
519 while (cmd_continuation)
521 continuation_ptr = cmd_continuation;
522 cmd_continuation = continuation_ptr->next;
523 xfree (continuation_ptr);
527 /* Add a continuation to the continuation list, the global list
528 intermediate_continuation. The new continuation will be added at
531 add_intermediate_continuation (void (*continuation_hook)
532 (struct continuation_arg *),
533 struct continuation_arg *arg_list)
535 struct continuation *continuation_ptr;
538 (struct continuation *) xmalloc (sizeof (struct continuation));
539 continuation_ptr->continuation_hook = continuation_hook;
540 continuation_ptr->arg_list = arg_list;
541 continuation_ptr->next = intermediate_continuation;
542 intermediate_continuation = continuation_ptr;
545 /* Walk down the cmd_continuation list, and execute all the
546 continuations. There is a problem though. In some cases new
547 continuations may be added while we are in the middle of this
548 loop. If this happens they will be added in the front, and done
549 before we have a chance of exhausting those that were already
550 there. We need to then save the beginning of the list in a pointer
551 and do the continuations from there on, instead of using the
552 global beginning of list as our iteration pointer.*/
554 do_all_intermediate_continuations (void)
556 struct continuation *continuation_ptr;
557 struct continuation *saved_continuation;
559 /* Copy the list header into another pointer, and set the global
560 list header to null, so that the global list can change as a side
561 effect of invoking the continuations and the processing of
562 the preexisting continuations will not be affected. */
563 continuation_ptr = intermediate_continuation;
564 intermediate_continuation = NULL;
566 /* Work now on the list we have set aside. */
567 while (continuation_ptr)
569 (continuation_ptr->continuation_hook) (continuation_ptr->arg_list);
570 saved_continuation = continuation_ptr;
571 continuation_ptr = continuation_ptr->next;
572 xfree (saved_continuation);
576 /* Walk down the cmd_continuation list, and get rid of all the
579 discard_all_intermediate_continuations (void)
581 struct continuation *continuation_ptr;
583 while (intermediate_continuation)
585 continuation_ptr = intermediate_continuation;
586 intermediate_continuation = continuation_ptr->next;
587 xfree (continuation_ptr);
593 /* Print a warning message. The first argument STRING is the warning
594 message, used as an fprintf format string, the second is the
595 va_list of arguments for that string. A warning is unfiltered (not
596 paginated) so that the user does not need to page through each
597 screen full of warnings when there are lots of them. */
600 vwarning (const char *string, va_list args)
602 if (deprecated_warning_hook)
603 (*deprecated_warning_hook) (string, args);
606 target_terminal_ours ();
607 wrap_here (""); /* Force out any buffered output */
608 gdb_flush (gdb_stdout);
609 if (warning_pre_print)
610 fputs_unfiltered (warning_pre_print, gdb_stderr);
611 vfprintf_unfiltered (gdb_stderr, string, args);
612 fprintf_unfiltered (gdb_stderr, "\n");
617 /* Print a warning message.
618 The first argument STRING is the warning message, used as a fprintf string,
619 and the remaining args are passed as arguments to it.
620 The primary difference between warnings and errors is that a warning
621 does not force the return to command level. */
624 warning (const char *string, ...)
627 va_start (args, string);
628 vwarning (string, args);
632 /* Print an error message and return to command level.
633 The first argument STRING is the error message, used as a fprintf string,
634 and the remaining args are passed as arguments to it. */
637 verror (const char *string, va_list args)
639 throw_verror (GENERIC_ERROR, string, args);
643 error (const char *string, ...)
646 va_start (args, string);
647 throw_verror (GENERIC_ERROR, string, args);
651 /* Print an error message and quit.
652 The first argument STRING is the error message, used as a fprintf string,
653 and the remaining args are passed as arguments to it. */
656 vfatal (const char *string, va_list args)
658 throw_vfatal (string, args);
662 fatal (const char *string, ...)
665 va_start (args, string);
666 throw_vfatal (string, args);
671 error_stream (struct ui_file *stream)
674 char *message = ui_file_xstrdup (stream, &len);
675 make_cleanup (xfree, message);
676 error (("%s"), message);
679 /* Print a message reporting an internal error/warning. Ask the user
680 if they want to continue, dump core, or just exit. Return
681 something to indicate a quit. */
683 struct internal_problem
686 /* FIXME: cagney/2002-08-15: There should be ``maint set/show''
687 commands available for controlling these variables. */
688 enum auto_boolean should_quit;
689 enum auto_boolean should_dump_core;
692 /* Report a problem, internal to GDB, to the user. Once the problem
693 has been reported, and assuming GDB didn't quit, the caller can
694 either allow execution to resume or throw an error. */
697 internal_vproblem (struct internal_problem *problem,
698 const char *file, int line, const char *fmt, va_list ap)
705 /* Don't allow infinite error/warning recursion. */
707 static char msg[] = "Recursive internal problem.\n";
715 fputs_unfiltered (msg, gdb_stderr);
716 abort (); /* NOTE: GDB has only three calls to abort(). */
719 write (STDERR_FILENO, msg, sizeof (msg));
724 /* Try to get the message out and at the start of a new line. */
725 target_terminal_ours ();
728 /* Create a string containing the full error/warning message. Need
729 to call query with this full string, as otherwize the reason
730 (error/warning) and question become separated. Format using a
731 style similar to a compiler error message. Include extra detail
732 so that the user knows that they are living on the edge. */
735 msg = xstrvprintf (fmt, ap);
736 reason = xstrprintf ("\
738 A problem internal to GDB has been detected,\n\
739 further debugging may prove unreliable.", file, line, problem->name, msg);
741 make_cleanup (xfree, reason);
744 switch (problem->should_quit)
746 case AUTO_BOOLEAN_AUTO:
747 /* Default (yes/batch case) is to quit GDB. When in batch mode
748 this lessens the likelhood of GDB going into an infinate
750 quit_p = query (_("%s\nQuit this debugging session? "), reason);
752 case AUTO_BOOLEAN_TRUE:
755 case AUTO_BOOLEAN_FALSE:
759 internal_error (__FILE__, __LINE__, _("bad switch"));
762 switch (problem->should_dump_core)
764 case AUTO_BOOLEAN_AUTO:
765 /* Default (yes/batch case) is to dump core. This leaves a GDB
766 `dropping' so that it is easier to see that something went
768 dump_core_p = query (_("%s\nCreate a core file of GDB? "), reason);
771 case AUTO_BOOLEAN_TRUE:
774 case AUTO_BOOLEAN_FALSE:
778 internal_error (__FILE__, __LINE__, _("bad switch"));
784 abort (); /* NOTE: GDB has only three calls to abort(). */
792 #ifdef HAVE_WORKING_FORK
794 abort (); /* NOTE: GDB has only three calls to abort(). */
802 static struct internal_problem internal_error_problem = {
803 "internal-error", AUTO_BOOLEAN_AUTO, AUTO_BOOLEAN_AUTO
807 internal_verror (const char *file, int line, const char *fmt, va_list ap)
809 internal_vproblem (&internal_error_problem, file, line, fmt, ap);
810 deprecated_throw_reason (RETURN_ERROR);
814 internal_error (const char *file, int line, const char *string, ...)
817 va_start (ap, string);
818 internal_verror (file, line, string, ap);
822 static struct internal_problem internal_warning_problem = {
823 "internal-warning", AUTO_BOOLEAN_AUTO, AUTO_BOOLEAN_AUTO
827 internal_vwarning (const char *file, int line, const char *fmt, va_list ap)
829 internal_vproblem (&internal_warning_problem, file, line, fmt, ap);
833 internal_warning (const char *file, int line, const char *string, ...)
836 va_start (ap, string);
837 internal_vwarning (file, line, string, ap);
841 /* The strerror() function can return NULL for errno values that are
842 out of range. Provide a "safe" version that always returns a
846 safe_strerror (int errnum)
850 msg = strerror (errnum);
854 xsnprintf (buf, sizeof buf, "(undocumented errno %d)", errnum);
860 /* Print the system error message for errno, and also mention STRING
861 as the file name for which the error was encountered.
862 Then return to command level. */
865 perror_with_name (const char *string)
870 err = safe_strerror (errno);
871 combined = (char *) alloca (strlen (err) + strlen (string) + 3);
872 strcpy (combined, string);
873 strcat (combined, ": ");
874 strcat (combined, err);
876 /* I understand setting these is a matter of taste. Still, some people
877 may clear errno but not know about bfd_error. Doing this here is not
879 bfd_set_error (bfd_error_no_error);
882 error (_("%s."), combined);
885 /* Print the system error message for ERRCODE, and also mention STRING
886 as the file name for which the error was encountered. */
889 print_sys_errmsg (const char *string, int errcode)
894 err = safe_strerror (errcode);
895 combined = (char *) alloca (strlen (err) + strlen (string) + 3);
896 strcpy (combined, string);
897 strcat (combined, ": ");
898 strcat (combined, err);
900 /* We want anything which was printed on stdout to come out first, before
902 gdb_flush (gdb_stdout);
903 fprintf_unfiltered (gdb_stderr, "%s.\n", combined);
906 /* Control C eventually causes this to be called, at a convenient time. */
912 /* No steenking SIGINT will ever be coming our way when the
913 program is resumed. Don't lie. */
917 /* If there is no terminal switching for this target, then we can't
918 possibly get screwed by the lack of job control. */
919 || current_target.to_terminal_ours == NULL)
922 fatal ("Quit (expect signal SIGINT when the program is resumed)");
926 /* Control C comes here */
928 request_quit (int signo)
931 /* Restore the signal handler. Harmless with BSD-style signals,
932 needed for System V-style signals. */
933 signal (signo, request_quit);
939 /* Called when a memory allocation fails, with the number of bytes of
940 memory requested in SIZE. */
947 internal_error (__FILE__, __LINE__,
948 _("virtual memory exhausted: can't allocate %ld bytes."),
953 internal_error (__FILE__, __LINE__, _("virtual memory exhausted."));
957 /* The xmalloc() (libiberty.h) family of memory management routines.
959 These are like the ISO-C malloc() family except that they implement
960 consistent semantics and guard against typical memory management
963 /* NOTE: These are declared using PTR to ensure consistency with
964 "libiberty.h". xfree() is GDB local. */
967 xmalloc (size_t size)
971 /* See libiberty/xmalloc.c. This function need's to match that's
972 semantics. It never returns NULL. */
976 val = malloc (size); /* OK: malloc */
984 xzalloc (size_t size)
986 return xcalloc (1, size);
990 xrealloc (PTR ptr, size_t size) /* OK: PTR */
994 /* See libiberty/xmalloc.c. This function need's to match that's
995 semantics. It never returns NULL. */
1000 val = realloc (ptr, size); /* OK: realloc */
1002 val = malloc (size); /* OK: malloc */
1010 xcalloc (size_t number, size_t size)
1014 /* See libiberty/xmalloc.c. This function need's to match that's
1015 semantics. It never returns NULL. */
1016 if (number == 0 || size == 0)
1022 mem = calloc (number, size); /* OK: xcalloc */
1024 nomem (number * size);
1033 free (ptr); /* OK: free */
1037 /* Like asprintf/vasprintf but get an internal_error if the call
1041 xstrprintf (const char *format, ...)
1045 va_start (args, format);
1046 ret = xstrvprintf (format, args);
1052 xasprintf (char **ret, const char *format, ...)
1055 va_start (args, format);
1056 (*ret) = xstrvprintf (format, args);
1061 xvasprintf (char **ret, const char *format, va_list ap)
1063 (*ret) = xstrvprintf (format, ap);
1067 xstrvprintf (const char *format, va_list ap)
1070 int status = vasprintf (&ret, format, ap);
1071 /* NULL is returned when there was a memory allocation problem. */
1074 /* A negative status (the printed length) with a non-NULL buffer
1075 should never happen, but just to be sure. */
1077 internal_error (__FILE__, __LINE__,
1078 _("vasprintf call failed (errno %d)"), errno);
1083 xsnprintf (char *str, size_t size, const char *format, ...)
1088 va_start (args, format);
1089 ret = vsnprintf (str, size, format, args);
1090 gdb_assert (ret < size);
1096 /* My replacement for the read system call.
1097 Used like `read' but keeps going if `read' returns too soon. */
1100 myread (int desc, char *addr, int len)
1107 val = read (desc, addr, len);
1111 return orglen - len;
1118 /* Make a copy of the string at PTR with SIZE characters
1119 (and add a null character at the end in the copy).
1120 Uses malloc to get the space. Returns the address of the copy. */
1123 savestring (const char *ptr, size_t size)
1125 char *p = (char *) xmalloc (size + 1);
1126 memcpy (p, ptr, size);
1132 print_spaces (int n, struct ui_file *file)
1134 fputs_unfiltered (n_spaces (n), file);
1137 /* Print a host address. */
1140 gdb_print_host_address (const void *addr, struct ui_file *stream)
1143 /* We could use the %p conversion specifier to fprintf if we had any
1144 way of knowing whether this host supports it. But the following
1145 should work on the Alpha and on 32 bit machines. */
1147 fprintf_filtered (stream, "0x%lx", (unsigned long) addr);
1150 /* Ask user a y-or-n question and return 1 iff answer is yes.
1151 Takes three args which are given to printf to print the question.
1152 The first, a control string, should end in "? ".
1153 It should not say how to answer, because we do that. */
1157 query (const char *ctlstr, ...)
1164 if (deprecated_query_hook)
1166 va_start (args, ctlstr);
1167 return deprecated_query_hook (ctlstr, args);
1170 /* Automatically answer "yes" if input is not from a terminal. */
1171 if (!input_from_terminal_p ())
1176 wrap_here (""); /* Flush any buffered output */
1177 gdb_flush (gdb_stdout);
1179 if (annotation_level > 1)
1180 printf_filtered (("\n\032\032pre-query\n"));
1182 va_start (args, ctlstr);
1183 vfprintf_filtered (gdb_stdout, ctlstr, args);
1185 printf_filtered (_("(y or n) "));
1187 if (annotation_level > 1)
1188 printf_filtered (("\n\032\032query\n"));
1191 gdb_flush (gdb_stdout);
1193 answer = fgetc (stdin);
1194 clearerr (stdin); /* in case of C-d */
1195 if (answer == EOF) /* C-d */
1200 /* Eat rest of input line, to EOF or newline */
1204 ans2 = fgetc (stdin);
1207 while (ans2 != EOF && ans2 != '\n' && ans2 != '\r');
1221 printf_filtered (_("Please answer y or n.\n"));
1224 if (annotation_level > 1)
1225 printf_filtered (("\n\032\032post-query\n"));
1230 /* This function supports the nquery() and yquery() functions.
1231 Ask user a y-or-n question and return 0 if answer is no, 1 if
1232 answer is yes, or default the answer to the specified default.
1233 DEFCHAR is either 'y' or 'n' and refers to the default answer.
1234 CTLSTR is the control string and should end in "? ". It should
1235 not say how to answer, because we do that.
1236 ARGS are the arguments passed along with the CTLSTR argument to
1240 defaulted_query (const char *ctlstr, const char defchar, va_list args)
1246 char def_answer, not_def_answer;
1247 char *y_string, *n_string;
1249 /* Set up according to which answer is the default. */
1254 not_def_answer = 'N';
1262 not_def_answer = 'Y';
1267 if (deprecated_query_hook)
1269 return deprecated_query_hook (ctlstr, args);
1272 /* Automatically answer default value if input is not from a terminal. */
1273 if (!input_from_terminal_p ())
1278 wrap_here (""); /* Flush any buffered output */
1279 gdb_flush (gdb_stdout);
1281 if (annotation_level > 1)
1282 printf_filtered (("\n\032\032pre-query\n"));
1284 vfprintf_filtered (gdb_stdout, ctlstr, args);
1285 printf_filtered (_("(%s or %s) "), y_string, n_string);
1287 if (annotation_level > 1)
1288 printf_filtered (("\n\032\032query\n"));
1291 gdb_flush (gdb_stdout);
1293 answer = fgetc (stdin);
1294 clearerr (stdin); /* in case of C-d */
1295 if (answer == EOF) /* C-d */
1300 /* Eat rest of input line, to EOF or newline */
1304 ans2 = fgetc (stdin);
1307 while (ans2 != EOF && ans2 != '\n' && ans2 != '\r');
1311 /* Check answer. For the non-default, the user must specify
1312 the non-default explicitly. */
1313 if (answer == not_def_answer)
1315 retval = !def_value;
1318 /* Otherwise, for the default, the user may either specify
1319 the required input or have it default by entering nothing. */
1320 if (answer == def_answer || answer == '\n' ||
1321 answer == '\r' || answer == EOF)
1326 /* Invalid entries are not defaulted and require another selection. */
1327 printf_filtered (_("Please answer %s or %s.\n"),
1328 y_string, n_string);
1331 if (annotation_level > 1)
1332 printf_filtered (("\n\032\032post-query\n"));
1337 /* Ask user a y-or-n question and return 0 if answer is no, 1 if
1338 answer is yes, or 0 if answer is defaulted.
1339 Takes three args which are given to printf to print the question.
1340 The first, a control string, should end in "? ".
1341 It should not say how to answer, because we do that. */
1344 nquery (const char *ctlstr, ...)
1348 va_start (args, ctlstr);
1349 return defaulted_query (ctlstr, 'n', args);
1353 /* Ask user a y-or-n question and return 0 if answer is no, 1 if
1354 answer is yes, or 1 if answer is defaulted.
1355 Takes three args which are given to printf to print the question.
1356 The first, a control string, should end in "? ".
1357 It should not say how to answer, because we do that. */
1360 yquery (const char *ctlstr, ...)
1364 va_start (args, ctlstr);
1365 return defaulted_query (ctlstr, 'y', args);
1369 /* Print an error message saying that we couldn't make sense of a
1370 \^mumble sequence in a string or character constant. START and END
1371 indicate a substring of some larger string that contains the
1372 erroneous backslash sequence, missing the initial backslash. */
1374 no_control_char_error (const char *start, const char *end)
1376 int len = end - start;
1377 char *copy = alloca (end - start + 1);
1379 memcpy (copy, start, len);
1382 error (_("There is no control character `\\%s' in the `%s' character set."),
1383 copy, target_charset ());
1386 /* Parse a C escape sequence. STRING_PTR points to a variable
1387 containing a pointer to the string to parse. That pointer
1388 should point to the character after the \. That pointer
1389 is updated past the characters we use. The value of the
1390 escape sequence is returned.
1392 A negative value means the sequence \ newline was seen,
1393 which is supposed to be equivalent to nothing at all.
1395 If \ is followed by a null character, we return a negative
1396 value and leave the string pointer pointing at the null character.
1398 If \ is followed by 000, we return 0 and leave the string pointer
1399 after the zeros. A value of 0 does not mean end of string. */
1402 parse_escape (char **string_ptr)
1405 int c = *(*string_ptr)++;
1406 if (c_parse_backslash (c, &target_char))
1418 /* Remember where this escape sequence started, for reporting
1420 char *sequence_start_pos = *string_ptr - 1;
1422 c = *(*string_ptr)++;
1426 /* XXXCHARSET: What is `delete' in the host character set? */
1429 if (!host_char_to_target (c, &target_char))
1430 error (_("There is no character corresponding to `Delete' "
1431 "in the target character set `%s'."), host_charset ());
1436 target_char = parse_escape (string_ptr);
1439 if (!host_char_to_target (c, &target_char))
1440 no_control_char_error (sequence_start_pos, *string_ptr);
1443 /* Now target_char is something like `c', and we want to find
1444 its control-character equivalent. */
1445 if (!target_char_to_control_char (target_char, &target_char))
1446 no_control_char_error (sequence_start_pos, *string_ptr);
1451 /* XXXCHARSET: we need to use isdigit and value-of-digit
1452 methods of the host character set here. */
1468 if (c >= '0' && c <= '7')
1482 if (!host_char_to_target (c, &target_char))
1484 ("The escape sequence `\%c' is equivalent to plain `%c', which"
1485 " has no equivalent\n" "in the `%s' character set.", c, c,
1491 /* Print the character C on STREAM as part of the contents of a literal
1492 string whose delimiter is QUOTER. Note that this routine should only
1493 be call for printing things which are independent of the language
1494 of the program being debugged. */
1497 printchar (int c, void (*do_fputs) (const char *, struct ui_file *),
1498 void (*do_fprintf) (struct ui_file *, const char *, ...),
1499 struct ui_file *stream, int quoter)
1502 c &= 0xFF; /* Avoid sign bit follies */
1504 if (c < 0x20 || /* Low control chars */
1505 (c >= 0x7F && c < 0xA0) || /* DEL, High controls */
1506 (sevenbit_strings && c >= 0x80))
1507 { /* high order bit set */
1511 do_fputs ("\\n", stream);
1514 do_fputs ("\\b", stream);
1517 do_fputs ("\\t", stream);
1520 do_fputs ("\\f", stream);
1523 do_fputs ("\\r", stream);
1526 do_fputs ("\\e", stream);
1529 do_fputs ("\\a", stream);
1532 do_fprintf (stream, "\\%.3o", (unsigned int) c);
1538 if (c == '\\' || c == quoter)
1539 do_fputs ("\\", stream);
1540 do_fprintf (stream, "%c", c);
1544 /* Print the character C on STREAM as part of the contents of a
1545 literal string whose delimiter is QUOTER. Note that these routines
1546 should only be call for printing things which are independent of
1547 the language of the program being debugged. */
1550 fputstr_filtered (const char *str, int quoter, struct ui_file *stream)
1553 printchar (*str++, fputs_filtered, fprintf_filtered, stream, quoter);
1557 fputstr_unfiltered (const char *str, int quoter, struct ui_file *stream)
1560 printchar (*str++, fputs_unfiltered, fprintf_unfiltered, stream, quoter);
1564 fputstrn_unfiltered (const char *str, int n, int quoter,
1565 struct ui_file *stream)
1568 for (i = 0; i < n; i++)
1569 printchar (str[i], fputs_unfiltered, fprintf_unfiltered, stream, quoter);
1573 /* Number of lines per page or UINT_MAX if paging is disabled. */
1574 static unsigned int lines_per_page;
1576 show_lines_per_page (struct ui_file *file, int from_tty,
1577 struct cmd_list_element *c, const char *value)
1579 fprintf_filtered (file, _("\
1580 Number of lines gdb thinks are in a page is %s.\n"),
1584 /* Number of chars per line or UINT_MAX if line folding is disabled. */
1585 static unsigned int chars_per_line;
1587 show_chars_per_line (struct ui_file *file, int from_tty,
1588 struct cmd_list_element *c, const char *value)
1590 fprintf_filtered (file, _("\
1591 Number of characters gdb thinks are in a line is %s.\n"),
1595 /* Current count of lines printed on this page, chars on this line. */
1596 static unsigned int lines_printed, chars_printed;
1598 /* Buffer and start column of buffered text, for doing smarter word-
1599 wrapping. When someone calls wrap_here(), we start buffering output
1600 that comes through fputs_filtered(). If we see a newline, we just
1601 spit it out and forget about the wrap_here(). If we see another
1602 wrap_here(), we spit it out and remember the newer one. If we see
1603 the end of the line, we spit out a newline, the indent, and then
1604 the buffered output. */
1606 /* Malloc'd buffer with chars_per_line+2 bytes. Contains characters which
1607 are waiting to be output (they have already been counted in chars_printed).
1608 When wrap_buffer[0] is null, the buffer is empty. */
1609 static char *wrap_buffer;
1611 /* Pointer in wrap_buffer to the next character to fill. */
1612 static char *wrap_pointer;
1614 /* String to indent by if the wrap occurs. Must not be NULL if wrap_column
1616 static char *wrap_indent;
1618 /* Column number on the screen where wrap_buffer begins, or 0 if wrapping
1619 is not in effect. */
1620 static int wrap_column;
1623 /* Inialize the number of lines per page and chars per line. */
1626 init_page_info (void)
1629 if (!tui_get_command_dimension (&chars_per_line, &lines_per_page))
1634 #if defined(__GO32__)
1635 rows = ScreenRows ();
1636 cols = ScreenCols ();
1637 lines_per_page = rows;
1638 chars_per_line = cols;
1640 /* Make sure Readline has initialized its terminal settings. */
1641 rl_reset_terminal (NULL);
1643 /* Get the screen size from Readline. */
1644 rl_get_screen_size (&rows, &cols);
1645 lines_per_page = rows;
1646 chars_per_line = cols;
1648 /* Readline should have fetched the termcap entry for us. */
1649 if (tgetnum ("li") < 0 || getenv ("EMACS"))
1651 /* The number of lines per page is not mentioned in the
1652 terminal description. This probably means that paging is
1653 not useful (e.g. emacs shell window), so disable paging. */
1654 lines_per_page = UINT_MAX;
1657 /* FIXME: Get rid of this junk. */
1658 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1659 SIGWINCH_HANDLER (SIGWINCH);
1662 /* If the output is not a terminal, don't paginate it. */
1663 if (!ui_file_isatty (gdb_stdout))
1664 lines_per_page = UINT_MAX;
1672 /* Set the screen size based on LINES_PER_PAGE and CHARS_PER_LINE. */
1675 set_screen_size (void)
1677 int rows = lines_per_page;
1678 int cols = chars_per_line;
1684 rl_get_screen_size (NULL, &cols);
1686 /* Update Readline's idea of the terminal size. */
1687 rl_set_screen_size (rows, cols);
1690 /* Reinitialize WRAP_BUFFER according to the current value of
1696 if (chars_per_line == 0)
1701 wrap_buffer = (char *) xmalloc (chars_per_line + 2);
1702 wrap_buffer[0] = '\0';
1705 wrap_buffer = (char *) xrealloc (wrap_buffer, chars_per_line + 2);
1706 wrap_pointer = wrap_buffer; /* Start it at the beginning. */
1710 set_width_command (char *args, int from_tty, struct cmd_list_element *c)
1717 set_height_command (char *args, int from_tty, struct cmd_list_element *c)
1722 /* Wait, so the user can read what's on the screen. Prompt the user
1723 to continue by pressing RETURN. */
1726 prompt_for_continue (void)
1729 char cont_prompt[120];
1731 if (annotation_level > 1)
1732 printf_unfiltered (("\n\032\032pre-prompt-for-continue\n"));
1734 strcpy (cont_prompt,
1735 "---Type <return> to continue, or q <return> to quit---");
1736 if (annotation_level > 1)
1737 strcat (cont_prompt, "\n\032\032prompt-for-continue\n");
1739 /* We must do this *before* we call gdb_readline, else it will eventually
1740 call us -- thinking that we're trying to print beyond the end of the
1742 reinitialize_more_filter ();
1745 /* On a real operating system, the user can quit with SIGINT.
1748 'q' is provided on all systems so users don't have to change habits
1749 from system to system, and because telling them what to do in
1750 the prompt is more user-friendly than expecting them to think of
1752 /* Call readline, not gdb_readline, because GO32 readline handles control-C
1753 whereas control-C to gdb_readline will cause the user to get dumped
1755 ignore = gdb_readline_wrapper (cont_prompt);
1757 if (annotation_level > 1)
1758 printf_unfiltered (("\n\032\032post-prompt-for-continue\n"));
1763 while (*p == ' ' || *p == '\t')
1766 async_request_quit (0);
1771 /* Now we have to do this again, so that GDB will know that it doesn't
1772 need to save the ---Type <return>--- line at the top of the screen. */
1773 reinitialize_more_filter ();
1775 dont_repeat (); /* Forget prev cmd -- CR won't repeat it. */
1778 /* Reinitialize filter; ie. tell it to reset to original values. */
1781 reinitialize_more_filter (void)
1787 /* Indicate that if the next sequence of characters overflows the line,
1788 a newline should be inserted here rather than when it hits the end.
1789 If INDENT is non-null, it is a string to be printed to indent the
1790 wrapped part on the next line. INDENT must remain accessible until
1791 the next call to wrap_here() or until a newline is printed through
1794 If the line is already overfull, we immediately print a newline and
1795 the indentation, and disable further wrapping.
1797 If we don't know the width of lines, but we know the page height,
1798 we must not wrap words, but should still keep track of newlines
1799 that were explicitly printed.
1801 INDENT should not contain tabs, as that will mess up the char count
1802 on the next line. FIXME.
1804 This routine is guaranteed to force out any output which has been
1805 squirreled away in the wrap_buffer, so wrap_here ((char *)0) can be
1806 used to force out output from the wrap_buffer. */
1809 wrap_here (char *indent)
1811 /* This should have been allocated, but be paranoid anyway. */
1813 internal_error (__FILE__, __LINE__, _("failed internal consistency check"));
1817 *wrap_pointer = '\0';
1818 fputs_unfiltered (wrap_buffer, gdb_stdout);
1820 wrap_pointer = wrap_buffer;
1821 wrap_buffer[0] = '\0';
1822 if (chars_per_line == UINT_MAX) /* No line overflow checking */
1826 else if (chars_printed >= chars_per_line)
1828 puts_filtered ("\n");
1830 puts_filtered (indent);
1835 wrap_column = chars_printed;
1839 wrap_indent = indent;
1843 /* Print input string to gdb_stdout, filtered, with wrap,
1844 arranging strings in columns of n chars. String can be
1845 right or left justified in the column. Never prints
1846 trailing spaces. String should never be longer than
1847 width. FIXME: this could be useful for the EXAMINE
1848 command, which currently doesn't tabulate very well */
1851 puts_filtered_tabular (char *string, int width, int right)
1857 gdb_assert (chars_per_line > 0);
1858 if (chars_per_line == UINT_MAX)
1860 fputs_filtered (string, gdb_stdout);
1861 fputs_filtered ("\n", gdb_stdout);
1865 if (((chars_printed - 1) / width + 2) * width >= chars_per_line)
1866 fputs_filtered ("\n", gdb_stdout);
1868 if (width >= chars_per_line)
1869 width = chars_per_line - 1;
1871 stringlen = strlen (string);
1873 if (chars_printed > 0)
1874 spaces = width - (chars_printed - 1) % width - 1;
1876 spaces += width - stringlen;
1878 spacebuf = alloca (spaces + 1);
1879 spacebuf[spaces] = '\0';
1881 spacebuf[spaces] = ' ';
1883 fputs_filtered (spacebuf, gdb_stdout);
1884 fputs_filtered (string, gdb_stdout);
1888 /* Ensure that whatever gets printed next, using the filtered output
1889 commands, starts at the beginning of the line. I.E. if there is
1890 any pending output for the current line, flush it and start a new
1891 line. Otherwise do nothing. */
1896 if (chars_printed > 0)
1898 puts_filtered ("\n");
1903 /* Like fputs but if FILTER is true, pause after every screenful.
1905 Regardless of FILTER can wrap at points other than the final
1906 character of a line.
1908 Unlike fputs, fputs_maybe_filtered does not return a value.
1909 It is OK for LINEBUFFER to be NULL, in which case just don't print
1912 Note that a longjmp to top level may occur in this routine (only if
1913 FILTER is true) (since prompt_for_continue may do so) so this
1914 routine should not be called when cleanups are not in place. */
1917 fputs_maybe_filtered (const char *linebuffer, struct ui_file *stream,
1920 const char *lineptr;
1922 if (linebuffer == 0)
1925 /* Don't do any filtering if it is disabled. */
1926 if ((stream != gdb_stdout) || !pagination_enabled
1927 || (lines_per_page == UINT_MAX && chars_per_line == UINT_MAX))
1929 fputs_unfiltered (linebuffer, stream);
1933 /* Go through and output each character. Show line extension
1934 when this is necessary; prompt user for new page when this is
1937 lineptr = linebuffer;
1940 /* Possible new page. */
1941 if (filter && (lines_printed >= lines_per_page - 1))
1942 prompt_for_continue ();
1944 while (*lineptr && *lineptr != '\n')
1946 /* Print a single line. */
1947 if (*lineptr == '\t')
1950 *wrap_pointer++ = '\t';
1952 fputc_unfiltered ('\t', stream);
1953 /* Shifting right by 3 produces the number of tab stops
1954 we have already passed, and then adding one and
1955 shifting left 3 advances to the next tab stop. */
1956 chars_printed = ((chars_printed >> 3) + 1) << 3;
1962 *wrap_pointer++ = *lineptr;
1964 fputc_unfiltered (*lineptr, stream);
1969 if (chars_printed >= chars_per_line)
1971 unsigned int save_chars = chars_printed;
1975 /* If we aren't actually wrapping, don't output newline --
1976 if chars_per_line is right, we probably just overflowed
1977 anyway; if it's wrong, let us keep going. */
1979 fputc_unfiltered ('\n', stream);
1981 /* Possible new page. */
1982 if (lines_printed >= lines_per_page - 1)
1983 prompt_for_continue ();
1985 /* Now output indentation and wrapped string */
1988 fputs_unfiltered (wrap_indent, stream);
1989 *wrap_pointer = '\0'; /* Null-terminate saved stuff */
1990 fputs_unfiltered (wrap_buffer, stream); /* and eject it */
1991 /* FIXME, this strlen is what prevents wrap_indent from
1992 containing tabs. However, if we recurse to print it
1993 and count its chars, we risk trouble if wrap_indent is
1994 longer than (the user settable) chars_per_line.
1995 Note also that this can set chars_printed > chars_per_line
1996 if we are printing a long string. */
1997 chars_printed = strlen (wrap_indent)
1998 + (save_chars - wrap_column);
1999 wrap_pointer = wrap_buffer; /* Reset buffer */
2000 wrap_buffer[0] = '\0';
2001 wrap_column = 0; /* And disable fancy wrap */
2006 if (*lineptr == '\n')
2009 wrap_here ((char *) 0); /* Spit out chars, cancel further wraps */
2011 fputc_unfiltered ('\n', stream);
2018 fputs_filtered (const char *linebuffer, struct ui_file *stream)
2020 fputs_maybe_filtered (linebuffer, stream, 1);
2024 putchar_unfiltered (int c)
2027 ui_file_write (gdb_stdout, &buf, 1);
2031 /* Write character C to gdb_stdout using GDB's paging mechanism and return C.
2032 May return nonlocally. */
2035 putchar_filtered (int c)
2037 return fputc_filtered (c, gdb_stdout);
2041 fputc_unfiltered (int c, struct ui_file *stream)
2044 ui_file_write (stream, &buf, 1);
2049 fputc_filtered (int c, struct ui_file *stream)
2055 fputs_filtered (buf, stream);
2059 /* puts_debug is like fputs_unfiltered, except it prints special
2060 characters in printable fashion. */
2063 puts_debug (char *prefix, char *string, char *suffix)
2067 /* Print prefix and suffix after each line. */
2068 static int new_line = 1;
2069 static int return_p = 0;
2070 static char *prev_prefix = "";
2071 static char *prev_suffix = "";
2073 if (*string == '\n')
2076 /* If the prefix is changing, print the previous suffix, a new line,
2077 and the new prefix. */
2078 if ((return_p || (strcmp (prev_prefix, prefix) != 0)) && !new_line)
2080 fputs_unfiltered (prev_suffix, gdb_stdlog);
2081 fputs_unfiltered ("\n", gdb_stdlog);
2082 fputs_unfiltered (prefix, gdb_stdlog);
2085 /* Print prefix if we printed a newline during the previous call. */
2089 fputs_unfiltered (prefix, gdb_stdlog);
2092 prev_prefix = prefix;
2093 prev_suffix = suffix;
2095 /* Output characters in a printable format. */
2096 while ((ch = *string++) != '\0')
2102 fputc_unfiltered (ch, gdb_stdlog);
2105 fprintf_unfiltered (gdb_stdlog, "\\x%02x", ch & 0xff);
2109 fputs_unfiltered ("\\\\", gdb_stdlog);
2112 fputs_unfiltered ("\\b", gdb_stdlog);
2115 fputs_unfiltered ("\\f", gdb_stdlog);
2119 fputs_unfiltered ("\\n", gdb_stdlog);
2122 fputs_unfiltered ("\\r", gdb_stdlog);
2125 fputs_unfiltered ("\\t", gdb_stdlog);
2128 fputs_unfiltered ("\\v", gdb_stdlog);
2132 return_p = ch == '\r';
2135 /* Print suffix if we printed a newline. */
2138 fputs_unfiltered (suffix, gdb_stdlog);
2139 fputs_unfiltered ("\n", gdb_stdlog);
2144 /* Print a variable number of ARGS using format FORMAT. If this
2145 information is going to put the amount written (since the last call
2146 to REINITIALIZE_MORE_FILTER or the last page break) over the page size,
2147 call prompt_for_continue to get the users permision to continue.
2149 Unlike fprintf, this function does not return a value.
2151 We implement three variants, vfprintf (takes a vararg list and stream),
2152 fprintf (takes a stream to write on), and printf (the usual).
2154 Note also that a longjmp to top level may occur in this routine
2155 (since prompt_for_continue may do so) so this routine should not be
2156 called when cleanups are not in place. */
2159 vfprintf_maybe_filtered (struct ui_file *stream, const char *format,
2160 va_list args, int filter)
2163 struct cleanup *old_cleanups;
2165 linebuffer = xstrvprintf (format, args);
2166 old_cleanups = make_cleanup (xfree, linebuffer);
2167 fputs_maybe_filtered (linebuffer, stream, filter);
2168 do_cleanups (old_cleanups);
2173 vfprintf_filtered (struct ui_file *stream, const char *format, va_list args)
2175 vfprintf_maybe_filtered (stream, format, args, 1);
2179 vfprintf_unfiltered (struct ui_file *stream, const char *format, va_list args)
2182 struct cleanup *old_cleanups;
2184 linebuffer = xstrvprintf (format, args);
2185 old_cleanups = make_cleanup (xfree, linebuffer);
2186 fputs_unfiltered (linebuffer, stream);
2187 do_cleanups (old_cleanups);
2191 vprintf_filtered (const char *format, va_list args)
2193 vfprintf_maybe_filtered (gdb_stdout, format, args, 1);
2197 vprintf_unfiltered (const char *format, va_list args)
2199 vfprintf_unfiltered (gdb_stdout, format, args);
2203 fprintf_filtered (struct ui_file *stream, const char *format, ...)
2206 va_start (args, format);
2207 vfprintf_filtered (stream, format, args);
2212 fprintf_unfiltered (struct ui_file *stream, const char *format, ...)
2215 va_start (args, format);
2216 vfprintf_unfiltered (stream, format, args);
2220 /* Like fprintf_filtered, but prints its result indented.
2221 Called as fprintfi_filtered (spaces, stream, format, ...); */
2224 fprintfi_filtered (int spaces, struct ui_file *stream, const char *format,
2228 va_start (args, format);
2229 print_spaces_filtered (spaces, stream);
2231 vfprintf_filtered (stream, format, args);
2237 printf_filtered (const char *format, ...)
2240 va_start (args, format);
2241 vfprintf_filtered (gdb_stdout, format, args);
2247 printf_unfiltered (const char *format, ...)
2250 va_start (args, format);
2251 vfprintf_unfiltered (gdb_stdout, format, args);
2255 /* Like printf_filtered, but prints it's result indented.
2256 Called as printfi_filtered (spaces, format, ...); */
2259 printfi_filtered (int spaces, const char *format, ...)
2262 va_start (args, format);
2263 print_spaces_filtered (spaces, gdb_stdout);
2264 vfprintf_filtered (gdb_stdout, format, args);
2268 /* Easy -- but watch out!
2270 This routine is *not* a replacement for puts()! puts() appends a newline.
2271 This one doesn't, and had better not! */
2274 puts_filtered (const char *string)
2276 fputs_filtered (string, gdb_stdout);
2280 puts_unfiltered (const char *string)
2282 fputs_unfiltered (string, gdb_stdout);
2285 /* Return a pointer to N spaces and a null. The pointer is good
2286 until the next call to here. */
2291 static char *spaces = 0;
2292 static int max_spaces = -1;
2298 spaces = (char *) xmalloc (n + 1);
2299 for (t = spaces + n; t != spaces;)
2305 return spaces + max_spaces - n;
2308 /* Print N spaces. */
2310 print_spaces_filtered (int n, struct ui_file *stream)
2312 fputs_filtered (n_spaces (n), stream);
2315 /* C++/ObjC demangler stuff. */
2317 /* fprintf_symbol_filtered attempts to demangle NAME, a symbol in language
2318 LANG, using demangling args ARG_MODE, and print it filtered to STREAM.
2319 If the name is not mangled, or the language for the name is unknown, or
2320 demangling is off, the name is printed in its "raw" form. */
2323 fprintf_symbol_filtered (struct ui_file *stream, char *name,
2324 enum language lang, int arg_mode)
2330 /* If user wants to see raw output, no problem. */
2333 fputs_filtered (name, stream);
2337 demangled = language_demangle (language_def (lang), name, arg_mode);
2338 fputs_filtered (demangled ? demangled : name, stream);
2339 if (demangled != NULL)
2347 /* Do a strcmp() type operation on STRING1 and STRING2, ignoring any
2348 differences in whitespace. Returns 0 if they match, non-zero if they
2349 don't (slightly different than strcmp()'s range of return values).
2351 As an extra hack, string1=="FOO(ARGS)" matches string2=="FOO".
2352 This "feature" is useful when searching for matching C++ function names
2353 (such as if the user types 'break FOO', where FOO is a mangled C++
2357 strcmp_iw (const char *string1, const char *string2)
2359 while ((*string1 != '\0') && (*string2 != '\0'))
2361 while (isspace (*string1))
2365 while (isspace (*string2))
2369 if (*string1 != *string2)
2373 if (*string1 != '\0')
2379 return (*string1 != '\0' && *string1 != '(') || (*string2 != '\0');
2382 /* This is like strcmp except that it ignores whitespace and treats
2383 '(' as the first non-NULL character in terms of ordering. Like
2384 strcmp (and unlike strcmp_iw), it returns negative if STRING1 <
2385 STRING2, 0 if STRING2 = STRING2, and positive if STRING1 > STRING2
2386 according to that ordering.
2388 If a list is sorted according to this function and if you want to
2389 find names in the list that match some fixed NAME according to
2390 strcmp_iw(LIST_ELT, NAME), then the place to start looking is right
2391 where this function would put NAME.
2393 Here are some examples of why using strcmp to sort is a bad idea:
2397 Say your partial symtab contains: "foo<char *>", "goo". Then, if
2398 we try to do a search for "foo<char*>", strcmp will locate this
2399 after "foo<char *>" and before "goo". Then lookup_partial_symbol
2400 will start looking at strings beginning with "goo", and will never
2401 see the correct match of "foo<char *>".
2403 Parenthesis example:
2405 In practice, this is less like to be an issue, but I'll give it a
2406 shot. Let's assume that '$' is a legitimate character to occur in
2407 symbols. (Which may well even be the case on some systems.) Then
2408 say that the partial symbol table contains "foo$" and "foo(int)".
2409 strcmp will put them in this order, since '$' < '('. Now, if the
2410 user searches for "foo", then strcmp will sort "foo" before "foo$".
2411 Then lookup_partial_symbol will notice that strcmp_iw("foo$",
2412 "foo") is false, so it won't proceed to the actual match of
2413 "foo(int)" with "foo". */
2416 strcmp_iw_ordered (const char *string1, const char *string2)
2418 while ((*string1 != '\0') && (*string2 != '\0'))
2420 while (isspace (*string1))
2424 while (isspace (*string2))
2428 if (*string1 != *string2)
2432 if (*string1 != '\0')
2441 /* Characters are non-equal unless they're both '\0'; we want to
2442 make sure we get the comparison right according to our
2443 comparison in the cases where one of them is '\0' or '('. */
2445 if (*string2 == '\0')
2450 if (*string2 == '\0')
2455 if (*string2 == '(')
2458 return *string1 - *string2;
2462 /* A simple comparison function with opposite semantics to strcmp. */
2465 streq (const char *lhs, const char *rhs)
2467 return !strcmp (lhs, rhs);
2473 ** Answer whether string_to_compare is a full or partial match to
2474 ** template_string. The partial match must be in sequence starting
2478 subset_compare (char *string_to_compare, char *template_string)
2481 if (template_string != (char *) NULL && string_to_compare != (char *) NULL
2482 && strlen (string_to_compare) <= strlen (template_string))
2485 (template_string, string_to_compare, strlen (string_to_compare)) == 0);
2492 static void pagination_on_command (char *arg, int from_tty);
2494 pagination_on_command (char *arg, int from_tty)
2496 pagination_enabled = 1;
2499 static void pagination_on_command (char *arg, int from_tty);
2501 pagination_off_command (char *arg, int from_tty)
2503 pagination_enabled = 0;
2508 initialize_utils (void)
2510 struct cmd_list_element *c;
2512 add_setshow_uinteger_cmd ("width", class_support, &chars_per_line, _("\
2513 Set number of characters gdb thinks are in a line."), _("\
2514 Show number of characters gdb thinks are in a line."), NULL,
2516 show_chars_per_line,
2517 &setlist, &showlist);
2519 add_setshow_uinteger_cmd ("height", class_support, &lines_per_page, _("\
2520 Set number of lines gdb thinks are in a page."), _("\
2521 Show number of lines gdb thinks are in a page."), NULL,
2523 show_lines_per_page,
2524 &setlist, &showlist);
2528 add_setshow_boolean_cmd ("demangle", class_support, &demangle, _("\
2529 Set demangling of encoded C++/ObjC names when displaying symbols."), _("\
2530 Show demangling of encoded C++/ObjC names when displaying symbols."), NULL,
2533 &setprintlist, &showprintlist);
2535 add_setshow_boolean_cmd ("pagination", class_support,
2536 &pagination_enabled, _("\
2537 Set state of pagination."), _("\
2538 Show state of pagination."), NULL,
2540 show_pagination_enabled,
2541 &setlist, &showlist);
2545 add_com ("am", class_support, pagination_on_command,
2546 _("Enable pagination"));
2547 add_com ("sm", class_support, pagination_off_command,
2548 _("Disable pagination"));
2551 add_setshow_boolean_cmd ("sevenbit-strings", class_support,
2552 &sevenbit_strings, _("\
2553 Set printing of 8-bit characters in strings as \\nnn."), _("\
2554 Show printing of 8-bit characters in strings as \\nnn."), NULL,
2556 show_sevenbit_strings,
2557 &setprintlist, &showprintlist);
2559 add_setshow_boolean_cmd ("asm-demangle", class_support, &asm_demangle, _("\
2560 Set demangling of C++/ObjC names in disassembly listings."), _("\
2561 Show demangling of C++/ObjC names in disassembly listings."), NULL,
2564 &setprintlist, &showprintlist);
2567 /* Machine specific function to handle SIGWINCH signal. */
2569 #ifdef SIGWINCH_HANDLER_BODY
2570 SIGWINCH_HANDLER_BODY
2572 /* print routines to handle variable size regs, etc. */
2573 /* temporary storage using circular buffer */
2579 static char buf[NUMCELLS][CELLSIZE];
2580 static int cell = 0;
2581 if (++cell >= NUMCELLS)
2589 return (TARGET_ADDR_BIT / 8 * 2);
2593 paddr (CORE_ADDR addr)
2595 return phex (addr, TARGET_ADDR_BIT / 8);
2599 paddr_nz (CORE_ADDR addr)
2601 return phex_nz (addr, TARGET_ADDR_BIT / 8);
2605 paddress (CORE_ADDR addr)
2607 /* Truncate address to the size of a target address, avoiding shifts
2608 larger or equal than the width of a CORE_ADDR. The local
2609 variable ADDR_BIT stops the compiler reporting a shift overflow
2610 when it won't occur. */
2611 /* NOTE: This assumes that the significant address information is
2612 kept in the least significant bits of ADDR - the upper bits were
2613 either zero or sign extended. Should ADDRESS_TO_POINTER() or
2614 some ADDRESS_TO_PRINTABLE() be used to do the conversion? */
2616 int addr_bit = TARGET_ADDR_BIT;
2618 if (addr_bit < (sizeof (CORE_ADDR) * HOST_CHAR_BIT))
2619 addr &= ((CORE_ADDR) 1 << addr_bit) - 1;
2620 return hex_string (addr);
2624 decimal2str (char *sign, ULONGEST addr, int width)
2626 /* Steal code from valprint.c:print_decimal(). Should this worry
2627 about the real size of addr as the above does? */
2628 unsigned long temp[3];
2629 char *str = get_cell ();
2634 temp[i] = addr % (1000 * 1000 * 1000);
2635 addr /= (1000 * 1000 * 1000);
2639 while (addr != 0 && i < (sizeof (temp) / sizeof (temp[0])));
2648 xsnprintf (str, CELLSIZE, "%s%0*lu", sign, width, temp[0]);
2651 xsnprintf (str, CELLSIZE, "%s%0*lu%09lu", sign, width,
2655 xsnprintf (str, CELLSIZE, "%s%0*lu%09lu%09lu", sign, width,
2656 temp[2], temp[1], temp[0]);
2659 internal_error (__FILE__, __LINE__,
2660 _("failed internal consistency check"));
2667 octal2str (ULONGEST addr, int width)
2669 unsigned long temp[3];
2670 char *str = get_cell ();
2675 temp[i] = addr % (0100000 * 0100000);
2676 addr /= (0100000 * 0100000);
2680 while (addr != 0 && i < (sizeof (temp) / sizeof (temp[0])));
2690 xsnprintf (str, CELLSIZE, "%*o", width, 0);
2692 xsnprintf (str, CELLSIZE, "0%0*lo", width, temp[0]);
2695 xsnprintf (str, CELLSIZE, "0%0*lo%010lo", width, temp[1], temp[0]);
2698 xsnprintf (str, CELLSIZE, "0%0*lo%010lo%010lo", width,
2699 temp[2], temp[1], temp[0]);
2702 internal_error (__FILE__, __LINE__,
2703 _("failed internal consistency check"));
2710 paddr_u (CORE_ADDR addr)
2712 return decimal2str ("", addr, 0);
2716 paddr_d (LONGEST addr)
2719 return decimal2str ("-", -addr, 0);
2721 return decimal2str ("", addr, 0);
2724 /* Eliminate warning from compiler on 32-bit systems. */
2725 static int thirty_two = 32;
2728 phex (ULONGEST l, int sizeof_l)
2736 xsnprintf (str, CELLSIZE, "%08lx%08lx",
2737 (unsigned long) (l >> thirty_two),
2738 (unsigned long) (l & 0xffffffff));
2742 xsnprintf (str, CELLSIZE, "%08lx", (unsigned long) l);
2746 xsnprintf (str, CELLSIZE, "%04x", (unsigned short) (l & 0xffff));
2749 str = phex (l, sizeof (l));
2757 phex_nz (ULONGEST l, int sizeof_l)
2765 unsigned long high = (unsigned long) (l >> thirty_two);
2768 xsnprintf (str, CELLSIZE, "%lx",
2769 (unsigned long) (l & 0xffffffff));
2771 xsnprintf (str, CELLSIZE, "%lx%08lx", high,
2772 (unsigned long) (l & 0xffffffff));
2777 xsnprintf (str, CELLSIZE, "%lx", (unsigned long) l);
2781 xsnprintf (str, CELLSIZE, "%x", (unsigned short) (l & 0xffff));
2784 str = phex_nz (l, sizeof (l));
2791 /* Converts a LONGEST to a C-format hexadecimal literal and stores it
2792 in a static string. Returns a pointer to this string. */
2794 hex_string (LONGEST num)
2796 char *result = get_cell ();
2797 xsnprintf (result, CELLSIZE, "0x%s", phex_nz (num, sizeof (num)));
2801 /* Converts a LONGEST number to a C-format hexadecimal literal and
2802 stores it in a static string. Returns a pointer to this string
2803 that is valid until the next call. The number is padded on the
2804 left with 0s to at least WIDTH characters. */
2806 hex_string_custom (LONGEST num, int width)
2808 char *result = get_cell ();
2809 char *result_end = result + CELLSIZE - 1;
2810 const char *hex = phex_nz (num, sizeof (num));
2811 int hex_len = strlen (hex);
2813 if (hex_len > width)
2815 if (width + 2 >= CELLSIZE)
2816 internal_error (__FILE__, __LINE__,
2817 _("hex_string_custom: insufficient space to store result"));
2819 strcpy (result_end - width - 2, "0x");
2820 memset (result_end - width, '0', width);
2821 strcpy (result_end - hex_len, hex);
2822 return result_end - width - 2;
2825 /* Convert VAL to a numeral in the given radix. For
2826 * radix 10, IS_SIGNED may be true, indicating a signed quantity;
2827 * otherwise VAL is interpreted as unsigned. If WIDTH is supplied,
2828 * it is the minimum width (0-padded if needed). USE_C_FORMAT means
2829 * to use C format in all cases. If it is false, then 'x'
2830 * and 'o' formats do not include a prefix (0x or leading 0). */
2833 int_string (LONGEST val, int radix, int is_signed, int width,
2842 result = hex_string (val);
2844 result = hex_string_custom (val, width);
2851 if (is_signed && val < 0)
2852 return decimal2str ("-", -val, width);
2854 return decimal2str ("", val, width);
2858 char *result = octal2str (val, width);
2859 if (use_c_format || val == 0)
2865 internal_error (__FILE__, __LINE__,
2866 _("failed internal consistency check"));
2870 /* Convert a CORE_ADDR into a string. */
2872 core_addr_to_string (const CORE_ADDR addr)
2874 char *str = get_cell ();
2876 strcat (str, phex (addr, sizeof (addr)));
2881 core_addr_to_string_nz (const CORE_ADDR addr)
2883 char *str = get_cell ();
2885 strcat (str, phex_nz (addr, sizeof (addr)));
2889 /* Convert a string back into a CORE_ADDR. */
2891 string_to_core_addr (const char *my_string)
2894 if (my_string[0] == '0' && tolower (my_string[1]) == 'x')
2896 /* Assume that it is in decimal. */
2898 for (i = 2; my_string[i] != '\0'; i++)
2900 if (isdigit (my_string[i]))
2901 addr = (my_string[i] - '0') + (addr * 16);
2902 else if (isxdigit (my_string[i]))
2903 addr = (tolower (my_string[i]) - 'a' + 0xa) + (addr * 16);
2905 internal_error (__FILE__, __LINE__, _("invalid hex"));
2910 /* Assume that it is in decimal. */
2912 for (i = 0; my_string[i] != '\0'; i++)
2914 if (isdigit (my_string[i]))
2915 addr = (my_string[i] - '0') + (addr * 10);
2917 internal_error (__FILE__, __LINE__, _("invalid decimal"));
2924 gdb_realpath (const char *filename)
2926 /* Method 1: The system has a compile time upper bound on a filename
2927 path. Use that and realpath() to canonicalize the name. This is
2928 the most common case. Note that, if there isn't a compile time
2929 upper bound, you want to avoid realpath() at all costs. */
2930 #if defined(HAVE_REALPATH)
2932 # if defined (PATH_MAX)
2934 # define USE_REALPATH
2935 # elif defined (MAXPATHLEN)
2936 char buf[MAXPATHLEN];
2937 # define USE_REALPATH
2939 # if defined (USE_REALPATH)
2940 const char *rp = realpath (filename, buf);
2943 return xstrdup (rp);
2946 #endif /* HAVE_REALPATH */
2948 /* Method 2: The host system (i.e., GNU) has the function
2949 canonicalize_file_name() which malloc's a chunk of memory and
2950 returns that, use that. */
2951 #if defined(HAVE_CANONICALIZE_FILE_NAME)
2953 char *rp = canonicalize_file_name (filename);
2955 return xstrdup (filename);
2961 /* FIXME: cagney/2002-11-13:
2963 Method 2a: Use realpath() with a NULL buffer. Some systems, due
2964 to the problems described in in method 3, have modified their
2965 realpath() implementation so that it will allocate a buffer when
2966 NULL is passed in. Before this can be used, though, some sort of
2967 configure time test would need to be added. Otherwize the code
2968 will likely core dump. */
2970 /* Method 3: Now we're getting desperate! The system doesn't have a
2971 compile time buffer size and no alternative function. Query the
2972 OS, using pathconf(), for the buffer limit. Care is needed
2973 though, some systems do not limit PATH_MAX (return -1 for
2974 pathconf()) making it impossible to pass a correctly sized buffer
2975 to realpath() (it could always overflow). On those systems, we
2977 #if defined (HAVE_REALPATH) && defined (HAVE_UNISTD_H) && defined(HAVE_ALLOCA)
2979 /* Find out the max path size. */
2980 long path_max = pathconf ("/", _PC_PATH_MAX);
2983 /* PATH_MAX is bounded. */
2984 char *buf = alloca (path_max);
2985 char *rp = realpath (filename, buf);
2986 return xstrdup (rp ? rp : filename);
2991 /* This system is a lost cause, just dup the buffer. */
2992 return xstrdup (filename);
2995 /* Return a copy of FILENAME, with its directory prefix canonicalized
2999 xfullpath (const char *filename)
3001 const char *base_name = lbasename (filename);
3006 /* Extract the basename of filename, and return immediately
3007 a copy of filename if it does not contain any directory prefix. */
3008 if (base_name == filename)
3009 return xstrdup (filename);
3011 dir_name = alloca ((size_t) (base_name - filename + 2));
3012 /* Allocate enough space to store the dir_name + plus one extra
3013 character sometimes needed under Windows (see below), and
3014 then the closing \000 character */
3015 strncpy (dir_name, filename, base_name - filename);
3016 dir_name[base_name - filename] = '\000';
3018 #ifdef HAVE_DOS_BASED_FILE_SYSTEM
3019 /* We need to be careful when filename is of the form 'd:foo', which
3020 is equivalent of d:./foo, which is totally different from d:/foo. */
3021 if (strlen (dir_name) == 2 && isalpha (dir_name[0]) && dir_name[1] == ':')
3024 dir_name[3] = '\000';
3028 /* Canonicalize the directory prefix, and build the resulting
3029 filename. If the dirname realpath already contains an ending
3030 directory separator, avoid doubling it. */
3031 real_path = gdb_realpath (dir_name);
3032 if (IS_DIR_SEPARATOR (real_path[strlen (real_path) - 1]))
3033 result = concat (real_path, base_name, (char *)NULL);
3035 result = concat (real_path, SLASH_STRING, base_name, (char *)NULL);
3042 /* This is the 32-bit CRC function used by the GNU separate debug
3043 facility. An executable may contain a section named
3044 .gnu_debuglink, which holds the name of a separate executable file
3045 containing its debug info, and a checksum of that file's contents,
3046 computed using this function. */
3048 gnu_debuglink_crc32 (unsigned long crc, unsigned char *buf, size_t len)
3050 static const unsigned long crc32_table[256] = {
3051 0x00000000, 0x77073096, 0xee0e612c, 0x990951ba, 0x076dc419,
3052 0x706af48f, 0xe963a535, 0x9e6495a3, 0x0edb8832, 0x79dcb8a4,
3053 0xe0d5e91e, 0x97d2d988, 0x09b64c2b, 0x7eb17cbd, 0xe7b82d07,
3054 0x90bf1d91, 0x1db71064, 0x6ab020f2, 0xf3b97148, 0x84be41de,
3055 0x1adad47d, 0x6ddde4eb, 0xf4d4b551, 0x83d385c7, 0x136c9856,
3056 0x646ba8c0, 0xfd62f97a, 0x8a65c9ec, 0x14015c4f, 0x63066cd9,
3057 0xfa0f3d63, 0x8d080df5, 0x3b6e20c8, 0x4c69105e, 0xd56041e4,
3058 0xa2677172, 0x3c03e4d1, 0x4b04d447, 0xd20d85fd, 0xa50ab56b,
3059 0x35b5a8fa, 0x42b2986c, 0xdbbbc9d6, 0xacbcf940, 0x32d86ce3,
3060 0x45df5c75, 0xdcd60dcf, 0xabd13d59, 0x26d930ac, 0x51de003a,
3061 0xc8d75180, 0xbfd06116, 0x21b4f4b5, 0x56b3c423, 0xcfba9599,
3062 0xb8bda50f, 0x2802b89e, 0x5f058808, 0xc60cd9b2, 0xb10be924,
3063 0x2f6f7c87, 0x58684c11, 0xc1611dab, 0xb6662d3d, 0x76dc4190,
3064 0x01db7106, 0x98d220bc, 0xefd5102a, 0x71b18589, 0x06b6b51f,
3065 0x9fbfe4a5, 0xe8b8d433, 0x7807c9a2, 0x0f00f934, 0x9609a88e,
3066 0xe10e9818, 0x7f6a0dbb, 0x086d3d2d, 0x91646c97, 0xe6635c01,
3067 0x6b6b51f4, 0x1c6c6162, 0x856530d8, 0xf262004e, 0x6c0695ed,
3068 0x1b01a57b, 0x8208f4c1, 0xf50fc457, 0x65b0d9c6, 0x12b7e950,
3069 0x8bbeb8ea, 0xfcb9887c, 0x62dd1ddf, 0x15da2d49, 0x8cd37cf3,
3070 0xfbd44c65, 0x4db26158, 0x3ab551ce, 0xa3bc0074, 0xd4bb30e2,
3071 0x4adfa541, 0x3dd895d7, 0xa4d1c46d, 0xd3d6f4fb, 0x4369e96a,
3072 0x346ed9fc, 0xad678846, 0xda60b8d0, 0x44042d73, 0x33031de5,
3073 0xaa0a4c5f, 0xdd0d7cc9, 0x5005713c, 0x270241aa, 0xbe0b1010,
3074 0xc90c2086, 0x5768b525, 0x206f85b3, 0xb966d409, 0xce61e49f,
3075 0x5edef90e, 0x29d9c998, 0xb0d09822, 0xc7d7a8b4, 0x59b33d17,
3076 0x2eb40d81, 0xb7bd5c3b, 0xc0ba6cad, 0xedb88320, 0x9abfb3b6,
3077 0x03b6e20c, 0x74b1d29a, 0xead54739, 0x9dd277af, 0x04db2615,
3078 0x73dc1683, 0xe3630b12, 0x94643b84, 0x0d6d6a3e, 0x7a6a5aa8,
3079 0xe40ecf0b, 0x9309ff9d, 0x0a00ae27, 0x7d079eb1, 0xf00f9344,
3080 0x8708a3d2, 0x1e01f268, 0x6906c2fe, 0xf762575d, 0x806567cb,
3081 0x196c3671, 0x6e6b06e7, 0xfed41b76, 0x89d32be0, 0x10da7a5a,
3082 0x67dd4acc, 0xf9b9df6f, 0x8ebeeff9, 0x17b7be43, 0x60b08ed5,
3083 0xd6d6a3e8, 0xa1d1937e, 0x38d8c2c4, 0x4fdff252, 0xd1bb67f1,
3084 0xa6bc5767, 0x3fb506dd, 0x48b2364b, 0xd80d2bda, 0xaf0a1b4c,
3085 0x36034af6, 0x41047a60, 0xdf60efc3, 0xa867df55, 0x316e8eef,
3086 0x4669be79, 0xcb61b38c, 0xbc66831a, 0x256fd2a0, 0x5268e236,
3087 0xcc0c7795, 0xbb0b4703, 0x220216b9, 0x5505262f, 0xc5ba3bbe,
3088 0xb2bd0b28, 0x2bb45a92, 0x5cb36a04, 0xc2d7ffa7, 0xb5d0cf31,
3089 0x2cd99e8b, 0x5bdeae1d, 0x9b64c2b0, 0xec63f226, 0x756aa39c,
3090 0x026d930a, 0x9c0906a9, 0xeb0e363f, 0x72076785, 0x05005713,
3091 0x95bf4a82, 0xe2b87a14, 0x7bb12bae, 0x0cb61b38, 0x92d28e9b,
3092 0xe5d5be0d, 0x7cdcefb7, 0x0bdbdf21, 0x86d3d2d4, 0xf1d4e242,
3093 0x68ddb3f8, 0x1fda836e, 0x81be16cd, 0xf6b9265b, 0x6fb077e1,
3094 0x18b74777, 0x88085ae6, 0xff0f6a70, 0x66063bca, 0x11010b5c,
3095 0x8f659eff, 0xf862ae69, 0x616bffd3, 0x166ccf45, 0xa00ae278,
3096 0xd70dd2ee, 0x4e048354, 0x3903b3c2, 0xa7672661, 0xd06016f7,
3097 0x4969474d, 0x3e6e77db, 0xaed16a4a, 0xd9d65adc, 0x40df0b66,
3098 0x37d83bf0, 0xa9bcae53, 0xdebb9ec5, 0x47b2cf7f, 0x30b5ffe9,
3099 0xbdbdf21c, 0xcabac28a, 0x53b39330, 0x24b4a3a6, 0xbad03605,
3100 0xcdd70693, 0x54de5729, 0x23d967bf, 0xb3667a2e, 0xc4614ab8,
3101 0x5d681b02, 0x2a6f2b94, 0xb40bbe37, 0xc30c8ea1, 0x5a05df1b,
3106 crc = ~crc & 0xffffffff;
3107 for (end = buf + len; buf < end; ++buf)
3108 crc = crc32_table[(crc ^ *buf) & 0xff] ^ (crc >> 8);
3109 return ~crc & 0xffffffff;;
3113 align_up (ULONGEST v, int n)
3115 /* Check that N is really a power of two. */
3116 gdb_assert (n && (n & (n-1)) == 0);
3117 return (v + n - 1) & -n;
3121 align_down (ULONGEST v, int n)
3123 /* Check that N is really a power of two. */
3124 gdb_assert (n && (n & (n-1)) == 0);