1 /* General utility routines for GDB, the GNU debugger.
2 Copyright 1986, 89, 90, 91, 92, 95, 96, 1998 Free Software Foundation, Inc.
4 This file is part of GDB.
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
22 #include "gdb_string.h"
34 /* SunOS's curses.h has a '#define reg register' in it. Thank you Sun. */
45 #include "expression.h"
49 #include <readline/readline.h>
51 /* readline defines this. */
54 void (*error_begin_hook
) PARAMS ((void));
56 /* Prototypes for local functions */
58 static void vfprintf_maybe_filtered
PARAMS ((GDB_FILE
*, const char *,
61 static void fputs_maybe_filtered
PARAMS ((const char *, GDB_FILE
*, int));
63 #if defined (USE_MMALLOC) && !defined (NO_MMCHECK)
64 static void malloc_botch
PARAMS ((void));
68 fatal_dump_core
PARAMS((char *, ...));
71 prompt_for_continue
PARAMS ((void));
74 set_width_command
PARAMS ((char *, int, struct cmd_list_element
*));
77 set_width
PARAMS ((void));
79 /* If this definition isn't overridden by the header files, assume
80 that isatty and fileno exist on this system. */
82 #define ISATTY(FP) (isatty (fileno (FP)))
85 #ifndef GDB_FILE_ISATTY
86 #define GDB_FILE_ISATTY(GDB_FILE_PTR) (gdb_file_isatty(GDB_FILE_PTR))
89 /* Chain of cleanup actions established with make_cleanup,
90 to be executed if an error happens. */
92 static struct cleanup
*cleanup_chain
; /* cleaned up after a failed command */
93 static struct cleanup
*final_cleanup_chain
; /* cleaned up when gdb exits */
94 static struct cleanup
*run_cleanup_chain
; /* cleaned up on each 'run' */
96 /* Nonzero if we have job control. */
100 /* Nonzero means a quit has been requested. */
104 /* Nonzero means quit immediately if Control-C is typed now, rather
105 than waiting until QUIT is executed. Be careful in setting this;
106 code which executes with immediate_quit set has to be very careful
107 about being able to deal with being interrupted at any time. It is
108 almost always better to use QUIT; the only exception I can think of
109 is being able to quit out of a system call (using EINTR loses if
110 the SIGINT happens between the previous QUIT and the system call).
111 To immediately quit in the case in which a SIGINT happens between
112 the previous QUIT and setting immediate_quit (desirable anytime we
113 expect to block), call QUIT after setting immediate_quit. */
117 /* Nonzero means that encoded C++ names should be printed out in their
118 C++ form rather than raw. */
122 /* Nonzero means that encoded C++ names should be printed out in their
123 C++ form even in assembler language displays. If this is set, but
124 DEMANGLE is zero, names are printed raw, i.e. DEMANGLE controls. */
126 int asm_demangle
= 0;
128 /* Nonzero means that strings with character values >0x7F should be printed
129 as octal escapes. Zero means just print the value (e.g. it's an
130 international character, and the terminal or window can cope.) */
132 int sevenbit_strings
= 0;
134 /* String to be printed before error messages, if any. */
136 char *error_pre_print
;
138 /* String to be printed before quit messages, if any. */
140 char *quit_pre_print
;
142 /* String to be printed before warning messages, if any. */
144 char *warning_pre_print
= "\nwarning: ";
146 int pagination_enabled
= 1;
149 /* Add a new cleanup to the cleanup_chain,
150 and return the previous chain pointer
151 to be passed later to do_cleanups or discard_cleanups.
152 Args are FUNCTION to clean up with, and ARG to pass to it. */
155 make_cleanup (function
, arg
)
156 void (*function
) PARAMS ((PTR
));
159 return make_my_cleanup (&cleanup_chain
, function
, arg
);
163 make_final_cleanup (function
, arg
)
164 void (*function
) PARAMS ((PTR
));
167 return make_my_cleanup (&final_cleanup_chain
, function
, arg
);
171 make_run_cleanup (function
, arg
)
172 void (*function
) PARAMS ((PTR
));
175 return make_my_cleanup (&run_cleanup_chain
, function
, arg
);
182 freeargv ((char**) arg
);
186 make_cleanup_freeargv (arg
)
189 return make_my_cleanup (&cleanup_chain
, do_freeargv
, arg
);
193 make_my_cleanup (pmy_chain
, function
, arg
)
194 struct cleanup
**pmy_chain
;
195 void (*function
) PARAMS ((PTR
));
198 register struct cleanup
*new
199 = (struct cleanup
*) xmalloc (sizeof (struct cleanup
));
200 register struct cleanup
*old_chain
= *pmy_chain
;
202 new->next
= *pmy_chain
;
203 new->function
= function
;
210 /* Discard cleanups and do the actions they describe
211 until we get back to the point OLD_CHAIN in the cleanup_chain. */
214 do_cleanups (old_chain
)
215 register struct cleanup
*old_chain
;
217 do_my_cleanups (&cleanup_chain
, old_chain
);
221 do_final_cleanups (old_chain
)
222 register struct cleanup
*old_chain
;
224 do_my_cleanups (&final_cleanup_chain
, old_chain
);
228 do_run_cleanups (old_chain
)
229 register struct cleanup
*old_chain
;
231 do_my_cleanups (&run_cleanup_chain
, old_chain
);
235 do_my_cleanups (pmy_chain
, old_chain
)
236 register struct cleanup
**pmy_chain
;
237 register struct cleanup
*old_chain
;
239 register struct cleanup
*ptr
;
240 while ((ptr
= *pmy_chain
) != old_chain
)
242 *pmy_chain
= ptr
->next
; /* Do this first incase recursion */
243 (*ptr
->function
) (ptr
->arg
);
248 /* Discard cleanups, not doing the actions they describe,
249 until we get back to the point OLD_CHAIN in the cleanup_chain. */
252 discard_cleanups (old_chain
)
253 register struct cleanup
*old_chain
;
255 discard_my_cleanups (&cleanup_chain
, old_chain
);
259 discard_final_cleanups (old_chain
)
260 register struct cleanup
*old_chain
;
262 discard_my_cleanups (&final_cleanup_chain
, old_chain
);
266 discard_my_cleanups (pmy_chain
, old_chain
)
267 register struct cleanup
**pmy_chain
;
268 register struct cleanup
*old_chain
;
270 register struct cleanup
*ptr
;
271 while ((ptr
= *pmy_chain
) != old_chain
)
273 *pmy_chain
= ptr
->next
;
278 /* Set the cleanup_chain to 0, and return the old cleanup chain. */
282 return save_my_cleanups (&cleanup_chain
);
286 save_final_cleanups ()
288 return save_my_cleanups (&final_cleanup_chain
);
292 save_my_cleanups (pmy_chain
)
293 struct cleanup
**pmy_chain
;
295 struct cleanup
*old_chain
= *pmy_chain
;
301 /* Restore the cleanup chain from a previously saved chain. */
303 restore_cleanups (chain
)
304 struct cleanup
*chain
;
306 restore_my_cleanups (&cleanup_chain
, chain
);
310 restore_final_cleanups (chain
)
311 struct cleanup
*chain
;
313 restore_my_cleanups (&final_cleanup_chain
, chain
);
317 restore_my_cleanups (pmy_chain
, chain
)
318 struct cleanup
**pmy_chain
;
319 struct cleanup
*chain
;
324 /* This function is useful for cleanups.
328 old_chain = make_cleanup (free_current_contents, &foo);
330 to arrange to free the object thus allocated. */
333 free_current_contents (location
)
339 /* Provide a known function that does nothing, to use as a base for
340 for a possibly long chain of cleanups. This is useful where we
341 use the cleanup chain for handling normal cleanups as well as dealing
342 with cleanups that need to be done as a result of a call to error().
343 In such cases, we may not be certain where the first cleanup is, unless
344 we have a do-nothing one to always use as the base. */
354 /* Print a warning message. Way to use this is to call warning_begin,
355 output the warning message (use unfiltered output to gdb_stderr),
356 ending in a newline. There is not currently a warning_end that you
357 call afterwards, but such a thing might be added if it is useful
358 for a GUI to separate warning messages from other output.
360 FIXME: Why do warnings use unfiltered output and errors filtered?
361 Is this anything other than a historical accident? */
366 target_terminal_ours ();
367 wrap_here(""); /* Force out any buffered output */
368 gdb_flush (gdb_stdout
);
369 if (warning_pre_print
)
370 fprintf_unfiltered (gdb_stderr
, warning_pre_print
);
373 /* Print a warning message.
374 The first argument STRING is the warning message, used as a fprintf string,
375 and the remaining args are passed as arguments to it.
376 The primary difference between warnings and errors is that a warning
377 does not force the return to command level. */
381 #ifdef ANSI_PROTOTYPES
382 warning (const char *string
, ...)
389 #ifdef ANSI_PROTOTYPES
390 va_start (args
, string
);
395 string
= va_arg (args
, char *);
398 (*warning_hook
) (string
, args
);
402 vfprintf_unfiltered (gdb_stderr
, string
, args
);
403 fprintf_unfiltered (gdb_stderr
, "\n");
408 /* Start the printing of an error message. Way to use this is to call
409 this, output the error message (use filtered output to gdb_stderr
410 (FIXME: Some callers, like memory_error, use gdb_stdout)), ending
411 in a newline, and then call return_to_top_level (RETURN_ERROR).
412 error() provides a convenient way to do this for the special case
413 that the error message can be formatted with a single printf call,
414 but this is more general. */
418 if (error_begin_hook
)
421 target_terminal_ours ();
422 wrap_here (""); /* Force out any buffered output */
423 gdb_flush (gdb_stdout
);
425 annotate_error_begin ();
428 fprintf_filtered (gdb_stderr
, error_pre_print
);
431 /* Print an error message and return to command level.
432 The first argument STRING is the error message, used as a fprintf string,
433 and the remaining args are passed as arguments to it. */
437 #ifdef ANSI_PROTOTYPES
438 error (const char *string
, ...)
445 #ifdef ANSI_PROTOTYPES
446 va_start (args
, string
);
455 #ifdef ANSI_PROTOTYPES
456 vfprintf_filtered (gdb_stderr
, string
, args
);
461 string1
= va_arg (args
, char *);
462 vfprintf_filtered (gdb_stderr
, string1
, args
);
465 fprintf_filtered (gdb_stderr
, "\n");
467 return_to_top_level (RETURN_ERROR
);
472 /* Print an error message and exit reporting failure.
473 This is for a error that we cannot continue from.
474 The arguments are printed a la printf.
476 This function cannot be declared volatile (NORETURN) in an
477 ANSI environment because exit() is not declared volatile. */
481 #ifdef ANSI_PROTOTYPES
482 fatal (char *string
, ...)
489 #ifdef ANSI_PROTOTYPES
490 va_start (args
, string
);
494 string
= va_arg (args
, char *);
496 fprintf_unfiltered (gdb_stderr
, "\ngdb: ");
497 vfprintf_unfiltered (gdb_stderr
, string
, args
);
498 fprintf_unfiltered (gdb_stderr
, "\n");
503 /* Print an error message and exit, dumping core.
504 The arguments are printed a la printf (). */
508 #ifdef ANSI_PROTOTYPES
509 fatal_dump_core (char *string
, ...)
511 fatal_dump_core (va_alist
)
516 #ifdef ANSI_PROTOTYPES
517 va_start (args
, string
);
522 string
= va_arg (args
, char *);
524 /* "internal error" is always correct, since GDB should never dump
525 core, no matter what the input. */
526 fprintf_unfiltered (gdb_stderr
, "\ngdb internal error: ");
527 vfprintf_unfiltered (gdb_stderr
, string
, args
);
528 fprintf_unfiltered (gdb_stderr
, "\n");
531 signal (SIGQUIT
, SIG_DFL
);
532 kill (getpid (), SIGQUIT
);
533 /* We should never get here, but just in case... */
537 /* The strerror() function can return NULL for errno values that are
538 out of range. Provide a "safe" version that always returns a
542 safe_strerror (errnum
)
548 if ((msg
= strerror (errnum
)) == NULL
)
550 sprintf (buf
, "(undocumented errno %d)", errnum
);
556 /* The strsignal() function can return NULL for signal values that are
557 out of range. Provide a "safe" version that always returns a
561 safe_strsignal (signo
)
567 if ((msg
= strsignal (signo
)) == NULL
)
569 sprintf (buf
, "(undocumented signal %d)", signo
);
576 /* Print the system error message for errno, and also mention STRING
577 as the file name for which the error was encountered.
578 Then return to command level. */
581 perror_with_name (string
)
587 err
= safe_strerror (errno
);
588 combined
= (char *) alloca (strlen (err
) + strlen (string
) + 3);
589 strcpy (combined
, string
);
590 strcat (combined
, ": ");
591 strcat (combined
, err
);
593 /* I understand setting these is a matter of taste. Still, some people
594 may clear errno but not know about bfd_error. Doing this here is not
596 bfd_set_error (bfd_error_no_error
);
599 error ("%s.", combined
);
602 /* Print the system error message for ERRCODE, and also mention STRING
603 as the file name for which the error was encountered. */
606 print_sys_errmsg (string
, errcode
)
613 err
= safe_strerror (errcode
);
614 combined
= (char *) alloca (strlen (err
) + strlen (string
) + 3);
615 strcpy (combined
, string
);
616 strcat (combined
, ": ");
617 strcat (combined
, err
);
619 /* We want anything which was printed on stdout to come out first, before
621 gdb_flush (gdb_stdout
);
622 fprintf_unfiltered (gdb_stderr
, "%s.\n", combined
);
625 /* Control C eventually causes this to be called, at a convenient time. */
630 serial_t gdb_stdout_serial
= serial_fdopen (1);
632 target_terminal_ours ();
634 /* We want all output to appear now, before we print "Quit". We
635 have 3 levels of buffering we have to flush (it's possible that
636 some of these should be changed to flush the lower-level ones
639 /* 1. The _filtered buffer. */
640 wrap_here ((char *)0);
642 /* 2. The stdio buffer. */
643 gdb_flush (gdb_stdout
);
644 gdb_flush (gdb_stderr
);
646 /* 3. The system-level buffer. */
647 SERIAL_DRAIN_OUTPUT (gdb_stdout_serial
);
648 SERIAL_UN_FDOPEN (gdb_stdout_serial
);
650 annotate_error_begin ();
652 /* Don't use *_filtered; we don't want to prompt the user to continue. */
654 fprintf_unfiltered (gdb_stderr
, quit_pre_print
);
657 /* If there is no terminal switching for this target, then we can't
658 possibly get screwed by the lack of job control. */
659 || current_target
.to_terminal_ours
== NULL
)
660 fprintf_unfiltered (gdb_stderr
, "Quit\n");
662 fprintf_unfiltered (gdb_stderr
,
663 "Quit (expect signal SIGINT when the program is resumed)\n");
664 return_to_top_level (RETURN_QUIT
);
668 #if defined(__GO32__)
670 /* In the absence of signals, poll keyboard for a quit.
671 Called from #define QUIT pollquit() in xm-go32.h. */
686 /* We just ignore it */
687 /* FIXME!! Don't think this actually works! */
688 fprintf_unfiltered (gdb_stderr
, "CTRL-A to quit, CTRL-B to quit harder\n");
693 #elif defined(_MSC_VER) /* should test for wingdb instead? */
696 * Windows translates all keyboard and mouse events
697 * into a message which is appended to the message
698 * queue for the process.
703 int k
= win32pollquit();
710 #else /* !defined(__GO32__) && !defined(_MSC_VER) */
714 /* Done by signals */
717 #endif /* !defined(__GO32__) && !defined(_MSC_VER) */
723 if (quit_flag
|| immediate_quit
)
727 /* Control C comes here */
734 /* Restore the signal handler. Harmless with BSD-style signals, needed
735 for System V-style signals. So just always do it, rather than worrying
736 about USG defines and stuff like that. */
737 signal (signo
, request_quit
);
748 /* Memory management stuff (malloc friends). */
750 /* Make a substitute size_t for non-ANSI compilers. */
752 #ifndef HAVE_STDDEF_H
754 #define size_t unsigned int
758 #if !defined (USE_MMALLOC)
765 return malloc (size
);
769 mrealloc (md
, ptr
, size
)
774 if (ptr
== 0) /* Guard against old realloc's */
775 return malloc (size
);
777 return realloc (ptr
, size
);
788 #endif /* USE_MMALLOC */
790 #if !defined (USE_MMALLOC) || defined (NO_MMCHECK)
798 #else /* Have mmalloc and want corruption checking */
803 fatal_dump_core ("Memory corruption");
806 /* Attempt to install hooks in mmalloc/mrealloc/mfree for the heap specified
807 by MD, to detect memory corruption. Note that MD may be NULL to specify
808 the default heap that grows via sbrk.
810 Note that for freshly created regions, we must call mmcheckf prior to any
811 mallocs in the region. Otherwise, any region which was allocated prior to
812 installing the checking hooks, which is later reallocated or freed, will
813 fail the checks! The mmcheck function only allows initial hooks to be
814 installed before the first mmalloc. However, anytime after we have called
815 mmcheck the first time to install the checking hooks, we can call it again
816 to update the function pointer to the memory corruption handler.
818 Returns zero on failure, non-zero on success. */
820 #ifndef MMCHECK_FORCE
821 #define MMCHECK_FORCE 0
828 if (!mmcheckf (md
, malloc_botch
, MMCHECK_FORCE
))
830 /* Don't use warning(), which relies on current_target being set
831 to something other than dummy_target, until after
832 initialize_all_files(). */
835 (gdb_stderr
, "warning: failed to install memory consistency checks; ");
837 (gdb_stderr
, "configuration should define NO_MMCHECK or MMCHECK_FORCE\n");
843 #endif /* Have mmalloc and want corruption checking */
845 /* Called when a memory allocation fails, with the number of bytes of
846 memory requested in SIZE. */
854 fatal ("virtual memory exhausted: can't allocate %ld bytes.", size
);
858 fatal ("virtual memory exhausted.");
862 /* Like mmalloc but get error if no storage available, and protect against
863 the caller wanting to allocate zero bytes. Whether to return NULL for
864 a zero byte request, or translate the request into a request for one
865 byte of zero'd storage, is a religious issue. */
878 else if ((val
= mmalloc (md
, size
)) == NULL
)
885 /* Like mrealloc but get error if no storage available. */
888 xmrealloc (md
, ptr
, size
)
897 val
= mrealloc (md
, ptr
, size
);
901 val
= mmalloc (md
, size
);
910 /* Like malloc but get error if no storage available, and protect against
911 the caller wanting to allocate zero bytes. */
917 return (xmmalloc ((PTR
) NULL
, size
));
920 /* Like mrealloc but get error if no storage available. */
927 return (xmrealloc ((PTR
) NULL
, ptr
, size
));
931 /* My replacement for the read system call.
932 Used like `read' but keeps going if `read' returns too soon. */
935 myread (desc
, addr
, len
)
945 val
= read (desc
, addr
, len
);
956 /* Make a copy of the string at PTR with SIZE characters
957 (and add a null character at the end in the copy).
958 Uses malloc to get the space. Returns the address of the copy. */
961 savestring (ptr
, size
)
965 register char *p
= (char *) xmalloc (size
+ 1);
966 memcpy (p
, ptr
, size
);
972 msavestring (md
, ptr
, size
)
977 register char *p
= (char *) xmmalloc (md
, size
+ 1);
978 memcpy (p
, ptr
, size
);
983 /* The "const" is so it compiles under DGUX (which prototypes strsave
984 in <string.h>. FIXME: This should be named "xstrsave", shouldn't it?
985 Doesn't real strsave return NULL if out of memory? */
990 return savestring (ptr
, strlen (ptr
));
998 return (msavestring (md
, ptr
, strlen (ptr
)));
1002 print_spaces (n
, file
)
1004 register GDB_FILE
*file
;
1006 if (file
->ts_streamtype
== astring
)
1010 gdb_file_adjust_strbuf (n
, file
);
1011 p
= file
->ts_strbuf
+ strlen (file
->ts_strbuf
);
1019 fputc (' ', file
->ts_filestream
);
1023 /* Print a host address. */
1026 gdb_print_address (addr
, stream
)
1031 /* We could use the %p conversion specifier to fprintf if we had any
1032 way of knowing whether this host supports it. But the following
1033 should work on the Alpha and on 32 bit machines. */
1035 fprintf_filtered (stream
, "0x%lx", (unsigned long)addr
);
1038 /* Ask user a y-or-n question and return 1 iff answer is yes.
1039 Takes three args which are given to printf to print the question.
1040 The first, a control string, should end in "? ".
1041 It should not say how to answer, because we do that. */
1045 #ifdef ANSI_PROTOTYPES
1046 query (char *ctlstr
, ...)
1053 register int answer
;
1057 #ifdef ANSI_PROTOTYPES
1058 va_start (args
, ctlstr
);
1062 ctlstr
= va_arg (args
, char *);
1067 return query_hook (ctlstr
, args
);
1070 /* Automatically answer "yes" if input is not from a terminal. */
1071 if (!input_from_terminal_p ())
1074 /* FIXME Automatically answer "yes" if called from MacGDB. */
1081 wrap_here (""); /* Flush any buffered output */
1082 gdb_flush (gdb_stdout
);
1084 if (annotation_level
> 1)
1085 printf_filtered ("\n\032\032pre-query\n");
1087 vfprintf_filtered (gdb_stdout
, ctlstr
, args
);
1088 printf_filtered ("(y or n) ");
1090 if (annotation_level
> 1)
1091 printf_filtered ("\n\032\032query\n");
1094 /* If not in MacGDB, move to a new line so the entered line doesn't
1095 have a prompt on the front of it. */
1097 fputs_unfiltered ("\n", gdb_stdout
);
1101 gdb_flush (gdb_stdout
);
1104 if (!tui_version
|| cmdWin
== tuiWinWithFocus())
1106 answer
= fgetc (stdin
);
1110 answer
= (unsigned char)tuiBufferGetc();
1113 clearerr (stdin
); /* in case of C-d */
1114 if (answer
== EOF
) /* C-d */
1119 /* Eat rest of input line, to EOF or newline */
1120 if ((answer
!= '\n') || (tui_version
&& answer
!= '\r'))
1124 if (!tui_version
|| cmdWin
== tuiWinWithFocus())
1126 ans2
= fgetc (stdin
);
1130 ans2
= (unsigned char)tuiBufferGetc();
1134 while (ans2
!= EOF
&& ans2
!= '\n' && ans2
!= '\r');
1135 TUIDO(((TuiOpaqueFuncPtr
)tui_vStartNewLines
, 1));
1149 printf_filtered ("Please answer y or n.\n");
1152 if (annotation_level
> 1)
1153 printf_filtered ("\n\032\032post-query\n");
1158 /* Parse a C escape sequence. STRING_PTR points to a variable
1159 containing a pointer to the string to parse. That pointer
1160 should point to the character after the \. That pointer
1161 is updated past the characters we use. The value of the
1162 escape sequence is returned.
1164 A negative value means the sequence \ newline was seen,
1165 which is supposed to be equivalent to nothing at all.
1167 If \ is followed by a null character, we return a negative
1168 value and leave the string pointer pointing at the null character.
1170 If \ is followed by 000, we return 0 and leave the string pointer
1171 after the zeros. A value of 0 does not mean end of string. */
1174 parse_escape (string_ptr
)
1177 register int c
= *(*string_ptr
)++;
1181 return 007; /* Bell (alert) char */
1184 case 'e': /* Escape character */
1202 c
= *(*string_ptr
)++;
1204 c
= parse_escape (string_ptr
);
1207 return (c
& 0200) | (c
& 037);
1218 register int i
= c
- '0';
1219 register int count
= 0;
1222 if ((c
= *(*string_ptr
)++) >= '0' && c
<= '7')
1240 /* Print the character C on STREAM as part of the contents of a literal
1241 string whose delimiter is QUOTER. Note that this routine should only
1242 be call for printing things which are independent of the language
1243 of the program being debugged. */
1246 gdb_printchar (c
, stream
, quoter
)
1252 c
&= 0xFF; /* Avoid sign bit follies */
1254 if ( c
< 0x20 || /* Low control chars */
1255 (c
>= 0x7F && c
< 0xA0) || /* DEL, High controls */
1256 (sevenbit_strings
&& c
>= 0x80)) { /* high order bit set */
1260 fputs_filtered ("\\n", stream
);
1263 fputs_filtered ("\\b", stream
);
1266 fputs_filtered ("\\t", stream
);
1269 fputs_filtered ("\\f", stream
);
1272 fputs_filtered ("\\r", stream
);
1275 fputs_filtered ("\\e", stream
);
1278 fputs_filtered ("\\a", stream
);
1281 fprintf_filtered (stream
, "\\%.3o", (unsigned int) c
);
1285 if (c
== '\\' || c
== quoter
)
1286 fputs_filtered ("\\", stream
);
1287 fprintf_filtered (stream
, "%c", c
);
1294 static char * hexlate
= "0123456789abcdef" ;
1295 int fmthex(inbuf
,outbuff
,length
,linelength
)
1296 unsigned char * inbuf
;
1297 unsigned char * outbuff
;
1301 unsigned char byte
, nib
;
1306 if (outlength
>= linelength
) break ;
1310 *outbuff
++ = hexlate
[nib
] ;
1312 *outbuff
++ = hexlate
[nib
] ;
1317 *outbuff
= '\0' ; /* null terminate our output line */
1322 /* Number of lines per page or UINT_MAX if paging is disabled. */
1323 static unsigned int lines_per_page
;
1324 /* Number of chars per line or UNIT_MAX is line folding is disabled. */
1325 static unsigned int chars_per_line
;
1326 /* Current count of lines printed on this page, chars on this line. */
1327 static unsigned int lines_printed
, chars_printed
;
1329 /* Buffer and start column of buffered text, for doing smarter word-
1330 wrapping. When someone calls wrap_here(), we start buffering output
1331 that comes through fputs_filtered(). If we see a newline, we just
1332 spit it out and forget about the wrap_here(). If we see another
1333 wrap_here(), we spit it out and remember the newer one. If we see
1334 the end of the line, we spit out a newline, the indent, and then
1335 the buffered output. */
1337 /* Malloc'd buffer with chars_per_line+2 bytes. Contains characters which
1338 are waiting to be output (they have already been counted in chars_printed).
1339 When wrap_buffer[0] is null, the buffer is empty. */
1340 static char *wrap_buffer
;
1342 /* Pointer in wrap_buffer to the next character to fill. */
1343 static char *wrap_pointer
;
1345 /* String to indent by if the wrap occurs. Must not be NULL if wrap_column
1347 static char *wrap_indent
;
1349 /* Column number on the screen where wrap_buffer begins, or 0 if wrapping
1350 is not in effect. */
1351 static int wrap_column
;
1354 /* Inialize the lines and chars per page */
1359 if (tui_version
&& m_winPtrNotNull(cmdWin
))
1361 lines_per_page
= cmdWin
->generic
.height
;
1362 chars_per_line
= cmdWin
->generic
.width
;
1367 /* These defaults will be used if we are unable to get the correct
1368 values from termcap. */
1369 #if defined(__GO32__)
1370 lines_per_page
= ScreenRows();
1371 chars_per_line
= ScreenCols();
1373 lines_per_page
= 24;
1374 chars_per_line
= 80;
1376 #if !defined (MPW) && !defined (_WIN32)
1377 /* No termcap under MPW, although might be cool to do something
1378 by looking at worksheet or console window sizes. */
1379 /* Initialize the screen height and width from termcap. */
1381 char *termtype
= getenv ("TERM");
1383 /* Positive means success, nonpositive means failure. */
1386 /* 2048 is large enough for all known terminals, according to the
1387 GNU termcap manual. */
1388 char term_buffer
[2048];
1392 status
= tgetent (term_buffer
, termtype
);
1396 int running_in_emacs
= getenv ("EMACS") != NULL
;
1398 val
= tgetnum ("li");
1399 if (val
>= 0 && !running_in_emacs
)
1400 lines_per_page
= val
;
1402 /* The number of lines per page is not mentioned
1403 in the terminal description. This probably means
1404 that paging is not useful (e.g. emacs shell window),
1405 so disable paging. */
1406 lines_per_page
= UINT_MAX
;
1408 val
= tgetnum ("co");
1410 chars_per_line
= val
;
1416 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1418 /* If there is a better way to determine the window size, use it. */
1419 SIGWINCH_HANDLER (SIGWINCH
);
1422 /* If the output is not a terminal, don't paginate it. */
1423 if (!GDB_FILE_ISATTY (gdb_stdout
))
1424 lines_per_page
= UINT_MAX
;
1425 } /* the command_line_version */
1432 if (chars_per_line
== 0)
1437 wrap_buffer
= (char *) xmalloc (chars_per_line
+ 2);
1438 wrap_buffer
[0] = '\0';
1441 wrap_buffer
= (char *) xrealloc (wrap_buffer
, chars_per_line
+ 2);
1442 wrap_pointer
= wrap_buffer
; /* Start it at the beginning */
1447 set_width_command (args
, from_tty
, c
)
1450 struct cmd_list_element
*c
;
1455 /* Wait, so the user can read what's on the screen. Prompt the user
1456 to continue by pressing RETURN. */
1459 prompt_for_continue ()
1462 char cont_prompt
[120];
1464 if (annotation_level
> 1)
1465 printf_unfiltered ("\n\032\032pre-prompt-for-continue\n");
1467 strcpy (cont_prompt
,
1468 "---Type <return> to continue, or q <return> to quit---");
1469 if (annotation_level
> 1)
1470 strcat (cont_prompt
, "\n\032\032prompt-for-continue\n");
1472 /* We must do this *before* we call gdb_readline, else it will eventually
1473 call us -- thinking that we're trying to print beyond the end of the
1475 reinitialize_more_filter ();
1478 /* On a real operating system, the user can quit with SIGINT.
1481 'q' is provided on all systems so users don't have to change habits
1482 from system to system, and because telling them what to do in
1483 the prompt is more user-friendly than expecting them to think of
1485 /* Call readline, not gdb_readline, because GO32 readline handles control-C
1486 whereas control-C to gdb_readline will cause the user to get dumped
1488 ignore
= readline (cont_prompt
);
1490 if (annotation_level
> 1)
1491 printf_unfiltered ("\n\032\032post-prompt-for-continue\n");
1496 while (*p
== ' ' || *p
== '\t')
1499 request_quit (SIGINT
);
1504 /* Now we have to do this again, so that GDB will know that it doesn't
1505 need to save the ---Type <return>--- line at the top of the screen. */
1506 reinitialize_more_filter ();
1508 dont_repeat (); /* Forget prev cmd -- CR won't repeat it. */
1511 /* Reinitialize filter; ie. tell it to reset to original values. */
1514 reinitialize_more_filter ()
1520 /* Indicate that if the next sequence of characters overflows the line,
1521 a newline should be inserted here rather than when it hits the end.
1522 If INDENT is non-null, it is a string to be printed to indent the
1523 wrapped part on the next line. INDENT must remain accessible until
1524 the next call to wrap_here() or until a newline is printed through
1527 If the line is already overfull, we immediately print a newline and
1528 the indentation, and disable further wrapping.
1530 If we don't know the width of lines, but we know the page height,
1531 we must not wrap words, but should still keep track of newlines
1532 that were explicitly printed.
1534 INDENT should not contain tabs, as that will mess up the char count
1535 on the next line. FIXME.
1537 This routine is guaranteed to force out any output which has been
1538 squirreled away in the wrap_buffer, so wrap_here ((char *)0) can be
1539 used to force out output from the wrap_buffer. */
1545 /* This should have been allocated, but be paranoid anyway. */
1551 *wrap_pointer
= '\0';
1552 fputs_unfiltered (wrap_buffer
, gdb_stdout
);
1554 wrap_pointer
= wrap_buffer
;
1555 wrap_buffer
[0] = '\0';
1556 if (chars_per_line
== UINT_MAX
) /* No line overflow checking */
1560 else if (chars_printed
>= chars_per_line
)
1562 puts_filtered ("\n");
1564 puts_filtered (indent
);
1569 wrap_column
= chars_printed
;
1573 wrap_indent
= indent
;
1577 /* Ensure that whatever gets printed next, using the filtered output
1578 commands, starts at the beginning of the line. I.E. if there is
1579 any pending output for the current line, flush it and start a new
1580 line. Otherwise do nothing. */
1585 if (chars_printed
> 0)
1587 puts_filtered ("\n");
1592 gdb_file_isatty (stream
)
1596 if (stream
->ts_streamtype
== afile
)
1597 return (isatty(fileno(stream
->ts_filestream
)));
1602 gdb_file_init_astring (n
)
1605 GDB_FILE
*tmpstream
;
1607 tmpstream
= xmalloc (sizeof(GDB_FILE
));
1608 tmpstream
->ts_streamtype
= astring
;
1609 tmpstream
->ts_filestream
= NULL
;
1612 tmpstream
->ts_strbuf
= xmalloc ((n
+ 1)*sizeof(char));
1613 tmpstream
->ts_strbuf
[0] = '\0';
1616 tmpstream
->ts_strbuf
= NULL
;
1617 tmpstream
->ts_buflen
= n
;
1623 gdb_file_deallocate (streamptr
)
1624 GDB_FILE
**streamptr
;
1626 GDB_FILE
*tmpstream
;
1628 tmpstream
= *streamptr
;
1629 if ((tmpstream
->ts_streamtype
== astring
) &&
1630 (tmpstream
->ts_strbuf
!= NULL
))
1632 free (tmpstream
->ts_strbuf
);
1640 gdb_file_get_strbuf (stream
)
1643 return (stream
->ts_strbuf
);
1646 /* adjust the length of the buffer by the amount necessary
1647 to accomodate appending a string of length N to the buffer contents */
1649 gdb_file_adjust_strbuf (n
, stream
)
1655 non_null_chars
= strlen(stream
->ts_strbuf
);
1657 if (n
> (stream
->ts_buflen
- non_null_chars
- 1))
1659 stream
->ts_buflen
= n
+ non_null_chars
+ 1;
1660 stream
->ts_strbuf
= xrealloc (stream
->ts_strbuf
, stream
->ts_buflen
);
1665 gdb_fopen (name
, mode
)
1672 gdb_file_size
= sizeof(GDB_FILE
);
1673 tmp
= (GDB_FILE
*) xmalloc (gdb_file_size
);
1674 tmp
->ts_streamtype
= afile
;
1675 tmp
->ts_filestream
= fopen (name
, mode
);
1676 tmp
->ts_strbuf
= NULL
;
1687 && (stream
== gdb_stdout
1688 || stream
== gdb_stderr
))
1690 flush_hook (stream
);
1694 fflush (stream
->ts_filestream
);
1698 gdb_fclose(streamptr
)
1699 GDB_FILE
**streamptr
;
1701 GDB_FILE
*tmpstream
;
1703 tmpstream
= *streamptr
;
1704 fclose (tmpstream
->ts_filestream
);
1705 gdb_file_deallocate (streamptr
);
1708 /* Like fputs but if FILTER is true, pause after every screenful.
1710 Regardless of FILTER can wrap at points other than the final
1711 character of a line.
1713 Unlike fputs, fputs_maybe_filtered does not return a value.
1714 It is OK for LINEBUFFER to be NULL, in which case just don't print
1717 Note that a longjmp to top level may occur in this routine (only if
1718 FILTER is true) (since prompt_for_continue may do so) so this
1719 routine should not be called when cleanups are not in place. */
1722 fputs_maybe_filtered (linebuffer
, stream
, filter
)
1723 const char *linebuffer
;
1727 const char *lineptr
;
1729 if (linebuffer
== 0)
1732 /* Don't do any filtering if it is disabled. */
1733 if ((stream
!= gdb_stdout
) || !pagination_enabled
1734 || (lines_per_page
== UINT_MAX
&& chars_per_line
== UINT_MAX
))
1736 fputs_unfiltered (linebuffer
, stream
);
1740 /* Go through and output each character. Show line extension
1741 when this is necessary; prompt user for new page when this is
1744 lineptr
= linebuffer
;
1747 /* Possible new page. */
1749 (lines_printed
>= lines_per_page
- 1))
1750 prompt_for_continue ();
1752 while (*lineptr
&& *lineptr
!= '\n')
1754 /* Print a single line. */
1755 if (*lineptr
== '\t')
1758 *wrap_pointer
++ = '\t';
1760 fputc_unfiltered ('\t', stream
);
1761 /* Shifting right by 3 produces the number of tab stops
1762 we have already passed, and then adding one and
1763 shifting left 3 advances to the next tab stop. */
1764 chars_printed
= ((chars_printed
>> 3) + 1) << 3;
1770 *wrap_pointer
++ = *lineptr
;
1772 fputc_unfiltered (*lineptr
, stream
);
1777 if (chars_printed
>= chars_per_line
)
1779 unsigned int save_chars
= chars_printed
;
1783 /* If we aren't actually wrapping, don't output newline --
1784 if chars_per_line is right, we probably just overflowed
1785 anyway; if it's wrong, let us keep going. */
1787 fputc_unfiltered ('\n', stream
);
1789 /* Possible new page. */
1790 if (lines_printed
>= lines_per_page
- 1)
1791 prompt_for_continue ();
1793 /* Now output indentation and wrapped string */
1796 fputs_unfiltered (wrap_indent
, stream
);
1797 *wrap_pointer
= '\0'; /* Null-terminate saved stuff */
1798 fputs_unfiltered (wrap_buffer
, stream
); /* and eject it */
1799 /* FIXME, this strlen is what prevents wrap_indent from
1800 containing tabs. However, if we recurse to print it
1801 and count its chars, we risk trouble if wrap_indent is
1802 longer than (the user settable) chars_per_line.
1803 Note also that this can set chars_printed > chars_per_line
1804 if we are printing a long string. */
1805 chars_printed
= strlen (wrap_indent
)
1806 + (save_chars
- wrap_column
);
1807 wrap_pointer
= wrap_buffer
; /* Reset buffer */
1808 wrap_buffer
[0] = '\0';
1809 wrap_column
= 0; /* And disable fancy wrap */
1814 if (*lineptr
== '\n')
1817 wrap_here ((char *)0); /* Spit out chars, cancel further wraps */
1819 fputc_unfiltered ('\n', stream
);
1826 fputs_filtered (linebuffer
, stream
)
1827 const char *linebuffer
;
1830 fputs_maybe_filtered (linebuffer
, stream
, 1);
1834 putchar_unfiltered (c
)
1841 fputs_unfiltered (buf
, gdb_stdout
);
1846 fputc_unfiltered (c
, stream
)
1854 fputs_unfiltered (buf
, stream
);
1859 fputc_filtered (c
, stream
)
1867 fputs_filtered (buf
, stream
);
1871 /* puts_debug is like fputs_unfiltered, except it prints special
1872 characters in printable fashion. */
1875 puts_debug (prefix
, string
, suffix
)
1882 /* Print prefix and suffix after each line. */
1883 static int new_line
= 1;
1884 static int return_p
= 0;
1885 static char *prev_prefix
= "";
1886 static char *prev_suffix
= "";
1888 if (*string
== '\n')
1891 /* If the prefix is changing, print the previous suffix, a new line,
1892 and the new prefix. */
1893 if ((return_p
|| (strcmp(prev_prefix
, prefix
) != 0)) && !new_line
)
1895 fputs_unfiltered (prev_suffix
, gdb_stderr
);
1896 fputs_unfiltered ("\n", gdb_stderr
);
1897 fputs_unfiltered (prefix
, gdb_stderr
);
1900 /* Print prefix if we printed a newline during the previous call. */
1904 fputs_unfiltered (prefix
, gdb_stderr
);
1907 prev_prefix
= prefix
;
1908 prev_suffix
= suffix
;
1910 /* Output characters in a printable format. */
1911 while ((ch
= *string
++) != '\0')
1917 fputc_unfiltered (ch
, gdb_stderr
);
1920 fprintf_unfiltered (gdb_stderr
, "\\x%02x", ch
& 0xff);
1923 case '\\': fputs_unfiltered ("\\\\", gdb_stderr
); break;
1924 case '\b': fputs_unfiltered ("\\b", gdb_stderr
); break;
1925 case '\f': fputs_unfiltered ("\\f", gdb_stderr
); break;
1926 case '\n': new_line
= 1;
1927 fputs_unfiltered ("\\n", gdb_stderr
); break;
1928 case '\r': fputs_unfiltered ("\\r", gdb_stderr
); break;
1929 case '\t': fputs_unfiltered ("\\t", gdb_stderr
); break;
1930 case '\v': fputs_unfiltered ("\\v", gdb_stderr
); break;
1933 return_p
= ch
== '\r';
1936 /* Print suffix if we printed a newline. */
1939 fputs_unfiltered (suffix
, gdb_stderr
);
1940 fputs_unfiltered ("\n", gdb_stderr
);
1945 /* Print a variable number of ARGS using format FORMAT. If this
1946 information is going to put the amount written (since the last call
1947 to REINITIALIZE_MORE_FILTER or the last page break) over the page size,
1948 call prompt_for_continue to get the users permision to continue.
1950 Unlike fprintf, this function does not return a value.
1952 We implement three variants, vfprintf (takes a vararg list and stream),
1953 fprintf (takes a stream to write on), and printf (the usual).
1955 Note also that a longjmp to top level may occur in this routine
1956 (since prompt_for_continue may do so) so this routine should not be
1957 called when cleanups are not in place. */
1960 vfprintf_maybe_filtered (stream
, format
, args
, filter
)
1967 struct cleanup
*old_cleanups
;
1969 vasprintf (&linebuffer
, format
, args
);
1970 if (linebuffer
== NULL
)
1972 fputs_unfiltered ("\ngdb: virtual memory exhausted.\n", gdb_stderr
);
1975 old_cleanups
= make_cleanup (free
, linebuffer
);
1976 fputs_maybe_filtered (linebuffer
, stream
, filter
);
1977 do_cleanups (old_cleanups
);
1982 vfprintf_filtered (stream
, format
, args
)
1987 vfprintf_maybe_filtered (stream
, format
, args
, 1);
1991 vfprintf_unfiltered (stream
, format
, args
)
1997 struct cleanup
*old_cleanups
;
1999 vasprintf (&linebuffer
, format
, args
);
2000 if (linebuffer
== NULL
)
2002 fputs_unfiltered ("\ngdb: virtual memory exhausted.\n", gdb_stderr
);
2005 old_cleanups
= make_cleanup (free
, linebuffer
);
2006 fputs_unfiltered (linebuffer
, stream
);
2007 do_cleanups (old_cleanups
);
2011 vprintf_filtered (format
, args
)
2015 vfprintf_maybe_filtered (gdb_stdout
, format
, args
, 1);
2019 vprintf_unfiltered (format
, args
)
2023 vfprintf_unfiltered (gdb_stdout
, format
, args
);
2028 #ifdef ANSI_PROTOTYPES
2029 fprintf_filtered (GDB_FILE
*stream
, const char *format
, ...)
2031 fprintf_filtered (va_alist
)
2036 #ifdef ANSI_PROTOTYPES
2037 va_start (args
, format
);
2043 stream
= va_arg (args
, GDB_FILE
*);
2044 format
= va_arg (args
, char *);
2046 vfprintf_filtered (stream
, format
, args
);
2052 #ifdef ANSI_PROTOTYPES
2053 fprintf_unfiltered (GDB_FILE
*stream
, const char *format
, ...)
2055 fprintf_unfiltered (va_alist
)
2060 #ifdef ANSI_PROTOTYPES
2061 va_start (args
, format
);
2067 stream
= va_arg (args
, GDB_FILE
*);
2068 format
= va_arg (args
, char *);
2070 vfprintf_unfiltered (stream
, format
, args
);
2074 /* Like fprintf_filtered, but prints its result indented.
2075 Called as fprintfi_filtered (spaces, stream, format, ...); */
2079 #ifdef ANSI_PROTOTYPES
2080 fprintfi_filtered (int spaces
, GDB_FILE
*stream
, const char *format
, ...)
2082 fprintfi_filtered (va_alist
)
2087 #ifdef ANSI_PROTOTYPES
2088 va_start (args
, format
);
2095 spaces
= va_arg (args
, int);
2096 stream
= va_arg (args
, GDB_FILE
*);
2097 format
= va_arg (args
, char *);
2099 print_spaces_filtered (spaces
, stream
);
2101 vfprintf_filtered (stream
, format
, args
);
2108 #ifdef ANSI_PROTOTYPES
2109 printf_filtered (const char *format
, ...)
2111 printf_filtered (va_alist
)
2116 #ifdef ANSI_PROTOTYPES
2117 va_start (args
, format
);
2122 format
= va_arg (args
, char *);
2124 vfprintf_filtered (gdb_stdout
, format
, args
);
2131 #ifdef ANSI_PROTOTYPES
2132 printf_unfiltered (const char *format
, ...)
2134 printf_unfiltered (va_alist
)
2139 #ifdef ANSI_PROTOTYPES
2140 va_start (args
, format
);
2145 format
= va_arg (args
, char *);
2147 vfprintf_unfiltered (gdb_stdout
, format
, args
);
2151 /* Like printf_filtered, but prints it's result indented.
2152 Called as printfi_filtered (spaces, format, ...); */
2156 #ifdef ANSI_PROTOTYPES
2157 printfi_filtered (int spaces
, const char *format
, ...)
2159 printfi_filtered (va_alist
)
2164 #ifdef ANSI_PROTOTYPES
2165 va_start (args
, format
);
2171 spaces
= va_arg (args
, int);
2172 format
= va_arg (args
, char *);
2174 print_spaces_filtered (spaces
, gdb_stdout
);
2175 vfprintf_filtered (gdb_stdout
, format
, args
);
2179 /* Easy -- but watch out!
2181 This routine is *not* a replacement for puts()! puts() appends a newline.
2182 This one doesn't, and had better not! */
2185 puts_filtered (string
)
2188 fputs_filtered (string
, gdb_stdout
);
2192 puts_unfiltered (string
)
2195 fputs_unfiltered (string
, gdb_stdout
);
2198 /* Return a pointer to N spaces and a null. The pointer is good
2199 until the next call to here. */
2205 static char *spaces
;
2206 static int max_spaces
;
2212 spaces
= (char *) xmalloc (n
+1);
2213 for (t
= spaces
+n
; t
!= spaces
;)
2219 return spaces
+ max_spaces
- n
;
2222 /* Print N spaces. */
2224 print_spaces_filtered (n
, stream
)
2228 fputs_filtered (n_spaces (n
), stream
);
2231 /* C++ demangler stuff. */
2233 /* fprintf_symbol_filtered attempts to demangle NAME, a symbol in language
2234 LANG, using demangling args ARG_MODE, and print it filtered to STREAM.
2235 If the name is not mangled, or the language for the name is unknown, or
2236 demangling is off, the name is printed in its "raw" form. */
2239 fprintf_symbol_filtered (stream
, name
, lang
, arg_mode
)
2249 /* If user wants to see raw output, no problem. */
2252 fputs_filtered (name
, stream
);
2258 case language_cplus
:
2259 demangled
= cplus_demangle (name
, arg_mode
);
2262 demangled
= cplus_demangle (name
, arg_mode
| DMGL_JAVA
);
2264 case language_chill
:
2265 demangled
= chill_demangle (name
);
2271 fputs_filtered (demangled
? demangled
: name
, stream
);
2272 if (demangled
!= NULL
)
2280 /* Do a strcmp() type operation on STRING1 and STRING2, ignoring any
2281 differences in whitespace. Returns 0 if they match, non-zero if they
2282 don't (slightly different than strcmp()'s range of return values).
2284 As an extra hack, string1=="FOO(ARGS)" matches string2=="FOO".
2285 This "feature" is useful when searching for matching C++ function names
2286 (such as if the user types 'break FOO', where FOO is a mangled C++
2290 strcmp_iw (string1
, string2
)
2291 const char *string1
;
2292 const char *string2
;
2294 while ((*string1
!= '\0') && (*string2
!= '\0'))
2296 while (isspace (*string1
))
2300 while (isspace (*string2
))
2304 if (*string1
!= *string2
)
2308 if (*string1
!= '\0')
2314 return (*string1
!= '\0' && *string1
!= '(') || (*string2
!= '\0');
2320 ** Answer whether string_to_compare is a full or partial match to
2321 ** template_string. The partial match must be in sequence starting
2325 subset_compare (string_to_compare
, template_string
)
2326 char *string_to_compare
;
2327 char *template_string
;
2330 if (template_string
!= (char *)NULL
&& string_to_compare
!= (char *)NULL
&&
2331 strlen(string_to_compare
) <= strlen(template_string
))
2332 match
= (strncmp(template_string
,
2334 strlen(string_to_compare
)) == 0);
2341 static void pagination_on_command
PARAMS ((char *arg
, int from_tty
));
2343 pagination_on_command (arg
, from_tty
)
2347 pagination_enabled
= 1;
2350 static void pagination_on_command
PARAMS ((char *arg
, int from_tty
));
2352 pagination_off_command (arg
, from_tty
)
2356 pagination_enabled
= 0;
2363 struct cmd_list_element
*c
;
2365 c
= add_set_cmd ("width", class_support
, var_uinteger
,
2366 (char *)&chars_per_line
,
2367 "Set number of characters gdb thinks are in a line.",
2369 add_show_from_set (c
, &showlist
);
2370 c
->function
.sfunc
= set_width_command
;
2373 (add_set_cmd ("height", class_support
,
2374 var_uinteger
, (char *)&lines_per_page
,
2375 "Set number of lines gdb thinks are in a page.", &setlist
),
2380 /* If the output is not a terminal, don't paginate it. */
2381 if (!GDB_FILE_ISATTY (gdb_stdout
))
2382 lines_per_page
= UINT_MAX
;
2384 set_width_command ((char *)NULL
, 0, c
);
2387 (add_set_cmd ("demangle", class_support
, var_boolean
,
2389 "Set demangling of encoded C++ names when displaying symbols.",
2394 (add_set_cmd ("pagination", class_support
,
2395 var_boolean
, (char *)&pagination_enabled
,
2396 "Set state of pagination.", &setlist
),
2400 add_com("am", class_support
, pagination_on_command
,
2401 "Enable pagination");
2402 add_com("sm", class_support
, pagination_off_command
,
2403 "Disable pagination");
2407 (add_set_cmd ("sevenbit-strings", class_support
, var_boolean
,
2408 (char *)&sevenbit_strings
,
2409 "Set printing of 8-bit characters in strings as \\nnn.",
2414 (add_set_cmd ("asm-demangle", class_support
, var_boolean
,
2415 (char *)&asm_demangle
,
2416 "Set demangling of C++ names in disassembly listings.",
2421 /* Machine specific function to handle SIGWINCH signal. */
2423 #ifdef SIGWINCH_HANDLER_BODY
2424 SIGWINCH_HANDLER_BODY
2427 /* Support for converting target fp numbers into host DOUBLEST format. */
2429 /* XXX - This code should really be in libiberty/floatformat.c, however
2430 configuration issues with libiberty made this very difficult to do in the
2433 #include "floatformat.h"
2434 #include <math.h> /* ldexp */
2436 /* The odds that CHAR_BIT will be anything but 8 are low enough that I'm not
2437 going to bother with trying to muck around with whether it is defined in
2438 a system header, what we do if not, etc. */
2439 #define FLOATFORMAT_CHAR_BIT 8
2441 static unsigned long get_field
PARAMS ((unsigned char *,
2442 enum floatformat_byteorders
,
2447 /* Extract a field which starts at START and is LEN bytes long. DATA and
2448 TOTAL_LEN are the thing we are extracting it from, in byteorder ORDER. */
2449 static unsigned long
2450 get_field (data
, order
, total_len
, start
, len
)
2451 unsigned char *data
;
2452 enum floatformat_byteorders order
;
2453 unsigned int total_len
;
2457 unsigned long result
;
2458 unsigned int cur_byte
;
2461 /* Start at the least significant part of the field. */
2462 cur_byte
= (start
+ len
) / FLOATFORMAT_CHAR_BIT
;
2463 if (order
== floatformat_little
|| order
== floatformat_littlebyte_bigword
)
2464 cur_byte
= (total_len
/ FLOATFORMAT_CHAR_BIT
) - cur_byte
- 1;
2466 ((start
+ len
) % FLOATFORMAT_CHAR_BIT
) - FLOATFORMAT_CHAR_BIT
;
2467 result
= *(data
+ cur_byte
) >> (-cur_bitshift
);
2468 cur_bitshift
+= FLOATFORMAT_CHAR_BIT
;
2469 if (order
== floatformat_little
|| order
== floatformat_littlebyte_bigword
)
2474 /* Move towards the most significant part of the field. */
2475 while (cur_bitshift
< len
)
2477 if (len
- cur_bitshift
< FLOATFORMAT_CHAR_BIT
)
2478 /* This is the last byte; zero out the bits which are not part of
2481 (*(data
+ cur_byte
) & ((1 << (len
- cur_bitshift
)) - 1))
2484 result
|= *(data
+ cur_byte
) << cur_bitshift
;
2485 cur_bitshift
+= FLOATFORMAT_CHAR_BIT
;
2486 if (order
== floatformat_little
|| order
== floatformat_littlebyte_bigword
)
2494 /* Convert from FMT to a DOUBLEST.
2495 FROM is the address of the extended float.
2496 Store the DOUBLEST in *TO. */
2499 floatformat_to_doublest (fmt
, from
, to
)
2500 const struct floatformat
*fmt
;
2504 unsigned char *ufrom
= (unsigned char *)from
;
2508 unsigned int mant_bits
, mant_off
;
2510 int special_exponent
; /* It's a NaN, denorm or zero */
2512 /* If the mantissa bits are not contiguous from one end of the
2513 mantissa to the other, we need to make a private copy of the
2514 source bytes that is in the right order since the unpacking
2515 algorithm assumes that the bits are contiguous.
2517 Swap the bytes individually rather than accessing them through
2518 "long *" since we have no guarantee that they start on a long
2519 alignment, and also sizeof(long) for the host could be different
2520 than sizeof(long) for the target. FIXME: Assumes sizeof(long)
2521 for the target is 4. */
2523 if (fmt
-> byteorder
== floatformat_littlebyte_bigword
)
2525 static unsigned char *newfrom
;
2526 unsigned char *swapin
, *swapout
;
2529 longswaps
= fmt
-> totalsize
/ FLOATFORMAT_CHAR_BIT
;
2532 if (newfrom
== NULL
)
2534 newfrom
= (unsigned char *) xmalloc (fmt
-> totalsize
);
2539 while (longswaps
-- > 0)
2541 /* This is ugly, but efficient */
2542 *swapout
++ = swapin
[4];
2543 *swapout
++ = swapin
[5];
2544 *swapout
++ = swapin
[6];
2545 *swapout
++ = swapin
[7];
2546 *swapout
++ = swapin
[0];
2547 *swapout
++ = swapin
[1];
2548 *swapout
++ = swapin
[2];
2549 *swapout
++ = swapin
[3];
2554 exponent
= get_field (ufrom
, fmt
->byteorder
, fmt
->totalsize
,
2555 fmt
->exp_start
, fmt
->exp_len
);
2556 /* Note that if exponent indicates a NaN, we can't really do anything useful
2557 (not knowing if the host has NaN's, or how to build one). So it will
2558 end up as an infinity or something close; that is OK. */
2560 mant_bits_left
= fmt
->man_len
;
2561 mant_off
= fmt
->man_start
;
2564 special_exponent
= exponent
== 0 || exponent
== fmt
->exp_nan
;
2566 /* Don't bias zero's, denorms or NaNs. */
2567 if (!special_exponent
)
2568 exponent
-= fmt
->exp_bias
;
2570 /* Build the result algebraically. Might go infinite, underflow, etc;
2573 /* If this format uses a hidden bit, explicitly add it in now. Otherwise,
2574 increment the exponent by one to account for the integer bit. */
2576 if (!special_exponent
)
2578 if (fmt
->intbit
== floatformat_intbit_no
)
2579 dto
= ldexp (1.0, exponent
);
2584 while (mant_bits_left
> 0)
2586 mant_bits
= min (mant_bits_left
, 32);
2588 mant
= get_field (ufrom
, fmt
->byteorder
, fmt
->totalsize
,
2589 mant_off
, mant_bits
);
2591 dto
+= ldexp ((double)mant
, exponent
- mant_bits
);
2592 exponent
-= mant_bits
;
2593 mant_off
+= mant_bits
;
2594 mant_bits_left
-= mant_bits
;
2597 /* Negate it if negative. */
2598 if (get_field (ufrom
, fmt
->byteorder
, fmt
->totalsize
, fmt
->sign_start
, 1))
2603 static void put_field
PARAMS ((unsigned char *, enum floatformat_byteorders
,
2609 /* Set a field which starts at START and is LEN bytes long. DATA and
2610 TOTAL_LEN are the thing we are extracting it from, in byteorder ORDER. */
2612 put_field (data
, order
, total_len
, start
, len
, stuff_to_put
)
2613 unsigned char *data
;
2614 enum floatformat_byteorders order
;
2615 unsigned int total_len
;
2618 unsigned long stuff_to_put
;
2620 unsigned int cur_byte
;
2623 /* Start at the least significant part of the field. */
2624 cur_byte
= (start
+ len
) / FLOATFORMAT_CHAR_BIT
;
2625 if (order
== floatformat_little
|| order
== floatformat_littlebyte_bigword
)
2626 cur_byte
= (total_len
/ FLOATFORMAT_CHAR_BIT
) - cur_byte
- 1;
2628 ((start
+ len
) % FLOATFORMAT_CHAR_BIT
) - FLOATFORMAT_CHAR_BIT
;
2629 *(data
+ cur_byte
) &=
2630 ~(((1 << ((start
+ len
) % FLOATFORMAT_CHAR_BIT
)) - 1) << (-cur_bitshift
));
2631 *(data
+ cur_byte
) |=
2632 (stuff_to_put
& ((1 << FLOATFORMAT_CHAR_BIT
) - 1)) << (-cur_bitshift
);
2633 cur_bitshift
+= FLOATFORMAT_CHAR_BIT
;
2634 if (order
== floatformat_little
|| order
== floatformat_littlebyte_bigword
)
2639 /* Move towards the most significant part of the field. */
2640 while (cur_bitshift
< len
)
2642 if (len
- cur_bitshift
< FLOATFORMAT_CHAR_BIT
)
2644 /* This is the last byte. */
2645 *(data
+ cur_byte
) &=
2646 ~((1 << (len
- cur_bitshift
)) - 1);
2647 *(data
+ cur_byte
) |= (stuff_to_put
>> cur_bitshift
);
2650 *(data
+ cur_byte
) = ((stuff_to_put
>> cur_bitshift
)
2651 & ((1 << FLOATFORMAT_CHAR_BIT
) - 1));
2652 cur_bitshift
+= FLOATFORMAT_CHAR_BIT
;
2653 if (order
== floatformat_little
|| order
== floatformat_littlebyte_bigword
)
2660 #ifdef HAVE_LONG_DOUBLE
2661 /* Return the fractional part of VALUE, and put the exponent of VALUE in *EPTR.
2662 The range of the returned value is >= 0.5 and < 1.0. This is equivalent to
2663 frexp, but operates on the long double data type. */
2665 static long double ldfrexp
PARAMS ((long double value
, int *eptr
));
2668 ldfrexp (value
, eptr
)
2675 /* Unfortunately, there are no portable functions for extracting the exponent
2676 of a long double, so we have to do it iteratively by multiplying or dividing
2677 by two until the fraction is between 0.5 and 1.0. */
2685 if (value
>= tmp
) /* Value >= 1.0 */
2686 while (value
>= tmp
)
2691 else if (value
!= 0.0l) /* Value < 1.0 and > 0.0 */
2705 #endif /* HAVE_LONG_DOUBLE */
2708 /* The converse: convert the DOUBLEST *FROM to an extended float
2709 and store where TO points. Neither FROM nor TO have any alignment
2713 floatformat_from_doublest (fmt
, from
, to
)
2714 CONST
struct floatformat
*fmt
;
2721 unsigned int mant_bits
, mant_off
;
2723 unsigned char *uto
= (unsigned char *)to
;
2725 memcpy (&dfrom
, from
, sizeof (dfrom
));
2726 memset (uto
, 0, fmt
->totalsize
/ FLOATFORMAT_CHAR_BIT
);
2728 return; /* Result is zero */
2729 if (dfrom
!= dfrom
) /* Result is NaN */
2732 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->exp_start
,
2733 fmt
->exp_len
, fmt
->exp_nan
);
2734 /* Be sure it's not infinity, but NaN value is irrel */
2735 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->man_start
,
2740 /* If negative, set the sign bit. */
2743 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->sign_start
, 1, 1);
2747 if (dfrom
+ dfrom
== dfrom
&& dfrom
!= 0.0) /* Result is Infinity */
2749 /* Infinity exponent is same as NaN's. */
2750 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->exp_start
,
2751 fmt
->exp_len
, fmt
->exp_nan
);
2752 /* Infinity mantissa is all zeroes. */
2753 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->man_start
,
2758 #ifdef HAVE_LONG_DOUBLE
2759 mant
= ldfrexp (dfrom
, &exponent
);
2761 mant
= frexp (dfrom
, &exponent
);
2764 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->exp_start
, fmt
->exp_len
,
2765 exponent
+ fmt
->exp_bias
- 1);
2767 mant_bits_left
= fmt
->man_len
;
2768 mant_off
= fmt
->man_start
;
2769 while (mant_bits_left
> 0)
2771 unsigned long mant_long
;
2772 mant_bits
= mant_bits_left
< 32 ? mant_bits_left
: 32;
2774 mant
*= 4294967296.0;
2775 mant_long
= (unsigned long)mant
;
2778 /* If the integer bit is implicit, then we need to discard it.
2779 If we are discarding a zero, we should be (but are not) creating
2780 a denormalized number which means adjusting the exponent
2782 if (mant_bits_left
== fmt
->man_len
2783 && fmt
->intbit
== floatformat_intbit_no
)
2791 /* The bits we want are in the most significant MANT_BITS bits of
2792 mant_long. Move them to the least significant. */
2793 mant_long
>>= 32 - mant_bits
;
2796 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
,
2797 mant_off
, mant_bits
, mant_long
);
2798 mant_off
+= mant_bits
;
2799 mant_bits_left
-= mant_bits
;
2801 if (fmt
-> byteorder
== floatformat_littlebyte_bigword
)
2804 unsigned char *swaplow
= uto
;
2805 unsigned char *swaphigh
= uto
+ 4;
2808 for (count
= 0; count
< 4; count
++)
2811 *swaplow
++ = *swaphigh
;
2817 /* temporary storage using circular buffer */
2823 static char buf
[NUMCELLS
][CELLSIZE
];
2825 if (++cell
>=NUMCELLS
) cell
=0;
2829 /* print routines to handle variable size regs, etc.
2831 FIXME: Note that t_addr is a bfd_vma, which is currently either an
2832 unsigned long or unsigned long long, determined at configure time.
2833 If t_addr is an unsigned long long and sizeof (unsigned long long)
2834 is greater than sizeof (unsigned long), then I believe this code will
2835 probably lose, at least for little endian machines. I believe that
2836 it would also be better to eliminate the switch on the absolute size
2837 of t_addr and replace it with a sequence of if statements that compare
2838 sizeof t_addr with sizeof the various types and do the right thing,
2839 which includes knowing whether or not the host supports long long.
2844 static int thirty_two
= 32; /* eliminate warning from compiler on 32-bit systems */
2850 char *paddr_str
=get_cell();
2851 switch (sizeof(t_addr
))
2854 sprintf (paddr_str
, "%08lx%08lx",
2855 (unsigned long) (addr
>> thirty_two
), (unsigned long) (addr
& 0xffffffff));
2858 sprintf (paddr_str
, "%08lx", (unsigned long) addr
);
2861 sprintf (paddr_str
, "%04x", (unsigned short) (addr
& 0xffff));
2864 sprintf (paddr_str
, "%lx", (unsigned long) addr
);
2873 char *preg_str
=get_cell();
2874 switch (sizeof(t_reg
))
2877 sprintf (preg_str
, "%08lx%08lx",
2878 (unsigned long) (reg
>> thirty_two
), (unsigned long) (reg
& 0xffffffff));
2881 sprintf (preg_str
, "%08lx", (unsigned long) reg
);
2884 sprintf (preg_str
, "%04x", (unsigned short) (reg
& 0xffff));
2887 sprintf (preg_str
, "%lx", (unsigned long) reg
);
2896 char *paddr_str
=get_cell();
2897 switch (sizeof(t_addr
))
2901 unsigned long high
= (unsigned long) (addr
>> thirty_two
);
2903 sprintf (paddr_str
, "%lx", (unsigned long) (addr
& 0xffffffff));
2905 sprintf (paddr_str
, "%lx%08lx",
2906 high
, (unsigned long) (addr
& 0xffffffff));
2910 sprintf (paddr_str
, "%lx", (unsigned long) addr
);
2913 sprintf (paddr_str
, "%x", (unsigned short) (addr
& 0xffff));
2916 sprintf (paddr_str
,"%lx", (unsigned long) addr
);
2925 char *preg_str
=get_cell();
2926 switch (sizeof(t_reg
))
2930 unsigned long high
= (unsigned long) (reg
>> thirty_two
);
2932 sprintf (preg_str
, "%lx", (unsigned long) (reg
& 0xffffffff));
2934 sprintf (preg_str
, "%lx%08lx",
2935 high
, (unsigned long) (reg
& 0xffffffff));
2939 sprintf (preg_str
, "%lx", (unsigned long) reg
);
2942 sprintf (preg_str
, "%x", (unsigned short) (reg
& 0xffff));
2945 sprintf (preg_str
, "%lx", (unsigned long) reg
);