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
)
851 msg
= strerror (errnum
);
854 sprintf (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
);
1082 /* My replacement for the read system call.
1083 Used like `read' but keeps going if `read' returns too soon. */
1086 myread (int desc
, char *addr
, int len
)
1093 val
= read (desc
, addr
, len
);
1097 return orglen
- len
;
1104 /* Make a copy of the string at PTR with SIZE characters
1105 (and add a null character at the end in the copy).
1106 Uses malloc to get the space. Returns the address of the copy. */
1109 savestring (const char *ptr
, size_t size
)
1111 char *p
= (char *) xmalloc (size
+ 1);
1112 memcpy (p
, ptr
, size
);
1118 print_spaces (int n
, struct ui_file
*file
)
1120 fputs_unfiltered (n_spaces (n
), file
);
1123 /* Print a host address. */
1126 gdb_print_host_address (const void *addr
, struct ui_file
*stream
)
1129 /* We could use the %p conversion specifier to fprintf if we had any
1130 way of knowing whether this host supports it. But the following
1131 should work on the Alpha and on 32 bit machines. */
1133 fprintf_filtered (stream
, "0x%lx", (unsigned long) addr
);
1136 /* Ask user a y-or-n question and return 1 iff answer is yes.
1137 Takes three args which are given to printf to print the question.
1138 The first, a control string, should end in "? ".
1139 It should not say how to answer, because we do that. */
1143 query (const char *ctlstr
, ...)
1150 if (deprecated_query_hook
)
1152 va_start (args
, ctlstr
);
1153 return deprecated_query_hook (ctlstr
, args
);
1156 /* Automatically answer "yes" if input is not from a terminal. */
1157 if (!input_from_terminal_p ())
1162 wrap_here (""); /* Flush any buffered output */
1163 gdb_flush (gdb_stdout
);
1165 if (annotation_level
> 1)
1166 printf_filtered (("\n\032\032pre-query\n"));
1168 va_start (args
, ctlstr
);
1169 vfprintf_filtered (gdb_stdout
, ctlstr
, args
);
1171 printf_filtered (_("(y or n) "));
1173 if (annotation_level
> 1)
1174 printf_filtered (("\n\032\032query\n"));
1177 gdb_flush (gdb_stdout
);
1179 answer
= fgetc (stdin
);
1180 clearerr (stdin
); /* in case of C-d */
1181 if (answer
== EOF
) /* C-d */
1186 /* Eat rest of input line, to EOF or newline */
1190 ans2
= fgetc (stdin
);
1193 while (ans2
!= EOF
&& ans2
!= '\n' && ans2
!= '\r');
1207 printf_filtered (_("Please answer y or n.\n"));
1210 if (annotation_level
> 1)
1211 printf_filtered (("\n\032\032post-query\n"));
1216 /* This function supports the nquery() and yquery() functions.
1217 Ask user a y-or-n question and return 0 if answer is no, 1 if
1218 answer is yes, or default the answer to the specified default.
1219 DEFCHAR is either 'y' or 'n' and refers to the default answer.
1220 CTLSTR is the control string and should end in "? ". It should
1221 not say how to answer, because we do that.
1222 ARGS are the arguments passed along with the CTLSTR argument to
1226 defaulted_query (const char *ctlstr
, const char defchar
, va_list args
)
1232 char def_answer
, not_def_answer
;
1233 char *y_string
, *n_string
;
1235 /* Set up according to which answer is the default. */
1240 not_def_answer
= 'N';
1248 not_def_answer
= 'Y';
1253 if (deprecated_query_hook
)
1255 return deprecated_query_hook (ctlstr
, args
);
1258 /* Automatically answer default value if input is not from a terminal. */
1259 if (!input_from_terminal_p ())
1264 wrap_here (""); /* Flush any buffered output */
1265 gdb_flush (gdb_stdout
);
1267 if (annotation_level
> 1)
1268 printf_filtered (("\n\032\032pre-query\n"));
1270 vfprintf_filtered (gdb_stdout
, ctlstr
, args
);
1271 printf_filtered (_("(%s or %s) "), y_string
, n_string
);
1273 if (annotation_level
> 1)
1274 printf_filtered (("\n\032\032query\n"));
1277 gdb_flush (gdb_stdout
);
1279 answer
= fgetc (stdin
);
1280 clearerr (stdin
); /* in case of C-d */
1281 if (answer
== EOF
) /* C-d */
1286 /* Eat rest of input line, to EOF or newline */
1290 ans2
= fgetc (stdin
);
1293 while (ans2
!= EOF
&& ans2
!= '\n' && ans2
!= '\r');
1297 /* Check answer. For the non-default, the user must specify
1298 the non-default explicitly. */
1299 if (answer
== not_def_answer
)
1301 retval
= !def_value
;
1304 /* Otherwise, for the default, the user may either specify
1305 the required input or have it default by entering nothing. */
1306 if (answer
== def_answer
|| answer
== '\n' ||
1307 answer
== '\r' || answer
== EOF
)
1312 /* Invalid entries are not defaulted and require another selection. */
1313 printf_filtered (_("Please answer %s or %s.\n"),
1314 y_string
, n_string
);
1317 if (annotation_level
> 1)
1318 printf_filtered (("\n\032\032post-query\n"));
1323 /* Ask user a y-or-n question and return 0 if answer is no, 1 if
1324 answer is yes, or 0 if answer is defaulted.
1325 Takes three args which are given to printf to print the question.
1326 The first, a control string, should end in "? ".
1327 It should not say how to answer, because we do that. */
1330 nquery (const char *ctlstr
, ...)
1334 va_start (args
, ctlstr
);
1335 return defaulted_query (ctlstr
, 'n', args
);
1339 /* Ask user a y-or-n question and return 0 if answer is no, 1 if
1340 answer is yes, or 1 if answer is defaulted.
1341 Takes three args which are given to printf to print the question.
1342 The first, a control string, should end in "? ".
1343 It should not say how to answer, because we do that. */
1346 yquery (const char *ctlstr
, ...)
1350 va_start (args
, ctlstr
);
1351 return defaulted_query (ctlstr
, 'y', args
);
1355 /* Print an error message saying that we couldn't make sense of a
1356 \^mumble sequence in a string or character constant. START and END
1357 indicate a substring of some larger string that contains the
1358 erroneous backslash sequence, missing the initial backslash. */
1360 no_control_char_error (const char *start
, const char *end
)
1362 int len
= end
- start
;
1363 char *copy
= alloca (end
- start
+ 1);
1365 memcpy (copy
, start
, len
);
1368 error (_("There is no control character `\\%s' in the `%s' character set."),
1369 copy
, target_charset ());
1372 /* Parse a C escape sequence. STRING_PTR points to a variable
1373 containing a pointer to the string to parse. That pointer
1374 should point to the character after the \. That pointer
1375 is updated past the characters we use. The value of the
1376 escape sequence is returned.
1378 A negative value means the sequence \ newline was seen,
1379 which is supposed to be equivalent to nothing at all.
1381 If \ is followed by a null character, we return a negative
1382 value and leave the string pointer pointing at the null character.
1384 If \ is followed by 000, we return 0 and leave the string pointer
1385 after the zeros. A value of 0 does not mean end of string. */
1388 parse_escape (char **string_ptr
)
1391 int c
= *(*string_ptr
)++;
1392 if (c_parse_backslash (c
, &target_char
))
1404 /* Remember where this escape sequence started, for reporting
1406 char *sequence_start_pos
= *string_ptr
- 1;
1408 c
= *(*string_ptr
)++;
1412 /* XXXCHARSET: What is `delete' in the host character set? */
1415 if (!host_char_to_target (c
, &target_char
))
1416 error (_("There is no character corresponding to `Delete' "
1417 "in the target character set `%s'."), host_charset ());
1422 target_char
= parse_escape (string_ptr
);
1425 if (!host_char_to_target (c
, &target_char
))
1426 no_control_char_error (sequence_start_pos
, *string_ptr
);
1429 /* Now target_char is something like `c', and we want to find
1430 its control-character equivalent. */
1431 if (!target_char_to_control_char (target_char
, &target_char
))
1432 no_control_char_error (sequence_start_pos
, *string_ptr
);
1437 /* XXXCHARSET: we need to use isdigit and value-of-digit
1438 methods of the host character set here. */
1454 if (c
>= '0' && c
<= '7')
1468 if (!host_char_to_target (c
, &target_char
))
1470 ("The escape sequence `\%c' is equivalent to plain `%c', which"
1471 " has no equivalent\n" "in the `%s' character set.", c
, c
,
1477 /* Print the character C on STREAM as part of the contents of a literal
1478 string whose delimiter is QUOTER. Note that this routine should only
1479 be call for printing things which are independent of the language
1480 of the program being debugged. */
1483 printchar (int c
, void (*do_fputs
) (const char *, struct ui_file
*),
1484 void (*do_fprintf
) (struct ui_file
*, const char *, ...),
1485 struct ui_file
*stream
, int quoter
)
1488 c
&= 0xFF; /* Avoid sign bit follies */
1490 if (c
< 0x20 || /* Low control chars */
1491 (c
>= 0x7F && c
< 0xA0) || /* DEL, High controls */
1492 (sevenbit_strings
&& c
>= 0x80))
1493 { /* high order bit set */
1497 do_fputs ("\\n", stream
);
1500 do_fputs ("\\b", stream
);
1503 do_fputs ("\\t", stream
);
1506 do_fputs ("\\f", stream
);
1509 do_fputs ("\\r", stream
);
1512 do_fputs ("\\e", stream
);
1515 do_fputs ("\\a", stream
);
1518 do_fprintf (stream
, "\\%.3o", (unsigned int) c
);
1524 if (c
== '\\' || c
== quoter
)
1525 do_fputs ("\\", stream
);
1526 do_fprintf (stream
, "%c", c
);
1530 /* Print the character C on STREAM as part of the contents of a
1531 literal string whose delimiter is QUOTER. Note that these routines
1532 should only be call for printing things which are independent of
1533 the language of the program being debugged. */
1536 fputstr_filtered (const char *str
, int quoter
, struct ui_file
*stream
)
1539 printchar (*str
++, fputs_filtered
, fprintf_filtered
, stream
, quoter
);
1543 fputstr_unfiltered (const char *str
, int quoter
, struct ui_file
*stream
)
1546 printchar (*str
++, fputs_unfiltered
, fprintf_unfiltered
, stream
, quoter
);
1550 fputstrn_unfiltered (const char *str
, int n
, int quoter
,
1551 struct ui_file
*stream
)
1554 for (i
= 0; i
< n
; i
++)
1555 printchar (str
[i
], fputs_unfiltered
, fprintf_unfiltered
, stream
, quoter
);
1559 /* Number of lines per page or UINT_MAX if paging is disabled. */
1560 static unsigned int lines_per_page
;
1562 show_lines_per_page (struct ui_file
*file
, int from_tty
,
1563 struct cmd_list_element
*c
, const char *value
)
1565 fprintf_filtered (file
, _("\
1566 Number of lines gdb thinks are in a page is %s.\n"),
1570 /* Number of chars per line or UINT_MAX if line folding is disabled. */
1571 static unsigned int chars_per_line
;
1573 show_chars_per_line (struct ui_file
*file
, int from_tty
,
1574 struct cmd_list_element
*c
, const char *value
)
1576 fprintf_filtered (file
, _("\
1577 Number of characters gdb thinks are in a line is %s.\n"),
1581 /* Current count of lines printed on this page, chars on this line. */
1582 static unsigned int lines_printed
, chars_printed
;
1584 /* Buffer and start column of buffered text, for doing smarter word-
1585 wrapping. When someone calls wrap_here(), we start buffering output
1586 that comes through fputs_filtered(). If we see a newline, we just
1587 spit it out and forget about the wrap_here(). If we see another
1588 wrap_here(), we spit it out and remember the newer one. If we see
1589 the end of the line, we spit out a newline, the indent, and then
1590 the buffered output. */
1592 /* Malloc'd buffer with chars_per_line+2 bytes. Contains characters which
1593 are waiting to be output (they have already been counted in chars_printed).
1594 When wrap_buffer[0] is null, the buffer is empty. */
1595 static char *wrap_buffer
;
1597 /* Pointer in wrap_buffer to the next character to fill. */
1598 static char *wrap_pointer
;
1600 /* String to indent by if the wrap occurs. Must not be NULL if wrap_column
1602 static char *wrap_indent
;
1604 /* Column number on the screen where wrap_buffer begins, or 0 if wrapping
1605 is not in effect. */
1606 static int wrap_column
;
1609 /* Inialize the number of lines per page and chars per line. */
1612 init_page_info (void)
1615 if (!tui_get_command_dimension (&chars_per_line
, &lines_per_page
))
1620 #if defined(__GO32__)
1621 rows
= ScreenRows ();
1622 cols
= ScreenCols ();
1623 lines_per_page
= rows
;
1624 chars_per_line
= cols
;
1626 /* Make sure Readline has initialized its terminal settings. */
1627 rl_reset_terminal (NULL
);
1629 /* Get the screen size from Readline. */
1630 rl_get_screen_size (&rows
, &cols
);
1631 lines_per_page
= rows
;
1632 chars_per_line
= cols
;
1634 /* Readline should have fetched the termcap entry for us. */
1635 if (tgetnum ("li") < 0 || getenv ("EMACS"))
1637 /* The number of lines per page is not mentioned in the
1638 terminal description. This probably means that paging is
1639 not useful (e.g. emacs shell window), so disable paging. */
1640 lines_per_page
= UINT_MAX
;
1643 /* FIXME: Get rid of this junk. */
1644 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1645 SIGWINCH_HANDLER (SIGWINCH
);
1648 /* If the output is not a terminal, don't paginate it. */
1649 if (!ui_file_isatty (gdb_stdout
))
1650 lines_per_page
= UINT_MAX
;
1658 /* Set the screen size based on LINES_PER_PAGE and CHARS_PER_LINE. */
1661 set_screen_size (void)
1663 int rows
= lines_per_page
;
1664 int cols
= chars_per_line
;
1670 rl_get_screen_size (NULL
, &cols
);
1672 /* Update Readline's idea of the terminal size. */
1673 rl_set_screen_size (rows
, cols
);
1676 /* Reinitialize WRAP_BUFFER according to the current value of
1682 if (chars_per_line
== 0)
1687 wrap_buffer
= (char *) xmalloc (chars_per_line
+ 2);
1688 wrap_buffer
[0] = '\0';
1691 wrap_buffer
= (char *) xrealloc (wrap_buffer
, chars_per_line
+ 2);
1692 wrap_pointer
= wrap_buffer
; /* Start it at the beginning. */
1696 set_width_command (char *args
, int from_tty
, struct cmd_list_element
*c
)
1703 set_height_command (char *args
, int from_tty
, struct cmd_list_element
*c
)
1708 /* Wait, so the user can read what's on the screen. Prompt the user
1709 to continue by pressing RETURN. */
1712 prompt_for_continue (void)
1715 char cont_prompt
[120];
1717 if (annotation_level
> 1)
1718 printf_unfiltered (("\n\032\032pre-prompt-for-continue\n"));
1720 strcpy (cont_prompt
,
1721 "---Type <return> to continue, or q <return> to quit---");
1722 if (annotation_level
> 1)
1723 strcat (cont_prompt
, "\n\032\032prompt-for-continue\n");
1725 /* We must do this *before* we call gdb_readline, else it will eventually
1726 call us -- thinking that we're trying to print beyond the end of the
1728 reinitialize_more_filter ();
1731 /* On a real operating system, the user can quit with SIGINT.
1734 'q' is provided on all systems so users don't have to change habits
1735 from system to system, and because telling them what to do in
1736 the prompt is more user-friendly than expecting them to think of
1738 /* Call readline, not gdb_readline, because GO32 readline handles control-C
1739 whereas control-C to gdb_readline will cause the user to get dumped
1741 ignore
= gdb_readline_wrapper (cont_prompt
);
1743 if (annotation_level
> 1)
1744 printf_unfiltered (("\n\032\032post-prompt-for-continue\n"));
1749 while (*p
== ' ' || *p
== '\t')
1752 async_request_quit (0);
1757 /* Now we have to do this again, so that GDB will know that it doesn't
1758 need to save the ---Type <return>--- line at the top of the screen. */
1759 reinitialize_more_filter ();
1761 dont_repeat (); /* Forget prev cmd -- CR won't repeat it. */
1764 /* Reinitialize filter; ie. tell it to reset to original values. */
1767 reinitialize_more_filter (void)
1773 /* Indicate that if the next sequence of characters overflows the line,
1774 a newline should be inserted here rather than when it hits the end.
1775 If INDENT is non-null, it is a string to be printed to indent the
1776 wrapped part on the next line. INDENT must remain accessible until
1777 the next call to wrap_here() or until a newline is printed through
1780 If the line is already overfull, we immediately print a newline and
1781 the indentation, and disable further wrapping.
1783 If we don't know the width of lines, but we know the page height,
1784 we must not wrap words, but should still keep track of newlines
1785 that were explicitly printed.
1787 INDENT should not contain tabs, as that will mess up the char count
1788 on the next line. FIXME.
1790 This routine is guaranteed to force out any output which has been
1791 squirreled away in the wrap_buffer, so wrap_here ((char *)0) can be
1792 used to force out output from the wrap_buffer. */
1795 wrap_here (char *indent
)
1797 /* This should have been allocated, but be paranoid anyway. */
1799 internal_error (__FILE__
, __LINE__
, _("failed internal consistency check"));
1803 *wrap_pointer
= '\0';
1804 fputs_unfiltered (wrap_buffer
, gdb_stdout
);
1806 wrap_pointer
= wrap_buffer
;
1807 wrap_buffer
[0] = '\0';
1808 if (chars_per_line
== UINT_MAX
) /* No line overflow checking */
1812 else if (chars_printed
>= chars_per_line
)
1814 puts_filtered ("\n");
1816 puts_filtered (indent
);
1821 wrap_column
= chars_printed
;
1825 wrap_indent
= indent
;
1829 /* Print input string to gdb_stdout, filtered, with wrap,
1830 arranging strings in columns of n chars. String can be
1831 right or left justified in the column. Never prints
1832 trailing spaces. String should never be longer than
1833 width. FIXME: this could be useful for the EXAMINE
1834 command, which currently doesn't tabulate very well */
1837 puts_filtered_tabular (char *string
, int width
, int right
)
1843 gdb_assert (chars_per_line
> 0);
1844 if (chars_per_line
== UINT_MAX
)
1846 fputs_filtered (string
, gdb_stdout
);
1847 fputs_filtered ("\n", gdb_stdout
);
1851 if (((chars_printed
- 1) / width
+ 2) * width
>= chars_per_line
)
1852 fputs_filtered ("\n", gdb_stdout
);
1854 if (width
>= chars_per_line
)
1855 width
= chars_per_line
- 1;
1857 stringlen
= strlen (string
);
1859 if (chars_printed
> 0)
1860 spaces
= width
- (chars_printed
- 1) % width
- 1;
1862 spaces
+= width
- stringlen
;
1864 spacebuf
= alloca (spaces
+ 1);
1865 spacebuf
[spaces
] = '\0';
1867 spacebuf
[spaces
] = ' ';
1869 fputs_filtered (spacebuf
, gdb_stdout
);
1870 fputs_filtered (string
, gdb_stdout
);
1874 /* Ensure that whatever gets printed next, using the filtered output
1875 commands, starts at the beginning of the line. I.E. if there is
1876 any pending output for the current line, flush it and start a new
1877 line. Otherwise do nothing. */
1882 if (chars_printed
> 0)
1884 puts_filtered ("\n");
1889 /* Like fputs but if FILTER is true, pause after every screenful.
1891 Regardless of FILTER can wrap at points other than the final
1892 character of a line.
1894 Unlike fputs, fputs_maybe_filtered does not return a value.
1895 It is OK for LINEBUFFER to be NULL, in which case just don't print
1898 Note that a longjmp to top level may occur in this routine (only if
1899 FILTER is true) (since prompt_for_continue may do so) so this
1900 routine should not be called when cleanups are not in place. */
1903 fputs_maybe_filtered (const char *linebuffer
, struct ui_file
*stream
,
1906 const char *lineptr
;
1908 if (linebuffer
== 0)
1911 /* Don't do any filtering if it is disabled. */
1912 if ((stream
!= gdb_stdout
) || !pagination_enabled
1913 || (lines_per_page
== UINT_MAX
&& chars_per_line
== UINT_MAX
))
1915 fputs_unfiltered (linebuffer
, stream
);
1919 /* Go through and output each character. Show line extension
1920 when this is necessary; prompt user for new page when this is
1923 lineptr
= linebuffer
;
1926 /* Possible new page. */
1927 if (filter
&& (lines_printed
>= lines_per_page
- 1))
1928 prompt_for_continue ();
1930 while (*lineptr
&& *lineptr
!= '\n')
1932 /* Print a single line. */
1933 if (*lineptr
== '\t')
1936 *wrap_pointer
++ = '\t';
1938 fputc_unfiltered ('\t', stream
);
1939 /* Shifting right by 3 produces the number of tab stops
1940 we have already passed, and then adding one and
1941 shifting left 3 advances to the next tab stop. */
1942 chars_printed
= ((chars_printed
>> 3) + 1) << 3;
1948 *wrap_pointer
++ = *lineptr
;
1950 fputc_unfiltered (*lineptr
, stream
);
1955 if (chars_printed
>= chars_per_line
)
1957 unsigned int save_chars
= chars_printed
;
1961 /* If we aren't actually wrapping, don't output newline --
1962 if chars_per_line is right, we probably just overflowed
1963 anyway; if it's wrong, let us keep going. */
1965 fputc_unfiltered ('\n', stream
);
1967 /* Possible new page. */
1968 if (lines_printed
>= lines_per_page
- 1)
1969 prompt_for_continue ();
1971 /* Now output indentation and wrapped string */
1974 fputs_unfiltered (wrap_indent
, stream
);
1975 *wrap_pointer
= '\0'; /* Null-terminate saved stuff */
1976 fputs_unfiltered (wrap_buffer
, stream
); /* and eject it */
1977 /* FIXME, this strlen is what prevents wrap_indent from
1978 containing tabs. However, if we recurse to print it
1979 and count its chars, we risk trouble if wrap_indent is
1980 longer than (the user settable) chars_per_line.
1981 Note also that this can set chars_printed > chars_per_line
1982 if we are printing a long string. */
1983 chars_printed
= strlen (wrap_indent
)
1984 + (save_chars
- wrap_column
);
1985 wrap_pointer
= wrap_buffer
; /* Reset buffer */
1986 wrap_buffer
[0] = '\0';
1987 wrap_column
= 0; /* And disable fancy wrap */
1992 if (*lineptr
== '\n')
1995 wrap_here ((char *) 0); /* Spit out chars, cancel further wraps */
1997 fputc_unfiltered ('\n', stream
);
2004 fputs_filtered (const char *linebuffer
, struct ui_file
*stream
)
2006 fputs_maybe_filtered (linebuffer
, stream
, 1);
2010 putchar_unfiltered (int c
)
2013 ui_file_write (gdb_stdout
, &buf
, 1);
2017 /* Write character C to gdb_stdout using GDB's paging mechanism and return C.
2018 May return nonlocally. */
2021 putchar_filtered (int c
)
2023 return fputc_filtered (c
, gdb_stdout
);
2027 fputc_unfiltered (int c
, struct ui_file
*stream
)
2030 ui_file_write (stream
, &buf
, 1);
2035 fputc_filtered (int c
, struct ui_file
*stream
)
2041 fputs_filtered (buf
, stream
);
2045 /* puts_debug is like fputs_unfiltered, except it prints special
2046 characters in printable fashion. */
2049 puts_debug (char *prefix
, char *string
, char *suffix
)
2053 /* Print prefix and suffix after each line. */
2054 static int new_line
= 1;
2055 static int return_p
= 0;
2056 static char *prev_prefix
= "";
2057 static char *prev_suffix
= "";
2059 if (*string
== '\n')
2062 /* If the prefix is changing, print the previous suffix, a new line,
2063 and the new prefix. */
2064 if ((return_p
|| (strcmp (prev_prefix
, prefix
) != 0)) && !new_line
)
2066 fputs_unfiltered (prev_suffix
, gdb_stdlog
);
2067 fputs_unfiltered ("\n", gdb_stdlog
);
2068 fputs_unfiltered (prefix
, gdb_stdlog
);
2071 /* Print prefix if we printed a newline during the previous call. */
2075 fputs_unfiltered (prefix
, gdb_stdlog
);
2078 prev_prefix
= prefix
;
2079 prev_suffix
= suffix
;
2081 /* Output characters in a printable format. */
2082 while ((ch
= *string
++) != '\0')
2088 fputc_unfiltered (ch
, gdb_stdlog
);
2091 fprintf_unfiltered (gdb_stdlog
, "\\x%02x", ch
& 0xff);
2095 fputs_unfiltered ("\\\\", gdb_stdlog
);
2098 fputs_unfiltered ("\\b", gdb_stdlog
);
2101 fputs_unfiltered ("\\f", gdb_stdlog
);
2105 fputs_unfiltered ("\\n", gdb_stdlog
);
2108 fputs_unfiltered ("\\r", gdb_stdlog
);
2111 fputs_unfiltered ("\\t", gdb_stdlog
);
2114 fputs_unfiltered ("\\v", gdb_stdlog
);
2118 return_p
= ch
== '\r';
2121 /* Print suffix if we printed a newline. */
2124 fputs_unfiltered (suffix
, gdb_stdlog
);
2125 fputs_unfiltered ("\n", gdb_stdlog
);
2130 /* Print a variable number of ARGS using format FORMAT. If this
2131 information is going to put the amount written (since the last call
2132 to REINITIALIZE_MORE_FILTER or the last page break) over the page size,
2133 call prompt_for_continue to get the users permision to continue.
2135 Unlike fprintf, this function does not return a value.
2137 We implement three variants, vfprintf (takes a vararg list and stream),
2138 fprintf (takes a stream to write on), and printf (the usual).
2140 Note also that a longjmp to top level may occur in this routine
2141 (since prompt_for_continue may do so) so this routine should not be
2142 called when cleanups are not in place. */
2145 vfprintf_maybe_filtered (struct ui_file
*stream
, const char *format
,
2146 va_list args
, int filter
)
2149 struct cleanup
*old_cleanups
;
2151 linebuffer
= xstrvprintf (format
, args
);
2152 old_cleanups
= make_cleanup (xfree
, linebuffer
);
2153 fputs_maybe_filtered (linebuffer
, stream
, filter
);
2154 do_cleanups (old_cleanups
);
2159 vfprintf_filtered (struct ui_file
*stream
, const char *format
, va_list args
)
2161 vfprintf_maybe_filtered (stream
, format
, args
, 1);
2165 vfprintf_unfiltered (struct ui_file
*stream
, const char *format
, va_list args
)
2168 struct cleanup
*old_cleanups
;
2170 linebuffer
= xstrvprintf (format
, args
);
2171 old_cleanups
= make_cleanup (xfree
, linebuffer
);
2172 fputs_unfiltered (linebuffer
, stream
);
2173 do_cleanups (old_cleanups
);
2177 vprintf_filtered (const char *format
, va_list args
)
2179 vfprintf_maybe_filtered (gdb_stdout
, format
, args
, 1);
2183 vprintf_unfiltered (const char *format
, va_list args
)
2185 vfprintf_unfiltered (gdb_stdout
, format
, args
);
2189 fprintf_filtered (struct ui_file
*stream
, const char *format
, ...)
2192 va_start (args
, format
);
2193 vfprintf_filtered (stream
, format
, args
);
2198 fprintf_unfiltered (struct ui_file
*stream
, const char *format
, ...)
2201 va_start (args
, format
);
2202 vfprintf_unfiltered (stream
, format
, args
);
2206 /* Like fprintf_filtered, but prints its result indented.
2207 Called as fprintfi_filtered (spaces, stream, format, ...); */
2210 fprintfi_filtered (int spaces
, struct ui_file
*stream
, const char *format
,
2214 va_start (args
, format
);
2215 print_spaces_filtered (spaces
, stream
);
2217 vfprintf_filtered (stream
, format
, args
);
2223 printf_filtered (const char *format
, ...)
2226 va_start (args
, format
);
2227 vfprintf_filtered (gdb_stdout
, format
, args
);
2233 printf_unfiltered (const char *format
, ...)
2236 va_start (args
, format
);
2237 vfprintf_unfiltered (gdb_stdout
, format
, args
);
2241 /* Like printf_filtered, but prints it's result indented.
2242 Called as printfi_filtered (spaces, format, ...); */
2245 printfi_filtered (int spaces
, const char *format
, ...)
2248 va_start (args
, format
);
2249 print_spaces_filtered (spaces
, gdb_stdout
);
2250 vfprintf_filtered (gdb_stdout
, format
, args
);
2254 /* Easy -- but watch out!
2256 This routine is *not* a replacement for puts()! puts() appends a newline.
2257 This one doesn't, and had better not! */
2260 puts_filtered (const char *string
)
2262 fputs_filtered (string
, gdb_stdout
);
2266 puts_unfiltered (const char *string
)
2268 fputs_unfiltered (string
, gdb_stdout
);
2271 /* Return a pointer to N spaces and a null. The pointer is good
2272 until the next call to here. */
2277 static char *spaces
= 0;
2278 static int max_spaces
= -1;
2284 spaces
= (char *) xmalloc (n
+ 1);
2285 for (t
= spaces
+ n
; t
!= spaces
;)
2291 return spaces
+ max_spaces
- n
;
2294 /* Print N spaces. */
2296 print_spaces_filtered (int n
, struct ui_file
*stream
)
2298 fputs_filtered (n_spaces (n
), stream
);
2301 /* C++/ObjC demangler stuff. */
2303 /* fprintf_symbol_filtered attempts to demangle NAME, a symbol in language
2304 LANG, using demangling args ARG_MODE, and print it filtered to STREAM.
2305 If the name is not mangled, or the language for the name is unknown, or
2306 demangling is off, the name is printed in its "raw" form. */
2309 fprintf_symbol_filtered (struct ui_file
*stream
, char *name
,
2310 enum language lang
, int arg_mode
)
2316 /* If user wants to see raw output, no problem. */
2319 fputs_filtered (name
, stream
);
2323 demangled
= language_demangle (language_def (lang
), name
, arg_mode
);
2324 fputs_filtered (demangled
? demangled
: name
, stream
);
2325 if (demangled
!= NULL
)
2333 /* Do a strcmp() type operation on STRING1 and STRING2, ignoring any
2334 differences in whitespace. Returns 0 if they match, non-zero if they
2335 don't (slightly different than strcmp()'s range of return values).
2337 As an extra hack, string1=="FOO(ARGS)" matches string2=="FOO".
2338 This "feature" is useful when searching for matching C++ function names
2339 (such as if the user types 'break FOO', where FOO is a mangled C++
2343 strcmp_iw (const char *string1
, const char *string2
)
2345 while ((*string1
!= '\0') && (*string2
!= '\0'))
2347 while (isspace (*string1
))
2351 while (isspace (*string2
))
2355 if (*string1
!= *string2
)
2359 if (*string1
!= '\0')
2365 return (*string1
!= '\0' && *string1
!= '(') || (*string2
!= '\0');
2368 /* This is like strcmp except that it ignores whitespace and treats
2369 '(' as the first non-NULL character in terms of ordering. Like
2370 strcmp (and unlike strcmp_iw), it returns negative if STRING1 <
2371 STRING2, 0 if STRING2 = STRING2, and positive if STRING1 > STRING2
2372 according to that ordering.
2374 If a list is sorted according to this function and if you want to
2375 find names in the list that match some fixed NAME according to
2376 strcmp_iw(LIST_ELT, NAME), then the place to start looking is right
2377 where this function would put NAME.
2379 Here are some examples of why using strcmp to sort is a bad idea:
2383 Say your partial symtab contains: "foo<char *>", "goo". Then, if
2384 we try to do a search for "foo<char*>", strcmp will locate this
2385 after "foo<char *>" and before "goo". Then lookup_partial_symbol
2386 will start looking at strings beginning with "goo", and will never
2387 see the correct match of "foo<char *>".
2389 Parenthesis example:
2391 In practice, this is less like to be an issue, but I'll give it a
2392 shot. Let's assume that '$' is a legitimate character to occur in
2393 symbols. (Which may well even be the case on some systems.) Then
2394 say that the partial symbol table contains "foo$" and "foo(int)".
2395 strcmp will put them in this order, since '$' < '('. Now, if the
2396 user searches for "foo", then strcmp will sort "foo" before "foo$".
2397 Then lookup_partial_symbol will notice that strcmp_iw("foo$",
2398 "foo") is false, so it won't proceed to the actual match of
2399 "foo(int)" with "foo". */
2402 strcmp_iw_ordered (const char *string1
, const char *string2
)
2404 while ((*string1
!= '\0') && (*string2
!= '\0'))
2406 while (isspace (*string1
))
2410 while (isspace (*string2
))
2414 if (*string1
!= *string2
)
2418 if (*string1
!= '\0')
2427 /* Characters are non-equal unless they're both '\0'; we want to
2428 make sure we get the comparison right according to our
2429 comparison in the cases where one of them is '\0' or '('. */
2431 if (*string2
== '\0')
2436 if (*string2
== '\0')
2441 if (*string2
== '(')
2444 return *string1
- *string2
;
2448 /* A simple comparison function with opposite semantics to strcmp. */
2451 streq (const char *lhs
, const char *rhs
)
2453 return !strcmp (lhs
, rhs
);
2459 ** Answer whether string_to_compare is a full or partial match to
2460 ** template_string. The partial match must be in sequence starting
2464 subset_compare (char *string_to_compare
, char *template_string
)
2467 if (template_string
!= (char *) NULL
&& string_to_compare
!= (char *) NULL
2468 && strlen (string_to_compare
) <= strlen (template_string
))
2471 (template_string
, string_to_compare
, strlen (string_to_compare
)) == 0);
2478 static void pagination_on_command (char *arg
, int from_tty
);
2480 pagination_on_command (char *arg
, int from_tty
)
2482 pagination_enabled
= 1;
2485 static void pagination_on_command (char *arg
, int from_tty
);
2487 pagination_off_command (char *arg
, int from_tty
)
2489 pagination_enabled
= 0;
2494 initialize_utils (void)
2496 struct cmd_list_element
*c
;
2498 add_setshow_uinteger_cmd ("width", class_support
, &chars_per_line
, _("\
2499 Set number of characters gdb thinks are in a line."), _("\
2500 Show number of characters gdb thinks are in a line."), NULL
,
2502 show_chars_per_line
,
2503 &setlist
, &showlist
);
2505 add_setshow_uinteger_cmd ("height", class_support
, &lines_per_page
, _("\
2506 Set number of lines gdb thinks are in a page."), _("\
2507 Show number of lines gdb thinks are in a page."), NULL
,
2509 show_lines_per_page
,
2510 &setlist
, &showlist
);
2514 add_setshow_boolean_cmd ("demangle", class_support
, &demangle
, _("\
2515 Set demangling of encoded C++/ObjC names when displaying symbols."), _("\
2516 Show demangling of encoded C++/ObjC names when displaying symbols."), NULL
,
2519 &setprintlist
, &showprintlist
);
2521 add_setshow_boolean_cmd ("pagination", class_support
,
2522 &pagination_enabled
, _("\
2523 Set state of pagination."), _("\
2524 Show state of pagination."), NULL
,
2526 show_pagination_enabled
,
2527 &setlist
, &showlist
);
2531 add_com ("am", class_support
, pagination_on_command
,
2532 _("Enable pagination"));
2533 add_com ("sm", class_support
, pagination_off_command
,
2534 _("Disable pagination"));
2537 add_setshow_boolean_cmd ("sevenbit-strings", class_support
,
2538 &sevenbit_strings
, _("\
2539 Set printing of 8-bit characters in strings as \\nnn."), _("\
2540 Show printing of 8-bit characters in strings as \\nnn."), NULL
,
2542 show_sevenbit_strings
,
2543 &setprintlist
, &showprintlist
);
2545 add_setshow_boolean_cmd ("asm-demangle", class_support
, &asm_demangle
, _("\
2546 Set demangling of C++/ObjC names in disassembly listings."), _("\
2547 Show demangling of C++/ObjC names in disassembly listings."), NULL
,
2550 &setprintlist
, &showprintlist
);
2553 /* Machine specific function to handle SIGWINCH signal. */
2555 #ifdef SIGWINCH_HANDLER_BODY
2556 SIGWINCH_HANDLER_BODY
2558 /* print routines to handle variable size regs, etc. */
2559 /* temporary storage using circular buffer */
2565 static char buf
[NUMCELLS
][CELLSIZE
];
2566 static int cell
= 0;
2567 if (++cell
>= NUMCELLS
)
2575 return (TARGET_ADDR_BIT
/ 8 * 2);
2579 paddr (CORE_ADDR addr
)
2581 return phex (addr
, TARGET_ADDR_BIT
/ 8);
2585 paddr_nz (CORE_ADDR addr
)
2587 return phex_nz (addr
, TARGET_ADDR_BIT
/ 8);
2591 paddress (CORE_ADDR addr
)
2593 /* Truncate address to the size of a target address, avoiding shifts
2594 larger or equal than the width of a CORE_ADDR. The local
2595 variable ADDR_BIT stops the compiler reporting a shift overflow
2596 when it won't occur. */
2597 /* NOTE: This assumes that the significant address information is
2598 kept in the least significant bits of ADDR - the upper bits were
2599 either zero or sign extended. Should ADDRESS_TO_POINTER() or
2600 some ADDRESS_TO_PRINTABLE() be used to do the conversion? */
2602 int addr_bit
= TARGET_ADDR_BIT
;
2604 if (addr_bit
< (sizeof (CORE_ADDR
) * HOST_CHAR_BIT
))
2605 addr
&= ((CORE_ADDR
) 1 << addr_bit
) - 1;
2606 return hex_string (addr
);
2610 decimal2str (char *paddr_str
, char *sign
, ULONGEST addr
, int width
)
2612 /* steal code from valprint.c:print_decimal(). Should this worry
2613 about the real size of addr as the above does? */
2614 unsigned long temp
[3];
2618 temp
[i
] = addr
% (1000 * 1000 * 1000);
2619 addr
/= (1000 * 1000 * 1000);
2623 while (addr
!= 0 && i
< (sizeof (temp
) / sizeof (temp
[0])));
2630 sprintf (paddr_str
, "%s%0*lu", sign
, width
, temp
[0]);
2633 sprintf (paddr_str
, "%s%0*lu%09lu", sign
, width
, temp
[1], temp
[0]);
2636 sprintf (paddr_str
, "%s%0*lu%09lu%09lu", sign
, width
,
2637 temp
[2], temp
[1], temp
[0]);
2640 internal_error (__FILE__
, __LINE__
,
2641 _("failed internal consistency check"));
2646 octal2str (char *paddr_str
, ULONGEST addr
, int width
)
2648 unsigned long temp
[3];
2652 temp
[i
] = addr
% (0100000 * 0100000);
2653 addr
/= (0100000 * 0100000);
2657 while (addr
!= 0 && i
< (sizeof (temp
) / sizeof (temp
[0])));
2665 sprintf (paddr_str
, "%*o", width
, 0);
2667 sprintf (paddr_str
, "0%0*lo", width
, temp
[0]);
2670 sprintf (paddr_str
, "0%0*lo%010lo", width
, temp
[1], temp
[0]);
2673 sprintf (paddr_str
, "0%0*lo%010lo%010lo", width
,
2674 temp
[2], temp
[1], temp
[0]);
2677 internal_error (__FILE__
, __LINE__
,
2678 _("failed internal consistency check"));
2683 paddr_u (CORE_ADDR addr
)
2685 char *paddr_str
= get_cell ();
2686 decimal2str (paddr_str
, "", addr
, 0);
2691 paddr_d (LONGEST addr
)
2693 char *paddr_str
= get_cell ();
2695 decimal2str (paddr_str
, "-", -addr
, 0);
2697 decimal2str (paddr_str
, "", addr
, 0);
2701 /* eliminate warning from compiler on 32-bit systems */
2702 static int thirty_two
= 32;
2705 phex (ULONGEST l
, int sizeof_l
)
2712 sprintf (str
, "%08lx%08lx",
2713 (unsigned long) (l
>> thirty_two
),
2714 (unsigned long) (l
& 0xffffffff));
2718 sprintf (str
, "%08lx", (unsigned long) l
);
2722 sprintf (str
, "%04x", (unsigned short) (l
& 0xffff));
2725 str
= phex (l
, sizeof (l
));
2732 phex_nz (ULONGEST l
, int sizeof_l
)
2739 unsigned long high
= (unsigned long) (l
>> thirty_two
);
2742 sprintf (str
, "%lx", (unsigned long) (l
& 0xffffffff));
2744 sprintf (str
, "%lx%08lx", high
, (unsigned long) (l
& 0xffffffff));
2749 sprintf (str
, "%lx", (unsigned long) l
);
2753 sprintf (str
, "%x", (unsigned short) (l
& 0xffff));
2756 str
= phex_nz (l
, sizeof (l
));
2762 /* Converts a LONGEST to a C-format hexadecimal literal and stores it
2763 in a static string. Returns a pointer to this string. */
2765 hex_string (LONGEST num
)
2767 char *result
= get_cell ();
2768 snprintf (result
, CELLSIZE
, "0x%s", phex_nz (num
, sizeof (num
)));
2772 /* Converts a LONGEST number to a C-format hexadecimal literal and
2773 stores it in a static string. Returns a pointer to this string
2774 that is valid until the next call. The number is padded on the
2775 left with 0s to at least WIDTH characters. */
2777 hex_string_custom (LONGEST num
, int width
)
2779 char *result
= get_cell ();
2780 char *result_end
= result
+ CELLSIZE
- 1;
2781 const char *hex
= phex_nz (num
, sizeof (num
));
2782 int hex_len
= strlen (hex
);
2784 if (hex_len
> width
)
2786 if (width
+ 2 >= CELLSIZE
)
2787 internal_error (__FILE__
, __LINE__
,
2788 _("hex_string_custom: insufficient space to store result"));
2790 strcpy (result_end
- width
- 2, "0x");
2791 memset (result_end
- width
, '0', width
);
2792 strcpy (result_end
- hex_len
, hex
);
2793 return result_end
- width
- 2;
2796 /* Convert VAL to a numeral in the given radix. For
2797 * radix 10, IS_SIGNED may be true, indicating a signed quantity;
2798 * otherwise VAL is interpreted as unsigned. If WIDTH is supplied,
2799 * it is the minimum width (0-padded if needed). USE_C_FORMAT means
2800 * to use C format in all cases. If it is false, then 'x'
2801 * and 'o' formats do not include a prefix (0x or leading 0). */
2804 int_string (LONGEST val
, int radix
, int is_signed
, int width
,
2813 result
= hex_string (val
);
2815 result
= hex_string_custom (val
, width
);
2822 char *result
= get_cell ();
2823 if (is_signed
&& val
< 0)
2824 decimal2str (result
, "-", -val
, width
);
2826 decimal2str (result
, "", val
, width
);
2831 char *result
= get_cell ();
2832 octal2str (result
, val
, width
);
2833 if (use_c_format
|| val
== 0)
2839 internal_error (__FILE__
, __LINE__
,
2840 _("failed internal consistency check"));
2844 /* Convert a CORE_ADDR into a string. */
2846 core_addr_to_string (const CORE_ADDR addr
)
2848 char *str
= get_cell ();
2850 strcat (str
, phex (addr
, sizeof (addr
)));
2855 core_addr_to_string_nz (const CORE_ADDR addr
)
2857 char *str
= get_cell ();
2859 strcat (str
, phex_nz (addr
, sizeof (addr
)));
2863 /* Convert a string back into a CORE_ADDR. */
2865 string_to_core_addr (const char *my_string
)
2868 if (my_string
[0] == '0' && tolower (my_string
[1]) == 'x')
2870 /* Assume that it is in decimal. */
2872 for (i
= 2; my_string
[i
] != '\0'; i
++)
2874 if (isdigit (my_string
[i
]))
2875 addr
= (my_string
[i
] - '0') + (addr
* 16);
2876 else if (isxdigit (my_string
[i
]))
2877 addr
= (tolower (my_string
[i
]) - 'a' + 0xa) + (addr
* 16);
2879 internal_error (__FILE__
, __LINE__
, _("invalid hex"));
2884 /* Assume that it is in decimal. */
2886 for (i
= 0; my_string
[i
] != '\0'; i
++)
2888 if (isdigit (my_string
[i
]))
2889 addr
= (my_string
[i
] - '0') + (addr
* 10);
2891 internal_error (__FILE__
, __LINE__
, _("invalid decimal"));
2898 gdb_realpath (const char *filename
)
2900 /* Method 1: The system has a compile time upper bound on a filename
2901 path. Use that and realpath() to canonicalize the name. This is
2902 the most common case. Note that, if there isn't a compile time
2903 upper bound, you want to avoid realpath() at all costs. */
2904 #if defined(HAVE_REALPATH)
2906 # if defined (PATH_MAX)
2908 # define USE_REALPATH
2909 # elif defined (MAXPATHLEN)
2910 char buf
[MAXPATHLEN
];
2911 # define USE_REALPATH
2913 # if defined (USE_REALPATH)
2914 const char *rp
= realpath (filename
, buf
);
2917 return xstrdup (rp
);
2920 #endif /* HAVE_REALPATH */
2922 /* Method 2: The host system (i.e., GNU) has the function
2923 canonicalize_file_name() which malloc's a chunk of memory and
2924 returns that, use that. */
2925 #if defined(HAVE_CANONICALIZE_FILE_NAME)
2927 char *rp
= canonicalize_file_name (filename
);
2929 return xstrdup (filename
);
2935 /* FIXME: cagney/2002-11-13:
2937 Method 2a: Use realpath() with a NULL buffer. Some systems, due
2938 to the problems described in in method 3, have modified their
2939 realpath() implementation so that it will allocate a buffer when
2940 NULL is passed in. Before this can be used, though, some sort of
2941 configure time test would need to be added. Otherwize the code
2942 will likely core dump. */
2944 /* Method 3: Now we're getting desperate! The system doesn't have a
2945 compile time buffer size and no alternative function. Query the
2946 OS, using pathconf(), for the buffer limit. Care is needed
2947 though, some systems do not limit PATH_MAX (return -1 for
2948 pathconf()) making it impossible to pass a correctly sized buffer
2949 to realpath() (it could always overflow). On those systems, we
2951 #if defined (HAVE_REALPATH) && defined (HAVE_UNISTD_H) && defined(HAVE_ALLOCA)
2953 /* Find out the max path size. */
2954 long path_max
= pathconf ("/", _PC_PATH_MAX
);
2957 /* PATH_MAX is bounded. */
2958 char *buf
= alloca (path_max
);
2959 char *rp
= realpath (filename
, buf
);
2960 return xstrdup (rp
? rp
: filename
);
2965 /* This system is a lost cause, just dup the buffer. */
2966 return xstrdup (filename
);
2969 /* Return a copy of FILENAME, with its directory prefix canonicalized
2973 xfullpath (const char *filename
)
2975 const char *base_name
= lbasename (filename
);
2980 /* Extract the basename of filename, and return immediately
2981 a copy of filename if it does not contain any directory prefix. */
2982 if (base_name
== filename
)
2983 return xstrdup (filename
);
2985 dir_name
= alloca ((size_t) (base_name
- filename
+ 2));
2986 /* Allocate enough space to store the dir_name + plus one extra
2987 character sometimes needed under Windows (see below), and
2988 then the closing \000 character */
2989 strncpy (dir_name
, filename
, base_name
- filename
);
2990 dir_name
[base_name
- filename
] = '\000';
2992 #ifdef HAVE_DOS_BASED_FILE_SYSTEM
2993 /* We need to be careful when filename is of the form 'd:foo', which
2994 is equivalent of d:./foo, which is totally different from d:/foo. */
2995 if (strlen (dir_name
) == 2 && isalpha (dir_name
[0]) && dir_name
[1] == ':')
2998 dir_name
[3] = '\000';
3002 /* Canonicalize the directory prefix, and build the resulting
3003 filename. If the dirname realpath already contains an ending
3004 directory separator, avoid doubling it. */
3005 real_path
= gdb_realpath (dir_name
);
3006 if (IS_DIR_SEPARATOR (real_path
[strlen (real_path
) - 1]))
3007 result
= concat (real_path
, base_name
, NULL
);
3009 result
= concat (real_path
, SLASH_STRING
, base_name
, NULL
);
3016 /* This is the 32-bit CRC function used by the GNU separate debug
3017 facility. An executable may contain a section named
3018 .gnu_debuglink, which holds the name of a separate executable file
3019 containing its debug info, and a checksum of that file's contents,
3020 computed using this function. */
3022 gnu_debuglink_crc32 (unsigned long crc
, unsigned char *buf
, size_t len
)
3024 static const unsigned long crc32_table
[256] = {
3025 0x00000000, 0x77073096, 0xee0e612c, 0x990951ba, 0x076dc419,
3026 0x706af48f, 0xe963a535, 0x9e6495a3, 0x0edb8832, 0x79dcb8a4,
3027 0xe0d5e91e, 0x97d2d988, 0x09b64c2b, 0x7eb17cbd, 0xe7b82d07,
3028 0x90bf1d91, 0x1db71064, 0x6ab020f2, 0xf3b97148, 0x84be41de,
3029 0x1adad47d, 0x6ddde4eb, 0xf4d4b551, 0x83d385c7, 0x136c9856,
3030 0x646ba8c0, 0xfd62f97a, 0x8a65c9ec, 0x14015c4f, 0x63066cd9,
3031 0xfa0f3d63, 0x8d080df5, 0x3b6e20c8, 0x4c69105e, 0xd56041e4,
3032 0xa2677172, 0x3c03e4d1, 0x4b04d447, 0xd20d85fd, 0xa50ab56b,
3033 0x35b5a8fa, 0x42b2986c, 0xdbbbc9d6, 0xacbcf940, 0x32d86ce3,
3034 0x45df5c75, 0xdcd60dcf, 0xabd13d59, 0x26d930ac, 0x51de003a,
3035 0xc8d75180, 0xbfd06116, 0x21b4f4b5, 0x56b3c423, 0xcfba9599,
3036 0xb8bda50f, 0x2802b89e, 0x5f058808, 0xc60cd9b2, 0xb10be924,
3037 0x2f6f7c87, 0x58684c11, 0xc1611dab, 0xb6662d3d, 0x76dc4190,
3038 0x01db7106, 0x98d220bc, 0xefd5102a, 0x71b18589, 0x06b6b51f,
3039 0x9fbfe4a5, 0xe8b8d433, 0x7807c9a2, 0x0f00f934, 0x9609a88e,
3040 0xe10e9818, 0x7f6a0dbb, 0x086d3d2d, 0x91646c97, 0xe6635c01,
3041 0x6b6b51f4, 0x1c6c6162, 0x856530d8, 0xf262004e, 0x6c0695ed,
3042 0x1b01a57b, 0x8208f4c1, 0xf50fc457, 0x65b0d9c6, 0x12b7e950,
3043 0x8bbeb8ea, 0xfcb9887c, 0x62dd1ddf, 0x15da2d49, 0x8cd37cf3,
3044 0xfbd44c65, 0x4db26158, 0x3ab551ce, 0xa3bc0074, 0xd4bb30e2,
3045 0x4adfa541, 0x3dd895d7, 0xa4d1c46d, 0xd3d6f4fb, 0x4369e96a,
3046 0x346ed9fc, 0xad678846, 0xda60b8d0, 0x44042d73, 0x33031de5,
3047 0xaa0a4c5f, 0xdd0d7cc9, 0x5005713c, 0x270241aa, 0xbe0b1010,
3048 0xc90c2086, 0x5768b525, 0x206f85b3, 0xb966d409, 0xce61e49f,
3049 0x5edef90e, 0x29d9c998, 0xb0d09822, 0xc7d7a8b4, 0x59b33d17,
3050 0x2eb40d81, 0xb7bd5c3b, 0xc0ba6cad, 0xedb88320, 0x9abfb3b6,
3051 0x03b6e20c, 0x74b1d29a, 0xead54739, 0x9dd277af, 0x04db2615,
3052 0x73dc1683, 0xe3630b12, 0x94643b84, 0x0d6d6a3e, 0x7a6a5aa8,
3053 0xe40ecf0b, 0x9309ff9d, 0x0a00ae27, 0x7d079eb1, 0xf00f9344,
3054 0x8708a3d2, 0x1e01f268, 0x6906c2fe, 0xf762575d, 0x806567cb,
3055 0x196c3671, 0x6e6b06e7, 0xfed41b76, 0x89d32be0, 0x10da7a5a,
3056 0x67dd4acc, 0xf9b9df6f, 0x8ebeeff9, 0x17b7be43, 0x60b08ed5,
3057 0xd6d6a3e8, 0xa1d1937e, 0x38d8c2c4, 0x4fdff252, 0xd1bb67f1,
3058 0xa6bc5767, 0x3fb506dd, 0x48b2364b, 0xd80d2bda, 0xaf0a1b4c,
3059 0x36034af6, 0x41047a60, 0xdf60efc3, 0xa867df55, 0x316e8eef,
3060 0x4669be79, 0xcb61b38c, 0xbc66831a, 0x256fd2a0, 0x5268e236,
3061 0xcc0c7795, 0xbb0b4703, 0x220216b9, 0x5505262f, 0xc5ba3bbe,
3062 0xb2bd0b28, 0x2bb45a92, 0x5cb36a04, 0xc2d7ffa7, 0xb5d0cf31,
3063 0x2cd99e8b, 0x5bdeae1d, 0x9b64c2b0, 0xec63f226, 0x756aa39c,
3064 0x026d930a, 0x9c0906a9, 0xeb0e363f, 0x72076785, 0x05005713,
3065 0x95bf4a82, 0xe2b87a14, 0x7bb12bae, 0x0cb61b38, 0x92d28e9b,
3066 0xe5d5be0d, 0x7cdcefb7, 0x0bdbdf21, 0x86d3d2d4, 0xf1d4e242,
3067 0x68ddb3f8, 0x1fda836e, 0x81be16cd, 0xf6b9265b, 0x6fb077e1,
3068 0x18b74777, 0x88085ae6, 0xff0f6a70, 0x66063bca, 0x11010b5c,
3069 0x8f659eff, 0xf862ae69, 0x616bffd3, 0x166ccf45, 0xa00ae278,
3070 0xd70dd2ee, 0x4e048354, 0x3903b3c2, 0xa7672661, 0xd06016f7,
3071 0x4969474d, 0x3e6e77db, 0xaed16a4a, 0xd9d65adc, 0x40df0b66,
3072 0x37d83bf0, 0xa9bcae53, 0xdebb9ec5, 0x47b2cf7f, 0x30b5ffe9,
3073 0xbdbdf21c, 0xcabac28a, 0x53b39330, 0x24b4a3a6, 0xbad03605,
3074 0xcdd70693, 0x54de5729, 0x23d967bf, 0xb3667a2e, 0xc4614ab8,
3075 0x5d681b02, 0x2a6f2b94, 0xb40bbe37, 0xc30c8ea1, 0x5a05df1b,
3080 crc
= ~crc
& 0xffffffff;
3081 for (end
= buf
+ len
; buf
< end
; ++buf
)
3082 crc
= crc32_table
[(crc
^ *buf
) & 0xff] ^ (crc
>> 8);
3083 return ~crc
& 0xffffffff;;
3087 align_up (ULONGEST v
, int n
)
3089 /* Check that N is really a power of two. */
3090 gdb_assert (n
&& (n
& (n
-1)) == 0);
3091 return (v
+ n
- 1) & -n
;
3095 align_down (ULONGEST v
, int n
)
3097 /* Check that N is really a power of two. */
3098 gdb_assert (n
&& (n
& (n
-1)) == 0);