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(). */
793 abort (); /* NOTE: GDB has only three calls to abort(). */
800 static struct internal_problem internal_error_problem
= {
801 "internal-error", AUTO_BOOLEAN_AUTO
, AUTO_BOOLEAN_AUTO
805 internal_verror (const char *file
, int line
, const char *fmt
, va_list ap
)
807 internal_vproblem (&internal_error_problem
, file
, line
, fmt
, ap
);
808 deprecated_throw_reason (RETURN_ERROR
);
812 internal_error (const char *file
, int line
, const char *string
, ...)
815 va_start (ap
, string
);
816 internal_verror (file
, line
, string
, ap
);
820 static struct internal_problem internal_warning_problem
= {
821 "internal-warning", AUTO_BOOLEAN_AUTO
, AUTO_BOOLEAN_AUTO
825 internal_vwarning (const char *file
, int line
, const char *fmt
, va_list ap
)
827 internal_vproblem (&internal_warning_problem
, file
, line
, fmt
, ap
);
831 internal_warning (const char *file
, int line
, const char *string
, ...)
834 va_start (ap
, string
);
835 internal_vwarning (file
, line
, string
, ap
);
839 /* The strerror() function can return NULL for errno values that are
840 out of range. Provide a "safe" version that always returns a
844 safe_strerror (int errnum
)
849 msg
= strerror (errnum
);
852 sprintf (buf
, "(undocumented errno %d)", errnum
);
858 /* Print the system error message for errno, and also mention STRING
859 as the file name for which the error was encountered.
860 Then return to command level. */
863 perror_with_name (const char *string
)
868 err
= safe_strerror (errno
);
869 combined
= (char *) alloca (strlen (err
) + strlen (string
) + 3);
870 strcpy (combined
, string
);
871 strcat (combined
, ": ");
872 strcat (combined
, err
);
874 /* I understand setting these is a matter of taste. Still, some people
875 may clear errno but not know about bfd_error. Doing this here is not
877 bfd_set_error (bfd_error_no_error
);
880 error (_("%s."), combined
);
883 /* Print the system error message for ERRCODE, and also mention STRING
884 as the file name for which the error was encountered. */
887 print_sys_errmsg (const char *string
, int errcode
)
892 err
= safe_strerror (errcode
);
893 combined
= (char *) alloca (strlen (err
) + strlen (string
) + 3);
894 strcpy (combined
, string
);
895 strcat (combined
, ": ");
896 strcat (combined
, err
);
898 /* We want anything which was printed on stdout to come out first, before
900 gdb_flush (gdb_stdout
);
901 fprintf_unfiltered (gdb_stderr
, "%s.\n", combined
);
904 /* Control C eventually causes this to be called, at a convenient time. */
910 /* No steenking SIGINT will ever be coming our way when the
911 program is resumed. Don't lie. */
915 /* If there is no terminal switching for this target, then we can't
916 possibly get screwed by the lack of job control. */
917 || current_target
.to_terminal_ours
== NULL
)
920 fatal ("Quit (expect signal SIGINT when the program is resumed)");
924 /* Control C comes here */
926 request_quit (int signo
)
929 /* Restore the signal handler. Harmless with BSD-style signals,
930 needed for System V-style signals. */
931 signal (signo
, request_quit
);
937 /* Called when a memory allocation fails, with the number of bytes of
938 memory requested in SIZE. */
945 internal_error (__FILE__
, __LINE__
,
946 _("virtual memory exhausted: can't allocate %ld bytes."),
951 internal_error (__FILE__
, __LINE__
, _("virtual memory exhausted."));
955 /* The xmalloc() (libiberty.h) family of memory management routines.
957 These are like the ISO-C malloc() family except that they implement
958 consistent semantics and guard against typical memory management
961 /* NOTE: These are declared using PTR to ensure consistency with
962 "libiberty.h". xfree() is GDB local. */
965 xmalloc (size_t size
)
969 /* See libiberty/xmalloc.c. This function need's to match that's
970 semantics. It never returns NULL. */
974 val
= malloc (size
); /* OK: malloc */
982 xzalloc (size_t size
)
984 return xcalloc (1, size
);
988 xrealloc (PTR ptr
, size_t size
) /* OK: PTR */
992 /* See libiberty/xmalloc.c. This function need's to match that's
993 semantics. It never returns NULL. */
998 val
= realloc (ptr
, size
); /* OK: realloc */
1000 val
= malloc (size
); /* OK: malloc */
1008 xcalloc (size_t number
, size_t size
)
1012 /* See libiberty/xmalloc.c. This function need's to match that's
1013 semantics. It never returns NULL. */
1014 if (number
== 0 || size
== 0)
1020 mem
= calloc (number
, size
); /* OK: xcalloc */
1022 nomem (number
* size
);
1031 free (ptr
); /* OK: free */
1035 /* Like asprintf/vasprintf but get an internal_error if the call
1039 xstrprintf (const char *format
, ...)
1043 va_start (args
, format
);
1044 ret
= xstrvprintf (format
, args
);
1050 xasprintf (char **ret
, const char *format
, ...)
1053 va_start (args
, format
);
1054 (*ret
) = xstrvprintf (format
, args
);
1059 xvasprintf (char **ret
, const char *format
, va_list ap
)
1061 (*ret
) = xstrvprintf (format
, ap
);
1065 xstrvprintf (const char *format
, va_list ap
)
1068 int status
= vasprintf (&ret
, format
, ap
);
1069 /* NULL is returned when there was a memory allocation problem. */
1072 /* A negative status (the printed length) with a non-NULL buffer
1073 should never happen, but just to be sure. */
1075 internal_error (__FILE__
, __LINE__
,
1076 _("vasprintf call failed (errno %d)"), errno
);
1080 /* My replacement for the read system call.
1081 Used like `read' but keeps going if `read' returns too soon. */
1084 myread (int desc
, char *addr
, int len
)
1091 val
= read (desc
, addr
, len
);
1095 return orglen
- len
;
1102 /* Make a copy of the string at PTR with SIZE characters
1103 (and add a null character at the end in the copy).
1104 Uses malloc to get the space. Returns the address of the copy. */
1107 savestring (const char *ptr
, size_t size
)
1109 char *p
= (char *) xmalloc (size
+ 1);
1110 memcpy (p
, ptr
, size
);
1116 print_spaces (int n
, struct ui_file
*file
)
1118 fputs_unfiltered (n_spaces (n
), file
);
1121 /* Print a host address. */
1124 gdb_print_host_address (const void *addr
, struct ui_file
*stream
)
1127 /* We could use the %p conversion specifier to fprintf if we had any
1128 way of knowing whether this host supports it. But the following
1129 should work on the Alpha and on 32 bit machines. */
1131 fprintf_filtered (stream
, "0x%lx", (unsigned long) addr
);
1134 /* Ask user a y-or-n question and return 1 iff answer is yes.
1135 Takes three args which are given to printf to print the question.
1136 The first, a control string, should end in "? ".
1137 It should not say how to answer, because we do that. */
1141 query (const char *ctlstr
, ...)
1148 if (deprecated_query_hook
)
1150 va_start (args
, ctlstr
);
1151 return deprecated_query_hook (ctlstr
, args
);
1154 /* Automatically answer "yes" if input is not from a terminal. */
1155 if (!input_from_terminal_p ())
1160 wrap_here (""); /* Flush any buffered output */
1161 gdb_flush (gdb_stdout
);
1163 if (annotation_level
> 1)
1164 printf_filtered (("\n\032\032pre-query\n"));
1166 va_start (args
, ctlstr
);
1167 vfprintf_filtered (gdb_stdout
, ctlstr
, args
);
1169 printf_filtered (_("(y or n) "));
1171 if (annotation_level
> 1)
1172 printf_filtered (("\n\032\032query\n"));
1175 gdb_flush (gdb_stdout
);
1177 answer
= fgetc (stdin
);
1178 clearerr (stdin
); /* in case of C-d */
1179 if (answer
== EOF
) /* C-d */
1184 /* Eat rest of input line, to EOF or newline */
1188 ans2
= fgetc (stdin
);
1191 while (ans2
!= EOF
&& ans2
!= '\n' && ans2
!= '\r');
1205 printf_filtered (_("Please answer y or n.\n"));
1208 if (annotation_level
> 1)
1209 printf_filtered (("\n\032\032post-query\n"));
1214 /* This function supports the nquery() and yquery() functions.
1215 Ask user a y-or-n question and return 0 if answer is no, 1 if
1216 answer is yes, or default the answer to the specified default.
1217 DEFCHAR is either 'y' or 'n' and refers to the default answer.
1218 CTLSTR is the control string and should end in "? ". It should
1219 not say how to answer, because we do that.
1220 ARGS are the arguments passed along with the CTLSTR argument to
1224 defaulted_query (const char *ctlstr
, const char defchar
, va_list args
)
1230 char def_answer
, not_def_answer
;
1231 char *y_string
, *n_string
;
1233 /* Set up according to which answer is the default. */
1238 not_def_answer
= 'N';
1246 not_def_answer
= 'Y';
1251 if (deprecated_query_hook
)
1253 return deprecated_query_hook (ctlstr
, args
);
1256 /* Automatically answer default value if input is not from a terminal. */
1257 if (!input_from_terminal_p ())
1262 wrap_here (""); /* Flush any buffered output */
1263 gdb_flush (gdb_stdout
);
1265 if (annotation_level
> 1)
1266 printf_filtered (("\n\032\032pre-query\n"));
1268 vfprintf_filtered (gdb_stdout
, ctlstr
, args
);
1269 printf_filtered (_("(%s or %s) "), y_string
, n_string
);
1271 if (annotation_level
> 1)
1272 printf_filtered (("\n\032\032query\n"));
1275 gdb_flush (gdb_stdout
);
1277 answer
= fgetc (stdin
);
1278 clearerr (stdin
); /* in case of C-d */
1279 if (answer
== EOF
) /* C-d */
1284 /* Eat rest of input line, to EOF or newline */
1288 ans2
= fgetc (stdin
);
1291 while (ans2
!= EOF
&& ans2
!= '\n' && ans2
!= '\r');
1295 /* Check answer. For the non-default, the user must specify
1296 the non-default explicitly. */
1297 if (answer
== not_def_answer
)
1299 retval
= !def_value
;
1302 /* Otherwise, for the default, the user may either specify
1303 the required input or have it default by entering nothing. */
1304 if (answer
== def_answer
|| answer
== '\n' ||
1305 answer
== '\r' || answer
== EOF
)
1310 /* Invalid entries are not defaulted and require another selection. */
1311 printf_filtered (_("Please answer %s or %s.\n"),
1312 y_string
, n_string
);
1315 if (annotation_level
> 1)
1316 printf_filtered (("\n\032\032post-query\n"));
1321 /* Ask user a y-or-n question and return 0 if answer is no, 1 if
1322 answer is yes, or 0 if answer is defaulted.
1323 Takes three args which are given to printf to print the question.
1324 The first, a control string, should end in "? ".
1325 It should not say how to answer, because we do that. */
1328 nquery (const char *ctlstr
, ...)
1332 va_start (args
, ctlstr
);
1333 return defaulted_query (ctlstr
, 'n', args
);
1337 /* Ask user a y-or-n question and return 0 if answer is no, 1 if
1338 answer is yes, or 1 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 yquery (const char *ctlstr
, ...)
1348 va_start (args
, ctlstr
);
1349 return defaulted_query (ctlstr
, 'y', args
);
1353 /* Print an error message saying that we couldn't make sense of a
1354 \^mumble sequence in a string or character constant. START and END
1355 indicate a substring of some larger string that contains the
1356 erroneous backslash sequence, missing the initial backslash. */
1358 no_control_char_error (const char *start
, const char *end
)
1360 int len
= end
- start
;
1361 char *copy
= alloca (end
- start
+ 1);
1363 memcpy (copy
, start
, len
);
1366 error (_("There is no control character `\\%s' in the `%s' character set."),
1367 copy
, target_charset ());
1370 /* Parse a C escape sequence. STRING_PTR points to a variable
1371 containing a pointer to the string to parse. That pointer
1372 should point to the character after the \. That pointer
1373 is updated past the characters we use. The value of the
1374 escape sequence is returned.
1376 A negative value means the sequence \ newline was seen,
1377 which is supposed to be equivalent to nothing at all.
1379 If \ is followed by a null character, we return a negative
1380 value and leave the string pointer pointing at the null character.
1382 If \ is followed by 000, we return 0 and leave the string pointer
1383 after the zeros. A value of 0 does not mean end of string. */
1386 parse_escape (char **string_ptr
)
1389 int c
= *(*string_ptr
)++;
1390 if (c_parse_backslash (c
, &target_char
))
1402 /* Remember where this escape sequence started, for reporting
1404 char *sequence_start_pos
= *string_ptr
- 1;
1406 c
= *(*string_ptr
)++;
1410 /* XXXCHARSET: What is `delete' in the host character set? */
1413 if (!host_char_to_target (c
, &target_char
))
1414 error (_("There is no character corresponding to `Delete' "
1415 "in the target character set `%s'."), host_charset ());
1420 target_char
= parse_escape (string_ptr
);
1423 if (!host_char_to_target (c
, &target_char
))
1424 no_control_char_error (sequence_start_pos
, *string_ptr
);
1427 /* Now target_char is something like `c', and we want to find
1428 its control-character equivalent. */
1429 if (!target_char_to_control_char (target_char
, &target_char
))
1430 no_control_char_error (sequence_start_pos
, *string_ptr
);
1435 /* XXXCHARSET: we need to use isdigit and value-of-digit
1436 methods of the host character set here. */
1452 if (c
>= '0' && c
<= '7')
1466 if (!host_char_to_target (c
, &target_char
))
1468 ("The escape sequence `\%c' is equivalent to plain `%c', which"
1469 " has no equivalent\n" "in the `%s' character set.", c
, c
,
1475 /* Print the character C on STREAM as part of the contents of a literal
1476 string whose delimiter is QUOTER. Note that this routine should only
1477 be call for printing things which are independent of the language
1478 of the program being debugged. */
1481 printchar (int c
, void (*do_fputs
) (const char *, struct ui_file
*),
1482 void (*do_fprintf
) (struct ui_file
*, const char *, ...),
1483 struct ui_file
*stream
, int quoter
)
1486 c
&= 0xFF; /* Avoid sign bit follies */
1488 if (c
< 0x20 || /* Low control chars */
1489 (c
>= 0x7F && c
< 0xA0) || /* DEL, High controls */
1490 (sevenbit_strings
&& c
>= 0x80))
1491 { /* high order bit set */
1495 do_fputs ("\\n", stream
);
1498 do_fputs ("\\b", stream
);
1501 do_fputs ("\\t", stream
);
1504 do_fputs ("\\f", stream
);
1507 do_fputs ("\\r", stream
);
1510 do_fputs ("\\e", stream
);
1513 do_fputs ("\\a", stream
);
1516 do_fprintf (stream
, "\\%.3o", (unsigned int) c
);
1522 if (c
== '\\' || c
== quoter
)
1523 do_fputs ("\\", stream
);
1524 do_fprintf (stream
, "%c", c
);
1528 /* Print the character C on STREAM as part of the contents of a
1529 literal string whose delimiter is QUOTER. Note that these routines
1530 should only be call for printing things which are independent of
1531 the language of the program being debugged. */
1534 fputstr_filtered (const char *str
, int quoter
, struct ui_file
*stream
)
1537 printchar (*str
++, fputs_filtered
, fprintf_filtered
, stream
, quoter
);
1541 fputstr_unfiltered (const char *str
, int quoter
, struct ui_file
*stream
)
1544 printchar (*str
++, fputs_unfiltered
, fprintf_unfiltered
, stream
, quoter
);
1548 fputstrn_unfiltered (const char *str
, int n
, int quoter
,
1549 struct ui_file
*stream
)
1552 for (i
= 0; i
< n
; i
++)
1553 printchar (str
[i
], fputs_unfiltered
, fprintf_unfiltered
, stream
, quoter
);
1557 /* Number of lines per page or UINT_MAX if paging is disabled. */
1558 static unsigned int lines_per_page
;
1560 show_lines_per_page (struct ui_file
*file
, int from_tty
,
1561 struct cmd_list_element
*c
, const char *value
)
1563 fprintf_filtered (file
, _("\
1564 Number of lines gdb thinks are in a page is %s.\n"),
1568 /* Number of chars per line or UINT_MAX if line folding is disabled. */
1569 static unsigned int chars_per_line
;
1571 show_chars_per_line (struct ui_file
*file
, int from_tty
,
1572 struct cmd_list_element
*c
, const char *value
)
1574 fprintf_filtered (file
, _("\
1575 Number of characters gdb thinks are in a line is %s.\n"),
1579 /* Current count of lines printed on this page, chars on this line. */
1580 static unsigned int lines_printed
, chars_printed
;
1582 /* Buffer and start column of buffered text, for doing smarter word-
1583 wrapping. When someone calls wrap_here(), we start buffering output
1584 that comes through fputs_filtered(). If we see a newline, we just
1585 spit it out and forget about the wrap_here(). If we see another
1586 wrap_here(), we spit it out and remember the newer one. If we see
1587 the end of the line, we spit out a newline, the indent, and then
1588 the buffered output. */
1590 /* Malloc'd buffer with chars_per_line+2 bytes. Contains characters which
1591 are waiting to be output (they have already been counted in chars_printed).
1592 When wrap_buffer[0] is null, the buffer is empty. */
1593 static char *wrap_buffer
;
1595 /* Pointer in wrap_buffer to the next character to fill. */
1596 static char *wrap_pointer
;
1598 /* String to indent by if the wrap occurs. Must not be NULL if wrap_column
1600 static char *wrap_indent
;
1602 /* Column number on the screen where wrap_buffer begins, or 0 if wrapping
1603 is not in effect. */
1604 static int wrap_column
;
1607 /* Inialize the number of lines per page and chars per line. */
1610 init_page_info (void)
1613 if (!tui_get_command_dimension (&chars_per_line
, &lines_per_page
))
1618 #if defined(__GO32__)
1619 rows
= ScreenRows ();
1620 cols
= ScreenCols ();
1621 lines_per_page
= rows
;
1622 chars_per_line
= cols
;
1624 /* Make sure Readline has initialized its terminal settings. */
1625 rl_reset_terminal (NULL
);
1627 /* Get the screen size from Readline. */
1628 rl_get_screen_size (&rows
, &cols
);
1629 lines_per_page
= rows
;
1630 chars_per_line
= cols
;
1632 /* Readline should have fetched the termcap entry for us. */
1633 if (tgetnum ("li") < 0 || getenv ("EMACS"))
1635 /* The number of lines per page is not mentioned in the
1636 terminal description. This probably means that paging is
1637 not useful (e.g. emacs shell window), so disable paging. */
1638 lines_per_page
= UINT_MAX
;
1641 /* FIXME: Get rid of this junk. */
1642 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1643 SIGWINCH_HANDLER (SIGWINCH
);
1646 /* If the output is not a terminal, don't paginate it. */
1647 if (!ui_file_isatty (gdb_stdout
))
1648 lines_per_page
= UINT_MAX
;
1656 /* Set the screen size based on LINES_PER_PAGE and CHARS_PER_LINE. */
1659 set_screen_size (void)
1661 int rows
= lines_per_page
;
1662 int cols
= chars_per_line
;
1668 rl_get_screen_size (NULL
, &cols
);
1670 /* Update Readline's idea of the terminal size. */
1671 rl_set_screen_size (rows
, cols
);
1674 /* Reinitialize WRAP_BUFFER according to the current value of
1680 if (chars_per_line
== 0)
1685 wrap_buffer
= (char *) xmalloc (chars_per_line
+ 2);
1686 wrap_buffer
[0] = '\0';
1689 wrap_buffer
= (char *) xrealloc (wrap_buffer
, chars_per_line
+ 2);
1690 wrap_pointer
= wrap_buffer
; /* Start it at the beginning. */
1694 set_width_command (char *args
, int from_tty
, struct cmd_list_element
*c
)
1701 set_height_command (char *args
, int from_tty
, struct cmd_list_element
*c
)
1706 /* Wait, so the user can read what's on the screen. Prompt the user
1707 to continue by pressing RETURN. */
1710 prompt_for_continue (void)
1713 char cont_prompt
[120];
1715 if (annotation_level
> 1)
1716 printf_unfiltered (("\n\032\032pre-prompt-for-continue\n"));
1718 strcpy (cont_prompt
,
1719 "---Type <return> to continue, or q <return> to quit---");
1720 if (annotation_level
> 1)
1721 strcat (cont_prompt
, "\n\032\032prompt-for-continue\n");
1723 /* We must do this *before* we call gdb_readline, else it will eventually
1724 call us -- thinking that we're trying to print beyond the end of the
1726 reinitialize_more_filter ();
1729 /* On a real operating system, the user can quit with SIGINT.
1732 'q' is provided on all systems so users don't have to change habits
1733 from system to system, and because telling them what to do in
1734 the prompt is more user-friendly than expecting them to think of
1736 /* Call readline, not gdb_readline, because GO32 readline handles control-C
1737 whereas control-C to gdb_readline will cause the user to get dumped
1739 ignore
= gdb_readline_wrapper (cont_prompt
);
1741 if (annotation_level
> 1)
1742 printf_unfiltered (("\n\032\032post-prompt-for-continue\n"));
1747 while (*p
== ' ' || *p
== '\t')
1750 async_request_quit (0);
1755 /* Now we have to do this again, so that GDB will know that it doesn't
1756 need to save the ---Type <return>--- line at the top of the screen. */
1757 reinitialize_more_filter ();
1759 dont_repeat (); /* Forget prev cmd -- CR won't repeat it. */
1762 /* Reinitialize filter; ie. tell it to reset to original values. */
1765 reinitialize_more_filter (void)
1771 /* Indicate that if the next sequence of characters overflows the line,
1772 a newline should be inserted here rather than when it hits the end.
1773 If INDENT is non-null, it is a string to be printed to indent the
1774 wrapped part on the next line. INDENT must remain accessible until
1775 the next call to wrap_here() or until a newline is printed through
1778 If the line is already overfull, we immediately print a newline and
1779 the indentation, and disable further wrapping.
1781 If we don't know the width of lines, but we know the page height,
1782 we must not wrap words, but should still keep track of newlines
1783 that were explicitly printed.
1785 INDENT should not contain tabs, as that will mess up the char count
1786 on the next line. FIXME.
1788 This routine is guaranteed to force out any output which has been
1789 squirreled away in the wrap_buffer, so wrap_here ((char *)0) can be
1790 used to force out output from the wrap_buffer. */
1793 wrap_here (char *indent
)
1795 /* This should have been allocated, but be paranoid anyway. */
1797 internal_error (__FILE__
, __LINE__
, _("failed internal consistency check"));
1801 *wrap_pointer
= '\0';
1802 fputs_unfiltered (wrap_buffer
, gdb_stdout
);
1804 wrap_pointer
= wrap_buffer
;
1805 wrap_buffer
[0] = '\0';
1806 if (chars_per_line
== UINT_MAX
) /* No line overflow checking */
1810 else if (chars_printed
>= chars_per_line
)
1812 puts_filtered ("\n");
1814 puts_filtered (indent
);
1819 wrap_column
= chars_printed
;
1823 wrap_indent
= indent
;
1827 /* Print input string to gdb_stdout, filtered, with wrap,
1828 arranging strings in columns of n chars. String can be
1829 right or left justified in the column. Never prints
1830 trailing spaces. String should never be longer than
1831 width. FIXME: this could be useful for the EXAMINE
1832 command, which currently doesn't tabulate very well */
1835 puts_filtered_tabular (char *string
, int width
, int right
)
1841 gdb_assert (chars_per_line
> 0);
1842 if (chars_per_line
== UINT_MAX
)
1844 fputs_filtered (string
, gdb_stdout
);
1845 fputs_filtered ("\n", gdb_stdout
);
1849 if (((chars_printed
- 1) / width
+ 2) * width
>= chars_per_line
)
1850 fputs_filtered ("\n", gdb_stdout
);
1852 if (width
>= chars_per_line
)
1853 width
= chars_per_line
- 1;
1855 stringlen
= strlen (string
);
1857 if (chars_printed
> 0)
1858 spaces
= width
- (chars_printed
- 1) % width
- 1;
1860 spaces
+= width
- stringlen
;
1862 spacebuf
= alloca (spaces
+ 1);
1863 spacebuf
[spaces
] = '\0';
1865 spacebuf
[spaces
] = ' ';
1867 fputs_filtered (spacebuf
, gdb_stdout
);
1868 fputs_filtered (string
, gdb_stdout
);
1872 /* Ensure that whatever gets printed next, using the filtered output
1873 commands, starts at the beginning of the line. I.E. if there is
1874 any pending output for the current line, flush it and start a new
1875 line. Otherwise do nothing. */
1880 if (chars_printed
> 0)
1882 puts_filtered ("\n");
1887 /* Like fputs but if FILTER is true, pause after every screenful.
1889 Regardless of FILTER can wrap at points other than the final
1890 character of a line.
1892 Unlike fputs, fputs_maybe_filtered does not return a value.
1893 It is OK for LINEBUFFER to be NULL, in which case just don't print
1896 Note that a longjmp to top level may occur in this routine (only if
1897 FILTER is true) (since prompt_for_continue may do so) so this
1898 routine should not be called when cleanups are not in place. */
1901 fputs_maybe_filtered (const char *linebuffer
, struct ui_file
*stream
,
1904 const char *lineptr
;
1906 if (linebuffer
== 0)
1909 /* Don't do any filtering if it is disabled. */
1910 if ((stream
!= gdb_stdout
) || !pagination_enabled
1911 || (lines_per_page
== UINT_MAX
&& chars_per_line
== UINT_MAX
))
1913 fputs_unfiltered (linebuffer
, stream
);
1917 /* Go through and output each character. Show line extension
1918 when this is necessary; prompt user for new page when this is
1921 lineptr
= linebuffer
;
1924 /* Possible new page. */
1925 if (filter
&& (lines_printed
>= lines_per_page
- 1))
1926 prompt_for_continue ();
1928 while (*lineptr
&& *lineptr
!= '\n')
1930 /* Print a single line. */
1931 if (*lineptr
== '\t')
1934 *wrap_pointer
++ = '\t';
1936 fputc_unfiltered ('\t', stream
);
1937 /* Shifting right by 3 produces the number of tab stops
1938 we have already passed, and then adding one and
1939 shifting left 3 advances to the next tab stop. */
1940 chars_printed
= ((chars_printed
>> 3) + 1) << 3;
1946 *wrap_pointer
++ = *lineptr
;
1948 fputc_unfiltered (*lineptr
, stream
);
1953 if (chars_printed
>= chars_per_line
)
1955 unsigned int save_chars
= chars_printed
;
1959 /* If we aren't actually wrapping, don't output newline --
1960 if chars_per_line is right, we probably just overflowed
1961 anyway; if it's wrong, let us keep going. */
1963 fputc_unfiltered ('\n', stream
);
1965 /* Possible new page. */
1966 if (lines_printed
>= lines_per_page
- 1)
1967 prompt_for_continue ();
1969 /* Now output indentation and wrapped string */
1972 fputs_unfiltered (wrap_indent
, stream
);
1973 *wrap_pointer
= '\0'; /* Null-terminate saved stuff */
1974 fputs_unfiltered (wrap_buffer
, stream
); /* and eject it */
1975 /* FIXME, this strlen is what prevents wrap_indent from
1976 containing tabs. However, if we recurse to print it
1977 and count its chars, we risk trouble if wrap_indent is
1978 longer than (the user settable) chars_per_line.
1979 Note also that this can set chars_printed > chars_per_line
1980 if we are printing a long string. */
1981 chars_printed
= strlen (wrap_indent
)
1982 + (save_chars
- wrap_column
);
1983 wrap_pointer
= wrap_buffer
; /* Reset buffer */
1984 wrap_buffer
[0] = '\0';
1985 wrap_column
= 0; /* And disable fancy wrap */
1990 if (*lineptr
== '\n')
1993 wrap_here ((char *) 0); /* Spit out chars, cancel further wraps */
1995 fputc_unfiltered ('\n', stream
);
2002 fputs_filtered (const char *linebuffer
, struct ui_file
*stream
)
2004 fputs_maybe_filtered (linebuffer
, stream
, 1);
2008 putchar_unfiltered (int c
)
2011 ui_file_write (gdb_stdout
, &buf
, 1);
2015 /* Write character C to gdb_stdout using GDB's paging mechanism and return C.
2016 May return nonlocally. */
2019 putchar_filtered (int c
)
2021 return fputc_filtered (c
, gdb_stdout
);
2025 fputc_unfiltered (int c
, struct ui_file
*stream
)
2028 ui_file_write (stream
, &buf
, 1);
2033 fputc_filtered (int c
, struct ui_file
*stream
)
2039 fputs_filtered (buf
, stream
);
2043 /* puts_debug is like fputs_unfiltered, except it prints special
2044 characters in printable fashion. */
2047 puts_debug (char *prefix
, char *string
, char *suffix
)
2051 /* Print prefix and suffix after each line. */
2052 static int new_line
= 1;
2053 static int return_p
= 0;
2054 static char *prev_prefix
= "";
2055 static char *prev_suffix
= "";
2057 if (*string
== '\n')
2060 /* If the prefix is changing, print the previous suffix, a new line,
2061 and the new prefix. */
2062 if ((return_p
|| (strcmp (prev_prefix
, prefix
) != 0)) && !new_line
)
2064 fputs_unfiltered (prev_suffix
, gdb_stdlog
);
2065 fputs_unfiltered ("\n", gdb_stdlog
);
2066 fputs_unfiltered (prefix
, gdb_stdlog
);
2069 /* Print prefix if we printed a newline during the previous call. */
2073 fputs_unfiltered (prefix
, gdb_stdlog
);
2076 prev_prefix
= prefix
;
2077 prev_suffix
= suffix
;
2079 /* Output characters in a printable format. */
2080 while ((ch
= *string
++) != '\0')
2086 fputc_unfiltered (ch
, gdb_stdlog
);
2089 fprintf_unfiltered (gdb_stdlog
, "\\x%02x", ch
& 0xff);
2093 fputs_unfiltered ("\\\\", gdb_stdlog
);
2096 fputs_unfiltered ("\\b", gdb_stdlog
);
2099 fputs_unfiltered ("\\f", gdb_stdlog
);
2103 fputs_unfiltered ("\\n", gdb_stdlog
);
2106 fputs_unfiltered ("\\r", gdb_stdlog
);
2109 fputs_unfiltered ("\\t", gdb_stdlog
);
2112 fputs_unfiltered ("\\v", gdb_stdlog
);
2116 return_p
= ch
== '\r';
2119 /* Print suffix if we printed a newline. */
2122 fputs_unfiltered (suffix
, gdb_stdlog
);
2123 fputs_unfiltered ("\n", gdb_stdlog
);
2128 /* Print a variable number of ARGS using format FORMAT. If this
2129 information is going to put the amount written (since the last call
2130 to REINITIALIZE_MORE_FILTER or the last page break) over the page size,
2131 call prompt_for_continue to get the users permision to continue.
2133 Unlike fprintf, this function does not return a value.
2135 We implement three variants, vfprintf (takes a vararg list and stream),
2136 fprintf (takes a stream to write on), and printf (the usual).
2138 Note also that a longjmp to top level may occur in this routine
2139 (since prompt_for_continue may do so) so this routine should not be
2140 called when cleanups are not in place. */
2143 vfprintf_maybe_filtered (struct ui_file
*stream
, const char *format
,
2144 va_list args
, int filter
)
2147 struct cleanup
*old_cleanups
;
2149 linebuffer
= xstrvprintf (format
, args
);
2150 old_cleanups
= make_cleanup (xfree
, linebuffer
);
2151 fputs_maybe_filtered (linebuffer
, stream
, filter
);
2152 do_cleanups (old_cleanups
);
2157 vfprintf_filtered (struct ui_file
*stream
, const char *format
, va_list args
)
2159 vfprintf_maybe_filtered (stream
, format
, args
, 1);
2163 vfprintf_unfiltered (struct ui_file
*stream
, const char *format
, va_list args
)
2166 struct cleanup
*old_cleanups
;
2168 linebuffer
= xstrvprintf (format
, args
);
2169 old_cleanups
= make_cleanup (xfree
, linebuffer
);
2170 fputs_unfiltered (linebuffer
, stream
);
2171 do_cleanups (old_cleanups
);
2175 vprintf_filtered (const char *format
, va_list args
)
2177 vfprintf_maybe_filtered (gdb_stdout
, format
, args
, 1);
2181 vprintf_unfiltered (const char *format
, va_list args
)
2183 vfprintf_unfiltered (gdb_stdout
, format
, args
);
2187 fprintf_filtered (struct ui_file
*stream
, const char *format
, ...)
2190 va_start (args
, format
);
2191 vfprintf_filtered (stream
, format
, args
);
2196 fprintf_unfiltered (struct ui_file
*stream
, const char *format
, ...)
2199 va_start (args
, format
);
2200 vfprintf_unfiltered (stream
, format
, args
);
2204 /* Like fprintf_filtered, but prints its result indented.
2205 Called as fprintfi_filtered (spaces, stream, format, ...); */
2208 fprintfi_filtered (int spaces
, struct ui_file
*stream
, const char *format
,
2212 va_start (args
, format
);
2213 print_spaces_filtered (spaces
, stream
);
2215 vfprintf_filtered (stream
, format
, args
);
2221 printf_filtered (const char *format
, ...)
2224 va_start (args
, format
);
2225 vfprintf_filtered (gdb_stdout
, format
, args
);
2231 printf_unfiltered (const char *format
, ...)
2234 va_start (args
, format
);
2235 vfprintf_unfiltered (gdb_stdout
, format
, args
);
2239 /* Like printf_filtered, but prints it's result indented.
2240 Called as printfi_filtered (spaces, format, ...); */
2243 printfi_filtered (int spaces
, const char *format
, ...)
2246 va_start (args
, format
);
2247 print_spaces_filtered (spaces
, gdb_stdout
);
2248 vfprintf_filtered (gdb_stdout
, format
, args
);
2252 /* Easy -- but watch out!
2254 This routine is *not* a replacement for puts()! puts() appends a newline.
2255 This one doesn't, and had better not! */
2258 puts_filtered (const char *string
)
2260 fputs_filtered (string
, gdb_stdout
);
2264 puts_unfiltered (const char *string
)
2266 fputs_unfiltered (string
, gdb_stdout
);
2269 /* Return a pointer to N spaces and a null. The pointer is good
2270 until the next call to here. */
2275 static char *spaces
= 0;
2276 static int max_spaces
= -1;
2282 spaces
= (char *) xmalloc (n
+ 1);
2283 for (t
= spaces
+ n
; t
!= spaces
;)
2289 return spaces
+ max_spaces
- n
;
2292 /* Print N spaces. */
2294 print_spaces_filtered (int n
, struct ui_file
*stream
)
2296 fputs_filtered (n_spaces (n
), stream
);
2299 /* C++/ObjC demangler stuff. */
2301 /* fprintf_symbol_filtered attempts to demangle NAME, a symbol in language
2302 LANG, using demangling args ARG_MODE, and print it filtered to STREAM.
2303 If the name is not mangled, or the language for the name is unknown, or
2304 demangling is off, the name is printed in its "raw" form. */
2307 fprintf_symbol_filtered (struct ui_file
*stream
, char *name
,
2308 enum language lang
, int arg_mode
)
2314 /* If user wants to see raw output, no problem. */
2317 fputs_filtered (name
, stream
);
2321 demangled
= language_demangle (language_def (lang
), name
, arg_mode
);
2322 fputs_filtered (demangled
? demangled
: name
, stream
);
2323 if (demangled
!= NULL
)
2331 /* Do a strcmp() type operation on STRING1 and STRING2, ignoring any
2332 differences in whitespace. Returns 0 if they match, non-zero if they
2333 don't (slightly different than strcmp()'s range of return values).
2335 As an extra hack, string1=="FOO(ARGS)" matches string2=="FOO".
2336 This "feature" is useful when searching for matching C++ function names
2337 (such as if the user types 'break FOO', where FOO is a mangled C++
2341 strcmp_iw (const char *string1
, const char *string2
)
2343 while ((*string1
!= '\0') && (*string2
!= '\0'))
2345 while (isspace (*string1
))
2349 while (isspace (*string2
))
2353 if (*string1
!= *string2
)
2357 if (*string1
!= '\0')
2363 return (*string1
!= '\0' && *string1
!= '(') || (*string2
!= '\0');
2366 /* This is like strcmp except that it ignores whitespace and treats
2367 '(' as the first non-NULL character in terms of ordering. Like
2368 strcmp (and unlike strcmp_iw), it returns negative if STRING1 <
2369 STRING2, 0 if STRING2 = STRING2, and positive if STRING1 > STRING2
2370 according to that ordering.
2372 If a list is sorted according to this function and if you want to
2373 find names in the list that match some fixed NAME according to
2374 strcmp_iw(LIST_ELT, NAME), then the place to start looking is right
2375 where this function would put NAME.
2377 Here are some examples of why using strcmp to sort is a bad idea:
2381 Say your partial symtab contains: "foo<char *>", "goo". Then, if
2382 we try to do a search for "foo<char*>", strcmp will locate this
2383 after "foo<char *>" and before "goo". Then lookup_partial_symbol
2384 will start looking at strings beginning with "goo", and will never
2385 see the correct match of "foo<char *>".
2387 Parenthesis example:
2389 In practice, this is less like to be an issue, but I'll give it a
2390 shot. Let's assume that '$' is a legitimate character to occur in
2391 symbols. (Which may well even be the case on some systems.) Then
2392 say that the partial symbol table contains "foo$" and "foo(int)".
2393 strcmp will put them in this order, since '$' < '('. Now, if the
2394 user searches for "foo", then strcmp will sort "foo" before "foo$".
2395 Then lookup_partial_symbol will notice that strcmp_iw("foo$",
2396 "foo") is false, so it won't proceed to the actual match of
2397 "foo(int)" with "foo". */
2400 strcmp_iw_ordered (const char *string1
, const char *string2
)
2402 while ((*string1
!= '\0') && (*string2
!= '\0'))
2404 while (isspace (*string1
))
2408 while (isspace (*string2
))
2412 if (*string1
!= *string2
)
2416 if (*string1
!= '\0')
2425 /* Characters are non-equal unless they're both '\0'; we want to
2426 make sure we get the comparison right according to our
2427 comparison in the cases where one of them is '\0' or '('. */
2429 if (*string2
== '\0')
2434 if (*string2
== '\0')
2439 if (*string2
== '(')
2442 return *string1
- *string2
;
2446 /* A simple comparison function with opposite semantics to strcmp. */
2449 streq (const char *lhs
, const char *rhs
)
2451 return !strcmp (lhs
, rhs
);
2457 ** Answer whether string_to_compare is a full or partial match to
2458 ** template_string. The partial match must be in sequence starting
2462 subset_compare (char *string_to_compare
, char *template_string
)
2465 if (template_string
!= (char *) NULL
&& string_to_compare
!= (char *) NULL
2466 && strlen (string_to_compare
) <= strlen (template_string
))
2469 (template_string
, string_to_compare
, strlen (string_to_compare
)) == 0);
2476 static void pagination_on_command (char *arg
, int from_tty
);
2478 pagination_on_command (char *arg
, int from_tty
)
2480 pagination_enabled
= 1;
2483 static void pagination_on_command (char *arg
, int from_tty
);
2485 pagination_off_command (char *arg
, int from_tty
)
2487 pagination_enabled
= 0;
2492 initialize_utils (void)
2494 struct cmd_list_element
*c
;
2496 add_setshow_uinteger_cmd ("width", class_support
, &chars_per_line
, _("\
2497 Set number of characters gdb thinks are in a line."), _("\
2498 Show number of characters gdb thinks are in a line."), NULL
,
2500 show_chars_per_line
,
2501 &setlist
, &showlist
);
2503 add_setshow_uinteger_cmd ("height", class_support
, &lines_per_page
, _("\
2504 Set number of lines gdb thinks are in a page."), _("\
2505 Show number of lines gdb thinks are in a page."), NULL
,
2507 show_lines_per_page
,
2508 &setlist
, &showlist
);
2512 add_setshow_boolean_cmd ("demangle", class_support
, &demangle
, _("\
2513 Set demangling of encoded C++/ObjC names when displaying symbols."), _("\
2514 Show demangling of encoded C++/ObjC names when displaying symbols."), NULL
,
2517 &setprintlist
, &showprintlist
);
2519 add_setshow_boolean_cmd ("pagination", class_support
,
2520 &pagination_enabled
, _("\
2521 Set state of pagination."), _("\
2522 Show state of pagination."), NULL
,
2524 show_pagination_enabled
,
2525 &setlist
, &showlist
);
2529 add_com ("am", class_support
, pagination_on_command
,
2530 _("Enable pagination"));
2531 add_com ("sm", class_support
, pagination_off_command
,
2532 _("Disable pagination"));
2535 add_setshow_boolean_cmd ("sevenbit-strings", class_support
,
2536 &sevenbit_strings
, _("\
2537 Set printing of 8-bit characters in strings as \\nnn."), _("\
2538 Show printing of 8-bit characters in strings as \\nnn."), NULL
,
2540 show_sevenbit_strings
,
2541 &setprintlist
, &showprintlist
);
2543 add_setshow_boolean_cmd ("asm-demangle", class_support
, &asm_demangle
, _("\
2544 Set demangling of C++/ObjC names in disassembly listings."), _("\
2545 Show demangling of C++/ObjC names in disassembly listings."), NULL
,
2548 &setprintlist
, &showprintlist
);
2551 /* Machine specific function to handle SIGWINCH signal. */
2553 #ifdef SIGWINCH_HANDLER_BODY
2554 SIGWINCH_HANDLER_BODY
2556 /* print routines to handle variable size regs, etc. */
2557 /* temporary storage using circular buffer */
2563 static char buf
[NUMCELLS
][CELLSIZE
];
2564 static int cell
= 0;
2565 if (++cell
>= NUMCELLS
)
2573 return (TARGET_ADDR_BIT
/ 8 * 2);
2577 paddr (CORE_ADDR addr
)
2579 return phex (addr
, TARGET_ADDR_BIT
/ 8);
2583 paddr_nz (CORE_ADDR addr
)
2585 return phex_nz (addr
, TARGET_ADDR_BIT
/ 8);
2589 paddress (CORE_ADDR addr
)
2591 /* Truncate address to the size of a target address, avoiding shifts
2592 larger or equal than the width of a CORE_ADDR. The local
2593 variable ADDR_BIT stops the compiler reporting a shift overflow
2594 when it won't occur. */
2595 /* NOTE: This assumes that the significant address information is
2596 kept in the least significant bits of ADDR - the upper bits were
2597 either zero or sign extended. Should ADDRESS_TO_POINTER() or
2598 some ADDRESS_TO_PRINTABLE() be used to do the conversion? */
2600 int addr_bit
= TARGET_ADDR_BIT
;
2602 if (addr_bit
< (sizeof (CORE_ADDR
) * HOST_CHAR_BIT
))
2603 addr
&= ((CORE_ADDR
) 1 << addr_bit
) - 1;
2604 return hex_string (addr
);
2608 decimal2str (char *paddr_str
, char *sign
, ULONGEST addr
, int width
)
2610 /* steal code from valprint.c:print_decimal(). Should this worry
2611 about the real size of addr as the above does? */
2612 unsigned long temp
[3];
2616 temp
[i
] = addr
% (1000 * 1000 * 1000);
2617 addr
/= (1000 * 1000 * 1000);
2621 while (addr
!= 0 && i
< (sizeof (temp
) / sizeof (temp
[0])));
2628 sprintf (paddr_str
, "%s%0*lu", sign
, width
, temp
[0]);
2631 sprintf (paddr_str
, "%s%0*lu%09lu", sign
, width
, temp
[1], temp
[0]);
2634 sprintf (paddr_str
, "%s%0*lu%09lu%09lu", sign
, width
,
2635 temp
[2], temp
[1], temp
[0]);
2638 internal_error (__FILE__
, __LINE__
,
2639 _("failed internal consistency check"));
2644 octal2str (char *paddr_str
, ULONGEST addr
, int width
)
2646 unsigned long temp
[3];
2650 temp
[i
] = addr
% (0100000 * 0100000);
2651 addr
/= (0100000 * 0100000);
2655 while (addr
!= 0 && i
< (sizeof (temp
) / sizeof (temp
[0])));
2663 sprintf (paddr_str
, "%*o", width
, 0);
2665 sprintf (paddr_str
, "0%0*lo", width
, temp
[0]);
2668 sprintf (paddr_str
, "0%0*lo%010lo", width
, temp
[1], temp
[0]);
2671 sprintf (paddr_str
, "0%0*lo%010lo%010lo", width
,
2672 temp
[2], temp
[1], temp
[0]);
2675 internal_error (__FILE__
, __LINE__
,
2676 _("failed internal consistency check"));
2681 paddr_u (CORE_ADDR addr
)
2683 char *paddr_str
= get_cell ();
2684 decimal2str (paddr_str
, "", addr
, 0);
2689 paddr_d (LONGEST addr
)
2691 char *paddr_str
= get_cell ();
2693 decimal2str (paddr_str
, "-", -addr
, 0);
2695 decimal2str (paddr_str
, "", addr
, 0);
2699 /* eliminate warning from compiler on 32-bit systems */
2700 static int thirty_two
= 32;
2703 phex (ULONGEST l
, int sizeof_l
)
2710 sprintf (str
, "%08lx%08lx",
2711 (unsigned long) (l
>> thirty_two
),
2712 (unsigned long) (l
& 0xffffffff));
2716 sprintf (str
, "%08lx", (unsigned long) l
);
2720 sprintf (str
, "%04x", (unsigned short) (l
& 0xffff));
2723 str
= phex (l
, sizeof (l
));
2730 phex_nz (ULONGEST l
, int sizeof_l
)
2737 unsigned long high
= (unsigned long) (l
>> thirty_two
);
2740 sprintf (str
, "%lx", (unsigned long) (l
& 0xffffffff));
2742 sprintf (str
, "%lx%08lx", high
, (unsigned long) (l
& 0xffffffff));
2747 sprintf (str
, "%lx", (unsigned long) l
);
2751 sprintf (str
, "%x", (unsigned short) (l
& 0xffff));
2754 str
= phex_nz (l
, sizeof (l
));
2760 /* Converts a LONGEST to a C-format hexadecimal literal and stores it
2761 in a static string. Returns a pointer to this string. */
2763 hex_string (LONGEST num
)
2765 char *result
= get_cell ();
2766 snprintf (result
, CELLSIZE
, "0x%s", phex_nz (num
, sizeof (num
)));
2770 /* Converts a LONGEST number to a C-format hexadecimal literal and
2771 stores it in a static string. Returns a pointer to this string
2772 that is valid until the next call. The number is padded on the
2773 left with 0s to at least WIDTH characters. */
2775 hex_string_custom (LONGEST num
, int width
)
2777 char *result
= get_cell ();
2778 char *result_end
= result
+ CELLSIZE
- 1;
2779 const char *hex
= phex_nz (num
, sizeof (num
));
2780 int hex_len
= strlen (hex
);
2782 if (hex_len
> width
)
2784 if (width
+ 2 >= CELLSIZE
)
2785 internal_error (__FILE__
, __LINE__
,
2786 _("hex_string_custom: insufficient space to store result"));
2788 strcpy (result_end
- width
- 2, "0x");
2789 memset (result_end
- width
, '0', width
);
2790 strcpy (result_end
- hex_len
, hex
);
2791 return result_end
- width
- 2;
2794 /* Convert VAL to a numeral in the given radix. For
2795 * radix 10, IS_SIGNED may be true, indicating a signed quantity;
2796 * otherwise VAL is interpreted as unsigned. If WIDTH is supplied,
2797 * it is the minimum width (0-padded if needed). USE_C_FORMAT means
2798 * to use C format in all cases. If it is false, then 'x'
2799 * and 'o' formats do not include a prefix (0x or leading 0). */
2802 int_string (LONGEST val
, int radix
, int is_signed
, int width
,
2811 result
= hex_string (val
);
2813 result
= hex_string_custom (val
, width
);
2820 char *result
= get_cell ();
2821 if (is_signed
&& val
< 0)
2822 decimal2str (result
, "-", -val
, width
);
2824 decimal2str (result
, "", val
, width
);
2829 char *result
= get_cell ();
2830 octal2str (result
, val
, width
);
2831 if (use_c_format
|| val
== 0)
2837 internal_error (__FILE__
, __LINE__
,
2838 _("failed internal consistency check"));
2842 /* Convert a CORE_ADDR into a string. */
2844 core_addr_to_string (const CORE_ADDR addr
)
2846 char *str
= get_cell ();
2848 strcat (str
, phex (addr
, sizeof (addr
)));
2853 core_addr_to_string_nz (const CORE_ADDR addr
)
2855 char *str
= get_cell ();
2857 strcat (str
, phex_nz (addr
, sizeof (addr
)));
2861 /* Convert a string back into a CORE_ADDR. */
2863 string_to_core_addr (const char *my_string
)
2866 if (my_string
[0] == '0' && tolower (my_string
[1]) == 'x')
2868 /* Assume that it is in decimal. */
2870 for (i
= 2; my_string
[i
] != '\0'; i
++)
2872 if (isdigit (my_string
[i
]))
2873 addr
= (my_string
[i
] - '0') + (addr
* 16);
2874 else if (isxdigit (my_string
[i
]))
2875 addr
= (tolower (my_string
[i
]) - 'a' + 0xa) + (addr
* 16);
2877 internal_error (__FILE__
, __LINE__
, _("invalid hex"));
2882 /* Assume that it is in decimal. */
2884 for (i
= 0; my_string
[i
] != '\0'; i
++)
2886 if (isdigit (my_string
[i
]))
2887 addr
= (my_string
[i
] - '0') + (addr
* 10);
2889 internal_error (__FILE__
, __LINE__
, _("invalid decimal"));
2896 gdb_realpath (const char *filename
)
2898 /* Method 1: The system has a compile time upper bound on a filename
2899 path. Use that and realpath() to canonicalize the name. This is
2900 the most common case. Note that, if there isn't a compile time
2901 upper bound, you want to avoid realpath() at all costs. */
2902 #if defined(HAVE_REALPATH)
2904 # if defined (PATH_MAX)
2906 # define USE_REALPATH
2907 # elif defined (MAXPATHLEN)
2908 char buf
[MAXPATHLEN
];
2909 # define USE_REALPATH
2911 # if defined (USE_REALPATH)
2912 const char *rp
= realpath (filename
, buf
);
2915 return xstrdup (rp
);
2918 #endif /* HAVE_REALPATH */
2920 /* Method 2: The host system (i.e., GNU) has the function
2921 canonicalize_file_name() which malloc's a chunk of memory and
2922 returns that, use that. */
2923 #if defined(HAVE_CANONICALIZE_FILE_NAME)
2925 char *rp
= canonicalize_file_name (filename
);
2927 return xstrdup (filename
);
2933 /* FIXME: cagney/2002-11-13:
2935 Method 2a: Use realpath() with a NULL buffer. Some systems, due
2936 to the problems described in in method 3, have modified their
2937 realpath() implementation so that it will allocate a buffer when
2938 NULL is passed in. Before this can be used, though, some sort of
2939 configure time test would need to be added. Otherwize the code
2940 will likely core dump. */
2942 /* Method 3: Now we're getting desperate! The system doesn't have a
2943 compile time buffer size and no alternative function. Query the
2944 OS, using pathconf(), for the buffer limit. Care is needed
2945 though, some systems do not limit PATH_MAX (return -1 for
2946 pathconf()) making it impossible to pass a correctly sized buffer
2947 to realpath() (it could always overflow). On those systems, we
2949 #if defined (HAVE_REALPATH) && defined (HAVE_UNISTD_H) && defined(HAVE_ALLOCA)
2951 /* Find out the max path size. */
2952 long path_max
= pathconf ("/", _PC_PATH_MAX
);
2955 /* PATH_MAX is bounded. */
2956 char *buf
= alloca (path_max
);
2957 char *rp
= realpath (filename
, buf
);
2958 return xstrdup (rp
? rp
: filename
);
2963 /* This system is a lost cause, just dup the buffer. */
2964 return xstrdup (filename
);
2967 /* Return a copy of FILENAME, with its directory prefix canonicalized
2971 xfullpath (const char *filename
)
2973 const char *base_name
= lbasename (filename
);
2978 /* Extract the basename of filename, and return immediately
2979 a copy of filename if it does not contain any directory prefix. */
2980 if (base_name
== filename
)
2981 return xstrdup (filename
);
2983 dir_name
= alloca ((size_t) (base_name
- filename
+ 2));
2984 /* Allocate enough space to store the dir_name + plus one extra
2985 character sometimes needed under Windows (see below), and
2986 then the closing \000 character */
2987 strncpy (dir_name
, filename
, base_name
- filename
);
2988 dir_name
[base_name
- filename
] = '\000';
2990 #ifdef HAVE_DOS_BASED_FILE_SYSTEM
2991 /* We need to be careful when filename is of the form 'd:foo', which
2992 is equivalent of d:./foo, which is totally different from d:/foo. */
2993 if (strlen (dir_name
) == 2 && isalpha (dir_name
[0]) && dir_name
[1] == ':')
2996 dir_name
[3] = '\000';
3000 /* Canonicalize the directory prefix, and build the resulting
3001 filename. If the dirname realpath already contains an ending
3002 directory separator, avoid doubling it. */
3003 real_path
= gdb_realpath (dir_name
);
3004 if (IS_DIR_SEPARATOR (real_path
[strlen (real_path
) - 1]))
3005 result
= concat (real_path
, base_name
, NULL
);
3007 result
= concat (real_path
, SLASH_STRING
, base_name
, NULL
);
3014 /* This is the 32-bit CRC function used by the GNU separate debug
3015 facility. An executable may contain a section named
3016 .gnu_debuglink, which holds the name of a separate executable file
3017 containing its debug info, and a checksum of that file's contents,
3018 computed using this function. */
3020 gnu_debuglink_crc32 (unsigned long crc
, unsigned char *buf
, size_t len
)
3022 static const unsigned long crc32_table
[256] = {
3023 0x00000000, 0x77073096, 0xee0e612c, 0x990951ba, 0x076dc419,
3024 0x706af48f, 0xe963a535, 0x9e6495a3, 0x0edb8832, 0x79dcb8a4,
3025 0xe0d5e91e, 0x97d2d988, 0x09b64c2b, 0x7eb17cbd, 0xe7b82d07,
3026 0x90bf1d91, 0x1db71064, 0x6ab020f2, 0xf3b97148, 0x84be41de,
3027 0x1adad47d, 0x6ddde4eb, 0xf4d4b551, 0x83d385c7, 0x136c9856,
3028 0x646ba8c0, 0xfd62f97a, 0x8a65c9ec, 0x14015c4f, 0x63066cd9,
3029 0xfa0f3d63, 0x8d080df5, 0x3b6e20c8, 0x4c69105e, 0xd56041e4,
3030 0xa2677172, 0x3c03e4d1, 0x4b04d447, 0xd20d85fd, 0xa50ab56b,
3031 0x35b5a8fa, 0x42b2986c, 0xdbbbc9d6, 0xacbcf940, 0x32d86ce3,
3032 0x45df5c75, 0xdcd60dcf, 0xabd13d59, 0x26d930ac, 0x51de003a,
3033 0xc8d75180, 0xbfd06116, 0x21b4f4b5, 0x56b3c423, 0xcfba9599,
3034 0xb8bda50f, 0x2802b89e, 0x5f058808, 0xc60cd9b2, 0xb10be924,
3035 0x2f6f7c87, 0x58684c11, 0xc1611dab, 0xb6662d3d, 0x76dc4190,
3036 0x01db7106, 0x98d220bc, 0xefd5102a, 0x71b18589, 0x06b6b51f,
3037 0x9fbfe4a5, 0xe8b8d433, 0x7807c9a2, 0x0f00f934, 0x9609a88e,
3038 0xe10e9818, 0x7f6a0dbb, 0x086d3d2d, 0x91646c97, 0xe6635c01,
3039 0x6b6b51f4, 0x1c6c6162, 0x856530d8, 0xf262004e, 0x6c0695ed,
3040 0x1b01a57b, 0x8208f4c1, 0xf50fc457, 0x65b0d9c6, 0x12b7e950,
3041 0x8bbeb8ea, 0xfcb9887c, 0x62dd1ddf, 0x15da2d49, 0x8cd37cf3,
3042 0xfbd44c65, 0x4db26158, 0x3ab551ce, 0xa3bc0074, 0xd4bb30e2,
3043 0x4adfa541, 0x3dd895d7, 0xa4d1c46d, 0xd3d6f4fb, 0x4369e96a,
3044 0x346ed9fc, 0xad678846, 0xda60b8d0, 0x44042d73, 0x33031de5,
3045 0xaa0a4c5f, 0xdd0d7cc9, 0x5005713c, 0x270241aa, 0xbe0b1010,
3046 0xc90c2086, 0x5768b525, 0x206f85b3, 0xb966d409, 0xce61e49f,
3047 0x5edef90e, 0x29d9c998, 0xb0d09822, 0xc7d7a8b4, 0x59b33d17,
3048 0x2eb40d81, 0xb7bd5c3b, 0xc0ba6cad, 0xedb88320, 0x9abfb3b6,
3049 0x03b6e20c, 0x74b1d29a, 0xead54739, 0x9dd277af, 0x04db2615,
3050 0x73dc1683, 0xe3630b12, 0x94643b84, 0x0d6d6a3e, 0x7a6a5aa8,
3051 0xe40ecf0b, 0x9309ff9d, 0x0a00ae27, 0x7d079eb1, 0xf00f9344,
3052 0x8708a3d2, 0x1e01f268, 0x6906c2fe, 0xf762575d, 0x806567cb,
3053 0x196c3671, 0x6e6b06e7, 0xfed41b76, 0x89d32be0, 0x10da7a5a,
3054 0x67dd4acc, 0xf9b9df6f, 0x8ebeeff9, 0x17b7be43, 0x60b08ed5,
3055 0xd6d6a3e8, 0xa1d1937e, 0x38d8c2c4, 0x4fdff252, 0xd1bb67f1,
3056 0xa6bc5767, 0x3fb506dd, 0x48b2364b, 0xd80d2bda, 0xaf0a1b4c,
3057 0x36034af6, 0x41047a60, 0xdf60efc3, 0xa867df55, 0x316e8eef,
3058 0x4669be79, 0xcb61b38c, 0xbc66831a, 0x256fd2a0, 0x5268e236,
3059 0xcc0c7795, 0xbb0b4703, 0x220216b9, 0x5505262f, 0xc5ba3bbe,
3060 0xb2bd0b28, 0x2bb45a92, 0x5cb36a04, 0xc2d7ffa7, 0xb5d0cf31,
3061 0x2cd99e8b, 0x5bdeae1d, 0x9b64c2b0, 0xec63f226, 0x756aa39c,
3062 0x026d930a, 0x9c0906a9, 0xeb0e363f, 0x72076785, 0x05005713,
3063 0x95bf4a82, 0xe2b87a14, 0x7bb12bae, 0x0cb61b38, 0x92d28e9b,
3064 0xe5d5be0d, 0x7cdcefb7, 0x0bdbdf21, 0x86d3d2d4, 0xf1d4e242,
3065 0x68ddb3f8, 0x1fda836e, 0x81be16cd, 0xf6b9265b, 0x6fb077e1,
3066 0x18b74777, 0x88085ae6, 0xff0f6a70, 0x66063bca, 0x11010b5c,
3067 0x8f659eff, 0xf862ae69, 0x616bffd3, 0x166ccf45, 0xa00ae278,
3068 0xd70dd2ee, 0x4e048354, 0x3903b3c2, 0xa7672661, 0xd06016f7,
3069 0x4969474d, 0x3e6e77db, 0xaed16a4a, 0xd9d65adc, 0x40df0b66,
3070 0x37d83bf0, 0xa9bcae53, 0xdebb9ec5, 0x47b2cf7f, 0x30b5ffe9,
3071 0xbdbdf21c, 0xcabac28a, 0x53b39330, 0x24b4a3a6, 0xbad03605,
3072 0xcdd70693, 0x54de5729, 0x23d967bf, 0xb3667a2e, 0xc4614ab8,
3073 0x5d681b02, 0x2a6f2b94, 0xb40bbe37, 0xc30c8ea1, 0x5a05df1b,
3078 crc
= ~crc
& 0xffffffff;
3079 for (end
= buf
+ len
; buf
< end
; ++buf
)
3080 crc
= crc32_table
[(crc
^ *buf
) & 0xff] ^ (crc
>> 8);
3081 return ~crc
& 0xffffffff;;
3085 align_up (ULONGEST v
, int n
)
3087 /* Check that N is really a power of two. */
3088 gdb_assert (n
&& (n
& (n
-1)) == 0);
3089 return (v
+ n
- 1) & -n
;
3093 align_down (ULONGEST v
, int n
)
3095 /* Check that N is really a power of two. */
3096 gdb_assert (n
&& (n
& (n
-1)) == 0);