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 Free Software
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"
31 #include "tui/tui.h" /* For tui_get_command_dimension. */
38 /* SunOS's curses.h has a '#define reg register' in it. Thank you Sun. */
49 #include "expression.h"
53 #include "filenames.h"
56 #include "inferior.h" /* for signed_pointer_to_address */
58 #include <sys/param.h> /* For MAXPATHLEN */
67 #include "readline/readline.h"
69 #ifdef NEED_DECLARATION_MALLOC
70 extern PTR
malloc (); /* OK: PTR */
72 #ifdef NEED_DECLARATION_REALLOC
73 extern PTR
realloc (); /* OK: PTR */
75 #ifdef NEED_DECLARATION_FREE
78 /* Actually, we'll never have the decl, since we don't define _GNU_SOURCE. */
79 #if defined(HAVE_CANONICALIZE_FILE_NAME) \
80 && defined(NEED_DECLARATION_CANONICALIZE_FILE_NAME)
81 extern char *canonicalize_file_name (const char *);
84 /* readline defines this. */
87 void (*deprecated_error_begin_hook
) (void);
89 /* Holds the last error message issued by gdb */
91 static struct ui_file
*gdb_lasterr
;
93 /* Prototypes for local functions */
95 static void vfprintf_maybe_filtered (struct ui_file
*, const char *,
98 static void fputs_maybe_filtered (const char *, struct ui_file
*, int);
100 static void do_my_cleanups (struct cleanup
**, struct cleanup
*);
102 static void prompt_for_continue (void);
104 static void set_screen_size (void);
105 static void set_width (void);
107 static NORETURN
void error_stream_1 (struct ui_file
*stream
,
108 enum return_reason reason
) ATTR_NORETURN
;
110 /* Chain of cleanup actions established with make_cleanup,
111 to be executed if an error happens. */
113 static struct cleanup
*cleanup_chain
; /* cleaned up after a failed command */
114 static struct cleanup
*final_cleanup_chain
; /* cleaned up when gdb exits */
115 static struct cleanup
*run_cleanup_chain
; /* cleaned up on each 'run' */
116 static struct cleanup
*exec_cleanup_chain
; /* cleaned up on each execution command */
117 /* cleaned up on each error from within an execution command */
118 static struct cleanup
*exec_error_cleanup_chain
;
120 /* Pointer to what is left to do for an execution command after the
121 target stops. Used only in asynchronous mode, by targets that
122 support async execution. The finish and until commands use it. So
123 does the target extended-remote command. */
124 struct continuation
*cmd_continuation
;
125 struct continuation
*intermediate_continuation
;
127 /* Nonzero if we have job control. */
131 /* Nonzero means a quit has been requested. */
135 /* Nonzero means quit immediately if Control-C is typed now, rather
136 than waiting until QUIT is executed. Be careful in setting this;
137 code which executes with immediate_quit set has to be very careful
138 about being able to deal with being interrupted at any time. It is
139 almost always better to use QUIT; the only exception I can think of
140 is being able to quit out of a system call (using EINTR loses if
141 the SIGINT happens between the previous QUIT and the system call).
142 To immediately quit in the case in which a SIGINT happens between
143 the previous QUIT and setting immediate_quit (desirable anytime we
144 expect to block), call QUIT after setting immediate_quit. */
148 /* Nonzero means that encoded C++/ObjC names should be printed out in their
149 C++/ObjC form rather than raw. */
153 /* Nonzero means that encoded C++/ObjC names should be printed out in their
154 C++/ObjC form even in assembler language displays. If this is set, but
155 DEMANGLE is zero, names are printed raw, i.e. DEMANGLE controls. */
157 int asm_demangle
= 0;
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 /* String to be printed before error messages, if any. */
167 char *error_pre_print
;
169 /* String to be printed before quit messages, if any. */
171 char *quit_pre_print
;
173 /* String to be printed before warning messages, if any. */
175 char *warning_pre_print
= "\nwarning: ";
177 int pagination_enabled
= 1;
180 /* Add a new cleanup to the cleanup_chain,
181 and return the previous chain pointer
182 to be passed later to do_cleanups or discard_cleanups.
183 Args are FUNCTION to clean up with, and ARG to pass to it. */
186 make_cleanup (make_cleanup_ftype
*function
, void *arg
)
188 return make_my_cleanup (&cleanup_chain
, function
, arg
);
192 make_final_cleanup (make_cleanup_ftype
*function
, void *arg
)
194 return make_my_cleanup (&final_cleanup_chain
, function
, arg
);
198 make_run_cleanup (make_cleanup_ftype
*function
, void *arg
)
200 return make_my_cleanup (&run_cleanup_chain
, function
, arg
);
204 make_exec_cleanup (make_cleanup_ftype
*function
, void *arg
)
206 return make_my_cleanup (&exec_cleanup_chain
, function
, arg
);
210 make_exec_error_cleanup (make_cleanup_ftype
*function
, void *arg
)
212 return make_my_cleanup (&exec_error_cleanup_chain
, function
, arg
);
216 do_freeargv (void *arg
)
218 freeargv ((char **) arg
);
222 make_cleanup_freeargv (char **arg
)
224 return make_my_cleanup (&cleanup_chain
, do_freeargv
, arg
);
228 do_bfd_close_cleanup (void *arg
)
234 make_cleanup_bfd_close (bfd
*abfd
)
236 return make_cleanup (do_bfd_close_cleanup
, abfd
);
240 do_close_cleanup (void *arg
)
248 make_cleanup_close (int fd
)
250 int *saved_fd
= xmalloc (sizeof (fd
));
252 return make_cleanup (do_close_cleanup
, saved_fd
);
256 do_ui_file_delete (void *arg
)
258 ui_file_delete (arg
);
262 make_cleanup_ui_file_delete (struct ui_file
*arg
)
264 return make_my_cleanup (&cleanup_chain
, do_ui_file_delete
, arg
);
268 do_free_section_addr_info (void *arg
)
270 free_section_addr_info (arg
);
274 make_cleanup_free_section_addr_info (struct section_addr_info
*addrs
)
276 return make_my_cleanup (&cleanup_chain
, do_free_section_addr_info
, addrs
);
281 make_my_cleanup (struct cleanup
**pmy_chain
, make_cleanup_ftype
*function
,
285 = (struct cleanup
*) xmalloc (sizeof (struct cleanup
));
286 struct cleanup
*old_chain
= *pmy_chain
;
288 new->next
= *pmy_chain
;
289 new->function
= function
;
296 /* Discard cleanups and do the actions they describe
297 until we get back to the point OLD_CHAIN in the cleanup_chain. */
300 do_cleanups (struct cleanup
*old_chain
)
302 do_my_cleanups (&cleanup_chain
, old_chain
);
306 do_final_cleanups (struct cleanup
*old_chain
)
308 do_my_cleanups (&final_cleanup_chain
, old_chain
);
312 do_run_cleanups (struct cleanup
*old_chain
)
314 do_my_cleanups (&run_cleanup_chain
, old_chain
);
318 do_exec_cleanups (struct cleanup
*old_chain
)
320 do_my_cleanups (&exec_cleanup_chain
, old_chain
);
324 do_exec_error_cleanups (struct cleanup
*old_chain
)
326 do_my_cleanups (&exec_error_cleanup_chain
, old_chain
);
330 do_my_cleanups (struct cleanup
**pmy_chain
,
331 struct cleanup
*old_chain
)
334 while ((ptr
= *pmy_chain
) != old_chain
)
336 *pmy_chain
= ptr
->next
; /* Do this first incase recursion */
337 (*ptr
->function
) (ptr
->arg
);
342 /* Discard cleanups, not doing the actions they describe,
343 until we get back to the point OLD_CHAIN in the cleanup_chain. */
346 discard_cleanups (struct cleanup
*old_chain
)
348 discard_my_cleanups (&cleanup_chain
, old_chain
);
352 discard_final_cleanups (struct cleanup
*old_chain
)
354 discard_my_cleanups (&final_cleanup_chain
, old_chain
);
358 discard_exec_error_cleanups (struct cleanup
*old_chain
)
360 discard_my_cleanups (&exec_error_cleanup_chain
, old_chain
);
364 discard_my_cleanups (struct cleanup
**pmy_chain
,
365 struct cleanup
*old_chain
)
368 while ((ptr
= *pmy_chain
) != old_chain
)
370 *pmy_chain
= ptr
->next
;
375 /* Set the cleanup_chain to 0, and return the old cleanup chain. */
379 return save_my_cleanups (&cleanup_chain
);
383 save_final_cleanups (void)
385 return save_my_cleanups (&final_cleanup_chain
);
389 save_my_cleanups (struct cleanup
**pmy_chain
)
391 struct cleanup
*old_chain
= *pmy_chain
;
397 /* Restore the cleanup chain from a previously saved chain. */
399 restore_cleanups (struct cleanup
*chain
)
401 restore_my_cleanups (&cleanup_chain
, chain
);
405 restore_final_cleanups (struct cleanup
*chain
)
407 restore_my_cleanups (&final_cleanup_chain
, chain
);
411 restore_my_cleanups (struct cleanup
**pmy_chain
, struct cleanup
*chain
)
416 /* This function is useful for cleanups.
420 old_chain = make_cleanup (free_current_contents, &foo);
422 to arrange to free the object thus allocated. */
425 free_current_contents (void *ptr
)
427 void **location
= ptr
;
428 if (location
== NULL
)
429 internal_error (__FILE__
, __LINE__
,
430 "free_current_contents: NULL pointer");
431 if (*location
!= NULL
)
438 /* Provide a known function that does nothing, to use as a base for
439 for a possibly long chain of cleanups. This is useful where we
440 use the cleanup chain for handling normal cleanups as well as dealing
441 with cleanups that need to be done as a result of a call to error().
442 In such cases, we may not be certain where the first cleanup is, unless
443 we have a do-nothing one to always use as the base. */
446 null_cleanup (void *arg
)
450 /* Add a continuation to the continuation list, the global list
451 cmd_continuation. The new continuation will be added at the front.*/
453 add_continuation (void (*continuation_hook
) (struct continuation_arg
*),
454 struct continuation_arg
*arg_list
)
456 struct continuation
*continuation_ptr
;
459 (struct continuation
*) xmalloc (sizeof (struct continuation
));
460 continuation_ptr
->continuation_hook
= continuation_hook
;
461 continuation_ptr
->arg_list
= arg_list
;
462 continuation_ptr
->next
= cmd_continuation
;
463 cmd_continuation
= continuation_ptr
;
466 /* Walk down the cmd_continuation list, and execute all the
467 continuations. There is a problem though. In some cases new
468 continuations may be added while we are in the middle of this
469 loop. If this happens they will be added in the front, and done
470 before we have a chance of exhausting those that were already
471 there. We need to then save the beginning of the list in a pointer
472 and do the continuations from there on, instead of using the
473 global beginning of list as our iteration pointer.*/
475 do_all_continuations (void)
477 struct continuation
*continuation_ptr
;
478 struct continuation
*saved_continuation
;
480 /* Copy the list header into another pointer, and set the global
481 list header to null, so that the global list can change as a side
482 effect of invoking the continuations and the processing of
483 the preexisting continuations will not be affected. */
484 continuation_ptr
= cmd_continuation
;
485 cmd_continuation
= NULL
;
487 /* Work now on the list we have set aside. */
488 while (continuation_ptr
)
490 (continuation_ptr
->continuation_hook
) (continuation_ptr
->arg_list
);
491 saved_continuation
= continuation_ptr
;
492 continuation_ptr
= continuation_ptr
->next
;
493 xfree (saved_continuation
);
497 /* Walk down the cmd_continuation list, and get rid of all the
500 discard_all_continuations (void)
502 struct continuation
*continuation_ptr
;
504 while (cmd_continuation
)
506 continuation_ptr
= cmd_continuation
;
507 cmd_continuation
= continuation_ptr
->next
;
508 xfree (continuation_ptr
);
512 /* Add a continuation to the continuation list, the global list
513 intermediate_continuation. The new continuation will be added at the front.*/
515 add_intermediate_continuation (void (*continuation_hook
)
516 (struct continuation_arg
*),
517 struct continuation_arg
*arg_list
)
519 struct continuation
*continuation_ptr
;
522 (struct continuation
*) xmalloc (sizeof (struct continuation
));
523 continuation_ptr
->continuation_hook
= continuation_hook
;
524 continuation_ptr
->arg_list
= arg_list
;
525 continuation_ptr
->next
= intermediate_continuation
;
526 intermediate_continuation
= continuation_ptr
;
529 /* Walk down the cmd_continuation list, and execute all the
530 continuations. There is a problem though. In some cases new
531 continuations may be added while we are in the middle of this
532 loop. If this happens they will be added in the front, and done
533 before we have a chance of exhausting those that were already
534 there. We need to then save the beginning of the list in a pointer
535 and do the continuations from there on, instead of using the
536 global beginning of list as our iteration pointer.*/
538 do_all_intermediate_continuations (void)
540 struct continuation
*continuation_ptr
;
541 struct continuation
*saved_continuation
;
543 /* Copy the list header into another pointer, and set the global
544 list header to null, so that the global list can change as a side
545 effect of invoking the continuations and the processing of
546 the preexisting continuations will not be affected. */
547 continuation_ptr
= intermediate_continuation
;
548 intermediate_continuation
= NULL
;
550 /* Work now on the list we have set aside. */
551 while (continuation_ptr
)
553 (continuation_ptr
->continuation_hook
) (continuation_ptr
->arg_list
);
554 saved_continuation
= continuation_ptr
;
555 continuation_ptr
= continuation_ptr
->next
;
556 xfree (saved_continuation
);
560 /* Walk down the cmd_continuation list, and get rid of all the
563 discard_all_intermediate_continuations (void)
565 struct continuation
*continuation_ptr
;
567 while (intermediate_continuation
)
569 continuation_ptr
= intermediate_continuation
;
570 intermediate_continuation
= continuation_ptr
->next
;
571 xfree (continuation_ptr
);
577 /* Print a warning message. The first argument STRING is the warning
578 message, used as an fprintf format string, the second is the
579 va_list of arguments for that string. A warning is unfiltered (not
580 paginated) so that the user does not need to page through each
581 screen full of warnings when there are lots of them. */
584 vwarning (const char *string
, va_list args
)
586 if (deprecated_warning_hook
)
587 (*deprecated_warning_hook
) (string
, args
);
590 target_terminal_ours ();
591 wrap_here (""); /* Force out any buffered output */
592 gdb_flush (gdb_stdout
);
593 if (warning_pre_print
)
594 fputs_unfiltered (warning_pre_print
, gdb_stderr
);
595 vfprintf_unfiltered (gdb_stderr
, string
, args
);
596 fprintf_unfiltered (gdb_stderr
, "\n");
601 /* Print a warning message.
602 The first argument STRING is the warning message, used as a fprintf string,
603 and the remaining args are passed as arguments to it.
604 The primary difference between warnings and errors is that a warning
605 does not force the return to command level. */
608 warning (const char *string
, ...)
611 va_start (args
, string
);
612 vwarning (string
, args
);
616 /* Print an error message and return to command level.
617 The first argument STRING is the error message, used as a fprintf string,
618 and the remaining args are passed as arguments to it. */
621 verror (const char *string
, va_list args
)
623 struct ui_file
*tmp_stream
= mem_fileopen ();
624 make_cleanup_ui_file_delete (tmp_stream
);
625 vfprintf_unfiltered (tmp_stream
, string
, args
);
626 error_stream_1 (tmp_stream
, RETURN_ERROR
);
630 error (const char *string
, ...)
633 va_start (args
, string
);
634 verror (string
, args
);
638 /* Print an error message and quit.
639 The first argument STRING is the error message, used as a fprintf string,
640 and the remaining args are passed as arguments to it. */
643 vfatal (const char *string
, va_list args
)
645 struct ui_file
*tmp_stream
= mem_fileopen ();
646 make_cleanup_ui_file_delete (tmp_stream
);
647 vfprintf_unfiltered (tmp_stream
, string
, args
);
648 error_stream_1 (tmp_stream
, RETURN_QUIT
);
652 fatal (const char *string
, ...)
655 va_start (args
, string
);
656 vfatal (string
, args
);
661 do_write (void *data
, const char *buffer
, long length_buffer
)
663 ui_file_write (data
, buffer
, length_buffer
);
666 /* Cause a silent error to occur. Any error message is recorded
667 though it is not issued. */
669 error_silent (const char *string
, ...)
672 struct ui_file
*tmp_stream
= mem_fileopen ();
673 va_start (args
, string
);
674 make_cleanup_ui_file_delete (tmp_stream
);
675 vfprintf_unfiltered (tmp_stream
, string
, args
);
676 /* Copy the stream into the GDB_LASTERR buffer. */
677 ui_file_rewind (gdb_lasterr
);
678 ui_file_put (tmp_stream
, do_write
, gdb_lasterr
);
681 throw_exception (RETURN_ERROR
);
684 /* Output an error message including any pre-print text to gdb_stderr. */
686 error_output_message (char *pre_print
, char *msg
)
688 target_terminal_ours ();
689 wrap_here (""); /* Force out any buffered output */
690 gdb_flush (gdb_stdout
);
691 annotate_error_begin ();
693 fputs_filtered (pre_print
, gdb_stderr
);
694 fputs_filtered (msg
, gdb_stderr
);
695 fprintf_filtered (gdb_stderr
, "\n");
699 error_stream_1 (struct ui_file
*stream
, enum return_reason reason
)
701 if (deprecated_error_begin_hook
)
702 deprecated_error_begin_hook ();
704 /* Copy the stream into the GDB_LASTERR buffer. */
705 ui_file_rewind (gdb_lasterr
);
706 ui_file_put (stream
, do_write
, gdb_lasterr
);
708 /* Write the message plus any error_pre_print to gdb_stderr. */
709 target_terminal_ours ();
710 wrap_here (""); /* Force out any buffered output */
711 gdb_flush (gdb_stdout
);
712 annotate_error_begin ();
714 fputs_filtered (error_pre_print
, gdb_stderr
);
715 ui_file_put (stream
, do_write
, gdb_stderr
);
716 fprintf_filtered (gdb_stderr
, "\n");
718 throw_exception (reason
);
722 error_stream (struct ui_file
*stream
)
724 error_stream_1 (stream
, RETURN_ERROR
);
727 /* Get the last error message issued by gdb */
730 error_last_message (void)
733 return ui_file_xstrdup (gdb_lasterr
, &len
);
736 /* This is to be called by main() at the very beginning */
741 gdb_lasterr
= mem_fileopen ();
744 /* Print a message reporting an internal error/warning. Ask the user
745 if they want to continue, dump core, or just exit. Return
746 something to indicate a quit. */
748 struct internal_problem
751 /* FIXME: cagney/2002-08-15: There should be ``maint set/show''
752 commands available for controlling these variables. */
753 enum auto_boolean should_quit
;
754 enum auto_boolean should_dump_core
;
757 /* Report a problem, internal to GDB, to the user. Once the problem
758 has been reported, and assuming GDB didn't quit, the caller can
759 either allow execution to resume or throw an error. */
762 internal_vproblem (struct internal_problem
*problem
,
763 const char *file
, int line
, const char *fmt
, va_list ap
)
770 /* Don't allow infinite error/warning recursion. */
772 static char msg
[] = "Recursive internal problem.\n";
780 fputs_unfiltered (msg
, gdb_stderr
);
781 abort (); /* NOTE: GDB has only three calls to abort(). */
784 write (STDERR_FILENO
, msg
, sizeof (msg
));
789 /* Try to get the message out and at the start of a new line. */
790 target_terminal_ours ();
793 /* Create a string containing the full error/warning message. Need
794 to call query with this full string, as otherwize the reason
795 (error/warning) and question become separated. Format using a
796 style similar to a compiler error message. Include extra detail
797 so that the user knows that they are living on the edge. */
800 msg
= xstrvprintf (fmt
, ap
);
801 reason
= xstrprintf ("\
803 A problem internal to GDB has been detected,\n\
804 further debugging may prove unreliable.", file
, line
, problem
->name
, msg
);
806 make_cleanup (xfree
, reason
);
809 switch (problem
->should_quit
)
811 case AUTO_BOOLEAN_AUTO
:
812 /* Default (yes/batch case) is to quit GDB. When in batch mode
813 this lessens the likelhood of GDB going into an infinate
815 quit_p
= query ("%s\nQuit this debugging session? ", reason
);
817 case AUTO_BOOLEAN_TRUE
:
820 case AUTO_BOOLEAN_FALSE
:
824 internal_error (__FILE__
, __LINE__
, "bad switch");
827 switch (problem
->should_dump_core
)
829 case AUTO_BOOLEAN_AUTO
:
830 /* Default (yes/batch case) is to dump core. This leaves a GDB
831 `dropping' so that it is easier to see that something went
833 dump_core_p
= query ("%s\nCreate a core file of GDB? ", reason
);
836 case AUTO_BOOLEAN_TRUE
:
839 case AUTO_BOOLEAN_FALSE
:
843 internal_error (__FILE__
, __LINE__
, "bad switch");
849 abort (); /* NOTE: GDB has only three calls to abort(). */
858 abort (); /* NOTE: GDB has only three calls to abort(). */
865 static struct internal_problem internal_error_problem
= {
866 "internal-error", AUTO_BOOLEAN_AUTO
, AUTO_BOOLEAN_AUTO
870 internal_verror (const char *file
, int line
, const char *fmt
, va_list ap
)
872 internal_vproblem (&internal_error_problem
, file
, line
, fmt
, ap
);
873 throw_exception (RETURN_ERROR
);
877 internal_error (const char *file
, int line
, const char *string
, ...)
880 va_start (ap
, string
);
881 internal_verror (file
, line
, string
, ap
);
885 static struct internal_problem internal_warning_problem
= {
886 "internal-warning", AUTO_BOOLEAN_AUTO
, AUTO_BOOLEAN_AUTO
890 internal_vwarning (const char *file
, int line
, const char *fmt
, va_list ap
)
892 internal_vproblem (&internal_warning_problem
, file
, line
, fmt
, ap
);
896 internal_warning (const char *file
, int line
, const char *string
, ...)
899 va_start (ap
, string
);
900 internal_vwarning (file
, line
, string
, ap
);
904 /* The strerror() function can return NULL for errno values that are
905 out of range. Provide a "safe" version that always returns a
909 safe_strerror (int errnum
)
914 msg
= strerror (errnum
);
917 sprintf (buf
, "(undocumented errno %d)", errnum
);
923 /* Print the system error message for errno, and also mention STRING
924 as the file name for which the error was encountered.
925 Then return to command level. */
928 perror_with_name (const char *string
)
933 err
= safe_strerror (errno
);
934 combined
= (char *) alloca (strlen (err
) + strlen (string
) + 3);
935 strcpy (combined
, string
);
936 strcat (combined
, ": ");
937 strcat (combined
, err
);
939 /* I understand setting these is a matter of taste. Still, some people
940 may clear errno but not know about bfd_error. Doing this here is not
942 bfd_set_error (bfd_error_no_error
);
945 error ("%s.", combined
);
948 /* Print the system error message for ERRCODE, and also mention STRING
949 as the file name for which the error was encountered. */
952 print_sys_errmsg (const char *string
, int errcode
)
957 err
= safe_strerror (errcode
);
958 combined
= (char *) alloca (strlen (err
) + strlen (string
) + 3);
959 strcpy (combined
, string
);
960 strcat (combined
, ": ");
961 strcat (combined
, err
);
963 /* We want anything which was printed on stdout to come out first, before
965 gdb_flush (gdb_stdout
);
966 fprintf_unfiltered (gdb_stderr
, "%s.\n", combined
);
969 /* Control C eventually causes this to be called, at a convenient time. */
974 struct serial
*gdb_stdout_serial
= serial_fdopen (1);
976 target_terminal_ours ();
978 /* We want all output to appear now, before we print "Quit". We
979 have 3 levels of buffering we have to flush (it's possible that
980 some of these should be changed to flush the lower-level ones
983 /* 1. The _filtered buffer. */
984 wrap_here ((char *) 0);
986 /* 2. The stdio buffer. */
987 gdb_flush (gdb_stdout
);
988 gdb_flush (gdb_stderr
);
990 /* 3. The system-level buffer. */
991 serial_drain_output (gdb_stdout_serial
);
992 serial_un_fdopen (gdb_stdout_serial
);
994 annotate_error_begin ();
996 /* Don't use *_filtered; we don't want to prompt the user to continue. */
998 fputs_unfiltered (quit_pre_print
, gdb_stderr
);
1001 /* No steenking SIGINT will ever be coming our way when the
1002 program is resumed. Don't lie. */
1003 fprintf_unfiltered (gdb_stderr
, "Quit\n");
1006 /* If there is no terminal switching for this target, then we can't
1007 possibly get screwed by the lack of job control. */
1008 || current_target
.to_terminal_ours
== NULL
)
1009 fprintf_unfiltered (gdb_stderr
, "Quit\n");
1011 fprintf_unfiltered (gdb_stderr
,
1012 "Quit (expect signal SIGINT when the program is resumed)\n");
1014 throw_exception (RETURN_QUIT
);
1017 /* Control C comes here */
1019 request_quit (int signo
)
1022 /* Restore the signal handler. Harmless with BSD-style signals,
1023 needed for System V-style signals. */
1024 signal (signo
, request_quit
);
1030 /* Called when a memory allocation fails, with the number of bytes of
1031 memory requested in SIZE. */
1038 internal_error (__FILE__
, __LINE__
,
1039 "virtual memory exhausted: can't allocate %ld bytes.",
1044 internal_error (__FILE__
, __LINE__
, "virtual memory exhausted.");
1048 /* The xmalloc() (libiberty.h) family of memory management routines.
1050 These are like the ISO-C malloc() family except that they implement
1051 consistent semantics and guard against typical memory management
1054 /* NOTE: These are declared using PTR to ensure consistency with
1055 "libiberty.h". xfree() is GDB local. */
1058 xmalloc (size_t size
)
1062 /* See libiberty/xmalloc.c. This function need's to match that's
1063 semantics. It never returns NULL. */
1067 val
= malloc (size
); /* OK: malloc */
1075 xrealloc (PTR ptr
, size_t size
) /* OK: PTR */
1079 /* See libiberty/xmalloc.c. This function need's to match that's
1080 semantics. It never returns NULL. */
1085 val
= realloc (ptr
, size
); /* OK: realloc */
1087 val
= malloc (size
); /* OK: malloc */
1095 xcalloc (size_t number
, size_t size
)
1099 /* See libiberty/xmalloc.c. This function need's to match that's
1100 semantics. It never returns NULL. */
1101 if (number
== 0 || size
== 0)
1107 mem
= calloc (number
, size
); /* OK: xcalloc */
1109 nomem (number
* size
);
1118 free (ptr
); /* OK: free */
1122 /* Like asprintf/vasprintf but get an internal_error if the call
1126 xstrprintf (const char *format
, ...)
1130 va_start (args
, format
);
1131 ret
= xstrvprintf (format
, args
);
1137 xasprintf (char **ret
, const char *format
, ...)
1140 va_start (args
, format
);
1141 (*ret
) = xstrvprintf (format
, args
);
1146 xvasprintf (char **ret
, const char *format
, va_list ap
)
1148 (*ret
) = xstrvprintf (format
, ap
);
1152 xstrvprintf (const char *format
, va_list ap
)
1155 int status
= vasprintf (&ret
, format
, ap
);
1156 /* NULL is returned when there was a memory allocation problem. */
1159 /* A negative status (the printed length) with a non-NULL buffer
1160 should never happen, but just to be sure. */
1162 internal_error (__FILE__
, __LINE__
,
1163 "vasprintf call failed (errno %d)", errno
);
1167 /* My replacement for the read system call.
1168 Used like `read' but keeps going if `read' returns too soon. */
1171 myread (int desc
, char *addr
, int len
)
1178 val
= read (desc
, addr
, len
);
1182 return orglen
- len
;
1189 /* Make a copy of the string at PTR with SIZE characters
1190 (and add a null character at the end in the copy).
1191 Uses malloc to get the space. Returns the address of the copy. */
1194 savestring (const char *ptr
, size_t size
)
1196 char *p
= (char *) xmalloc (size
+ 1);
1197 memcpy (p
, ptr
, size
);
1203 print_spaces (int n
, struct ui_file
*file
)
1205 fputs_unfiltered (n_spaces (n
), file
);
1208 /* Print a host address. */
1211 gdb_print_host_address (const void *addr
, struct ui_file
*stream
)
1214 /* We could use the %p conversion specifier to fprintf if we had any
1215 way of knowing whether this host supports it. But the following
1216 should work on the Alpha and on 32 bit machines. */
1218 fprintf_filtered (stream
, "0x%lx", (unsigned long) addr
);
1221 /* Ask user a y-or-n question and return 1 iff answer is yes.
1222 Takes three args which are given to printf to print the question.
1223 The first, a control string, should end in "? ".
1224 It should not say how to answer, because we do that. */
1228 query (const char *ctlstr
, ...)
1235 if (deprecated_query_hook
)
1237 va_start (args
, ctlstr
);
1238 return deprecated_query_hook (ctlstr
, args
);
1241 /* Automatically answer "yes" if input is not from a terminal. */
1242 if (!input_from_terminal_p ())
1247 wrap_here (""); /* Flush any buffered output */
1248 gdb_flush (gdb_stdout
);
1250 if (annotation_level
> 1)
1251 printf_filtered ("\n\032\032pre-query\n");
1253 va_start (args
, ctlstr
);
1254 vfprintf_filtered (gdb_stdout
, ctlstr
, args
);
1256 printf_filtered ("(y or n) ");
1258 if (annotation_level
> 1)
1259 printf_filtered ("\n\032\032query\n");
1262 gdb_flush (gdb_stdout
);
1264 answer
= fgetc (stdin
);
1265 clearerr (stdin
); /* in case of C-d */
1266 if (answer
== EOF
) /* C-d */
1271 /* Eat rest of input line, to EOF or newline */
1275 ans2
= fgetc (stdin
);
1278 while (ans2
!= EOF
&& ans2
!= '\n' && ans2
!= '\r');
1292 printf_filtered ("Please answer y or n.\n");
1295 if (annotation_level
> 1)
1296 printf_filtered ("\n\032\032post-query\n");
1301 /* This function supports the nquery() and yquery() functions.
1302 Ask user a y-or-n question and return 0 if answer is no, 1 if
1303 answer is yes, or default the answer to the specified default.
1304 DEFCHAR is either 'y' or 'n' and refers to the default answer.
1305 CTLSTR is the control string and should end in "? ". It should
1306 not say how to answer, because we do that.
1307 ARGS are the arguments passed along with the CTLSTR argument to
1311 defaulted_query (const char *ctlstr
, const char defchar
, va_list args
)
1317 char def_answer
, not_def_answer
;
1318 char *y_string
, *n_string
;
1320 /* Set up according to which answer is the default. */
1325 not_def_answer
= 'N';
1333 not_def_answer
= 'Y';
1338 if (deprecated_query_hook
)
1340 return deprecated_query_hook (ctlstr
, args
);
1343 /* Automatically answer default value if input is not from a terminal. */
1344 if (!input_from_terminal_p ())
1349 wrap_here (""); /* Flush any buffered output */
1350 gdb_flush (gdb_stdout
);
1352 if (annotation_level
> 1)
1353 printf_filtered ("\n\032\032pre-query\n");
1355 vfprintf_filtered (gdb_stdout
, ctlstr
, args
);
1356 printf_filtered ("(%s or %s) ", y_string
, n_string
);
1358 if (annotation_level
> 1)
1359 printf_filtered ("\n\032\032query\n");
1362 gdb_flush (gdb_stdout
);
1364 answer
= fgetc (stdin
);
1365 clearerr (stdin
); /* in case of C-d */
1366 if (answer
== EOF
) /* C-d */
1371 /* Eat rest of input line, to EOF or newline */
1375 ans2
= fgetc (stdin
);
1378 while (ans2
!= EOF
&& ans2
!= '\n' && ans2
!= '\r');
1382 /* Check answer. For the non-default, the user must specify
1383 the non-default explicitly. */
1384 if (answer
== not_def_answer
)
1386 retval
= !def_value
;
1389 /* Otherwise, for the default, the user may either specify
1390 the required input or have it default by entering nothing. */
1391 if (answer
== def_answer
|| answer
== '\n' ||
1392 answer
== '\r' || answer
== EOF
)
1397 /* Invalid entries are not defaulted and require another selection. */
1398 printf_filtered ("Please answer %s or %s.\n",
1399 y_string
, n_string
);
1402 if (annotation_level
> 1)
1403 printf_filtered ("\n\032\032post-query\n");
1408 /* Ask user a y-or-n question and return 0 if answer is no, 1 if
1409 answer is yes, or 0 if answer is defaulted.
1410 Takes three args which are given to printf to print the question.
1411 The first, a control string, should end in "? ".
1412 It should not say how to answer, because we do that. */
1415 nquery (const char *ctlstr
, ...)
1419 va_start (args
, ctlstr
);
1420 return defaulted_query (ctlstr
, 'n', args
);
1424 /* Ask user a y-or-n question and return 0 if answer is no, 1 if
1425 answer is yes, or 1 if answer is defaulted.
1426 Takes three args which are given to printf to print the question.
1427 The first, a control string, should end in "? ".
1428 It should not say how to answer, because we do that. */
1431 yquery (const char *ctlstr
, ...)
1435 va_start (args
, ctlstr
);
1436 return defaulted_query (ctlstr
, 'y', args
);
1440 /* Print an error message saying that we couldn't make sense of a
1441 \^mumble sequence in a string or character constant. START and END
1442 indicate a substring of some larger string that contains the
1443 erroneous backslash sequence, missing the initial backslash. */
1445 no_control_char_error (const char *start
, const char *end
)
1447 int len
= end
- start
;
1448 char *copy
= alloca (end
- start
+ 1);
1450 memcpy (copy
, start
, len
);
1453 error ("There is no control character `\\%s' in the `%s' character set.",
1454 copy
, target_charset ());
1457 /* Parse a C escape sequence. STRING_PTR points to a variable
1458 containing a pointer to the string to parse. That pointer
1459 should point to the character after the \. That pointer
1460 is updated past the characters we use. The value of the
1461 escape sequence is returned.
1463 A negative value means the sequence \ newline was seen,
1464 which is supposed to be equivalent to nothing at all.
1466 If \ is followed by a null character, we return a negative
1467 value and leave the string pointer pointing at the null character.
1469 If \ is followed by 000, we return 0 and leave the string pointer
1470 after the zeros. A value of 0 does not mean end of string. */
1473 parse_escape (char **string_ptr
)
1476 int c
= *(*string_ptr
)++;
1477 if (c_parse_backslash (c
, &target_char
))
1489 /* Remember where this escape sequence started, for reporting
1491 char *sequence_start_pos
= *string_ptr
- 1;
1493 c
= *(*string_ptr
)++;
1497 /* XXXCHARSET: What is `delete' in the host character set? */
1500 if (!host_char_to_target (c
, &target_char
))
1501 error ("There is no character corresponding to `Delete' "
1502 "in the target character set `%s'.", host_charset ());
1507 target_char
= parse_escape (string_ptr
);
1510 if (!host_char_to_target (c
, &target_char
))
1511 no_control_char_error (sequence_start_pos
, *string_ptr
);
1514 /* Now target_char is something like `c', and we want to find
1515 its control-character equivalent. */
1516 if (!target_char_to_control_char (target_char
, &target_char
))
1517 no_control_char_error (sequence_start_pos
, *string_ptr
);
1522 /* XXXCHARSET: we need to use isdigit and value-of-digit
1523 methods of the host character set here. */
1539 if (c
>= '0' && c
<= '7')
1553 if (!host_char_to_target (c
, &target_char
))
1555 ("The escape sequence `\%c' is equivalent to plain `%c', which"
1556 " has no equivalent\n" "in the `%s' character set.", c
, c
,
1562 /* Print the character C on STREAM as part of the contents of a literal
1563 string whose delimiter is QUOTER. Note that this routine should only
1564 be call for printing things which are independent of the language
1565 of the program being debugged. */
1568 printchar (int c
, void (*do_fputs
) (const char *, struct ui_file
*),
1569 void (*do_fprintf
) (struct ui_file
*, const char *, ...),
1570 struct ui_file
*stream
, int quoter
)
1573 c
&= 0xFF; /* Avoid sign bit follies */
1575 if (c
< 0x20 || /* Low control chars */
1576 (c
>= 0x7F && c
< 0xA0) || /* DEL, High controls */
1577 (sevenbit_strings
&& c
>= 0x80))
1578 { /* high order bit set */
1582 do_fputs ("\\n", stream
);
1585 do_fputs ("\\b", stream
);
1588 do_fputs ("\\t", stream
);
1591 do_fputs ("\\f", stream
);
1594 do_fputs ("\\r", stream
);
1597 do_fputs ("\\e", stream
);
1600 do_fputs ("\\a", stream
);
1603 do_fprintf (stream
, "\\%.3o", (unsigned int) c
);
1609 if (c
== '\\' || c
== quoter
)
1610 do_fputs ("\\", stream
);
1611 do_fprintf (stream
, "%c", c
);
1615 /* Print the character C on STREAM as part of the contents of a
1616 literal string whose delimiter is QUOTER. Note that these routines
1617 should only be call for printing things which are independent of
1618 the language of the program being debugged. */
1621 fputstr_filtered (const char *str
, int quoter
, struct ui_file
*stream
)
1624 printchar (*str
++, fputs_filtered
, fprintf_filtered
, stream
, quoter
);
1628 fputstr_unfiltered (const char *str
, int quoter
, struct ui_file
*stream
)
1631 printchar (*str
++, fputs_unfiltered
, fprintf_unfiltered
, stream
, quoter
);
1635 fputstrn_unfiltered (const char *str
, int n
, int quoter
,
1636 struct ui_file
*stream
)
1639 for (i
= 0; i
< n
; i
++)
1640 printchar (str
[i
], fputs_unfiltered
, fprintf_unfiltered
, stream
, quoter
);
1644 /* Number of lines per page or UINT_MAX if paging is disabled. */
1645 static unsigned int lines_per_page
;
1647 /* Number of chars per line or UINT_MAX if line folding is disabled. */
1648 static unsigned int chars_per_line
;
1650 /* Current count of lines printed on this page, chars on this line. */
1651 static unsigned int lines_printed
, chars_printed
;
1653 /* Buffer and start column of buffered text, for doing smarter word-
1654 wrapping. When someone calls wrap_here(), we start buffering output
1655 that comes through fputs_filtered(). If we see a newline, we just
1656 spit it out and forget about the wrap_here(). If we see another
1657 wrap_here(), we spit it out and remember the newer one. If we see
1658 the end of the line, we spit out a newline, the indent, and then
1659 the buffered output. */
1661 /* Malloc'd buffer with chars_per_line+2 bytes. Contains characters which
1662 are waiting to be output (they have already been counted in chars_printed).
1663 When wrap_buffer[0] is null, the buffer is empty. */
1664 static char *wrap_buffer
;
1666 /* Pointer in wrap_buffer to the next character to fill. */
1667 static char *wrap_pointer
;
1669 /* String to indent by if the wrap occurs. Must not be NULL if wrap_column
1671 static char *wrap_indent
;
1673 /* Column number on the screen where wrap_buffer begins, or 0 if wrapping
1674 is not in effect. */
1675 static int wrap_column
;
1678 /* Inialize the number of lines per page and chars per line. */
1681 init_page_info (void)
1684 if (!tui_get_command_dimension (&chars_per_line
, &lines_per_page
))
1689 #if defined(__GO32__)
1690 rows
= ScreenRows ();
1691 cols
= ScreenCols ();
1692 lines_per_page
= rows
;
1693 chars_per_line
= cols
;
1695 /* Make sure Readline has initialized its terminal settings. */
1696 rl_reset_terminal (NULL
);
1698 /* Get the screen size from Readline. */
1699 rl_get_screen_size (&rows
, &cols
);
1700 lines_per_page
= rows
;
1701 chars_per_line
= cols
;
1703 /* Readline should have fetched the termcap entry for us. */
1704 if (tgetnum ("li") < 0 || getenv ("EMACS"))
1706 /* The number of lines per page is not mentioned in the
1707 terminal description. This probably means that paging is
1708 not useful (e.g. emacs shell window), so disable paging. */
1709 lines_per_page
= UINT_MAX
;
1712 /* FIXME: Get rid of this junk. */
1713 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1714 SIGWINCH_HANDLER (SIGWINCH
);
1717 /* If the output is not a terminal, don't paginate it. */
1718 if (!ui_file_isatty (gdb_stdout
))
1719 lines_per_page
= UINT_MAX
;
1727 /* Set the screen size based on LINES_PER_PAGE and CHARS_PER_LINE. */
1730 set_screen_size (void)
1732 int rows
= lines_per_page
;
1733 int cols
= chars_per_line
;
1739 rl_get_screen_size (NULL
, &cols
);
1741 /* Update Readline's idea of the terminal size. */
1742 rl_set_screen_size (rows
, cols
);
1745 /* Reinitialize WRAP_BUFFER according to the current value of
1751 if (chars_per_line
== 0)
1756 wrap_buffer
= (char *) xmalloc (chars_per_line
+ 2);
1757 wrap_buffer
[0] = '\0';
1760 wrap_buffer
= (char *) xrealloc (wrap_buffer
, chars_per_line
+ 2);
1761 wrap_pointer
= wrap_buffer
; /* Start it at the beginning. */
1765 set_width_command (char *args
, int from_tty
, struct cmd_list_element
*c
)
1772 set_height_command (char *args
, int from_tty
, struct cmd_list_element
*c
)
1777 /* Wait, so the user can read what's on the screen. Prompt the user
1778 to continue by pressing RETURN. */
1781 prompt_for_continue (void)
1784 char cont_prompt
[120];
1786 if (annotation_level
> 1)
1787 printf_unfiltered ("\n\032\032pre-prompt-for-continue\n");
1789 strcpy (cont_prompt
,
1790 "---Type <return> to continue, or q <return> to quit---");
1791 if (annotation_level
> 1)
1792 strcat (cont_prompt
, "\n\032\032prompt-for-continue\n");
1794 /* We must do this *before* we call gdb_readline, else it will eventually
1795 call us -- thinking that we're trying to print beyond the end of the
1797 reinitialize_more_filter ();
1800 /* On a real operating system, the user can quit with SIGINT.
1803 'q' is provided on all systems so users don't have to change habits
1804 from system to system, and because telling them what to do in
1805 the prompt is more user-friendly than expecting them to think of
1807 /* Call readline, not gdb_readline, because GO32 readline handles control-C
1808 whereas control-C to gdb_readline will cause the user to get dumped
1810 ignore
= gdb_readline_wrapper (cont_prompt
);
1812 if (annotation_level
> 1)
1813 printf_unfiltered ("\n\032\032post-prompt-for-continue\n");
1818 while (*p
== ' ' || *p
== '\t')
1821 async_request_quit (0);
1826 /* Now we have to do this again, so that GDB will know that it doesn't
1827 need to save the ---Type <return>--- line at the top of the screen. */
1828 reinitialize_more_filter ();
1830 dont_repeat (); /* Forget prev cmd -- CR won't repeat it. */
1833 /* Reinitialize filter; ie. tell it to reset to original values. */
1836 reinitialize_more_filter (void)
1842 /* Indicate that if the next sequence of characters overflows the line,
1843 a newline should be inserted here rather than when it hits the end.
1844 If INDENT is non-null, it is a string to be printed to indent the
1845 wrapped part on the next line. INDENT must remain accessible until
1846 the next call to wrap_here() or until a newline is printed through
1849 If the line is already overfull, we immediately print a newline and
1850 the indentation, and disable further wrapping.
1852 If we don't know the width of lines, but we know the page height,
1853 we must not wrap words, but should still keep track of newlines
1854 that were explicitly printed.
1856 INDENT should not contain tabs, as that will mess up the char count
1857 on the next line. FIXME.
1859 This routine is guaranteed to force out any output which has been
1860 squirreled away in the wrap_buffer, so wrap_here ((char *)0) can be
1861 used to force out output from the wrap_buffer. */
1864 wrap_here (char *indent
)
1866 /* This should have been allocated, but be paranoid anyway. */
1868 internal_error (__FILE__
, __LINE__
, "failed internal consistency check");
1872 *wrap_pointer
= '\0';
1873 fputs_unfiltered (wrap_buffer
, gdb_stdout
);
1875 wrap_pointer
= wrap_buffer
;
1876 wrap_buffer
[0] = '\0';
1877 if (chars_per_line
== UINT_MAX
) /* No line overflow checking */
1881 else if (chars_printed
>= chars_per_line
)
1883 puts_filtered ("\n");
1885 puts_filtered (indent
);
1890 wrap_column
= chars_printed
;
1894 wrap_indent
= indent
;
1898 /* Print input string to gdb_stdout, filtered, with wrap,
1899 arranging strings in columns of n chars. String can be
1900 right or left justified in the column. Never prints
1901 trailing spaces. String should never be longer than
1902 width. FIXME: this could be useful for the EXAMINE
1903 command, which currently doesn't tabulate very well */
1906 puts_filtered_tabular (char *string
, int width
, int right
)
1912 gdb_assert (chars_per_line
> 0);
1913 if (chars_per_line
== UINT_MAX
)
1915 fputs_filtered (string
, gdb_stdout
);
1916 fputs_filtered ("\n", gdb_stdout
);
1920 if (((chars_printed
- 1) / width
+ 2) * width
>= chars_per_line
)
1921 fputs_filtered ("\n", gdb_stdout
);
1923 if (width
>= chars_per_line
)
1924 width
= chars_per_line
- 1;
1926 stringlen
= strlen (string
);
1928 if (chars_printed
> 0)
1929 spaces
= width
- (chars_printed
- 1) % width
- 1;
1931 spaces
+= width
- stringlen
;
1933 spacebuf
= alloca (spaces
+ 1);
1934 spacebuf
[spaces
] = '\0';
1936 spacebuf
[spaces
] = ' ';
1938 fputs_filtered (spacebuf
, gdb_stdout
);
1939 fputs_filtered (string
, gdb_stdout
);
1943 /* Ensure that whatever gets printed next, using the filtered output
1944 commands, starts at the beginning of the line. I.E. if there is
1945 any pending output for the current line, flush it and start a new
1946 line. Otherwise do nothing. */
1951 if (chars_printed
> 0)
1953 puts_filtered ("\n");
1958 /* Like fputs but if FILTER is true, pause after every screenful.
1960 Regardless of FILTER can wrap at points other than the final
1961 character of a line.
1963 Unlike fputs, fputs_maybe_filtered does not return a value.
1964 It is OK for LINEBUFFER to be NULL, in which case just don't print
1967 Note that a longjmp to top level may occur in this routine (only if
1968 FILTER is true) (since prompt_for_continue may do so) so this
1969 routine should not be called when cleanups are not in place. */
1972 fputs_maybe_filtered (const char *linebuffer
, struct ui_file
*stream
,
1975 const char *lineptr
;
1977 if (linebuffer
== 0)
1980 /* Don't do any filtering if it is disabled. */
1981 if ((stream
!= gdb_stdout
) || !pagination_enabled
1982 || (lines_per_page
== UINT_MAX
&& chars_per_line
== UINT_MAX
))
1984 fputs_unfiltered (linebuffer
, stream
);
1988 /* Go through and output each character. Show line extension
1989 when this is necessary; prompt user for new page when this is
1992 lineptr
= linebuffer
;
1995 /* Possible new page. */
1996 if (filter
&& (lines_printed
>= lines_per_page
- 1))
1997 prompt_for_continue ();
1999 while (*lineptr
&& *lineptr
!= '\n')
2001 /* Print a single line. */
2002 if (*lineptr
== '\t')
2005 *wrap_pointer
++ = '\t';
2007 fputc_unfiltered ('\t', stream
);
2008 /* Shifting right by 3 produces the number of tab stops
2009 we have already passed, and then adding one and
2010 shifting left 3 advances to the next tab stop. */
2011 chars_printed
= ((chars_printed
>> 3) + 1) << 3;
2017 *wrap_pointer
++ = *lineptr
;
2019 fputc_unfiltered (*lineptr
, stream
);
2024 if (chars_printed
>= chars_per_line
)
2026 unsigned int save_chars
= chars_printed
;
2030 /* If we aren't actually wrapping, don't output newline --
2031 if chars_per_line is right, we probably just overflowed
2032 anyway; if it's wrong, let us keep going. */
2034 fputc_unfiltered ('\n', stream
);
2036 /* Possible new page. */
2037 if (lines_printed
>= lines_per_page
- 1)
2038 prompt_for_continue ();
2040 /* Now output indentation and wrapped string */
2043 fputs_unfiltered (wrap_indent
, stream
);
2044 *wrap_pointer
= '\0'; /* Null-terminate saved stuff */
2045 fputs_unfiltered (wrap_buffer
, stream
); /* and eject it */
2046 /* FIXME, this strlen is what prevents wrap_indent from
2047 containing tabs. However, if we recurse to print it
2048 and count its chars, we risk trouble if wrap_indent is
2049 longer than (the user settable) chars_per_line.
2050 Note also that this can set chars_printed > chars_per_line
2051 if we are printing a long string. */
2052 chars_printed
= strlen (wrap_indent
)
2053 + (save_chars
- wrap_column
);
2054 wrap_pointer
= wrap_buffer
; /* Reset buffer */
2055 wrap_buffer
[0] = '\0';
2056 wrap_column
= 0; /* And disable fancy wrap */
2061 if (*lineptr
== '\n')
2064 wrap_here ((char *) 0); /* Spit out chars, cancel further wraps */
2066 fputc_unfiltered ('\n', stream
);
2073 fputs_filtered (const char *linebuffer
, struct ui_file
*stream
)
2075 fputs_maybe_filtered (linebuffer
, stream
, 1);
2079 putchar_unfiltered (int c
)
2082 ui_file_write (gdb_stdout
, &buf
, 1);
2086 /* Write character C to gdb_stdout using GDB's paging mechanism and return C.
2087 May return nonlocally. */
2090 putchar_filtered (int c
)
2092 return fputc_filtered (c
, gdb_stdout
);
2096 fputc_unfiltered (int c
, struct ui_file
*stream
)
2099 ui_file_write (stream
, &buf
, 1);
2104 fputc_filtered (int c
, struct ui_file
*stream
)
2110 fputs_filtered (buf
, stream
);
2114 /* puts_debug is like fputs_unfiltered, except it prints special
2115 characters in printable fashion. */
2118 puts_debug (char *prefix
, char *string
, char *suffix
)
2122 /* Print prefix and suffix after each line. */
2123 static int new_line
= 1;
2124 static int return_p
= 0;
2125 static char *prev_prefix
= "";
2126 static char *prev_suffix
= "";
2128 if (*string
== '\n')
2131 /* If the prefix is changing, print the previous suffix, a new line,
2132 and the new prefix. */
2133 if ((return_p
|| (strcmp (prev_prefix
, prefix
) != 0)) && !new_line
)
2135 fputs_unfiltered (prev_suffix
, gdb_stdlog
);
2136 fputs_unfiltered ("\n", gdb_stdlog
);
2137 fputs_unfiltered (prefix
, gdb_stdlog
);
2140 /* Print prefix if we printed a newline during the previous call. */
2144 fputs_unfiltered (prefix
, gdb_stdlog
);
2147 prev_prefix
= prefix
;
2148 prev_suffix
= suffix
;
2150 /* Output characters in a printable format. */
2151 while ((ch
= *string
++) != '\0')
2157 fputc_unfiltered (ch
, gdb_stdlog
);
2160 fprintf_unfiltered (gdb_stdlog
, "\\x%02x", ch
& 0xff);
2164 fputs_unfiltered ("\\\\", gdb_stdlog
);
2167 fputs_unfiltered ("\\b", gdb_stdlog
);
2170 fputs_unfiltered ("\\f", gdb_stdlog
);
2174 fputs_unfiltered ("\\n", gdb_stdlog
);
2177 fputs_unfiltered ("\\r", gdb_stdlog
);
2180 fputs_unfiltered ("\\t", gdb_stdlog
);
2183 fputs_unfiltered ("\\v", gdb_stdlog
);
2187 return_p
= ch
== '\r';
2190 /* Print suffix if we printed a newline. */
2193 fputs_unfiltered (suffix
, gdb_stdlog
);
2194 fputs_unfiltered ("\n", gdb_stdlog
);
2199 /* Print a variable number of ARGS using format FORMAT. If this
2200 information is going to put the amount written (since the last call
2201 to REINITIALIZE_MORE_FILTER or the last page break) over the page size,
2202 call prompt_for_continue to get the users permision to continue.
2204 Unlike fprintf, this function does not return a value.
2206 We implement three variants, vfprintf (takes a vararg list and stream),
2207 fprintf (takes a stream to write on), and printf (the usual).
2209 Note also that a longjmp to top level may occur in this routine
2210 (since prompt_for_continue may do so) so this routine should not be
2211 called when cleanups are not in place. */
2214 vfprintf_maybe_filtered (struct ui_file
*stream
, const char *format
,
2215 va_list args
, int filter
)
2218 struct cleanup
*old_cleanups
;
2220 linebuffer
= xstrvprintf (format
, args
);
2221 old_cleanups
= make_cleanup (xfree
, linebuffer
);
2222 fputs_maybe_filtered (linebuffer
, stream
, filter
);
2223 do_cleanups (old_cleanups
);
2228 vfprintf_filtered (struct ui_file
*stream
, const char *format
, va_list args
)
2230 vfprintf_maybe_filtered (stream
, format
, args
, 1);
2234 vfprintf_unfiltered (struct ui_file
*stream
, const char *format
, va_list args
)
2237 struct cleanup
*old_cleanups
;
2239 linebuffer
= xstrvprintf (format
, args
);
2240 old_cleanups
= make_cleanup (xfree
, linebuffer
);
2241 fputs_unfiltered (linebuffer
, stream
);
2242 do_cleanups (old_cleanups
);
2246 vprintf_filtered (const char *format
, va_list args
)
2248 vfprintf_maybe_filtered (gdb_stdout
, format
, args
, 1);
2252 vprintf_unfiltered (const char *format
, va_list args
)
2254 vfprintf_unfiltered (gdb_stdout
, format
, args
);
2258 fprintf_filtered (struct ui_file
*stream
, const char *format
, ...)
2261 va_start (args
, format
);
2262 vfprintf_filtered (stream
, format
, args
);
2267 fprintf_unfiltered (struct ui_file
*stream
, const char *format
, ...)
2270 va_start (args
, format
);
2271 vfprintf_unfiltered (stream
, format
, args
);
2275 /* Like fprintf_filtered, but prints its result indented.
2276 Called as fprintfi_filtered (spaces, stream, format, ...); */
2279 fprintfi_filtered (int spaces
, struct ui_file
*stream
, const char *format
,
2283 va_start (args
, format
);
2284 print_spaces_filtered (spaces
, stream
);
2286 vfprintf_filtered (stream
, format
, args
);
2292 printf_filtered (const char *format
, ...)
2295 va_start (args
, format
);
2296 vfprintf_filtered (gdb_stdout
, format
, args
);
2302 printf_unfiltered (const char *format
, ...)
2305 va_start (args
, format
);
2306 vfprintf_unfiltered (gdb_stdout
, format
, args
);
2310 /* Like printf_filtered, but prints it's result indented.
2311 Called as printfi_filtered (spaces, format, ...); */
2314 printfi_filtered (int spaces
, const char *format
, ...)
2317 va_start (args
, format
);
2318 print_spaces_filtered (spaces
, gdb_stdout
);
2319 vfprintf_filtered (gdb_stdout
, format
, args
);
2323 /* Easy -- but watch out!
2325 This routine is *not* a replacement for puts()! puts() appends a newline.
2326 This one doesn't, and had better not! */
2329 puts_filtered (const char *string
)
2331 fputs_filtered (string
, gdb_stdout
);
2335 puts_unfiltered (const char *string
)
2337 fputs_unfiltered (string
, gdb_stdout
);
2340 /* Return a pointer to N spaces and a null. The pointer is good
2341 until the next call to here. */
2346 static char *spaces
= 0;
2347 static int max_spaces
= -1;
2353 spaces
= (char *) xmalloc (n
+ 1);
2354 for (t
= spaces
+ n
; t
!= spaces
;)
2360 return spaces
+ max_spaces
- n
;
2363 /* Print N spaces. */
2365 print_spaces_filtered (int n
, struct ui_file
*stream
)
2367 fputs_filtered (n_spaces (n
), stream
);
2370 /* C++/ObjC demangler stuff. */
2372 /* fprintf_symbol_filtered attempts to demangle NAME, a symbol in language
2373 LANG, using demangling args ARG_MODE, and print it filtered to STREAM.
2374 If the name is not mangled, or the language for the name is unknown, or
2375 demangling is off, the name is printed in its "raw" form. */
2378 fprintf_symbol_filtered (struct ui_file
*stream
, char *name
,
2379 enum language lang
, int arg_mode
)
2385 /* If user wants to see raw output, no problem. */
2388 fputs_filtered (name
, stream
);
2392 demangled
= language_demangle (language_def (lang
), name
, arg_mode
);
2393 fputs_filtered (demangled
? demangled
: name
, stream
);
2394 if (demangled
!= NULL
)
2402 /* Do a strcmp() type operation on STRING1 and STRING2, ignoring any
2403 differences in whitespace. Returns 0 if they match, non-zero if they
2404 don't (slightly different than strcmp()'s range of return values).
2406 As an extra hack, string1=="FOO(ARGS)" matches string2=="FOO".
2407 This "feature" is useful when searching for matching C++ function names
2408 (such as if the user types 'break FOO', where FOO is a mangled C++
2412 strcmp_iw (const char *string1
, const char *string2
)
2414 while ((*string1
!= '\0') && (*string2
!= '\0'))
2416 while (isspace (*string1
))
2420 while (isspace (*string2
))
2424 if (*string1
!= *string2
)
2428 if (*string1
!= '\0')
2434 return (*string1
!= '\0' && *string1
!= '(') || (*string2
!= '\0');
2437 /* This is like strcmp except that it ignores whitespace and treats
2438 '(' as the first non-NULL character in terms of ordering. Like
2439 strcmp (and unlike strcmp_iw), it returns negative if STRING1 <
2440 STRING2, 0 if STRING2 = STRING2, and positive if STRING1 > STRING2
2441 according to that ordering.
2443 If a list is sorted according to this function and if you want to
2444 find names in the list that match some fixed NAME according to
2445 strcmp_iw(LIST_ELT, NAME), then the place to start looking is right
2446 where this function would put NAME.
2448 Here are some examples of why using strcmp to sort is a bad idea:
2452 Say your partial symtab contains: "foo<char *>", "goo". Then, if
2453 we try to do a search for "foo<char*>", strcmp will locate this
2454 after "foo<char *>" and before "goo". Then lookup_partial_symbol
2455 will start looking at strings beginning with "goo", and will never
2456 see the correct match of "foo<char *>".
2458 Parenthesis example:
2460 In practice, this is less like to be an issue, but I'll give it a
2461 shot. Let's assume that '$' is a legitimate character to occur in
2462 symbols. (Which may well even be the case on some systems.) Then
2463 say that the partial symbol table contains "foo$" and "foo(int)".
2464 strcmp will put them in this order, since '$' < '('. Now, if the
2465 user searches for "foo", then strcmp will sort "foo" before "foo$".
2466 Then lookup_partial_symbol will notice that strcmp_iw("foo$",
2467 "foo") is false, so it won't proceed to the actual match of
2468 "foo(int)" with "foo". */
2471 strcmp_iw_ordered (const char *string1
, const char *string2
)
2473 while ((*string1
!= '\0') && (*string2
!= '\0'))
2475 while (isspace (*string1
))
2479 while (isspace (*string2
))
2483 if (*string1
!= *string2
)
2487 if (*string1
!= '\0')
2496 /* Characters are non-equal unless they're both '\0'; we want to
2497 make sure we get the comparison right according to our
2498 comparison in the cases where one of them is '\0' or '('. */
2500 if (*string2
== '\0')
2505 if (*string2
== '\0')
2510 if (*string2
== '(')
2513 return *string1
- *string2
;
2517 /* A simple comparison function with opposite semantics to strcmp. */
2520 streq (const char *lhs
, const char *rhs
)
2522 return !strcmp (lhs
, rhs
);
2528 ** Answer whether string_to_compare is a full or partial match to
2529 ** template_string. The partial match must be in sequence starting
2533 subset_compare (char *string_to_compare
, char *template_string
)
2536 if (template_string
!= (char *) NULL
&& string_to_compare
!= (char *) NULL
2537 && strlen (string_to_compare
) <= strlen (template_string
))
2540 (template_string
, string_to_compare
, strlen (string_to_compare
)) == 0);
2547 static void pagination_on_command (char *arg
, int from_tty
);
2549 pagination_on_command (char *arg
, int from_tty
)
2551 pagination_enabled
= 1;
2554 static void pagination_on_command (char *arg
, int from_tty
);
2556 pagination_off_command (char *arg
, int from_tty
)
2558 pagination_enabled
= 0;
2563 initialize_utils (void)
2565 struct cmd_list_element
*c
;
2567 c
= add_set_cmd ("width", class_support
, var_uinteger
, &chars_per_line
,
2568 "Set number of characters gdb thinks are in a line.",
2570 deprecated_add_show_from_set (c
, &showlist
);
2571 set_cmd_sfunc (c
, set_width_command
);
2573 c
= add_set_cmd ("height", class_support
, var_uinteger
, &lines_per_page
,
2574 "Set number of lines gdb thinks are in a page.", &setlist
);
2575 deprecated_add_show_from_set (c
, &showlist
);
2576 set_cmd_sfunc (c
, set_height_command
);
2580 deprecated_add_show_from_set
2581 (add_set_cmd ("demangle", class_support
, var_boolean
,
2583 "Set demangling of encoded C++/ObjC names when displaying symbols.",
2584 &setprintlist
), &showprintlist
);
2586 deprecated_add_show_from_set
2587 (add_set_cmd ("pagination", class_support
,
2588 var_boolean
, (char *) &pagination_enabled
,
2589 "Set state of pagination.", &setlist
), &showlist
);
2593 add_com ("am", class_support
, pagination_on_command
,
2594 "Enable pagination");
2595 add_com ("sm", class_support
, pagination_off_command
,
2596 "Disable pagination");
2599 deprecated_add_show_from_set
2600 (add_set_cmd ("sevenbit-strings", class_support
, var_boolean
,
2601 (char *) &sevenbit_strings
,
2602 "Set printing of 8-bit characters in strings as \\nnn.",
2603 &setprintlist
), &showprintlist
);
2605 deprecated_add_show_from_set
2606 (add_set_cmd ("asm-demangle", class_support
, var_boolean
,
2607 (char *) &asm_demangle
,
2608 "Set demangling of C++/ObjC names in disassembly listings.",
2609 &setprintlist
), &showprintlist
);
2612 /* Machine specific function to handle SIGWINCH signal. */
2614 #ifdef SIGWINCH_HANDLER_BODY
2615 SIGWINCH_HANDLER_BODY
2617 /* print routines to handle variable size regs, etc. */
2618 /* temporary storage using circular buffer */
2624 static char buf
[NUMCELLS
][CELLSIZE
];
2625 static int cell
= 0;
2626 if (++cell
>= NUMCELLS
)
2634 return (TARGET_ADDR_BIT
/ 8 * 2);
2638 paddr (CORE_ADDR addr
)
2640 return phex (addr
, TARGET_ADDR_BIT
/ 8);
2644 paddr_nz (CORE_ADDR addr
)
2646 return phex_nz (addr
, TARGET_ADDR_BIT
/ 8);
2650 decimal2str (char *paddr_str
, char *sign
, ULONGEST addr
, int width
)
2652 /* steal code from valprint.c:print_decimal(). Should this worry
2653 about the real size of addr as the above does? */
2654 unsigned long temp
[3];
2658 temp
[i
] = addr
% (1000 * 1000 * 1000);
2659 addr
/= (1000 * 1000 * 1000);
2663 while (addr
!= 0 && i
< (sizeof (temp
) / sizeof (temp
[0])));
2670 sprintf (paddr_str
, "%s%0*lu", sign
, width
, temp
[0]);
2673 sprintf (paddr_str
, "%s%0*lu%09lu", sign
, width
, temp
[1], temp
[0]);
2676 sprintf (paddr_str
, "%s%0*lu%09lu%09lu", sign
, width
,
2677 temp
[2], temp
[1], temp
[0]);
2680 internal_error (__FILE__
, __LINE__
,
2681 "failed internal consistency check");
2686 octal2str (char *paddr_str
, ULONGEST addr
, int width
)
2688 unsigned long temp
[3];
2692 temp
[i
] = addr
% (0100000 * 0100000);
2693 addr
/= (0100000 * 0100000);
2697 while (addr
!= 0 && i
< (sizeof (temp
) / sizeof (temp
[0])));
2705 sprintf (paddr_str
, "%*o", width
, 0);
2707 sprintf (paddr_str
, "0%0*lo", width
, temp
[0]);
2710 sprintf (paddr_str
, "0%0*lo%010lo", width
, temp
[1], temp
[0]);
2713 sprintf (paddr_str
, "0%0*lo%010lo%010lo", width
,
2714 temp
[2], temp
[1], temp
[0]);
2717 internal_error (__FILE__
, __LINE__
,
2718 "failed internal consistency check");
2723 paddr_u (CORE_ADDR addr
)
2725 char *paddr_str
= get_cell ();
2726 decimal2str (paddr_str
, "", addr
, 0);
2731 paddr_d (LONGEST addr
)
2733 char *paddr_str
= get_cell ();
2735 decimal2str (paddr_str
, "-", -addr
, 0);
2737 decimal2str (paddr_str
, "", addr
, 0);
2741 /* eliminate warning from compiler on 32-bit systems */
2742 static int thirty_two
= 32;
2745 phex (ULONGEST l
, int sizeof_l
)
2752 sprintf (str
, "%08lx%08lx",
2753 (unsigned long) (l
>> thirty_two
),
2754 (unsigned long) (l
& 0xffffffff));
2758 sprintf (str
, "%08lx", (unsigned long) l
);
2762 sprintf (str
, "%04x", (unsigned short) (l
& 0xffff));
2765 str
= phex (l
, sizeof (l
));
2772 phex_nz (ULONGEST l
, int sizeof_l
)
2779 unsigned long high
= (unsigned long) (l
>> thirty_two
);
2782 sprintf (str
, "%lx", (unsigned long) (l
& 0xffffffff));
2784 sprintf (str
, "%lx%08lx", high
, (unsigned long) (l
& 0xffffffff));
2789 sprintf (str
, "%lx", (unsigned long) l
);
2793 sprintf (str
, "%x", (unsigned short) (l
& 0xffff));
2796 str
= phex_nz (l
, sizeof (l
));
2802 /* Converts a LONGEST to a C-format hexadecimal literal and stores it
2803 in a static string. Returns a pointer to this string. */
2805 hex_string (LONGEST num
)
2807 char *result
= get_cell ();
2808 snprintf (result
, CELLSIZE
, "0x%s", phex_nz (num
, sizeof (num
)));
2812 /* Converts a LONGEST number to a C-format hexadecimal literal and
2813 stores it in a static string. Returns a pointer to this string
2814 that is valid until the next call. The number is padded on the
2815 left with 0s to at least WIDTH characters. */
2817 hex_string_custom (LONGEST num
, int width
)
2819 char *result
= get_cell ();
2820 char *result_end
= result
+ CELLSIZE
- 1;
2821 const char *hex
= phex_nz (num
, sizeof (num
));
2822 int hex_len
= strlen (hex
);
2824 if (hex_len
> width
)
2826 if (width
+ 2 >= CELLSIZE
)
2827 internal_error (__FILE__
, __LINE__
,
2828 "hex_string_custom: insufficient space to store result");
2830 strcpy (result_end
- width
- 2, "0x");
2831 memset (result_end
- width
, '0', width
);
2832 strcpy (result_end
- hex_len
, hex
);
2833 return result_end
- width
- 2;
2836 /* Convert VAL to a numeral in the given radix. For
2837 * radix 10, IS_SIGNED may be true, indicating a signed quantity;
2838 * otherwise VAL is interpreted as unsigned. If WIDTH is supplied,
2839 * it is the minimum width (0-padded if needed). USE_C_FORMAT means
2840 * to use C format in all cases. If it is false, then 'x'
2841 * and 'o' formats do not include a prefix (0x or leading 0). */
2844 int_string (LONGEST val
, int radix
, int is_signed
, int width
,
2853 result
= hex_string (val
);
2855 result
= hex_string_custom (val
, width
);
2862 char *result
= get_cell ();
2863 if (is_signed
&& val
< 0)
2864 decimal2str (result
, "-", -val
, width
);
2866 decimal2str (result
, "", val
, width
);
2871 char *result
= get_cell ();
2872 octal2str (result
, val
, width
);
2873 if (use_c_format
|| val
== 0)
2879 internal_error (__FILE__
, __LINE__
,
2880 "failed internal consistency check");
2884 /* Convert a CORE_ADDR into a string. */
2886 core_addr_to_string (const CORE_ADDR addr
)
2888 char *str
= get_cell ();
2890 strcat (str
, phex (addr
, sizeof (addr
)));
2895 core_addr_to_string_nz (const CORE_ADDR addr
)
2897 char *str
= get_cell ();
2899 strcat (str
, phex_nz (addr
, sizeof (addr
)));
2903 /* Convert a string back into a CORE_ADDR. */
2905 string_to_core_addr (const char *my_string
)
2908 if (my_string
[0] == '0' && tolower (my_string
[1]) == 'x')
2910 /* Assume that it is in decimal. */
2912 for (i
= 2; my_string
[i
] != '\0'; i
++)
2914 if (isdigit (my_string
[i
]))
2915 addr
= (my_string
[i
] - '0') + (addr
* 16);
2916 else if (isxdigit (my_string
[i
]))
2917 addr
= (tolower (my_string
[i
]) - 'a' + 0xa) + (addr
* 16);
2919 internal_error (__FILE__
, __LINE__
, "invalid hex");
2924 /* Assume that it is in decimal. */
2926 for (i
= 0; my_string
[i
] != '\0'; i
++)
2928 if (isdigit (my_string
[i
]))
2929 addr
= (my_string
[i
] - '0') + (addr
* 10);
2931 internal_error (__FILE__
, __LINE__
, "invalid decimal");
2938 gdb_realpath (const char *filename
)
2940 /* Method 1: The system has a compile time upper bound on a filename
2941 path. Use that and realpath() to canonicalize the name. This is
2942 the most common case. Note that, if there isn't a compile time
2943 upper bound, you want to avoid realpath() at all costs. */
2944 #if defined(HAVE_REALPATH)
2946 # if defined (PATH_MAX)
2948 # define USE_REALPATH
2949 # elif defined (MAXPATHLEN)
2950 char buf
[MAXPATHLEN
];
2951 # define USE_REALPATH
2953 # if defined (USE_REALPATH)
2954 const char *rp
= realpath (filename
, buf
);
2957 return xstrdup (rp
);
2960 #endif /* HAVE_REALPATH */
2962 /* Method 2: The host system (i.e., GNU) has the function
2963 canonicalize_file_name() which malloc's a chunk of memory and
2964 returns that, use that. */
2965 #if defined(HAVE_CANONICALIZE_FILE_NAME)
2967 char *rp
= canonicalize_file_name (filename
);
2969 return xstrdup (filename
);
2975 /* FIXME: cagney/2002-11-13:
2977 Method 2a: Use realpath() with a NULL buffer. Some systems, due
2978 to the problems described in in method 3, have modified their
2979 realpath() implementation so that it will allocate a buffer when
2980 NULL is passed in. Before this can be used, though, some sort of
2981 configure time test would need to be added. Otherwize the code
2982 will likely core dump. */
2984 /* Method 3: Now we're getting desperate! The system doesn't have a
2985 compile time buffer size and no alternative function. Query the
2986 OS, using pathconf(), for the buffer limit. Care is needed
2987 though, some systems do not limit PATH_MAX (return -1 for
2988 pathconf()) making it impossible to pass a correctly sized buffer
2989 to realpath() (it could always overflow). On those systems, we
2991 #if defined (HAVE_REALPATH) && defined (HAVE_UNISTD_H) && defined(HAVE_ALLOCA)
2993 /* Find out the max path size. */
2994 long path_max
= pathconf ("/", _PC_PATH_MAX
);
2997 /* PATH_MAX is bounded. */
2998 char *buf
= alloca (path_max
);
2999 char *rp
= realpath (filename
, buf
);
3000 return xstrdup (rp
? rp
: filename
);
3005 /* This system is a lost cause, just dup the buffer. */
3006 return xstrdup (filename
);
3009 /* Return a copy of FILENAME, with its directory prefix canonicalized
3013 xfullpath (const char *filename
)
3015 const char *base_name
= lbasename (filename
);
3020 /* Extract the basename of filename, and return immediately
3021 a copy of filename if it does not contain any directory prefix. */
3022 if (base_name
== filename
)
3023 return xstrdup (filename
);
3025 dir_name
= alloca ((size_t) (base_name
- filename
+ 2));
3026 /* Allocate enough space to store the dir_name + plus one extra
3027 character sometimes needed under Windows (see below), and
3028 then the closing \000 character */
3029 strncpy (dir_name
, filename
, base_name
- filename
);
3030 dir_name
[base_name
- filename
] = '\000';
3032 #ifdef HAVE_DOS_BASED_FILE_SYSTEM
3033 /* We need to be careful when filename is of the form 'd:foo', which
3034 is equivalent of d:./foo, which is totally different from d:/foo. */
3035 if (strlen (dir_name
) == 2 && isalpha (dir_name
[0]) && dir_name
[1] == ':')
3038 dir_name
[3] = '\000';
3042 /* Canonicalize the directory prefix, and build the resulting
3043 filename. If the dirname realpath already contains an ending
3044 directory separator, avoid doubling it. */
3045 real_path
= gdb_realpath (dir_name
);
3046 if (IS_DIR_SEPARATOR (real_path
[strlen (real_path
) - 1]))
3047 result
= concat (real_path
, base_name
, NULL
);
3049 result
= concat (real_path
, SLASH_STRING
, base_name
, NULL
);
3056 /* This is the 32-bit CRC function used by the GNU separate debug
3057 facility. An executable may contain a section named
3058 .gnu_debuglink, which holds the name of a separate executable file
3059 containing its debug info, and a checksum of that file's contents,
3060 computed using this function. */
3062 gnu_debuglink_crc32 (unsigned long crc
, unsigned char *buf
, size_t len
)
3064 static const unsigned long crc32_table
[256] = {
3065 0x00000000, 0x77073096, 0xee0e612c, 0x990951ba, 0x076dc419,
3066 0x706af48f, 0xe963a535, 0x9e6495a3, 0x0edb8832, 0x79dcb8a4,
3067 0xe0d5e91e, 0x97d2d988, 0x09b64c2b, 0x7eb17cbd, 0xe7b82d07,
3068 0x90bf1d91, 0x1db71064, 0x6ab020f2, 0xf3b97148, 0x84be41de,
3069 0x1adad47d, 0x6ddde4eb, 0xf4d4b551, 0x83d385c7, 0x136c9856,
3070 0x646ba8c0, 0xfd62f97a, 0x8a65c9ec, 0x14015c4f, 0x63066cd9,
3071 0xfa0f3d63, 0x8d080df5, 0x3b6e20c8, 0x4c69105e, 0xd56041e4,
3072 0xa2677172, 0x3c03e4d1, 0x4b04d447, 0xd20d85fd, 0xa50ab56b,
3073 0x35b5a8fa, 0x42b2986c, 0xdbbbc9d6, 0xacbcf940, 0x32d86ce3,
3074 0x45df5c75, 0xdcd60dcf, 0xabd13d59, 0x26d930ac, 0x51de003a,
3075 0xc8d75180, 0xbfd06116, 0x21b4f4b5, 0x56b3c423, 0xcfba9599,
3076 0xb8bda50f, 0x2802b89e, 0x5f058808, 0xc60cd9b2, 0xb10be924,
3077 0x2f6f7c87, 0x58684c11, 0xc1611dab, 0xb6662d3d, 0x76dc4190,
3078 0x01db7106, 0x98d220bc, 0xefd5102a, 0x71b18589, 0x06b6b51f,
3079 0x9fbfe4a5, 0xe8b8d433, 0x7807c9a2, 0x0f00f934, 0x9609a88e,
3080 0xe10e9818, 0x7f6a0dbb, 0x086d3d2d, 0x91646c97, 0xe6635c01,
3081 0x6b6b51f4, 0x1c6c6162, 0x856530d8, 0xf262004e, 0x6c0695ed,
3082 0x1b01a57b, 0x8208f4c1, 0xf50fc457, 0x65b0d9c6, 0x12b7e950,
3083 0x8bbeb8ea, 0xfcb9887c, 0x62dd1ddf, 0x15da2d49, 0x8cd37cf3,
3084 0xfbd44c65, 0x4db26158, 0x3ab551ce, 0xa3bc0074, 0xd4bb30e2,
3085 0x4adfa541, 0x3dd895d7, 0xa4d1c46d, 0xd3d6f4fb, 0x4369e96a,
3086 0x346ed9fc, 0xad678846, 0xda60b8d0, 0x44042d73, 0x33031de5,
3087 0xaa0a4c5f, 0xdd0d7cc9, 0x5005713c, 0x270241aa, 0xbe0b1010,
3088 0xc90c2086, 0x5768b525, 0x206f85b3, 0xb966d409, 0xce61e49f,
3089 0x5edef90e, 0x29d9c998, 0xb0d09822, 0xc7d7a8b4, 0x59b33d17,
3090 0x2eb40d81, 0xb7bd5c3b, 0xc0ba6cad, 0xedb88320, 0x9abfb3b6,
3091 0x03b6e20c, 0x74b1d29a, 0xead54739, 0x9dd277af, 0x04db2615,
3092 0x73dc1683, 0xe3630b12, 0x94643b84, 0x0d6d6a3e, 0x7a6a5aa8,
3093 0xe40ecf0b, 0x9309ff9d, 0x0a00ae27, 0x7d079eb1, 0xf00f9344,
3094 0x8708a3d2, 0x1e01f268, 0x6906c2fe, 0xf762575d, 0x806567cb,
3095 0x196c3671, 0x6e6b06e7, 0xfed41b76, 0x89d32be0, 0x10da7a5a,
3096 0x67dd4acc, 0xf9b9df6f, 0x8ebeeff9, 0x17b7be43, 0x60b08ed5,
3097 0xd6d6a3e8, 0xa1d1937e, 0x38d8c2c4, 0x4fdff252, 0xd1bb67f1,
3098 0xa6bc5767, 0x3fb506dd, 0x48b2364b, 0xd80d2bda, 0xaf0a1b4c,
3099 0x36034af6, 0x41047a60, 0xdf60efc3, 0xa867df55, 0x316e8eef,
3100 0x4669be79, 0xcb61b38c, 0xbc66831a, 0x256fd2a0, 0x5268e236,
3101 0xcc0c7795, 0xbb0b4703, 0x220216b9, 0x5505262f, 0xc5ba3bbe,
3102 0xb2bd0b28, 0x2bb45a92, 0x5cb36a04, 0xc2d7ffa7, 0xb5d0cf31,
3103 0x2cd99e8b, 0x5bdeae1d, 0x9b64c2b0, 0xec63f226, 0x756aa39c,
3104 0x026d930a, 0x9c0906a9, 0xeb0e363f, 0x72076785, 0x05005713,
3105 0x95bf4a82, 0xe2b87a14, 0x7bb12bae, 0x0cb61b38, 0x92d28e9b,
3106 0xe5d5be0d, 0x7cdcefb7, 0x0bdbdf21, 0x86d3d2d4, 0xf1d4e242,
3107 0x68ddb3f8, 0x1fda836e, 0x81be16cd, 0xf6b9265b, 0x6fb077e1,
3108 0x18b74777, 0x88085ae6, 0xff0f6a70, 0x66063bca, 0x11010b5c,
3109 0x8f659eff, 0xf862ae69, 0x616bffd3, 0x166ccf45, 0xa00ae278,
3110 0xd70dd2ee, 0x4e048354, 0x3903b3c2, 0xa7672661, 0xd06016f7,
3111 0x4969474d, 0x3e6e77db, 0xaed16a4a, 0xd9d65adc, 0x40df0b66,
3112 0x37d83bf0, 0xa9bcae53, 0xdebb9ec5, 0x47b2cf7f, 0x30b5ffe9,
3113 0xbdbdf21c, 0xcabac28a, 0x53b39330, 0x24b4a3a6, 0xbad03605,
3114 0xcdd70693, 0x54de5729, 0x23d967bf, 0xb3667a2e, 0xc4614ab8,
3115 0x5d681b02, 0x2a6f2b94, 0xb40bbe37, 0xc30c8ea1, 0x5a05df1b,
3120 crc
= ~crc
& 0xffffffff;
3121 for (end
= buf
+ len
; buf
< end
; ++buf
)
3122 crc
= crc32_table
[(crc
^ *buf
) & 0xff] ^ (crc
>> 8);
3123 return ~crc
& 0xffffffff;;
3127 align_up (ULONGEST v
, int n
)
3129 /* Check that N is really a power of two. */
3130 gdb_assert (n
&& (n
& (n
-1)) == 0);
3131 return (v
+ n
- 1) & -n
;
3135 align_down (ULONGEST v
, int n
)
3137 /* Check that N is really a power of two. */
3138 gdb_assert (n
&& (n
& (n
-1)) == 0);