1 /* General utility routines for GDB, the GNU debugger.
2 Copyright 1986, 1989, 1990, 1991, 1992 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., 675 Mass Ave, Cambridge, MA 02139, USA. */
21 #if !defined(__GO32__)
22 #include <sys/ioctl.h>
23 #include <sys/param.h>
37 /* Prototypes for local functions */
39 #if !defined (NO_MALLOC_CHECK)
42 malloc_botch PARAMS ((void));
44 #endif /* NO_MALLOC_CHECK */
47 fatal_dump_core (); /* Can't prototype with <varargs.h> usage... */
50 prompt_for_continue PARAMS ((void));
53 set_width_command PARAMS ((char *, int, struct cmd_list_element *));
56 vfprintf_filtered PARAMS ((FILE *, char *, va_list));
58 /* If this definition isn't overridden by the header files, assume
59 that isatty and fileno exist on this system. */
61 #define ISATTY(FP) (isatty (fileno (FP)))
64 /* Chain of cleanup actions established with make_cleanup,
65 to be executed if an error happens. */
67 static struct cleanup *cleanup_chain;
69 /* Nonzero means a quit has been requested. */
73 /* Nonzero means quit immediately if Control-C is typed now,
74 rather than waiting until QUIT is executed. */
78 /* Nonzero means that encoded C++ names should be printed out in their
79 C++ form rather than raw. */
83 /* Nonzero means that encoded C++ names should be printed out in their
84 C++ form even in assembler language displays. If this is set, but
85 DEMANGLE is zero, names are printed raw, i.e. DEMANGLE controls. */
89 /* Nonzero means that strings with character values >0x7F should be printed
90 as octal escapes. Zero means just print the value (e.g. it's an
91 international character, and the terminal or window can cope.) */
93 int sevenbit_strings = 0;
95 /* String to be printed before error messages, if any. */
97 char *error_pre_print;
98 char *warning_pre_print = "\nwarning: ";
100 /* Add a new cleanup to the cleanup_chain,
101 and return the previous chain pointer
102 to be passed later to do_cleanups or discard_cleanups.
103 Args are FUNCTION to clean up with, and ARG to pass to it. */
106 make_cleanup (function, arg)
107 void (*function) PARAMS ((PTR));
110 register struct cleanup *new
111 = (struct cleanup *) xmalloc (sizeof (struct cleanup));
112 register struct cleanup *old_chain = cleanup_chain;
114 new->next = cleanup_chain;
115 new->function = function;
122 /* Discard cleanups and do the actions they describe
123 until we get back to the point OLD_CHAIN in the cleanup_chain. */
126 do_cleanups (old_chain)
127 register struct cleanup *old_chain;
129 register struct cleanup *ptr;
130 while ((ptr = cleanup_chain) != old_chain)
132 cleanup_chain = ptr->next; /* Do this first incase recursion */
133 (*ptr->function) (ptr->arg);
138 /* Discard cleanups, not doing the actions they describe,
139 until we get back to the point OLD_CHAIN in the cleanup_chain. */
142 discard_cleanups (old_chain)
143 register struct cleanup *old_chain;
145 register struct cleanup *ptr;
146 while ((ptr = cleanup_chain) != old_chain)
148 cleanup_chain = ptr->next;
153 /* Set the cleanup_chain to 0, and return the old cleanup chain. */
157 struct cleanup *old_chain = cleanup_chain;
163 /* Restore the cleanup chain from a previously saved chain. */
165 restore_cleanups (chain)
166 struct cleanup *chain;
168 cleanup_chain = chain;
171 /* This function is useful for cleanups.
175 old_chain = make_cleanup (free_current_contents, &foo);
177 to arrange to free the object thus allocated. */
180 free_current_contents (location)
186 /* Provide a known function that does nothing, to use as a base for
187 for a possibly long chain of cleanups. This is useful where we
188 use the cleanup chain for handling normal cleanups as well as dealing
189 with cleanups that need to be done as a result of a call to error().
190 In such cases, we may not be certain where the first cleanup is, unless
191 we have a do-nothing one to always use as the base. */
201 /* Provide a hook for modules wishing to print their own warning messages
202 to set up the terminal state in a compatible way, without them having
203 to import all the target_<...> macros. */
208 target_terminal_ours ();
209 wrap_here(""); /* Force out any buffered output */
213 /* Print a warning message.
214 The first argument STRING is the warning message, used as a fprintf string,
215 and the remaining args are passed as arguments to it.
216 The primary difference between warnings and errors is that a warning
217 does not force the return to command level. */
228 target_terminal_ours ();
229 wrap_here(""); /* Force out any buffered output */
231 if (warning_pre_print)
232 fprintf (stderr, warning_pre_print);
233 string = va_arg (args, char *);
234 vfprintf (stderr, string, args);
235 fprintf (stderr, "\n");
239 /* Print an error message and return to command level.
240 The first argument STRING is the error message, used as a fprintf string,
241 and the remaining args are passed as arguments to it. */
252 target_terminal_ours ();
253 wrap_here(""); /* Force out any buffered output */
256 fprintf_filtered (stderr, error_pre_print);
257 string = va_arg (args, char *);
258 vfprintf_filtered (stderr, string, args);
259 fprintf_filtered (stderr, "\n");
261 return_to_top_level ();
264 /* Print an error message and exit reporting failure.
265 This is for a error that we cannot continue from.
266 The arguments are printed a la printf.
268 This function cannot be declared volatile (NORETURN) in an
269 ANSI environment because exit() is not declared volatile. */
280 string = va_arg (args, char *);
281 fprintf (stderr, "\ngdb: ");
282 vfprintf (stderr, string, args);
283 fprintf (stderr, "\n");
288 /* Print an error message and exit, dumping core.
289 The arguments are printed a la printf (). */
293 fatal_dump_core (va_alist)
300 string = va_arg (args, char *);
301 /* "internal error" is always correct, since GDB should never dump
302 core, no matter what the input. */
303 fprintf (stderr, "\ngdb internal error: ");
304 vfprintf (stderr, string, args);
305 fprintf (stderr, "\n");
308 signal (SIGQUIT, SIG_DFL);
309 kill (getpid (), SIGQUIT);
310 /* We should never get here, but just in case... */
314 /* The strerror() function can return NULL for errno values that are
315 out of range. Provide a "safe" version that always returns a
319 safe_strerror (errnum)
325 if ((msg = strerror (errnum)) == NULL)
327 sprintf (buf, "(undocumented errno %d)", errnum);
333 /* The strsignal() function can return NULL for signal values that are
334 out of range. Provide a "safe" version that always returns a
338 safe_strsignal (signo)
344 if ((msg = strsignal (signo)) == NULL)
346 sprintf (buf, "(undocumented signal %d)", signo);
353 /* Print the system error message for errno, and also mention STRING
354 as the file name for which the error was encountered.
355 Then return to command level. */
358 perror_with_name (string)
364 err = safe_strerror (errno);
365 combined = (char *) alloca (strlen (err) + strlen (string) + 3);
366 strcpy (combined, string);
367 strcat (combined, ": ");
368 strcat (combined, err);
370 /* I understand setting these is a matter of taste. Still, some people
371 may clear errno but not know about bfd_error. Doing this here is not
373 bfd_error = no_error;
376 error ("%s.", combined);
379 /* Print the system error message for ERRCODE, and also mention STRING
380 as the file name for which the error was encountered. */
383 print_sys_errmsg (string, errcode)
390 err = safe_strerror (errcode);
391 combined = (char *) alloca (strlen (err) + strlen (string) + 3);
392 strcpy (combined, string);
393 strcat (combined, ": ");
394 strcat (combined, err);
396 fprintf (stderr, "%s.\n", combined);
399 /* Control C eventually causes this to be called, at a convenient time. */
404 target_terminal_ours ();
405 wrap_here ((char *)0); /* Force out any pending output */
406 #if !defined(__GO32__)
408 ioctl (fileno (stdout), TCFLSH, 1);
409 #else /* not HAVE_TERMIO */
410 ioctl (fileno (stdout), TIOCFLUSH, 0);
411 #endif /* not HAVE_TERMIO */
415 error ("Quit (expect signal %d when inferior is resumed)", SIGINT);
416 #endif /* TIOCGPGRP */
420 /* Control C comes here */
429 /* Restore the signal handler. */
430 signal (signo, request_quit);
438 /* Memory management stuff (malloc friends). */
440 #if defined (NO_MMALLOC)
447 return (malloc (size));
451 mrealloc (md, ptr, size)
456 if (ptr == 0) /* Guard against old realloc's */
457 return malloc (size);
459 return realloc (ptr, size);
470 #endif /* NO_MMALLOC */
472 #if defined (NO_MMALLOC) || defined (NO_MMALLOC_CHECK)
480 #else /* have mmalloc and want corruption checking */
485 fatal_dump_core ("Memory corruption");
488 /* Attempt to install hooks in mmalloc/mrealloc/mfree for the heap specified
489 by MD, to detect memory corruption. Note that MD may be NULL to specify
490 the default heap that grows via sbrk.
492 Note that for freshly created regions, we must call mmcheck prior to any
493 mallocs in the region. Otherwise, any region which was allocated prior to
494 installing the checking hooks, which is later reallocated or freed, will
495 fail the checks! The mmcheck function only allows initial hooks to be
496 installed before the first mmalloc. However, anytime after we have called
497 mmcheck the first time to install the checking hooks, we can call it again
498 to update the function pointer to the memory corruption handler.
500 Returns zero on failure, non-zero on success. */
506 if (!mmcheck (md, malloc_botch))
508 warning ("internal error: failed to install memory consistency checks");
514 #endif /* Have mmalloc and want corruption checking */
516 /* Called when a memory allocation fails, with the number of bytes of
517 memory requested in SIZE. */
525 fatal ("virtual memory exhausted: can't allocate %ld bytes.", size);
529 fatal ("virtual memory exhausted.");
533 /* Like mmalloc but get error if no storage available, and protect against
534 the caller wanting to allocate zero bytes. Whether to return NULL for
535 a zero byte request, or translate the request into a request for one
536 byte of zero'd storage, is a religious issue. */
549 else if ((val = mmalloc (md, size)) == NULL)
556 /* Like mrealloc but get error if no storage available. */
559 xmrealloc (md, ptr, size)
568 val = mrealloc (md, ptr, size);
572 val = mmalloc (md, size);
581 /* Like malloc but get error if no storage available, and protect against
582 the caller wanting to allocate zero bytes. */
588 return (xmmalloc ((void *) NULL, size));
591 /* Like mrealloc but get error if no storage available. */
598 return (xmrealloc ((void *) NULL, ptr, size));
602 /* My replacement for the read system call.
603 Used like `read' but keeps going if `read' returns too soon. */
606 myread (desc, addr, len)
616 val = read (desc, addr, len);
627 /* Make a copy of the string at PTR with SIZE characters
628 (and add a null character at the end in the copy).
629 Uses malloc to get the space. Returns the address of the copy. */
632 savestring (ptr, size)
636 register char *p = (char *) xmalloc (size + 1);
637 memcpy (p, ptr, size);
643 msavestring (md, ptr, size)
648 register char *p = (char *) xmmalloc (md, size + 1);
649 memcpy (p, ptr, size);
654 /* The "const" is so it compiles under DGUX (which prototypes strsave
655 in <string.h>. FIXME: This should be named "xstrsave", shouldn't it?
656 Doesn't real strsave return NULL if out of memory? */
661 return savestring (ptr, strlen (ptr));
669 return (msavestring (md, ptr, strlen (ptr)));
673 print_spaces (n, file)
681 /* Ask user a y-or-n question and return 1 iff answer is yes.
682 Takes three args which are given to printf to print the question.
683 The first, a control string, should end in "? ".
684 It should not say how to answer, because we do that. */
696 /* Automatically answer "yes" if input is not from a terminal. */
697 if (!input_from_terminal_p ())
702 wrap_here (""); /* Flush any buffered output */
705 ctlstr = va_arg (args, char *);
706 energize_query (ctlstr, args);
707 vfprintf_filtered (stdout, ctlstr, args);
708 printf_filtered ("(y or n) ");
713 buf = energize_command_line_input(0, 0);
714 answer = buf ? *buf : 'Y';
715 energize_acknowledge_query(buf);
720 answer = fgetc (stdin);
721 clearerr (stdin); /* in case of C-d */
722 if (answer == EOF) /* C-d */
724 if (answer != '\n') /* Eat rest of input line, to EOF or newline */
727 ans2 = fgetc (stdin);
730 while (ans2 != EOF && ans2 != '\n');
738 printf_filtered ("Please answer y or n.\n");
744 /* Parse a C escape sequence. STRING_PTR points to a variable
745 containing a pointer to the string to parse. That pointer
746 should point to the character after the \. That pointer
747 is updated past the characters we use. The value of the
748 escape sequence is returned.
750 A negative value means the sequence \ newline was seen,
751 which is supposed to be equivalent to nothing at all.
753 If \ is followed by a null character, we return a negative
754 value and leave the string pointer pointing at the null character.
756 If \ is followed by 000, we return 0 and leave the string pointer
757 after the zeros. A value of 0 does not mean end of string. */
760 parse_escape (string_ptr)
763 register int c = *(*string_ptr)++;
767 return 007; /* Bell (alert) char */
770 case 'e': /* Escape character */
788 c = *(*string_ptr)++;
790 c = parse_escape (string_ptr);
793 return (c & 0200) | (c & 037);
804 register int i = c - '0';
805 register int count = 0;
808 if ((c = *(*string_ptr)++) >= '0' && c <= '7')
826 /* Print the character C on STREAM as part of the contents
827 of a literal string whose delimiter is QUOTER. */
830 printchar (c, stream, quoter)
836 c &= 0xFF; /* Avoid sign bit follies */
838 if ( c < 0x20 || /* Low control chars */
839 (c >= 0x7F && c < 0xA0) || /* DEL, High controls */
840 (sevenbit_strings && c >= 0x80)) { /* high order bit set */
844 fputs_filtered ("\\n", stream);
847 fputs_filtered ("\\b", stream);
850 fputs_filtered ("\\t", stream);
853 fputs_filtered ("\\f", stream);
856 fputs_filtered ("\\r", stream);
859 fputs_filtered ("\\e", stream);
862 fputs_filtered ("\\a", stream);
865 fprintf_filtered (stream, "\\%.3o", (unsigned int) c);
869 if (c == '\\' || c == quoter)
870 fputs_filtered ("\\", stream);
871 fprintf_filtered (stream, "%c", c);
875 /* Number of lines per page or UINT_MAX if paging is disabled. */
876 static unsigned int lines_per_page;
877 /* Number of chars per line or UNIT_MAX is line folding is disabled. */
878 static unsigned int chars_per_line;
879 /* Current count of lines printed on this page, chars on this line. */
880 static unsigned int lines_printed, chars_printed;
882 /* Buffer and start column of buffered text, for doing smarter word-
883 wrapping. When someone calls wrap_here(), we start buffering output
884 that comes through fputs_filtered(). If we see a newline, we just
885 spit it out and forget about the wrap_here(). If we see another
886 wrap_here(), we spit it out and remember the newer one. If we see
887 the end of the line, we spit out a newline, the indent, and then
890 wrap_column is the column number on the screen where wrap_buffer begins.
891 When wrap_column is zero, wrapping is not in effect.
892 wrap_buffer is malloc'd with chars_per_line+2 bytes.
893 When wrap_buffer[0] is null, the buffer is empty.
894 wrap_pointer points into it at the next character to fill.
895 wrap_indent is the string that should be used as indentation if the
898 static char *wrap_buffer, *wrap_pointer, *wrap_indent;
899 static int wrap_column;
903 set_width_command (args, from_tty, c)
906 struct cmd_list_element *c;
910 wrap_buffer = (char *) xmalloc (chars_per_line + 2);
911 wrap_buffer[0] = '\0';
914 wrap_buffer = (char *) xrealloc (wrap_buffer, chars_per_line + 2);
915 wrap_pointer = wrap_buffer; /* Start it at the beginning */
919 prompt_for_continue ()
924 ignore = gdb_readline ("---Type <return> to continue---");
927 chars_printed = lines_printed = 0;
929 dont_repeat (); /* Forget prev cmd -- CR won't repeat it. */
932 /* Reinitialize filter; ie. tell it to reset to original values. */
935 reinitialize_more_filter ()
941 /* Indicate that if the next sequence of characters overflows the line,
942 a newline should be inserted here rather than when it hits the end.
943 If INDENT is nonzero, it is a string to be printed to indent the
944 wrapped part on the next line. INDENT must remain accessible until
945 the next call to wrap_here() or until a newline is printed through
948 If the line is already overfull, we immediately print a newline and
949 the indentation, and disable further wrapping.
951 If we don't know the width of lines, but we know the page height,
952 we must not wrap words, but should still keep track of newlines
953 that were explicitly printed.
955 INDENT should not contain tabs, as that
956 will mess up the char count on the next line. FIXME. */
964 *wrap_pointer = '\0';
965 fputs (wrap_buffer, stdout);
967 wrap_pointer = wrap_buffer;
968 wrap_buffer[0] = '\0';
969 if (chars_per_line == UINT_MAX) /* No line overflow checking */
973 else if (chars_printed >= chars_per_line)
975 puts_filtered ("\n");
976 puts_filtered (indent);
981 wrap_column = chars_printed;
982 wrap_indent = indent;
986 /* Like fputs but pause after every screenful, and can wrap at points
987 other than the final character of a line.
988 Unlike fputs, fputs_filtered does not return a value.
989 It is OK for LINEBUFFER to be NULL, in which case just don't print
992 Note that a longjmp to top level may occur in this routine
993 (since prompt_for_continue may do so) so this routine should not be
994 called when cleanups are not in place. */
997 fputs_filtered (linebuffer, stream)
998 const char *linebuffer;
1001 const char *lineptr;
1003 if (linebuffer == 0)
1008 energize_fputs(linebuffer);
1012 /* Don't do any filtering if it is disabled. */
1013 if (stream != stdout
1014 || (lines_per_page == UINT_MAX && chars_per_line == UINT_MAX))
1016 fputs (linebuffer, stream);
1020 /* Go through and output each character. Show line extension
1021 when this is necessary; prompt user for new page when this is
1024 lineptr = linebuffer;
1027 /* Possible new page. */
1028 if (lines_printed >= lines_per_page - 1)
1029 prompt_for_continue ();
1031 while (*lineptr && *lineptr != '\n')
1033 /* Print a single line. */
1034 if (*lineptr == '\t')
1037 *wrap_pointer++ = '\t';
1039 putc ('\t', stream);
1040 /* Shifting right by 3 produces the number of tab stops
1041 we have already passed, and then adding one and
1042 shifting left 3 advances to the next tab stop. */
1043 chars_printed = ((chars_printed >> 3) + 1) << 3;
1049 *wrap_pointer++ = *lineptr;
1051 putc (*lineptr, stream);
1056 if (chars_printed >= chars_per_line)
1058 unsigned int save_chars = chars_printed;
1062 /* If we aren't actually wrapping, don't output newline --
1063 if chars_per_line is right, we probably just overflowed
1064 anyway; if it's wrong, let us keep going. */
1066 putc ('\n', stream);
1068 /* Possible new page. */
1069 if (lines_printed >= lines_per_page - 1)
1070 prompt_for_continue ();
1072 /* Now output indentation and wrapped string */
1076 fputs (wrap_indent, stream);
1077 *wrap_pointer = '\0'; /* Null-terminate saved stuff */
1078 fputs (wrap_buffer, stream); /* and eject it */
1079 /* FIXME, this strlen is what prevents wrap_indent from
1080 containing tabs. However, if we recurse to print it
1081 and count its chars, we risk trouble if wrap_indent is
1082 longer than (the user settable) chars_per_line.
1083 Note also that this can set chars_printed > chars_per_line
1084 if we are printing a long string. */
1085 chars_printed = strlen (wrap_indent)
1086 + (save_chars - wrap_column);
1087 wrap_pointer = wrap_buffer; /* Reset buffer */
1088 wrap_buffer[0] = '\0';
1089 wrap_column = 0; /* And disable fancy wrap */
1094 if (*lineptr == '\n')
1097 wrap_here ((char *)0); /* Spit out chars, cancel further wraps */
1099 putc ('\n', stream);
1106 /* fputs_demangled is a variant of fputs_filtered that
1107 demangles g++ names.*/
1110 fputs_demangled (linebuffer, stream, arg_mode)
1115 #define SYMBOL_MAX 1024
1117 #define SYMBOL_CHAR(c) (isascii(c) \
1118 && (isalnum(c) || (c) == '_' || (c) == CPLUS_MARKER))
1120 char buf[SYMBOL_MAX+1];
1121 # define DMSLOP 5 /* How much room to leave in buf */
1124 if (linebuffer == NULL)
1127 /* If user wants to see raw output, no problem. */
1129 fputs_filtered (linebuffer, stream);
1135 while ( *p != (char) 0 ) {
1138 /* collect non-interesting characters into buf */
1139 while (*p != (char) 0 && !SYMBOL_CHAR(*p) && i < (int)sizeof(buf)-DMSLOP ) {
1144 /* output the non-interesting characters without demangling */
1146 fputs_filtered(buf, stream);
1147 i = 0; /* reset buf */
1150 /* and now the interesting characters */
1151 while (i < SYMBOL_MAX
1154 && i < (int)sizeof(buf) - DMSLOP) {
1162 if ( (result = cplus_demangle(buf, arg_mode)) != NULL ) {
1163 fputs_filtered(result, stream);
1167 fputs_filtered(buf, stream);
1173 /* Print a variable number of ARGS using format FORMAT. If this
1174 information is going to put the amount written (since the last call
1175 to INITIALIZE_MORE_FILTER or the last page break) over the page size,
1176 print out a pause message and do a gdb_readline to get the users
1177 permision to continue.
1179 Unlike fprintf, this function does not return a value.
1181 We implement three variants, vfprintf (takes a vararg list and stream),
1182 fprintf (takes a stream to write on), and printf (the usual).
1184 Note that this routine has a restriction that the length of the
1185 final output line must be less than 255 characters *or* it must be
1186 less than twice the size of the format string. This is a very
1187 arbitrary restriction, but it is an internal restriction, so I'll
1188 put it in. This means that the %s format specifier is almost
1189 useless; unless the caller can GUARANTEE that the string is short
1190 enough, fputs_filtered should be used instead.
1192 Note also that a longjmp to top level may occur in this routine
1193 (since prompt_for_continue may do so) so this routine should not be
1194 called when cleanups are not in place. */
1197 vfprintf_filtered (stream, format, args)
1202 static char *linebuffer = (char *) 0;
1203 static int line_size;
1206 format_length = strlen (format);
1208 /* Allocated linebuffer for the first time. */
1211 linebuffer = (char *) xmalloc (255);
1215 /* Reallocate buffer to a larger size if this is necessary. */
1216 if (format_length * 2 > line_size)
1218 line_size = format_length * 2;
1220 /* You don't have to copy. */
1222 linebuffer = (char *) xmalloc (line_size);
1226 /* This won't blow up if the restrictions described above are
1228 vsprintf (linebuffer, format, args);
1230 fputs_filtered (linebuffer, stream);
1235 fprintf_filtered (va_alist)
1243 stream = va_arg (args, FILE *);
1244 format = va_arg (args, char *);
1246 /* This won't blow up if the restrictions described above are
1248 vfprintf_filtered (stream, format, args);
1252 /* Like fprintf_filtered, but prints it's result indent.
1253 Called as fprintfi_filtered (spaces, format, arg1, arg2, ...); */
1257 fprintfi_filtered (va_alist)
1266 spaces = va_arg (args, int);
1267 stream = va_arg (args, FILE *);
1268 format = va_arg (args, char *);
1269 print_spaces_filtered (spaces, stream);
1271 /* This won't blow up if the restrictions described above are
1273 vfprintf_filtered (stream, format, args);
1279 printf_filtered (va_alist)
1286 format = va_arg (args, char *);
1288 vfprintf_filtered (stdout, format, args);
1292 /* Like printf_filtered, but prints it's result indented.
1293 Called as printfi_filtered (spaces, format, arg1, arg2, ...); */
1297 printfi_filtered (va_alist)
1305 spaces = va_arg (args, int);
1306 format = va_arg (args, char *);
1307 print_spaces_filtered (spaces, stdout);
1308 vfprintf_filtered (stdout, format, args);
1315 puts_filtered (string)
1318 fputs_filtered (string, stdout);
1321 /* Return a pointer to N spaces and a null. The pointer is good
1322 until the next call to here. */
1328 static char *spaces;
1329 static int max_spaces;
1335 spaces = (char *) xmalloc (n+1);
1336 for (t = spaces+n; t != spaces;)
1342 return spaces + max_spaces - n;
1345 /* Print N spaces. */
1347 print_spaces_filtered (n, stream)
1351 fputs_filtered (n_spaces (n), stream);
1354 /* C++ demangler stuff. */
1356 /* Make a copy of a symbol, applying C++ demangling if demangling is enabled
1357 and a demangled version exists. Note that the value returned from
1358 cplus_demangle is already allocated in malloc'd memory. */
1361 strdup_demangled (name)
1364 char *demangled = NULL;
1368 demangled = cplus_demangle (name, DMGL_PARAMS | DMGL_ANSI);
1370 return ((demangled != NULL) ? demangled : strdup (name));
1374 /* Print NAME on STREAM, demangling if necessary. */
1376 fprint_symbol (stream, name)
1382 || NULL == (demangled = cplus_demangle (name, DMGL_PARAMS | DMGL_ANSI)))
1383 fputs_filtered (name, stream);
1386 fputs_filtered (demangled, stream);
1391 /* Do a strcmp() type operation on STRING1 and STRING2, ignoring any
1392 differences in whitespace. Returns 0 if they match, non-zero if they
1393 don't (slightly different than strcmp()'s range of return values).
1395 As an extra hack, string1=="FOO(ARGS)" matches string2=="FOO".
1396 This "feature" is useful for demangle_and_match(), which is used
1397 when searching for matching C++ function names (such as if the
1398 user types 'break FOO', where FOO is a mangled C++ function). */
1401 strcmp_iw (string1, string2)
1402 const char *string1;
1403 const char *string2;
1405 while ((*string1 != '\0') && (*string2 != '\0'))
1407 while (isspace (*string1))
1411 while (isspace (*string2))
1415 if (*string1 != *string2)
1419 if (*string1 != '\0')
1425 return (*string1 != '\0' && *string1 != '(') || (*string2 != '\0');
1428 /* Demangle NAME and compare the result with LOOKFOR, ignoring any differences
1431 If a match is found, returns a pointer to the demangled version of NAME
1432 in malloc'd memory, which needs to be freed by the caller after use.
1433 If a match is not found, returns NULL.
1435 OPTIONS is a flags word that controls the demangling process and is just
1436 passed on to the demangler.
1438 When the caller sees a non-NULL result, it knows that NAME is the mangled
1439 equivalent of LOOKFOR, and it can use either NAME, the "official demangled"
1440 version of NAME (the return value) or the "unofficial demangled" version
1441 of NAME (LOOKFOR, which it already knows). */
1444 demangle_and_match (name, lookfor, options)
1446 const char *lookfor;
1451 if ((demangled = cplus_demangle (name, options)) != NULL)
1453 if (strcmp_iw (demangled, lookfor) != 0)
1464 _initialize_utils ()
1466 struct cmd_list_element *c;
1468 c = add_set_cmd ("width", class_support, var_uinteger,
1469 (char *)&chars_per_line,
1470 "Set number of characters gdb thinks are in a line.",
1472 add_show_from_set (c, &showlist);
1473 c->function.sfunc = set_width_command;
1476 (add_set_cmd ("height", class_support,
1477 var_uinteger, (char *)&lines_per_page,
1478 "Set number of lines gdb thinks are in a page.", &setlist),
1481 /* These defaults will be used if we are unable to get the correct
1482 values from termcap. */
1483 #if defined(__GO32__)
1484 lines_per_page = ScreenRows();
1485 chars_per_line = ScreenCols();
1487 lines_per_page = 24;
1488 chars_per_line = 80;
1489 /* Initialize the screen height and width from termcap. */
1491 char *termtype = getenv ("TERM");
1493 /* Positive means success, nonpositive means failure. */
1496 /* 2048 is large enough for all known terminals, according to the
1497 GNU termcap manual. */
1498 char term_buffer[2048];
1502 status = tgetent (term_buffer, termtype);
1507 val = tgetnum ("li");
1509 lines_per_page = val;
1511 /* The number of lines per page is not mentioned
1512 in the terminal description. This probably means
1513 that paging is not useful (e.g. emacs shell window),
1514 so disable paging. */
1515 lines_per_page = UINT_MAX;
1517 val = tgetnum ("co");
1519 chars_per_line = val;
1524 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1526 /* If there is a better way to determine the window size, use it. */
1527 SIGWINCH_HANDLER ();
1530 /* If the output is not a terminal, don't paginate it. */
1531 if (!ISATTY (stdout))
1532 lines_per_page = UINT_MAX;
1534 set_width_command ((char *)NULL, 0, c);
1537 (add_set_cmd ("demangle", class_support, var_boolean,
1539 "Set demangling of encoded C++ names when displaying symbols.",
1544 (add_set_cmd ("sevenbit-strings", class_support, var_boolean,
1545 (char *)&sevenbit_strings,
1546 "Set printing of 8-bit characters in strings as \\nnn.",
1551 (add_set_cmd ("asm-demangle", class_support, var_boolean,
1552 (char *)&asm_demangle,
1553 "Set demangling of C++ names in disassembly listings.",
1558 /* Machine specific function to handle SIGWINCH signal. */
1560 #ifdef SIGWINCH_HANDLER_BODY
1561 SIGWINCH_HANDLER_BODY