(defaulted_query): Don't ask for confirmation if server
[external/binutils.git] / gdb / utils.c
1 /* General utility routines for GDB, the GNU debugger.
2
3    Copyright (C) 1986, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
4    1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008,
5    2009 Free Software Foundation, Inc.
6
7    This file is part of GDB.
8
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 3 of the License, or
12    (at your option) any later version.
13
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.
18
19    You should have received a copy of the GNU General Public License
20    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
21
22 #include "defs.h"
23 #include "gdb_assert.h"
24 #include <ctype.h>
25 #include "gdb_string.h"
26 #include "event-top.h"
27 #include "exceptions.h"
28 #include "gdbthread.h"
29
30 #ifdef TUI
31 #include "tui/tui.h"            /* For tui_get_command_dimension.   */
32 #endif
33
34 #ifdef __GO32__
35 #include <pc.h>
36 #endif
37
38 /* SunOS's curses.h has a '#define reg register' in it.  Thank you Sun. */
39 #ifdef reg
40 #undef reg
41 #endif
42
43 #include <signal.h>
44 #include "gdbcmd.h"
45 #include "serial.h"
46 #include "bfd.h"
47 #include "target.h"
48 #include "demangle.h"
49 #include "expression.h"
50 #include "language.h"
51 #include "charset.h"
52 #include "annotate.h"
53 #include "filenames.h"
54 #include "symfile.h"
55 #include "gdb_obstack.h"
56 #include "gdbcore.h"
57 #include "top.h"
58
59 #include "inferior.h"           /* for signed_pointer_to_address */
60
61 #include <sys/param.h>          /* For MAXPATHLEN */
62
63 #include "gdb_curses.h"
64
65 #include "readline/readline.h"
66
67 #include <sys/time.h>
68 #include <time.h>
69
70 #include "gdb_usleep.h"
71
72 #if !HAVE_DECL_MALLOC
73 extern PTR malloc ();           /* ARI: PTR */
74 #endif
75 #if !HAVE_DECL_REALLOC
76 extern PTR realloc ();          /* ARI: PTR */
77 #endif
78 #if !HAVE_DECL_FREE
79 extern void free ();
80 #endif
81
82 /* readline defines this.  */
83 #undef savestring
84
85 void (*deprecated_error_begin_hook) (void);
86
87 /* Prototypes for local functions */
88
89 static void vfprintf_maybe_filtered (struct ui_file *, const char *,
90                                      va_list, int) ATTR_FORMAT (printf, 2, 0);
91
92 static void fputs_maybe_filtered (const char *, struct ui_file *, int);
93
94 static void do_my_cleanups (struct cleanup **, struct cleanup *);
95
96 static void prompt_for_continue (void);
97
98 static void set_screen_size (void);
99 static void set_width (void);
100
101 /* A flag indicating whether to timestamp debugging messages.  */
102
103 static int debug_timestamp = 0;
104
105 /* Chain of cleanup actions established with make_cleanup,
106    to be executed if an error happens.  */
107
108 static struct cleanup *cleanup_chain;   /* cleaned up after a failed command */
109 static struct cleanup *final_cleanup_chain;     /* cleaned up when gdb exits */
110
111 /* Nonzero if we have job control. */
112
113 int job_control;
114
115 /* Nonzero means a quit has been requested.  */
116
117 int quit_flag;
118
119 /* Nonzero means quit immediately if Control-C is typed now, rather
120    than waiting until QUIT is executed.  Be careful in setting this;
121    code which executes with immediate_quit set has to be very careful
122    about being able to deal with being interrupted at any time.  It is
123    almost always better to use QUIT; the only exception I can think of
124    is being able to quit out of a system call (using EINTR loses if
125    the SIGINT happens between the previous QUIT and the system call).
126    To immediately quit in the case in which a SIGINT happens between
127    the previous QUIT and setting immediate_quit (desirable anytime we
128    expect to block), call QUIT after setting immediate_quit.  */
129
130 int immediate_quit;
131
132 /* Nonzero means that encoded C++/ObjC names should be printed out in their
133    C++/ObjC form rather than raw.  */
134
135 int demangle = 1;
136 static void
137 show_demangle (struct ui_file *file, int from_tty,
138                struct cmd_list_element *c, const char *value)
139 {
140   fprintf_filtered (file, _("\
141 Demangling of encoded C++/ObjC names when displaying symbols is %s.\n"),
142                     value);
143 }
144
145 /* Nonzero means that encoded C++/ObjC names should be printed out in their
146    C++/ObjC form even in assembler language displays.  If this is set, but
147    DEMANGLE is zero, names are printed raw, i.e. DEMANGLE controls.  */
148
149 int asm_demangle = 0;
150 static void
151 show_asm_demangle (struct ui_file *file, int from_tty,
152                    struct cmd_list_element *c, const char *value)
153 {
154   fprintf_filtered (file, _("\
155 Demangling of C++/ObjC names in disassembly listings is %s.\n"),
156                     value);
157 }
158
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.)  */
162
163 int sevenbit_strings = 0;
164 static void
165 show_sevenbit_strings (struct ui_file *file, int from_tty,
166                        struct cmd_list_element *c, const char *value)
167 {
168   fprintf_filtered (file, _("\
169 Printing of 8-bit characters in strings as \\nnn is %s.\n"),
170                     value);
171 }
172
173 /* String to be printed before error messages, if any.  */
174
175 char *error_pre_print;
176
177 /* String to be printed before quit messages, if any.  */
178
179 char *quit_pre_print;
180
181 /* String to be printed before warning messages, if any.  */
182
183 char *warning_pre_print = "\nwarning: ";
184
185 int pagination_enabled = 1;
186 static void
187 show_pagination_enabled (struct ui_file *file, int from_tty,
188                          struct cmd_list_element *c, const char *value)
189 {
190   fprintf_filtered (file, _("State of pagination is %s.\n"), value);
191 }
192
193 \f
194
195 /* Add a new cleanup to the cleanup_chain,
196    and return the previous chain pointer
197    to be passed later to do_cleanups or discard_cleanups.
198    Args are FUNCTION to clean up with, and ARG to pass to it.  */
199
200 struct cleanup *
201 make_cleanup (make_cleanup_ftype *function, void *arg)
202 {
203   return make_my_cleanup (&cleanup_chain, function, arg);
204 }
205
206 struct cleanup *
207 make_cleanup_dtor (make_cleanup_ftype *function, void *arg,
208                    void (*dtor) (void *))
209 {
210   return make_my_cleanup2 (&cleanup_chain,
211                            function, arg, dtor);
212 }
213
214 struct cleanup *
215 make_final_cleanup (make_cleanup_ftype *function, void *arg)
216 {
217   return make_my_cleanup (&final_cleanup_chain, function, arg);
218 }
219
220 static void
221 do_freeargv (void *arg)
222 {
223   freeargv ((char **) arg);
224 }
225
226 struct cleanup *
227 make_cleanup_freeargv (char **arg)
228 {
229   return make_my_cleanup (&cleanup_chain, do_freeargv, arg);
230 }
231
232 static void
233 do_bfd_close_cleanup (void *arg)
234 {
235   bfd_close (arg);
236 }
237
238 struct cleanup *
239 make_cleanup_bfd_close (bfd *abfd)
240 {
241   return make_cleanup (do_bfd_close_cleanup, abfd);
242 }
243
244 static void
245 do_close_cleanup (void *arg)
246 {
247   int *fd = arg;
248   close (*fd);
249 }
250
251 struct cleanup *
252 make_cleanup_close (int fd)
253 {
254   int *saved_fd = xmalloc (sizeof (fd));
255   *saved_fd = fd;
256   return make_cleanup_dtor (do_close_cleanup, saved_fd, xfree);
257 }
258
259 /* Helper function which does the work for make_cleanup_fclose.  */
260
261 static void
262 do_fclose_cleanup (void *arg)
263 {
264   FILE *file = arg;
265   fclose (arg);
266 }
267
268 /* Return a new cleanup that closes FILE.  */
269
270 struct cleanup *
271 make_cleanup_fclose (FILE *file)
272 {
273   return make_cleanup (do_fclose_cleanup, file);
274 }
275
276 /* Helper function which does the work for make_cleanup_obstack_free.  */
277
278 static void
279 do_obstack_free (void *arg)
280 {
281   struct obstack *ob = arg;
282   obstack_free (ob, NULL);
283 }
284
285 /* Return a new cleanup that frees OBSTACK.  */
286
287 struct cleanup *
288 make_cleanup_obstack_free (struct obstack *obstack)
289 {
290   return make_cleanup (do_obstack_free, obstack);
291 }
292
293 static void
294 do_ui_file_delete (void *arg)
295 {
296   ui_file_delete (arg);
297 }
298
299 struct cleanup *
300 make_cleanup_ui_file_delete (struct ui_file *arg)
301 {
302   return make_my_cleanup (&cleanup_chain, do_ui_file_delete, arg);
303 }
304
305 static void
306 do_free_section_addr_info (void *arg)
307 {
308   free_section_addr_info (arg);
309 }
310
311 struct cleanup *
312 make_cleanup_free_section_addr_info (struct section_addr_info *addrs)
313 {
314   return make_my_cleanup (&cleanup_chain, do_free_section_addr_info, addrs);
315 }
316
317 struct restore_integer_closure
318 {
319   int *variable;
320   int value;
321 };
322
323 static void
324 restore_integer (void *p)
325 {
326   struct restore_integer_closure *closure = p;
327   *(closure->variable) = closure->value;
328 }
329
330 /* Remember the current value of *VARIABLE and make it restored when the cleanup
331    is run.  */
332 struct cleanup *
333 make_cleanup_restore_integer (int *variable)
334 {
335   struct restore_integer_closure *c =
336     xmalloc (sizeof (struct restore_integer_closure));
337   c->variable = variable;
338   c->value = *variable;
339
340   return make_my_cleanup2 (&cleanup_chain, restore_integer, (void *)c,
341                            xfree);
342 }
343
344 struct cleanup *
345 make_my_cleanup2 (struct cleanup **pmy_chain, make_cleanup_ftype *function,
346                   void *arg,  void (*free_arg) (void *))
347 {
348   struct cleanup *new
349     = (struct cleanup *) xmalloc (sizeof (struct cleanup));
350   struct cleanup *old_chain = *pmy_chain;
351
352   new->next = *pmy_chain;
353   new->function = function;
354   new->free_arg = free_arg;
355   new->arg = arg;
356   *pmy_chain = new;
357
358   return old_chain;
359 }
360
361 struct cleanup *
362 make_my_cleanup (struct cleanup **pmy_chain, make_cleanup_ftype *function,
363                  void *arg)
364 {
365   return make_my_cleanup2 (pmy_chain, function, arg, NULL);
366 }
367
368 /* Discard cleanups and do the actions they describe
369    until we get back to the point OLD_CHAIN in the cleanup_chain.  */
370
371 void
372 do_cleanups (struct cleanup *old_chain)
373 {
374   do_my_cleanups (&cleanup_chain, old_chain);
375 }
376
377 void
378 do_final_cleanups (struct cleanup *old_chain)
379 {
380   do_my_cleanups (&final_cleanup_chain, old_chain);
381 }
382
383 static void
384 do_my_cleanups (struct cleanup **pmy_chain,
385                 struct cleanup *old_chain)
386 {
387   struct cleanup *ptr;
388   while ((ptr = *pmy_chain) != old_chain)
389     {
390       *pmy_chain = ptr->next;   /* Do this first incase recursion */
391       (*ptr->function) (ptr->arg);
392       if (ptr->free_arg)
393         (*ptr->free_arg) (ptr->arg);
394       xfree (ptr);
395     }
396 }
397
398 /* Discard cleanups, not doing the actions they describe,
399    until we get back to the point OLD_CHAIN in the cleanup_chain.  */
400
401 void
402 discard_cleanups (struct cleanup *old_chain)
403 {
404   discard_my_cleanups (&cleanup_chain, old_chain);
405 }
406
407 void
408 discard_final_cleanups (struct cleanup *old_chain)
409 {
410   discard_my_cleanups (&final_cleanup_chain, old_chain);
411 }
412
413 void
414 discard_my_cleanups (struct cleanup **pmy_chain,
415                      struct cleanup *old_chain)
416 {
417   struct cleanup *ptr;
418   while ((ptr = *pmy_chain) != old_chain)
419     {
420       *pmy_chain = ptr->next;
421       if (ptr->free_arg)
422         (*ptr->free_arg) (ptr->arg);
423       xfree (ptr);
424     }
425 }
426
427 /* Set the cleanup_chain to 0, and return the old cleanup chain.  */
428 struct cleanup *
429 save_cleanups (void)
430 {
431   return save_my_cleanups (&cleanup_chain);
432 }
433
434 struct cleanup *
435 save_final_cleanups (void)
436 {
437   return save_my_cleanups (&final_cleanup_chain);
438 }
439
440 struct cleanup *
441 save_my_cleanups (struct cleanup **pmy_chain)
442 {
443   struct cleanup *old_chain = *pmy_chain;
444
445   *pmy_chain = 0;
446   return old_chain;
447 }
448
449 /* Restore the cleanup chain from a previously saved chain.  */
450 void
451 restore_cleanups (struct cleanup *chain)
452 {
453   restore_my_cleanups (&cleanup_chain, chain);
454 }
455
456 void
457 restore_final_cleanups (struct cleanup *chain)
458 {
459   restore_my_cleanups (&final_cleanup_chain, chain);
460 }
461
462 void
463 restore_my_cleanups (struct cleanup **pmy_chain, struct cleanup *chain)
464 {
465   *pmy_chain = chain;
466 }
467
468 /* This function is useful for cleanups.
469    Do
470
471    foo = xmalloc (...);
472    old_chain = make_cleanup (free_current_contents, &foo);
473
474    to arrange to free the object thus allocated.  */
475
476 void
477 free_current_contents (void *ptr)
478 {
479   void **location = ptr;
480   if (location == NULL)
481     internal_error (__FILE__, __LINE__,
482                     _("free_current_contents: NULL pointer"));
483   if (*location != NULL)
484     {
485       xfree (*location);
486       *location = NULL;
487     }
488 }
489
490 /* Provide a known function that does nothing, to use as a base for
491    for a possibly long chain of cleanups.  This is useful where we
492    use the cleanup chain for handling normal cleanups as well as dealing
493    with cleanups that need to be done as a result of a call to error().
494    In such cases, we may not be certain where the first cleanup is, unless
495    we have a do-nothing one to always use as the base. */
496
497 void
498 null_cleanup (void *arg)
499 {
500 }
501
502 /* Continuations are implemented as cleanups internally.  Inherit from
503    cleanups.  */
504 struct continuation
505 {
506   struct cleanup base;
507 };
508
509 /* Add a continuation to the continuation list of THREAD.  The new
510    continuation will be added at the front.  */
511 void
512 add_continuation (struct thread_info *thread,
513                   void (*continuation_hook) (void *), void *args,
514                   void (*continuation_free_args) (void *))
515 {
516   struct cleanup *as_cleanup = &thread->continuations->base;
517   make_cleanup_ftype *continuation_hook_fn = continuation_hook;
518
519   make_my_cleanup2 (&as_cleanup,
520                     continuation_hook_fn,
521                     args,
522                     continuation_free_args);
523
524   thread->continuations = (struct continuation *) as_cleanup;
525 }
526
527 /* Add a continuation to the continuation list of INFERIOR.  The new
528    continuation will be added at the front.  */
529
530 void
531 add_inferior_continuation (void (*continuation_hook) (void *), void *args,
532                            void (*continuation_free_args) (void *))
533 {
534   struct inferior *inf = current_inferior ();
535   struct cleanup *as_cleanup = &inf->continuations->base;
536   make_cleanup_ftype *continuation_hook_fn = continuation_hook;
537
538   make_my_cleanup2 (&as_cleanup,
539                     continuation_hook_fn,
540                     args,
541                     continuation_free_args);
542
543   inf->continuations = (struct continuation *) as_cleanup;
544 }
545
546 /* Do all continuations of the current inferior.  */
547
548 void
549 do_all_inferior_continuations (void)
550 {
551   struct cleanup *old_chain;
552   struct cleanup *as_cleanup;
553   struct inferior *inf = current_inferior ();
554
555   if (inf->continuations == NULL)
556     return;
557
558   /* Copy the list header into another pointer, and set the global
559      list header to null, so that the global list can change as a side
560      effect of invoking the continuations and the processing of the
561      preexisting continuations will not be affected.  */
562
563   as_cleanup = &inf->continuations->base;
564   inf->continuations = NULL;
565
566   /* Work now on the list we have set aside.  */
567   do_my_cleanups (&as_cleanup, NULL);
568 }
569
570 /* Get rid of all the inferior-wide continuations of INF.  */
571
572 void
573 discard_all_inferior_continuations (struct inferior *inf)
574 {
575   struct cleanup *continuation_ptr = &inf->continuations->base;
576   discard_my_cleanups (&continuation_ptr, NULL);
577   inf->continuations = NULL;
578 }
579
580 static void
581 restore_thread_cleanup (void *arg)
582 {
583   ptid_t *ptid_p = arg;
584   switch_to_thread (*ptid_p);
585 }
586
587 /* Walk down the continuation list of PTID, and execute all the
588    continuations.  There is a problem though.  In some cases new
589    continuations may be added while we are in the middle of this loop.
590    If this happens they will be added in the front, and done before we
591    have a chance of exhausting those that were already there.  We need
592    to then save the beginning of the list in a pointer and do the
593    continuations from there on, instead of using the global beginning
594    of list as our iteration pointer.  */
595 static void
596 do_all_continuations_ptid (ptid_t ptid,
597                            struct continuation **continuations_p)
598 {
599   struct cleanup *old_chain;
600   ptid_t current_thread;
601   struct cleanup *as_cleanup;
602
603   if (*continuations_p == NULL)
604     return;
605
606   current_thread = inferior_ptid;
607
608   /* Restore selected thread on exit.  Don't try to restore the frame
609      as well, because:
610
611     - When running continuations, the selected frame is always #0.
612
613     - The continuations may trigger symbol file loads, which may
614       change the frame layout (frame ids change), which would trigger
615       a warning if we used make_cleanup_restore_current_thread.  */
616
617   old_chain = make_cleanup (restore_thread_cleanup, &current_thread);
618
619   /* Let the continuation see this thread as selected.  */
620   switch_to_thread (ptid);
621
622   /* Copy the list header into another pointer, and set the global
623      list header to null, so that the global list can change as a side
624      effect of invoking the continuations and the processing of the
625      preexisting continuations will not be affected.  */
626
627   as_cleanup = &(*continuations_p)->base;
628   *continuations_p = NULL;
629
630   /* Work now on the list we have set aside.  */
631   do_my_cleanups (&as_cleanup, NULL);
632
633   do_cleanups (old_chain);
634 }
635
636 /* Callback for iterate over threads.  */
637 static int
638 do_all_continuations_thread_callback (struct thread_info *thread, void *data)
639 {
640   do_all_continuations_ptid (thread->ptid, &thread->continuations);
641   return 0;
642 }
643
644 /* Do all continuations of thread THREAD.  */
645 void
646 do_all_continuations_thread (struct thread_info *thread)
647 {
648   do_all_continuations_thread_callback (thread, NULL);
649 }
650
651 /* Do all continuations of all threads.  */
652 void
653 do_all_continuations (void)
654 {
655   iterate_over_threads (do_all_continuations_thread_callback, NULL);
656 }
657
658 /* Callback for iterate over threads.  */
659 static int
660 discard_all_continuations_thread_callback (struct thread_info *thread,
661                                            void *data)
662 {
663   struct cleanup *continuation_ptr = &thread->continuations->base;
664   discard_my_cleanups (&continuation_ptr, NULL);
665   thread->continuations = NULL;
666   return 0;
667 }
668
669 /* Get rid of all the continuations of THREAD.  */
670 void
671 discard_all_continuations_thread (struct thread_info *thread)
672 {
673   discard_all_continuations_thread_callback (thread, NULL);
674 }
675
676 /* Get rid of all the continuations of all threads.  */
677 void
678 discard_all_continuations (void)
679 {
680   iterate_over_threads (discard_all_continuations_thread_callback, NULL);
681 }
682
683
684 /* Add a continuation to the intermediate continuation list of THREAD.
685    The new continuation will be added at the front.  */
686 void
687 add_intermediate_continuation (struct thread_info *thread,
688                                void (*continuation_hook)
689                                (void *), void *args,
690                                void (*continuation_free_args) (void *))
691 {
692   struct cleanup *as_cleanup = &thread->intermediate_continuations->base;
693   make_cleanup_ftype *continuation_hook_fn = continuation_hook;
694
695   make_my_cleanup2 (&as_cleanup,
696                     continuation_hook_fn,
697                     args,
698                     continuation_free_args);
699
700   thread->intermediate_continuations = (struct continuation *) as_cleanup;
701 }
702
703 /* Walk down the cmd_continuation list, and execute all the
704    continuations. There is a problem though. In some cases new
705    continuations may be added while we are in the middle of this
706    loop. If this happens they will be added in the front, and done
707    before we have a chance of exhausting those that were already
708    there. We need to then save the beginning of the list in a pointer
709    and do the continuations from there on, instead of using the
710    global beginning of list as our iteration pointer.*/
711 static int
712 do_all_intermediate_continuations_thread_callback (struct thread_info *thread,
713                                                    void *data)
714 {
715   do_all_continuations_ptid (thread->ptid,
716                              &thread->intermediate_continuations);
717   return 0;
718 }
719
720 /* Do all intermediate continuations of thread THREAD.  */
721 void
722 do_all_intermediate_continuations_thread (struct thread_info *thread)
723 {
724   do_all_intermediate_continuations_thread_callback (thread, NULL);
725 }
726
727 /* Do all intermediate continuations of all threads.  */
728 void
729 do_all_intermediate_continuations (void)
730 {
731   iterate_over_threads (do_all_intermediate_continuations_thread_callback, NULL);
732 }
733
734 /* Callback for iterate over threads.  */
735 static int
736 discard_all_intermediate_continuations_thread_callback (struct thread_info *thread,
737                                                         void *data)
738 {
739   struct cleanup *continuation_ptr = &thread->intermediate_continuations->base;
740   discard_my_cleanups (&continuation_ptr, NULL);
741   thread->intermediate_continuations = NULL;
742   return 0;
743 }
744
745 /* Get rid of all the intermediate continuations of THREAD.  */
746 void
747 discard_all_intermediate_continuations_thread (struct thread_info *thread)
748 {
749   discard_all_intermediate_continuations_thread_callback (thread, NULL);
750 }
751
752 /* Get rid of all the intermediate continuations of all threads.  */
753 void
754 discard_all_intermediate_continuations (void)
755 {
756   iterate_over_threads (discard_all_intermediate_continuations_thread_callback, NULL);
757 }
758 \f
759
760
761 /* Print a warning message.  The first argument STRING is the warning
762    message, used as an fprintf format string, the second is the
763    va_list of arguments for that string.  A warning is unfiltered (not
764    paginated) so that the user does not need to page through each
765    screen full of warnings when there are lots of them.  */
766
767 void
768 vwarning (const char *string, va_list args)
769 {
770   if (deprecated_warning_hook)
771     (*deprecated_warning_hook) (string, args);
772   else
773     {
774       target_terminal_ours ();
775       wrap_here ("");           /* Force out any buffered output */
776       gdb_flush (gdb_stdout);
777       if (warning_pre_print)
778         fputs_unfiltered (warning_pre_print, gdb_stderr);
779       vfprintf_unfiltered (gdb_stderr, string, args);
780       fprintf_unfiltered (gdb_stderr, "\n");
781       va_end (args);
782     }
783 }
784
785 /* Print a warning message.
786    The first argument STRING is the warning message, used as a fprintf string,
787    and the remaining args are passed as arguments to it.
788    The primary difference between warnings and errors is that a warning
789    does not force the return to command level.  */
790
791 void
792 warning (const char *string, ...)
793 {
794   va_list args;
795   va_start (args, string);
796   vwarning (string, args);
797   va_end (args);
798 }
799
800 /* Print an error message and return to command level.
801    The first argument STRING is the error message, used as a fprintf string,
802    and the remaining args are passed as arguments to it.  */
803
804 NORETURN void
805 verror (const char *string, va_list args)
806 {
807   throw_verror (GENERIC_ERROR, string, args);
808 }
809
810 NORETURN void
811 error (const char *string, ...)
812 {
813   va_list args;
814   va_start (args, string);
815   throw_verror (GENERIC_ERROR, string, args);
816   va_end (args);
817 }
818
819 /* Print an error message and quit.
820    The first argument STRING is the error message, used as a fprintf string,
821    and the remaining args are passed as arguments to it.  */
822
823 NORETURN void
824 vfatal (const char *string, va_list args)
825 {
826   throw_vfatal (string, args);
827 }
828
829 NORETURN void
830 fatal (const char *string, ...)
831 {
832   va_list args;
833   va_start (args, string);
834   throw_vfatal (string, args);
835   va_end (args);
836 }
837
838 NORETURN void
839 error_stream (struct ui_file *stream)
840 {
841   long len;
842   char *message = ui_file_xstrdup (stream, &len);
843   make_cleanup (xfree, message);
844   error (("%s"), message);
845 }
846
847 /* Allow the user to configure the debugger behavior with respect to
848    what to do when an internal problem is detected.  */
849
850 const char internal_problem_ask[] = "ask";
851 const char internal_problem_yes[] = "yes";
852 const char internal_problem_no[] = "no";
853 static const char *internal_problem_modes[] =
854 {
855   internal_problem_ask,
856   internal_problem_yes,
857   internal_problem_no,
858   NULL
859 };
860 static const char *internal_problem_mode = internal_problem_ask;
861
862 /* Print a message reporting an internal error/warning. Ask the user
863    if they want to continue, dump core, or just exit.  Return
864    something to indicate a quit.  */
865
866 struct internal_problem
867 {
868   const char *name;
869   const char *should_quit;
870   const char *should_dump_core;
871 };
872
873 /* Report a problem, internal to GDB, to the user.  Once the problem
874    has been reported, and assuming GDB didn't quit, the caller can
875    either allow execution to resume or throw an error.  */
876
877 static void ATTR_FORMAT (printf, 4, 0)
878 internal_vproblem (struct internal_problem *problem,
879                    const char *file, int line, const char *fmt, va_list ap)
880 {
881   static int dejavu;
882   int quit_p;
883   int dump_core_p;
884   char *reason;
885
886   /* Don't allow infinite error/warning recursion.  */
887   {
888     static char msg[] = "Recursive internal problem.\n";
889     switch (dejavu)
890       {
891       case 0:
892         dejavu = 1;
893         break;
894       case 1:
895         dejavu = 2;
896         fputs_unfiltered (msg, gdb_stderr);
897         abort ();       /* NOTE: GDB has only four calls to abort().  */
898       default:
899         dejavu = 3;
900         /* Newer GLIBC versions put the warn_unused_result attribute
901            on write, but this is one of those rare cases where
902            ignoring the return value is correct.  Casting to (void)
903            does not fix this problem.  This is the solution suggested
904            at http://gcc.gnu.org/bugzilla/show_bug.cgi?id=25509.  */
905         if (write (STDERR_FILENO, msg, sizeof (msg)) != sizeof (msg))
906           abort (); /* NOTE: GDB has only four calls to abort().  */
907         exit (1);
908       }
909   }
910
911   /* Try to get the message out and at the start of a new line.  */
912   target_terminal_ours ();
913   begin_line ();
914
915   /* Create a string containing the full error/warning message.  Need
916      to call query with this full string, as otherwize the reason
917      (error/warning) and question become separated.  Format using a
918      style similar to a compiler error message.  Include extra detail
919      so that the user knows that they are living on the edge.  */
920   {
921     char *msg;
922     msg = xstrvprintf (fmt, ap);
923     reason = xstrprintf ("\
924 %s:%d: %s: %s\n\
925 A problem internal to GDB has been detected,\n\
926 further debugging may prove unreliable.", file, line, problem->name, msg);
927     xfree (msg);
928     make_cleanup (xfree, reason);
929   }
930
931   if (problem->should_quit == internal_problem_ask)
932     {
933       /* Default (yes/batch case) is to quit GDB.  When in batch mode
934          this lessens the likelihood of GDB going into an infinite
935          loop.  */
936       if (caution == 0)
937         {
938           /* Emit the message and quit.  */
939           fputs_unfiltered (reason, gdb_stderr);
940           fputs_unfiltered ("\n", gdb_stderr);
941           quit_p = 1;
942         }
943       else
944         quit_p = query (_("%s\nQuit this debugging session? "), reason);
945     }
946   else if (problem->should_quit == internal_problem_yes)
947     quit_p = 1;
948   else if (problem->should_quit == internal_problem_no)
949     quit_p = 0;
950   else
951     internal_error (__FILE__, __LINE__, _("bad switch"));
952
953   if (problem->should_dump_core == internal_problem_ask)
954     {
955       /* Default (yes/batch case) is to dump core.  This leaves a GDB
956          `dropping' so that it is easier to see that something went
957          wrong in GDB.  */
958       dump_core_p = query (_("%s\nCreate a core file of GDB? "), reason);
959     }
960   else if (problem->should_dump_core == internal_problem_yes)
961     dump_core_p = 1;
962   else if (problem->should_dump_core == internal_problem_no)
963     dump_core_p = 0;
964   else
965     internal_error (__FILE__, __LINE__, _("bad switch"));
966
967   if (quit_p)
968     {
969       if (dump_core_p)
970         abort ();               /* NOTE: GDB has only four calls to abort().  */
971       else
972         exit (1);
973     }
974   else
975     {
976       if (dump_core_p)
977         {
978 #ifdef HAVE_WORKING_FORK
979           if (fork () == 0)
980             abort ();           /* NOTE: GDB has only four calls to abort().  */
981 #endif
982         }
983     }
984
985   dejavu = 0;
986 }
987
988 static struct internal_problem internal_error_problem = {
989   "internal-error", internal_problem_ask, internal_problem_ask
990 };
991
992 NORETURN void
993 internal_verror (const char *file, int line, const char *fmt, va_list ap)
994 {
995   internal_vproblem (&internal_error_problem, file, line, fmt, ap);
996   deprecated_throw_reason (RETURN_ERROR);
997 }
998
999 NORETURN void
1000 internal_error (const char *file, int line, const char *string, ...)
1001 {
1002   va_list ap;
1003   va_start (ap, string);
1004   internal_verror (file, line, string, ap);
1005   va_end (ap);
1006 }
1007
1008 static struct internal_problem internal_warning_problem = {
1009   "internal-warning", internal_problem_ask, internal_problem_ask
1010 };
1011
1012 void
1013 internal_vwarning (const char *file, int line, const char *fmt, va_list ap)
1014 {
1015   internal_vproblem (&internal_warning_problem, file, line, fmt, ap);
1016 }
1017
1018 void
1019 internal_warning (const char *file, int line, const char *string, ...)
1020 {
1021   va_list ap;
1022   va_start (ap, string);
1023   internal_vwarning (file, line, string, ap);
1024   va_end (ap);
1025 }
1026
1027 /* Dummy functions to keep add_prefix_cmd happy.  */
1028
1029 static void
1030 set_internal_problem_cmd (char *args, int from_tty)
1031 {
1032 }
1033
1034 static void
1035 show_internal_problem_cmd (char *args, int from_tty)
1036 {
1037 }
1038
1039 /* When GDB reports an internal problem (error or warning) it gives
1040    the user the opportunity to quit GDB and/or create a core file of
1041    the current debug session.  This function registers a few commands
1042    that make it possible to specify that GDB should always or never
1043    quit or create a core file, without asking.  The commands look
1044    like:
1045
1046    maint set PROBLEM-NAME quit ask|yes|no
1047    maint show PROBLEM-NAME quit
1048    maint set PROBLEM-NAME corefile ask|yes|no
1049    maint show PROBLEM-NAME corefile
1050
1051    Where PROBLEM-NAME is currently "internal-error" or
1052    "internal-warning".  */
1053
1054 static void
1055 add_internal_problem_command (struct internal_problem *problem)
1056 {
1057   struct cmd_list_element **set_cmd_list;
1058   struct cmd_list_element **show_cmd_list;
1059   char *set_doc;
1060   char *show_doc;
1061
1062   set_cmd_list = xmalloc (sizeof (*set_cmd_list));
1063   show_cmd_list = xmalloc (sizeof (*set_cmd_list));
1064   *set_cmd_list = NULL;
1065   *show_cmd_list = NULL;
1066
1067   set_doc = xstrprintf (_("Configure what GDB does when %s is detected."),
1068                         problem->name);
1069
1070   show_doc = xstrprintf (_("Show what GDB does when %s is detected."),
1071                          problem->name);
1072
1073   add_prefix_cmd ((char*) problem->name,
1074                   class_maintenance, set_internal_problem_cmd, set_doc,
1075                   set_cmd_list,
1076                   concat ("maintenance set ", problem->name, " ", NULL),
1077                   0/*allow-unknown*/, &maintenance_set_cmdlist);
1078
1079   add_prefix_cmd ((char*) problem->name,
1080                   class_maintenance, show_internal_problem_cmd, show_doc,
1081                   show_cmd_list,
1082                   concat ("maintenance show ", problem->name, " ", NULL),
1083                   0/*allow-unknown*/, &maintenance_show_cmdlist);
1084
1085   set_doc = xstrprintf (_("\
1086 Set whether GDB should quit when an %s is detected"),
1087                         problem->name);
1088   show_doc = xstrprintf (_("\
1089 Show whether GDB will quit when an %s is detected"),
1090                          problem->name);
1091   add_setshow_enum_cmd ("quit", class_maintenance,
1092                         internal_problem_modes,
1093                         &problem->should_quit,
1094                         set_doc,
1095                         show_doc,
1096                         NULL, /* help_doc */
1097                         NULL, /* setfunc */
1098                         NULL, /* showfunc */
1099                         set_cmd_list,
1100                         show_cmd_list);
1101
1102   set_doc = xstrprintf (_("\
1103 Set whether GDB should create a core file of GDB when %s is detected"),
1104                         problem->name);
1105   show_doc = xstrprintf (_("\
1106 Show whether GDB will create a core file of GDB when %s is detected"),
1107                          problem->name);
1108   add_setshow_enum_cmd ("corefile", class_maintenance,
1109                         internal_problem_modes,
1110                         &problem->should_dump_core,
1111                         set_doc,
1112                         show_doc,
1113                         NULL, /* help_doc */
1114                         NULL, /* setfunc */
1115                         NULL, /* showfunc */
1116                         set_cmd_list,
1117                         show_cmd_list);
1118 }
1119
1120 /* Print the system error message for errno, and also mention STRING
1121    as the file name for which the error was encountered.
1122    Then return to command level.  */
1123
1124 NORETURN void
1125 perror_with_name (const char *string)
1126 {
1127   char *err;
1128   char *combined;
1129
1130   err = safe_strerror (errno);
1131   combined = (char *) alloca (strlen (err) + strlen (string) + 3);
1132   strcpy (combined, string);
1133   strcat (combined, ": ");
1134   strcat (combined, err);
1135
1136   /* I understand setting these is a matter of taste.  Still, some people
1137      may clear errno but not know about bfd_error.  Doing this here is not
1138      unreasonable. */
1139   bfd_set_error (bfd_error_no_error);
1140   errno = 0;
1141
1142   error (_("%s."), combined);
1143 }
1144
1145 /* Print the system error message for ERRCODE, and also mention STRING
1146    as the file name for which the error was encountered.  */
1147
1148 void
1149 print_sys_errmsg (const char *string, int errcode)
1150 {
1151   char *err;
1152   char *combined;
1153
1154   err = safe_strerror (errcode);
1155   combined = (char *) alloca (strlen (err) + strlen (string) + 3);
1156   strcpy (combined, string);
1157   strcat (combined, ": ");
1158   strcat (combined, err);
1159
1160   /* We want anything which was printed on stdout to come out first, before
1161      this message.  */
1162   gdb_flush (gdb_stdout);
1163   fprintf_unfiltered (gdb_stderr, "%s.\n", combined);
1164 }
1165
1166 /* Control C eventually causes this to be called, at a convenient time.  */
1167
1168 void
1169 quit (void)
1170 {
1171 #ifdef __MSDOS__
1172   /* No steenking SIGINT will ever be coming our way when the
1173      program is resumed.  Don't lie.  */
1174   fatal ("Quit");
1175 #else
1176   if (job_control
1177       /* If there is no terminal switching for this target, then we can't
1178          possibly get screwed by the lack of job control.  */
1179       || current_target.to_terminal_ours == NULL)
1180     fatal ("Quit");
1181   else
1182     fatal ("Quit (expect signal SIGINT when the program is resumed)");
1183 #endif
1184 }
1185
1186 \f
1187 /* Called when a memory allocation fails, with the number of bytes of
1188    memory requested in SIZE. */
1189
1190 NORETURN void
1191 nomem (long size)
1192 {
1193   if (size > 0)
1194     {
1195       internal_error (__FILE__, __LINE__,
1196                       _("virtual memory exhausted: can't allocate %ld bytes."),
1197                       size);
1198     }
1199   else
1200     {
1201       internal_error (__FILE__, __LINE__, _("virtual memory exhausted."));
1202     }
1203 }
1204
1205 /* The xmalloc() (libiberty.h) family of memory management routines.
1206
1207    These are like the ISO-C malloc() family except that they implement
1208    consistent semantics and guard against typical memory management
1209    problems.  */
1210
1211 /* NOTE: These are declared using PTR to ensure consistency with
1212    "libiberty.h".  xfree() is GDB local.  */
1213
1214 PTR                             /* ARI: PTR */
1215 xmalloc (size_t size)
1216 {
1217   void *val;
1218
1219   /* See libiberty/xmalloc.c.  This function need's to match that's
1220      semantics.  It never returns NULL.  */
1221   if (size == 0)
1222     size = 1;
1223
1224   val = malloc (size);          /* ARI: malloc */
1225   if (val == NULL)
1226     nomem (size);
1227
1228   return (val);
1229 }
1230
1231 void *
1232 xzalloc (size_t size)
1233 {
1234   return xcalloc (1, size);
1235 }
1236
1237 PTR                             /* ARI: PTR */
1238 xrealloc (PTR ptr, size_t size) /* ARI: PTR */
1239 {
1240   void *val;
1241
1242   /* See libiberty/xmalloc.c.  This function need's to match that's
1243      semantics.  It never returns NULL.  */
1244   if (size == 0)
1245     size = 1;
1246
1247   if (ptr != NULL)
1248     val = realloc (ptr, size);  /* ARI: realloc */
1249   else
1250     val = malloc (size);                /* ARI: malloc */
1251   if (val == NULL)
1252     nomem (size);
1253
1254   return (val);
1255 }
1256
1257 PTR                             /* ARI: PTR */
1258 xcalloc (size_t number, size_t size)
1259 {
1260   void *mem;
1261
1262   /* See libiberty/xmalloc.c.  This function need's to match that's
1263      semantics.  It never returns NULL.  */
1264   if (number == 0 || size == 0)
1265     {
1266       number = 1;
1267       size = 1;
1268     }
1269
1270   mem = calloc (number, size);          /* ARI: xcalloc */
1271   if (mem == NULL)
1272     nomem (number * size);
1273
1274   return mem;
1275 }
1276
1277 void
1278 xfree (void *ptr)
1279 {
1280   if (ptr != NULL)
1281     free (ptr);         /* ARI: free */
1282 }
1283 \f
1284
1285 /* Like asprintf/vasprintf but get an internal_error if the call
1286    fails. */
1287
1288 char *
1289 xstrprintf (const char *format, ...)
1290 {
1291   char *ret;
1292   va_list args;
1293   va_start (args, format);
1294   ret = xstrvprintf (format, args);
1295   va_end (args);
1296   return ret;
1297 }
1298
1299 void
1300 xasprintf (char **ret, const char *format, ...)
1301 {
1302   va_list args;
1303   va_start (args, format);
1304   (*ret) = xstrvprintf (format, args);
1305   va_end (args);
1306 }
1307
1308 void
1309 xvasprintf (char **ret, const char *format, va_list ap)
1310 {
1311   (*ret) = xstrvprintf (format, ap);
1312 }
1313
1314 char *
1315 xstrvprintf (const char *format, va_list ap)
1316 {
1317   char *ret = NULL;
1318   int status = vasprintf (&ret, format, ap);
1319   /* NULL is returned when there was a memory allocation problem, or
1320      any other error (for instance, a bad format string).  A negative
1321      status (the printed length) with a non-NULL buffer should never
1322      happen, but just to be sure.  */
1323   if (ret == NULL || status < 0)
1324     internal_error (__FILE__, __LINE__, _("vasprintf call failed"));
1325   return ret;
1326 }
1327
1328 int
1329 xsnprintf (char *str, size_t size, const char *format, ...)
1330 {
1331   va_list args;
1332   int ret;
1333
1334   va_start (args, format);
1335   ret = vsnprintf (str, size, format, args);
1336   gdb_assert (ret < size);
1337   va_end (args);
1338
1339   return ret;
1340 }
1341
1342 /* My replacement for the read system call.
1343    Used like `read' but keeps going if `read' returns too soon.  */
1344
1345 int
1346 myread (int desc, char *addr, int len)
1347 {
1348   int val;
1349   int orglen = len;
1350
1351   while (len > 0)
1352     {
1353       val = read (desc, addr, len);
1354       if (val < 0)
1355         return val;
1356       if (val == 0)
1357         return orglen - len;
1358       len -= val;
1359       addr += val;
1360     }
1361   return orglen;
1362 }
1363 \f
1364 /* Make a copy of the string at PTR with SIZE characters
1365    (and add a null character at the end in the copy).
1366    Uses malloc to get the space.  Returns the address of the copy.  */
1367
1368 char *
1369 savestring (const char *ptr, size_t size)
1370 {
1371   char *p = (char *) xmalloc (size + 1);
1372   memcpy (p, ptr, size);
1373   p[size] = 0;
1374   return p;
1375 }
1376
1377 void
1378 print_spaces (int n, struct ui_file *file)
1379 {
1380   fputs_unfiltered (n_spaces (n), file);
1381 }
1382
1383 /* Print a host address.  */
1384
1385 void
1386 gdb_print_host_address (const void *addr, struct ui_file *stream)
1387 {
1388   fprintf_filtered (stream, "%s", host_address_to_string (addr));
1389 }
1390 \f
1391
1392 /* This function supports the query, nquery, and yquery functions.
1393    Ask user a y-or-n question and return 0 if answer is no, 1 if
1394    answer is yes, or default the answer to the specified default
1395    (for yquery or nquery).  DEFCHAR may be 'y' or 'n' to provide a
1396    default answer, or '\0' for no default.
1397    CTLSTR is the control string and should end in "? ".  It should
1398    not say how to answer, because we do that.
1399    ARGS are the arguments passed along with the CTLSTR argument to
1400    printf.  */
1401
1402 static int ATTR_FORMAT (printf, 1, 0)
1403 defaulted_query (const char *ctlstr, const char defchar, va_list args)
1404 {
1405   int answer;
1406   int ans2;
1407   int retval;
1408   int def_value;
1409   char def_answer, not_def_answer;
1410   char *y_string, *n_string, *question;
1411
1412   /* Set up according to which answer is the default.  */
1413   if (defchar == '\0')
1414     {
1415       def_value = 1;
1416       def_answer = 'Y';
1417       not_def_answer = 'N';
1418       y_string = "y";
1419       n_string = "n";
1420     }
1421   else if (defchar == 'y')
1422     {
1423       def_value = 1;
1424       def_answer = 'Y';
1425       not_def_answer = 'N';
1426       y_string = "[y]";
1427       n_string = "n";
1428     }
1429   else
1430     {
1431       def_value = 0;
1432       def_answer = 'N';
1433       not_def_answer = 'Y';
1434       y_string = "y";
1435       n_string = "[n]";
1436     }
1437
1438   /* Automatically answer the default value if the user did not want
1439      prompts or the command was issued with the server prefix.  */
1440   if (! caution || server_command)
1441     return def_value;
1442
1443   /* If input isn't coming from the user directly, just say what
1444      question we're asking, and then answer the default automatically.  This
1445      way, important error messages don't get lost when talking to GDB
1446      over a pipe.  */
1447   if (! input_from_terminal_p ())
1448     {
1449       wrap_here ("");
1450       vfprintf_filtered (gdb_stdout, ctlstr, args);
1451
1452       printf_filtered (_("(%s or %s) [answered %c; input not from terminal]\n"),
1453                        y_string, n_string, def_answer);
1454       gdb_flush (gdb_stdout);
1455
1456       return def_value;
1457     }
1458
1459   if (deprecated_query_hook)
1460     {
1461       return deprecated_query_hook (ctlstr, args);
1462     }
1463
1464   /* Format the question outside of the loop, to avoid reusing args.  */
1465   question = xstrvprintf (ctlstr, args);
1466
1467   while (1)
1468     {
1469       wrap_here ("");           /* Flush any buffered output */
1470       gdb_flush (gdb_stdout);
1471
1472       if (annotation_level > 1)
1473         printf_filtered (("\n\032\032pre-query\n"));
1474
1475       fputs_filtered (question, gdb_stdout);
1476       printf_filtered (_("(%s or %s) "), y_string, n_string);
1477
1478       if (annotation_level > 1)
1479         printf_filtered (("\n\032\032query\n"));
1480
1481       wrap_here ("");
1482       gdb_flush (gdb_stdout);
1483
1484       answer = fgetc (stdin);
1485
1486       /* We expect fgetc to block until a character is read.  But
1487          this may not be the case if the terminal was opened with
1488          the NONBLOCK flag.  In that case, if there is nothing to
1489          read on stdin, fgetc returns EOF, but also sets the error
1490          condition flag on stdin and errno to EAGAIN.  With a true
1491          EOF, stdin's error condition flag is not set.
1492
1493          A situation where this behavior was observed is a pseudo
1494          terminal on AIX.  */
1495       while (answer == EOF && ferror (stdin) && errno == EAGAIN)
1496         {
1497           /* Not a real EOF.  Wait a little while and try again until
1498              we read something.  */
1499           clearerr (stdin);
1500           gdb_usleep (10000);
1501           answer = fgetc (stdin);
1502         }
1503
1504       clearerr (stdin);         /* in case of C-d */
1505       if (answer == EOF)        /* C-d */
1506         {
1507           printf_filtered ("EOF [assumed %c]\n", def_answer);
1508           retval = def_value;
1509           break;
1510         }
1511       /* Eat rest of input line, to EOF or newline */
1512       if (answer != '\n')
1513         do
1514           {
1515             ans2 = fgetc (stdin);
1516             clearerr (stdin);
1517           }
1518         while (ans2 != EOF && ans2 != '\n' && ans2 != '\r');
1519
1520       if (answer >= 'a')
1521         answer -= 040;
1522       /* Check answer.  For the non-default, the user must specify
1523          the non-default explicitly.  */
1524       if (answer == not_def_answer)
1525         {
1526           retval = !def_value;
1527           break;
1528         }
1529       /* Otherwise, if a default was specified, the user may either
1530          specify the required input or have it default by entering
1531          nothing.  */
1532       if (answer == def_answer
1533           || (defchar != '\0' &&
1534               (answer == '\n' || answer == '\r' || answer == EOF)))
1535         {
1536           retval = def_value;
1537           break;
1538         }
1539       /* Invalid entries are not defaulted and require another selection.  */
1540       printf_filtered (_("Please answer %s or %s.\n"),
1541                        y_string, n_string);
1542     }
1543
1544   xfree (question);
1545   if (annotation_level > 1)
1546     printf_filtered (("\n\032\032post-query\n"));
1547   return retval;
1548 }
1549 \f
1550
1551 /* Ask user a y-or-n question and return 0 if answer is no, 1 if
1552    answer is yes, or 0 if answer is defaulted.
1553    Takes three args which are given to printf to print the question.
1554    The first, a control string, should end in "? ".
1555    It should not say how to answer, because we do that.  */
1556
1557 int
1558 nquery (const char *ctlstr, ...)
1559 {
1560   va_list args;
1561
1562   va_start (args, ctlstr);
1563   return defaulted_query (ctlstr, 'n', args);
1564   va_end (args);
1565 }
1566
1567 /* Ask user a y-or-n question and return 0 if answer is no, 1 if
1568    answer is yes, or 1 if answer is defaulted.
1569    Takes three args which are given to printf to print the question.
1570    The first, a control string, should end in "? ".
1571    It should not say how to answer, because we do that.  */
1572
1573 int
1574 yquery (const char *ctlstr, ...)
1575 {
1576   va_list args;
1577
1578   va_start (args, ctlstr);
1579   return defaulted_query (ctlstr, 'y', args);
1580   va_end (args);
1581 }
1582
1583 /* Ask user a y-or-n question and return 1 iff answer is yes.
1584    Takes three args which are given to printf to print the question.
1585    The first, a control string, should end in "? ".
1586    It should not say how to answer, because we do that.  */
1587
1588 int
1589 query (const char *ctlstr, ...)
1590 {
1591   va_list args;
1592
1593   va_start (args, ctlstr);
1594   return defaulted_query (ctlstr, '\0', args);
1595   va_end (args);
1596 }
1597
1598 /* A helper for parse_escape that converts a host character to a
1599    target character.  C is the host character.  If conversion is
1600    possible, then the target character is stored in *TARGET_C and the
1601    function returns 1.  Otherwise, the function returns 0.  */
1602
1603 static int
1604 host_char_to_target (int c, int *target_c)
1605 {
1606   struct obstack host_data;
1607   char the_char = c;
1608   struct cleanup *cleanups;
1609   int result = 0;
1610
1611   obstack_init (&host_data);
1612   cleanups = make_cleanup_obstack_free (&host_data);
1613
1614   convert_between_encodings (target_charset (), host_charset (),
1615                              &the_char, 1, 1, &host_data, translit_none);
1616
1617   if (obstack_object_size (&host_data) == 1)
1618     {
1619       result = 1;
1620       *target_c = *(char *) obstack_base (&host_data);
1621     }
1622
1623   do_cleanups (cleanups);
1624   return result;
1625 }
1626
1627 /* Parse a C escape sequence.  STRING_PTR points to a variable
1628    containing a pointer to the string to parse.  That pointer
1629    should point to the character after the \.  That pointer
1630    is updated past the characters we use.  The value of the
1631    escape sequence is returned.
1632
1633    A negative value means the sequence \ newline was seen,
1634    which is supposed to be equivalent to nothing at all.
1635
1636    If \ is followed by a null character, we return a negative
1637    value and leave the string pointer pointing at the null character.
1638
1639    If \ is followed by 000, we return 0 and leave the string pointer
1640    after the zeros.  A value of 0 does not mean end of string.  */
1641
1642 int
1643 parse_escape (char **string_ptr)
1644 {
1645   int target_char = -2; /* initialize to avoid GCC warnings */
1646   int c = *(*string_ptr)++;
1647   switch (c)
1648     {
1649       case '\n':
1650         return -2;
1651       case 0:
1652         (*string_ptr)--;
1653         return 0;
1654
1655       case '0':
1656       case '1':
1657       case '2':
1658       case '3':
1659       case '4':
1660       case '5':
1661       case '6':
1662       case '7':
1663         {
1664           int i = host_hex_value (c);
1665           int count = 0;
1666           while (++count < 3)
1667             {
1668               c = (**string_ptr);
1669               if (isdigit (c) && c != '8' && c != '9')
1670                 {
1671                   (*string_ptr)++;
1672                   i *= 8;
1673                   i += host_hex_value (c);
1674                 }
1675               else
1676                 {
1677                   break;
1678                 }
1679             }
1680           return i;
1681         }
1682
1683     case 'a':
1684       c = '\a';
1685       break;
1686     case 'b':
1687       c = '\b';
1688       break;
1689     case 'f':
1690       c = '\f';
1691       break;
1692     case 'n':
1693       c = '\n';
1694       break;
1695     case 'r':
1696       c = '\r';
1697       break;
1698     case 't':
1699       c = '\t';
1700       break;
1701     case 'v':
1702       c = '\v';
1703       break;
1704
1705     default:
1706       break;
1707     }
1708
1709   if (!host_char_to_target (c, &target_char))
1710     error
1711       ("The escape sequence `\%c' is equivalent to plain `%c', which"
1712        " has no equivalent\n" "in the `%s' character set.", c, c,
1713        target_charset ());
1714   return target_char;
1715 }
1716 \f
1717 /* Print the character C on STREAM as part of the contents of a literal
1718    string whose delimiter is QUOTER.  Note that this routine should only
1719    be call for printing things which are independent of the language
1720    of the program being debugged. */
1721
1722 static void
1723 printchar (int c, void (*do_fputs) (const char *, struct ui_file *),
1724            void (*do_fprintf) (struct ui_file *, const char *, ...)
1725            ATTRIBUTE_FPTR_PRINTF_2, struct ui_file *stream, int quoter)
1726 {
1727
1728   c &= 0xFF;                    /* Avoid sign bit follies */
1729
1730   if (c < 0x20 ||               /* Low control chars */
1731       (c >= 0x7F && c < 0xA0) ||        /* DEL, High controls */
1732       (sevenbit_strings && c >= 0x80))
1733     {                           /* high order bit set */
1734       switch (c)
1735         {
1736         case '\n':
1737           do_fputs ("\\n", stream);
1738           break;
1739         case '\b':
1740           do_fputs ("\\b", stream);
1741           break;
1742         case '\t':
1743           do_fputs ("\\t", stream);
1744           break;
1745         case '\f':
1746           do_fputs ("\\f", stream);
1747           break;
1748         case '\r':
1749           do_fputs ("\\r", stream);
1750           break;
1751         case '\033':
1752           do_fputs ("\\e", stream);
1753           break;
1754         case '\007':
1755           do_fputs ("\\a", stream);
1756           break;
1757         default:
1758           do_fprintf (stream, "\\%.3o", (unsigned int) c);
1759           break;
1760         }
1761     }
1762   else
1763     {
1764       if (c == '\\' || c == quoter)
1765         do_fputs ("\\", stream);
1766       do_fprintf (stream, "%c", c);
1767     }
1768 }
1769
1770 /* Print the character C on STREAM as part of the contents of a
1771    literal string whose delimiter is QUOTER.  Note that these routines
1772    should only be call for printing things which are independent of
1773    the language of the program being debugged. */
1774
1775 void
1776 fputstr_filtered (const char *str, int quoter, struct ui_file *stream)
1777 {
1778   while (*str)
1779     printchar (*str++, fputs_filtered, fprintf_filtered, stream, quoter);
1780 }
1781
1782 void
1783 fputstr_unfiltered (const char *str, int quoter, struct ui_file *stream)
1784 {
1785   while (*str)
1786     printchar (*str++, fputs_unfiltered, fprintf_unfiltered, stream, quoter);
1787 }
1788
1789 void
1790 fputstrn_filtered (const char *str, int n, int quoter,
1791                    struct ui_file *stream)
1792 {
1793   int i;
1794   for (i = 0; i < n; i++)
1795     printchar (str[i], fputs_filtered, fprintf_filtered, stream, quoter);
1796 }
1797
1798 void
1799 fputstrn_unfiltered (const char *str, int n, int quoter,
1800                      struct ui_file *stream)
1801 {
1802   int i;
1803   for (i = 0; i < n; i++)
1804     printchar (str[i], fputs_unfiltered, fprintf_unfiltered, stream, quoter);
1805 }
1806 \f
1807
1808 /* Number of lines per page or UINT_MAX if paging is disabled.  */
1809 static unsigned int lines_per_page;
1810 static void
1811 show_lines_per_page (struct ui_file *file, int from_tty,
1812                      struct cmd_list_element *c, const char *value)
1813 {
1814   fprintf_filtered (file, _("\
1815 Number of lines gdb thinks are in a page is %s.\n"),
1816                     value);
1817 }
1818
1819 /* Number of chars per line or UINT_MAX if line folding is disabled.  */
1820 static unsigned int chars_per_line;
1821 static void
1822 show_chars_per_line (struct ui_file *file, int from_tty,
1823                      struct cmd_list_element *c, const char *value)
1824 {
1825   fprintf_filtered (file, _("\
1826 Number of characters gdb thinks are in a line is %s.\n"),
1827                     value);
1828 }
1829
1830 /* Current count of lines printed on this page, chars on this line.  */
1831 static unsigned int lines_printed, chars_printed;
1832
1833 /* Buffer and start column of buffered text, for doing smarter word-
1834    wrapping.  When someone calls wrap_here(), we start buffering output
1835    that comes through fputs_filtered().  If we see a newline, we just
1836    spit it out and forget about the wrap_here().  If we see another
1837    wrap_here(), we spit it out and remember the newer one.  If we see
1838    the end of the line, we spit out a newline, the indent, and then
1839    the buffered output.  */
1840
1841 /* Malloc'd buffer with chars_per_line+2 bytes.  Contains characters which
1842    are waiting to be output (they have already been counted in chars_printed).
1843    When wrap_buffer[0] is null, the buffer is empty.  */
1844 static char *wrap_buffer;
1845
1846 /* Pointer in wrap_buffer to the next character to fill.  */
1847 static char *wrap_pointer;
1848
1849 /* String to indent by if the wrap occurs.  Must not be NULL if wrap_column
1850    is non-zero.  */
1851 static char *wrap_indent;
1852
1853 /* Column number on the screen where wrap_buffer begins, or 0 if wrapping
1854    is not in effect.  */
1855 static int wrap_column;
1856 \f
1857
1858 /* Inialize the number of lines per page and chars per line.  */
1859
1860 void
1861 init_page_info (void)
1862 {
1863 #if defined(TUI)
1864   if (!tui_get_command_dimension (&chars_per_line, &lines_per_page))
1865 #endif
1866     {
1867       int rows, cols;
1868
1869 #if defined(__GO32__)
1870       rows = ScreenRows ();
1871       cols = ScreenCols ();
1872       lines_per_page = rows;
1873       chars_per_line = cols;
1874 #else
1875       /* Make sure Readline has initialized its terminal settings.  */
1876       rl_reset_terminal (NULL);
1877
1878       /* Get the screen size from Readline.  */
1879       rl_get_screen_size (&rows, &cols);
1880       lines_per_page = rows;
1881       chars_per_line = cols;
1882
1883       /* Readline should have fetched the termcap entry for us.  */
1884       if (tgetnum ("li") < 0 || getenv ("EMACS"))
1885         {
1886           /* The number of lines per page is not mentioned in the
1887              terminal description.  This probably means that paging is
1888              not useful (e.g. emacs shell window), so disable paging.  */
1889           lines_per_page = UINT_MAX;
1890         }
1891
1892       /* FIXME: Get rid of this junk.  */
1893 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1894       SIGWINCH_HANDLER (SIGWINCH);
1895 #endif
1896
1897       /* If the output is not a terminal, don't paginate it.  */
1898       if (!ui_file_isatty (gdb_stdout))
1899         lines_per_page = UINT_MAX;
1900 #endif
1901     }
1902
1903   set_screen_size ();
1904   set_width ();
1905 }
1906
1907 /* Set the screen size based on LINES_PER_PAGE and CHARS_PER_LINE.  */
1908
1909 static void
1910 set_screen_size (void)
1911 {
1912   int rows = lines_per_page;
1913   int cols = chars_per_line;
1914
1915   if (rows <= 0)
1916     rows = INT_MAX;
1917
1918   if (cols <= 0)
1919     cols = INT_MAX;
1920
1921   /* Update Readline's idea of the terminal size.  */
1922   rl_set_screen_size (rows, cols);
1923 }
1924
1925 /* Reinitialize WRAP_BUFFER according to the current value of
1926    CHARS_PER_LINE.  */
1927
1928 static void
1929 set_width (void)
1930 {
1931   if (chars_per_line == 0)
1932     init_page_info ();
1933
1934   if (!wrap_buffer)
1935     {
1936       wrap_buffer = (char *) xmalloc (chars_per_line + 2);
1937       wrap_buffer[0] = '\0';
1938     }
1939   else
1940     wrap_buffer = (char *) xrealloc (wrap_buffer, chars_per_line + 2);
1941   wrap_pointer = wrap_buffer;   /* Start it at the beginning.  */
1942 }
1943
1944 static void
1945 set_width_command (char *args, int from_tty, struct cmd_list_element *c)
1946 {
1947   set_screen_size ();
1948   set_width ();
1949 }
1950
1951 static void
1952 set_height_command (char *args, int from_tty, struct cmd_list_element *c)
1953 {
1954   set_screen_size ();
1955 }
1956
1957 /* Wait, so the user can read what's on the screen.  Prompt the user
1958    to continue by pressing RETURN.  */
1959
1960 static void
1961 prompt_for_continue (void)
1962 {
1963   char *ignore;
1964   char cont_prompt[120];
1965
1966   if (annotation_level > 1)
1967     printf_unfiltered (("\n\032\032pre-prompt-for-continue\n"));
1968
1969   strcpy (cont_prompt,
1970           "---Type <return> to continue, or q <return> to quit---");
1971   if (annotation_level > 1)
1972     strcat (cont_prompt, "\n\032\032prompt-for-continue\n");
1973
1974   /* We must do this *before* we call gdb_readline, else it will eventually
1975      call us -- thinking that we're trying to print beyond the end of the 
1976      screen.  */
1977   reinitialize_more_filter ();
1978
1979   immediate_quit++;
1980   /* On a real operating system, the user can quit with SIGINT.
1981      But not on GO32.
1982
1983      'q' is provided on all systems so users don't have to change habits
1984      from system to system, and because telling them what to do in
1985      the prompt is more user-friendly than expecting them to think of
1986      SIGINT.  */
1987   /* Call readline, not gdb_readline, because GO32 readline handles control-C
1988      whereas control-C to gdb_readline will cause the user to get dumped
1989      out to DOS.  */
1990   ignore = gdb_readline_wrapper (cont_prompt);
1991
1992   if (annotation_level > 1)
1993     printf_unfiltered (("\n\032\032post-prompt-for-continue\n"));
1994
1995   if (ignore)
1996     {
1997       char *p = ignore;
1998       while (*p == ' ' || *p == '\t')
1999         ++p;
2000       if (p[0] == 'q')
2001         async_request_quit (0);
2002       xfree (ignore);
2003     }
2004   immediate_quit--;
2005
2006   /* Now we have to do this again, so that GDB will know that it doesn't
2007      need to save the ---Type <return>--- line at the top of the screen.  */
2008   reinitialize_more_filter ();
2009
2010   dont_repeat ();               /* Forget prev cmd -- CR won't repeat it. */
2011 }
2012
2013 /* Reinitialize filter; ie. tell it to reset to original values.  */
2014
2015 void
2016 reinitialize_more_filter (void)
2017 {
2018   lines_printed = 0;
2019   chars_printed = 0;
2020 }
2021
2022 /* Indicate that if the next sequence of characters overflows the line,
2023    a newline should be inserted here rather than when it hits the end. 
2024    If INDENT is non-null, it is a string to be printed to indent the
2025    wrapped part on the next line.  INDENT must remain accessible until
2026    the next call to wrap_here() or until a newline is printed through
2027    fputs_filtered().
2028
2029    If the line is already overfull, we immediately print a newline and
2030    the indentation, and disable further wrapping.
2031
2032    If we don't know the width of lines, but we know the page height,
2033    we must not wrap words, but should still keep track of newlines
2034    that were explicitly printed.
2035
2036    INDENT should not contain tabs, as that will mess up the char count
2037    on the next line.  FIXME.
2038
2039    This routine is guaranteed to force out any output which has been
2040    squirreled away in the wrap_buffer, so wrap_here ((char *)0) can be
2041    used to force out output from the wrap_buffer.  */
2042
2043 void
2044 wrap_here (char *indent)
2045 {
2046   /* This should have been allocated, but be paranoid anyway. */
2047   if (!wrap_buffer)
2048     internal_error (__FILE__, __LINE__, _("failed internal consistency check"));
2049
2050   if (wrap_buffer[0])
2051     {
2052       *wrap_pointer = '\0';
2053       fputs_unfiltered (wrap_buffer, gdb_stdout);
2054     }
2055   wrap_pointer = wrap_buffer;
2056   wrap_buffer[0] = '\0';
2057   if (chars_per_line == UINT_MAX)       /* No line overflow checking */
2058     {
2059       wrap_column = 0;
2060     }
2061   else if (chars_printed >= chars_per_line)
2062     {
2063       puts_filtered ("\n");
2064       if (indent != NULL)
2065         puts_filtered (indent);
2066       wrap_column = 0;
2067     }
2068   else
2069     {
2070       wrap_column = chars_printed;
2071       if (indent == NULL)
2072         wrap_indent = "";
2073       else
2074         wrap_indent = indent;
2075     }
2076 }
2077
2078 /* Print input string to gdb_stdout, filtered, with wrap, 
2079    arranging strings in columns of n chars. String can be
2080    right or left justified in the column.  Never prints 
2081    trailing spaces.  String should never be longer than
2082    width.  FIXME: this could be useful for the EXAMINE 
2083    command, which currently doesn't tabulate very well */
2084
2085 void
2086 puts_filtered_tabular (char *string, int width, int right)
2087 {
2088   int spaces = 0;
2089   int stringlen;
2090   char *spacebuf;
2091
2092   gdb_assert (chars_per_line > 0);
2093   if (chars_per_line == UINT_MAX)
2094     {
2095       fputs_filtered (string, gdb_stdout);
2096       fputs_filtered ("\n", gdb_stdout);
2097       return;
2098     }
2099
2100   if (((chars_printed - 1) / width + 2) * width >= chars_per_line)
2101     fputs_filtered ("\n", gdb_stdout);
2102
2103   if (width >= chars_per_line)
2104     width = chars_per_line - 1;
2105
2106   stringlen = strlen (string);
2107
2108   if (chars_printed > 0)
2109     spaces = width - (chars_printed - 1) % width - 1;
2110   if (right)
2111     spaces += width - stringlen;
2112
2113   spacebuf = alloca (spaces + 1);
2114   spacebuf[spaces] = '\0';
2115   while (spaces--)
2116     spacebuf[spaces] = ' ';
2117
2118   fputs_filtered (spacebuf, gdb_stdout);
2119   fputs_filtered (string, gdb_stdout);
2120 }
2121
2122
2123 /* Ensure that whatever gets printed next, using the filtered output
2124    commands, starts at the beginning of the line.  I.E. if there is
2125    any pending output for the current line, flush it and start a new
2126    line.  Otherwise do nothing. */
2127
2128 void
2129 begin_line (void)
2130 {
2131   if (chars_printed > 0)
2132     {
2133       puts_filtered ("\n");
2134     }
2135 }
2136
2137
2138 /* Like fputs but if FILTER is true, pause after every screenful.
2139
2140    Regardless of FILTER can wrap at points other than the final
2141    character of a line.
2142
2143    Unlike fputs, fputs_maybe_filtered does not return a value.
2144    It is OK for LINEBUFFER to be NULL, in which case just don't print
2145    anything.
2146
2147    Note that a longjmp to top level may occur in this routine (only if
2148    FILTER is true) (since prompt_for_continue may do so) so this
2149    routine should not be called when cleanups are not in place.  */
2150
2151 static void
2152 fputs_maybe_filtered (const char *linebuffer, struct ui_file *stream,
2153                       int filter)
2154 {
2155   const char *lineptr;
2156
2157   if (linebuffer == 0)
2158     return;
2159
2160   /* Don't do any filtering if it is disabled.  */
2161   if ((stream != gdb_stdout) || !pagination_enabled
2162       || (lines_per_page == UINT_MAX && chars_per_line == UINT_MAX))
2163     {
2164       fputs_unfiltered (linebuffer, stream);
2165       return;
2166     }
2167
2168   /* Go through and output each character.  Show line extension
2169      when this is necessary; prompt user for new page when this is
2170      necessary.  */
2171
2172   lineptr = linebuffer;
2173   while (*lineptr)
2174     {
2175       /* Possible new page.  */
2176       if (filter && (lines_printed >= lines_per_page - 1))
2177         prompt_for_continue ();
2178
2179       while (*lineptr && *lineptr != '\n')
2180         {
2181           /* Print a single line.  */
2182           if (*lineptr == '\t')
2183             {
2184               if (wrap_column)
2185                 *wrap_pointer++ = '\t';
2186               else
2187                 fputc_unfiltered ('\t', stream);
2188               /* Shifting right by 3 produces the number of tab stops
2189                  we have already passed, and then adding one and
2190                  shifting left 3 advances to the next tab stop.  */
2191               chars_printed = ((chars_printed >> 3) + 1) << 3;
2192               lineptr++;
2193             }
2194           else
2195             {
2196               if (wrap_column)
2197                 *wrap_pointer++ = *lineptr;
2198               else
2199                 fputc_unfiltered (*lineptr, stream);
2200               chars_printed++;
2201               lineptr++;
2202             }
2203
2204           if (chars_printed >= chars_per_line)
2205             {
2206               unsigned int save_chars = chars_printed;
2207
2208               chars_printed = 0;
2209               lines_printed++;
2210               /* If we aren't actually wrapping, don't output newline --
2211                  if chars_per_line is right, we probably just overflowed
2212                  anyway; if it's wrong, let us keep going.  */
2213               if (wrap_column)
2214                 fputc_unfiltered ('\n', stream);
2215
2216               /* Possible new page.  */
2217               if (lines_printed >= lines_per_page - 1)
2218                 prompt_for_continue ();
2219
2220               /* Now output indentation and wrapped string */
2221               if (wrap_column)
2222                 {
2223                   fputs_unfiltered (wrap_indent, stream);
2224                   *wrap_pointer = '\0'; /* Null-terminate saved stuff */
2225                   fputs_unfiltered (wrap_buffer, stream);       /* and eject it */
2226                   /* FIXME, this strlen is what prevents wrap_indent from
2227                      containing tabs.  However, if we recurse to print it
2228                      and count its chars, we risk trouble if wrap_indent is
2229                      longer than (the user settable) chars_per_line. 
2230                      Note also that this can set chars_printed > chars_per_line
2231                      if we are printing a long string.  */
2232                   chars_printed = strlen (wrap_indent)
2233                     + (save_chars - wrap_column);
2234                   wrap_pointer = wrap_buffer;   /* Reset buffer */
2235                   wrap_buffer[0] = '\0';
2236                   wrap_column = 0;      /* And disable fancy wrap */
2237                 }
2238             }
2239         }
2240
2241       if (*lineptr == '\n')
2242         {
2243           chars_printed = 0;
2244           wrap_here ((char *) 0);       /* Spit out chars, cancel further wraps */
2245           lines_printed++;
2246           fputc_unfiltered ('\n', stream);
2247           lineptr++;
2248         }
2249     }
2250 }
2251
2252 void
2253 fputs_filtered (const char *linebuffer, struct ui_file *stream)
2254 {
2255   fputs_maybe_filtered (linebuffer, stream, 1);
2256 }
2257
2258 int
2259 putchar_unfiltered (int c)
2260 {
2261   char buf = c;
2262   ui_file_write (gdb_stdout, &buf, 1);
2263   return c;
2264 }
2265
2266 /* Write character C to gdb_stdout using GDB's paging mechanism and return C.
2267    May return nonlocally.  */
2268
2269 int
2270 putchar_filtered (int c)
2271 {
2272   return fputc_filtered (c, gdb_stdout);
2273 }
2274
2275 int
2276 fputc_unfiltered (int c, struct ui_file *stream)
2277 {
2278   char buf = c;
2279   ui_file_write (stream, &buf, 1);
2280   return c;
2281 }
2282
2283 int
2284 fputc_filtered (int c, struct ui_file *stream)
2285 {
2286   char buf[2];
2287
2288   buf[0] = c;
2289   buf[1] = 0;
2290   fputs_filtered (buf, stream);
2291   return c;
2292 }
2293
2294 /* puts_debug is like fputs_unfiltered, except it prints special
2295    characters in printable fashion.  */
2296
2297 void
2298 puts_debug (char *prefix, char *string, char *suffix)
2299 {
2300   int ch;
2301
2302   /* Print prefix and suffix after each line.  */
2303   static int new_line = 1;
2304   static int return_p = 0;
2305   static char *prev_prefix = "";
2306   static char *prev_suffix = "";
2307
2308   if (*string == '\n')
2309     return_p = 0;
2310
2311   /* If the prefix is changing, print the previous suffix, a new line,
2312      and the new prefix.  */
2313   if ((return_p || (strcmp (prev_prefix, prefix) != 0)) && !new_line)
2314     {
2315       fputs_unfiltered (prev_suffix, gdb_stdlog);
2316       fputs_unfiltered ("\n", gdb_stdlog);
2317       fputs_unfiltered (prefix, gdb_stdlog);
2318     }
2319
2320   /* Print prefix if we printed a newline during the previous call.  */
2321   if (new_line)
2322     {
2323       new_line = 0;
2324       fputs_unfiltered (prefix, gdb_stdlog);
2325     }
2326
2327   prev_prefix = prefix;
2328   prev_suffix = suffix;
2329
2330   /* Output characters in a printable format.  */
2331   while ((ch = *string++) != '\0')
2332     {
2333       switch (ch)
2334         {
2335         default:
2336           if (isprint (ch))
2337             fputc_unfiltered (ch, gdb_stdlog);
2338
2339           else
2340             fprintf_unfiltered (gdb_stdlog, "\\x%02x", ch & 0xff);
2341           break;
2342
2343         case '\\':
2344           fputs_unfiltered ("\\\\", gdb_stdlog);
2345           break;
2346         case '\b':
2347           fputs_unfiltered ("\\b", gdb_stdlog);
2348           break;
2349         case '\f':
2350           fputs_unfiltered ("\\f", gdb_stdlog);
2351           break;
2352         case '\n':
2353           new_line = 1;
2354           fputs_unfiltered ("\\n", gdb_stdlog);
2355           break;
2356         case '\r':
2357           fputs_unfiltered ("\\r", gdb_stdlog);
2358           break;
2359         case '\t':
2360           fputs_unfiltered ("\\t", gdb_stdlog);
2361           break;
2362         case '\v':
2363           fputs_unfiltered ("\\v", gdb_stdlog);
2364           break;
2365         }
2366
2367       return_p = ch == '\r';
2368     }
2369
2370   /* Print suffix if we printed a newline.  */
2371   if (new_line)
2372     {
2373       fputs_unfiltered (suffix, gdb_stdlog);
2374       fputs_unfiltered ("\n", gdb_stdlog);
2375     }
2376 }
2377
2378
2379 /* Print a variable number of ARGS using format FORMAT.  If this
2380    information is going to put the amount written (since the last call
2381    to REINITIALIZE_MORE_FILTER or the last page break) over the page size,
2382    call prompt_for_continue to get the users permision to continue.
2383
2384    Unlike fprintf, this function does not return a value.
2385
2386    We implement three variants, vfprintf (takes a vararg list and stream),
2387    fprintf (takes a stream to write on), and printf (the usual).
2388
2389    Note also that a longjmp to top level may occur in this routine
2390    (since prompt_for_continue may do so) so this routine should not be
2391    called when cleanups are not in place.  */
2392
2393 static void
2394 vfprintf_maybe_filtered (struct ui_file *stream, const char *format,
2395                          va_list args, int filter)
2396 {
2397   char *linebuffer;
2398   struct cleanup *old_cleanups;
2399
2400   linebuffer = xstrvprintf (format, args);
2401   old_cleanups = make_cleanup (xfree, linebuffer);
2402   fputs_maybe_filtered (linebuffer, stream, filter);
2403   do_cleanups (old_cleanups);
2404 }
2405
2406
2407 void
2408 vfprintf_filtered (struct ui_file *stream, const char *format, va_list args)
2409 {
2410   vfprintf_maybe_filtered (stream, format, args, 1);
2411 }
2412
2413 void
2414 vfprintf_unfiltered (struct ui_file *stream, const char *format, va_list args)
2415 {
2416   char *linebuffer;
2417   struct cleanup *old_cleanups;
2418
2419   linebuffer = xstrvprintf (format, args);
2420   old_cleanups = make_cleanup (xfree, linebuffer);
2421   if (debug_timestamp && stream == gdb_stdlog)
2422     {
2423       struct timeval tm;
2424       char *timestamp;
2425       int len, need_nl;
2426
2427       gettimeofday (&tm, NULL);
2428
2429       len = strlen (linebuffer);
2430       need_nl = (len > 0 && linebuffer[len - 1] != '\n');
2431
2432       timestamp = xstrprintf ("%ld:%ld %s%s",
2433                               (long) tm.tv_sec, (long) tm.tv_usec,
2434                               linebuffer,
2435                               need_nl ? "\n": "");
2436       make_cleanup (xfree, timestamp);
2437       fputs_unfiltered (timestamp, stream);
2438     }
2439   else
2440     fputs_unfiltered (linebuffer, stream);
2441   do_cleanups (old_cleanups);
2442 }
2443
2444 void
2445 vprintf_filtered (const char *format, va_list args)
2446 {
2447   vfprintf_maybe_filtered (gdb_stdout, format, args, 1);
2448 }
2449
2450 void
2451 vprintf_unfiltered (const char *format, va_list args)
2452 {
2453   vfprintf_unfiltered (gdb_stdout, format, args);
2454 }
2455
2456 void
2457 fprintf_filtered (struct ui_file *stream, const char *format, ...)
2458 {
2459   va_list args;
2460   va_start (args, format);
2461   vfprintf_filtered (stream, format, args);
2462   va_end (args);
2463 }
2464
2465 void
2466 fprintf_unfiltered (struct ui_file *stream, const char *format, ...)
2467 {
2468   va_list args;
2469   va_start (args, format);
2470   vfprintf_unfiltered (stream, format, args);
2471   va_end (args);
2472 }
2473
2474 /* Like fprintf_filtered, but prints its result indented.
2475    Called as fprintfi_filtered (spaces, stream, format, ...);  */
2476
2477 void
2478 fprintfi_filtered (int spaces, struct ui_file *stream, const char *format,
2479                    ...)
2480 {
2481   va_list args;
2482   va_start (args, format);
2483   print_spaces_filtered (spaces, stream);
2484
2485   vfprintf_filtered (stream, format, args);
2486   va_end (args);
2487 }
2488
2489
2490 void
2491 printf_filtered (const char *format, ...)
2492 {
2493   va_list args;
2494   va_start (args, format);
2495   vfprintf_filtered (gdb_stdout, format, args);
2496   va_end (args);
2497 }
2498
2499
2500 void
2501 printf_unfiltered (const char *format, ...)
2502 {
2503   va_list args;
2504   va_start (args, format);
2505   vfprintf_unfiltered (gdb_stdout, format, args);
2506   va_end (args);
2507 }
2508
2509 /* Like printf_filtered, but prints it's result indented.
2510    Called as printfi_filtered (spaces, format, ...);  */
2511
2512 void
2513 printfi_filtered (int spaces, const char *format, ...)
2514 {
2515   va_list args;
2516   va_start (args, format);
2517   print_spaces_filtered (spaces, gdb_stdout);
2518   vfprintf_filtered (gdb_stdout, format, args);
2519   va_end (args);
2520 }
2521
2522 /* Easy -- but watch out!
2523
2524    This routine is *not* a replacement for puts()!  puts() appends a newline.
2525    This one doesn't, and had better not!  */
2526
2527 void
2528 puts_filtered (const char *string)
2529 {
2530   fputs_filtered (string, gdb_stdout);
2531 }
2532
2533 void
2534 puts_unfiltered (const char *string)
2535 {
2536   fputs_unfiltered (string, gdb_stdout);
2537 }
2538
2539 /* Return a pointer to N spaces and a null.  The pointer is good
2540    until the next call to here.  */
2541 char *
2542 n_spaces (int n)
2543 {
2544   char *t;
2545   static char *spaces = 0;
2546   static int max_spaces = -1;
2547
2548   if (n > max_spaces)
2549     {
2550       if (spaces)
2551         xfree (spaces);
2552       spaces = (char *) xmalloc (n + 1);
2553       for (t = spaces + n; t != spaces;)
2554         *--t = ' ';
2555       spaces[n] = '\0';
2556       max_spaces = n;
2557     }
2558
2559   return spaces + max_spaces - n;
2560 }
2561
2562 /* Print N spaces.  */
2563 void
2564 print_spaces_filtered (int n, struct ui_file *stream)
2565 {
2566   fputs_filtered (n_spaces (n), stream);
2567 }
2568 \f
2569 /* C++/ObjC demangler stuff.  */
2570
2571 /* fprintf_symbol_filtered attempts to demangle NAME, a symbol in language
2572    LANG, using demangling args ARG_MODE, and print it filtered to STREAM.
2573    If the name is not mangled, or the language for the name is unknown, or
2574    demangling is off, the name is printed in its "raw" form. */
2575
2576 void
2577 fprintf_symbol_filtered (struct ui_file *stream, char *name,
2578                          enum language lang, int arg_mode)
2579 {
2580   char *demangled;
2581
2582   if (name != NULL)
2583     {
2584       /* If user wants to see raw output, no problem.  */
2585       if (!demangle)
2586         {
2587           fputs_filtered (name, stream);
2588         }
2589       else
2590         {
2591           demangled = language_demangle (language_def (lang), name, arg_mode);
2592           fputs_filtered (demangled ? demangled : name, stream);
2593           if (demangled != NULL)
2594             {
2595               xfree (demangled);
2596             }
2597         }
2598     }
2599 }
2600
2601 /* Do a strcmp() type operation on STRING1 and STRING2, ignoring any
2602    differences in whitespace.  Returns 0 if they match, non-zero if they
2603    don't (slightly different than strcmp()'s range of return values).
2604
2605    As an extra hack, string1=="FOO(ARGS)" matches string2=="FOO".
2606    This "feature" is useful when searching for matching C++ function names
2607    (such as if the user types 'break FOO', where FOO is a mangled C++
2608    function). */
2609
2610 int
2611 strcmp_iw (const char *string1, const char *string2)
2612 {
2613   while ((*string1 != '\0') && (*string2 != '\0'))
2614     {
2615       while (isspace (*string1))
2616         {
2617           string1++;
2618         }
2619       while (isspace (*string2))
2620         {
2621           string2++;
2622         }
2623       if (*string1 != *string2)
2624         {
2625           break;
2626         }
2627       if (*string1 != '\0')
2628         {
2629           string1++;
2630           string2++;
2631         }
2632     }
2633   return (*string1 != '\0' && *string1 != '(') || (*string2 != '\0');
2634 }
2635
2636 /* This is like strcmp except that it ignores whitespace and treats
2637    '(' as the first non-NULL character in terms of ordering.  Like
2638    strcmp (and unlike strcmp_iw), it returns negative if STRING1 <
2639    STRING2, 0 if STRING2 = STRING2, and positive if STRING1 > STRING2
2640    according to that ordering.
2641
2642    If a list is sorted according to this function and if you want to
2643    find names in the list that match some fixed NAME according to
2644    strcmp_iw(LIST_ELT, NAME), then the place to start looking is right
2645    where this function would put NAME.
2646
2647    Here are some examples of why using strcmp to sort is a bad idea:
2648
2649    Whitespace example:
2650
2651    Say your partial symtab contains: "foo<char *>", "goo".  Then, if
2652    we try to do a search for "foo<char*>", strcmp will locate this
2653    after "foo<char *>" and before "goo".  Then lookup_partial_symbol
2654    will start looking at strings beginning with "goo", and will never
2655    see the correct match of "foo<char *>".
2656
2657    Parenthesis example:
2658
2659    In practice, this is less like to be an issue, but I'll give it a
2660    shot.  Let's assume that '$' is a legitimate character to occur in
2661    symbols.  (Which may well even be the case on some systems.)  Then
2662    say that the partial symbol table contains "foo$" and "foo(int)".
2663    strcmp will put them in this order, since '$' < '('.  Now, if the
2664    user searches for "foo", then strcmp will sort "foo" before "foo$".
2665    Then lookup_partial_symbol will notice that strcmp_iw("foo$",
2666    "foo") is false, so it won't proceed to the actual match of
2667    "foo(int)" with "foo".  */
2668
2669 int
2670 strcmp_iw_ordered (const char *string1, const char *string2)
2671 {
2672   while ((*string1 != '\0') && (*string2 != '\0'))
2673     {
2674       while (isspace (*string1))
2675         {
2676           string1++;
2677         }
2678       while (isspace (*string2))
2679         {
2680           string2++;
2681         }
2682       if (*string1 != *string2)
2683         {
2684           break;
2685         }
2686       if (*string1 != '\0')
2687         {
2688           string1++;
2689           string2++;
2690         }
2691     }
2692
2693   switch (*string1)
2694     {
2695       /* Characters are non-equal unless they're both '\0'; we want to
2696          make sure we get the comparison right according to our
2697          comparison in the cases where one of them is '\0' or '('.  */
2698     case '\0':
2699       if (*string2 == '\0')
2700         return 0;
2701       else
2702         return -1;
2703     case '(':
2704       if (*string2 == '\0')
2705         return 1;
2706       else
2707         return -1;
2708     default:
2709       if (*string2 == '(')
2710         return 1;
2711       else
2712         return *string1 - *string2;
2713     }
2714 }
2715
2716 /* A simple comparison function with opposite semantics to strcmp.  */
2717
2718 int
2719 streq (const char *lhs, const char *rhs)
2720 {
2721   return !strcmp (lhs, rhs);
2722 }
2723 \f
2724
2725 /*
2726    ** subset_compare()
2727    **    Answer whether string_to_compare is a full or partial match to
2728    **    template_string.  The partial match must be in sequence starting
2729    **    at index 0.
2730  */
2731 int
2732 subset_compare (char *string_to_compare, char *template_string)
2733 {
2734   int match;
2735   if (template_string != (char *) NULL && string_to_compare != (char *) NULL
2736       && strlen (string_to_compare) <= strlen (template_string))
2737     match =
2738       (strncmp
2739        (template_string, string_to_compare, strlen (string_to_compare)) == 0);
2740   else
2741     match = 0;
2742   return match;
2743 }
2744
2745 static void
2746 pagination_on_command (char *arg, int from_tty)
2747 {
2748   pagination_enabled = 1;
2749 }
2750
2751 static void
2752 pagination_off_command (char *arg, int from_tty)
2753 {
2754   pagination_enabled = 0;
2755 }
2756
2757 static void
2758 show_debug_timestamp (struct ui_file *file, int from_tty,
2759                       struct cmd_list_element *c, const char *value)
2760 {
2761   fprintf_filtered (file, _("Timestamping debugging messages is %s.\n"), value);
2762 }
2763 \f
2764
2765 void
2766 initialize_utils (void)
2767 {
2768   struct cmd_list_element *c;
2769
2770   add_setshow_uinteger_cmd ("width", class_support, &chars_per_line, _("\
2771 Set number of characters gdb thinks are in a line."), _("\
2772 Show number of characters gdb thinks are in a line."), NULL,
2773                             set_width_command,
2774                             show_chars_per_line,
2775                             &setlist, &showlist);
2776
2777   add_setshow_uinteger_cmd ("height", class_support, &lines_per_page, _("\
2778 Set number of lines gdb thinks are in a page."), _("\
2779 Show number of lines gdb thinks are in a page."), NULL,
2780                             set_height_command,
2781                             show_lines_per_page,
2782                             &setlist, &showlist);
2783
2784   init_page_info ();
2785
2786   add_setshow_boolean_cmd ("demangle", class_support, &demangle, _("\
2787 Set demangling of encoded C++/ObjC names when displaying symbols."), _("\
2788 Show demangling of encoded C++/ObjC names when displaying symbols."), NULL,
2789                            NULL,
2790                            show_demangle,
2791                            &setprintlist, &showprintlist);
2792
2793   add_setshow_boolean_cmd ("pagination", class_support,
2794                            &pagination_enabled, _("\
2795 Set state of pagination."), _("\
2796 Show state of pagination."), NULL,
2797                            NULL,
2798                            show_pagination_enabled,
2799                            &setlist, &showlist);
2800
2801   if (xdb_commands)
2802     {
2803       add_com ("am", class_support, pagination_on_command,
2804                _("Enable pagination"));
2805       add_com ("sm", class_support, pagination_off_command,
2806                _("Disable pagination"));
2807     }
2808
2809   add_setshow_boolean_cmd ("sevenbit-strings", class_support,
2810                            &sevenbit_strings, _("\
2811 Set printing of 8-bit characters in strings as \\nnn."), _("\
2812 Show printing of 8-bit characters in strings as \\nnn."), NULL,
2813                            NULL,
2814                            show_sevenbit_strings,
2815                            &setprintlist, &showprintlist);
2816
2817   add_setshow_boolean_cmd ("asm-demangle", class_support, &asm_demangle, _("\
2818 Set demangling of C++/ObjC names in disassembly listings."), _("\
2819 Show demangling of C++/ObjC names in disassembly listings."), NULL,
2820                            NULL,
2821                            show_asm_demangle,
2822                            &setprintlist, &showprintlist);
2823
2824   add_setshow_boolean_cmd ("timestamp", class_maintenance,
2825                             &debug_timestamp, _("\
2826 Set timestamping of debugging messages."), _("\
2827 Show timestamping of debugging messages."), _("\
2828 When set, debugging messages will be marked with seconds and microseconds."),
2829                            NULL,
2830                            show_debug_timestamp,
2831                            &setdebuglist, &showdebuglist);
2832 }
2833
2834 /* Machine specific function to handle SIGWINCH signal. */
2835
2836 #ifdef  SIGWINCH_HANDLER_BODY
2837 SIGWINCH_HANDLER_BODY
2838 #endif
2839 /* print routines to handle variable size regs, etc. */
2840 /* temporary storage using circular buffer */
2841 #define NUMCELLS 16
2842 #define CELLSIZE 50
2843 static char *
2844 get_cell (void)
2845 {
2846   static char buf[NUMCELLS][CELLSIZE];
2847   static int cell = 0;
2848   if (++cell >= NUMCELLS)
2849     cell = 0;
2850   return buf[cell];
2851 }
2852
2853 const char *
2854 paddress (struct gdbarch *gdbarch, CORE_ADDR addr)
2855 {
2856   /* Truncate address to the size of a target address, avoiding shifts
2857      larger or equal than the width of a CORE_ADDR.  The local
2858      variable ADDR_BIT stops the compiler reporting a shift overflow
2859      when it won't occur. */
2860   /* NOTE: This assumes that the significant address information is
2861      kept in the least significant bits of ADDR - the upper bits were
2862      either zero or sign extended.  Should gdbarch_address_to_pointer or
2863      some ADDRESS_TO_PRINTABLE() be used to do the conversion?  */
2864
2865   int addr_bit = gdbarch_addr_bit (gdbarch);
2866
2867   if (addr_bit < (sizeof (CORE_ADDR) * HOST_CHAR_BIT))
2868     addr &= ((CORE_ADDR) 1 << addr_bit) - 1;
2869   return hex_string (addr);
2870 }
2871
2872 static char *
2873 decimal2str (char *sign, ULONGEST addr, int width)
2874 {
2875   /* Steal code from valprint.c:print_decimal().  Should this worry
2876      about the real size of addr as the above does? */
2877   unsigned long temp[3];
2878   char *str = get_cell ();
2879
2880   int i = 0;
2881   do
2882     {
2883       temp[i] = addr % (1000 * 1000 * 1000);
2884       addr /= (1000 * 1000 * 1000);
2885       i++;
2886       width -= 9;
2887     }
2888   while (addr != 0 && i < (sizeof (temp) / sizeof (temp[0])));
2889
2890   width += 9;
2891   if (width < 0)
2892     width = 0;
2893
2894   switch (i)
2895     {
2896     case 1:
2897       xsnprintf (str, CELLSIZE, "%s%0*lu", sign, width, temp[0]);
2898       break;
2899     case 2:
2900       xsnprintf (str, CELLSIZE, "%s%0*lu%09lu", sign, width,
2901                  temp[1], temp[0]);
2902       break;
2903     case 3:
2904       xsnprintf (str, CELLSIZE, "%s%0*lu%09lu%09lu", sign, width,
2905                  temp[2], temp[1], temp[0]);
2906       break;
2907     default:
2908       internal_error (__FILE__, __LINE__,
2909                       _("failed internal consistency check"));
2910     }
2911
2912   return str;
2913 }
2914
2915 static char *
2916 octal2str (ULONGEST addr, int width)
2917 {
2918   unsigned long temp[3];
2919   char *str = get_cell ();
2920
2921   int i = 0;
2922   do
2923     {
2924       temp[i] = addr % (0100000 * 0100000);
2925       addr /= (0100000 * 0100000);
2926       i++;
2927       width -= 10;
2928     }
2929   while (addr != 0 && i < (sizeof (temp) / sizeof (temp[0])));
2930
2931   width += 10;
2932   if (width < 0)
2933     width = 0;
2934
2935   switch (i)
2936     {
2937     case 1:
2938       if (temp[0] == 0)
2939         xsnprintf (str, CELLSIZE, "%*o", width, 0);
2940       else
2941         xsnprintf (str, CELLSIZE, "0%0*lo", width, temp[0]);
2942       break;
2943     case 2:
2944       xsnprintf (str, CELLSIZE, "0%0*lo%010lo", width, temp[1], temp[0]);
2945       break;
2946     case 3:
2947       xsnprintf (str, CELLSIZE, "0%0*lo%010lo%010lo", width,
2948                  temp[2], temp[1], temp[0]);
2949       break;
2950     default:
2951       internal_error (__FILE__, __LINE__,
2952                       _("failed internal consistency check"));
2953     }
2954
2955   return str;
2956 }
2957
2958 char *
2959 pulongest (ULONGEST u)
2960 {
2961   return decimal2str ("", u, 0);
2962 }
2963
2964 char *
2965 plongest (LONGEST l)
2966 {
2967   if (l < 0)
2968     return decimal2str ("-", -l, 0);
2969   else
2970     return decimal2str ("", l, 0);
2971 }
2972
2973 /* Eliminate warning from compiler on 32-bit systems.  */
2974 static int thirty_two = 32;
2975
2976 char *
2977 phex (ULONGEST l, int sizeof_l)
2978 {
2979   char *str;
2980
2981   switch (sizeof_l)
2982     {
2983     case 8:
2984       str = get_cell ();
2985       xsnprintf (str, CELLSIZE, "%08lx%08lx",
2986                  (unsigned long) (l >> thirty_two),
2987                  (unsigned long) (l & 0xffffffff));
2988       break;
2989     case 4:
2990       str = get_cell ();
2991       xsnprintf (str, CELLSIZE, "%08lx", (unsigned long) l);
2992       break;
2993     case 2:
2994       str = get_cell ();
2995       xsnprintf (str, CELLSIZE, "%04x", (unsigned short) (l & 0xffff));
2996       break;
2997     default:
2998       str = phex (l, sizeof (l));
2999       break;
3000     }
3001
3002   return str;
3003 }
3004
3005 char *
3006 phex_nz (ULONGEST l, int sizeof_l)
3007 {
3008   char *str;
3009
3010   switch (sizeof_l)
3011     {
3012     case 8:
3013       {
3014         unsigned long high = (unsigned long) (l >> thirty_two);
3015         str = get_cell ();
3016         if (high == 0)
3017           xsnprintf (str, CELLSIZE, "%lx",
3018                      (unsigned long) (l & 0xffffffff));
3019         else
3020           xsnprintf (str, CELLSIZE, "%lx%08lx", high,
3021                      (unsigned long) (l & 0xffffffff));
3022         break;
3023       }
3024     case 4:
3025       str = get_cell ();
3026       xsnprintf (str, CELLSIZE, "%lx", (unsigned long) l);
3027       break;
3028     case 2:
3029       str = get_cell ();
3030       xsnprintf (str, CELLSIZE, "%x", (unsigned short) (l & 0xffff));
3031       break;
3032     default:
3033       str = phex_nz (l, sizeof (l));
3034       break;
3035     }
3036
3037   return str;
3038 }
3039
3040 /* Converts a LONGEST to a C-format hexadecimal literal and stores it
3041    in a static string.  Returns a pointer to this string.  */
3042 char *
3043 hex_string (LONGEST num)
3044 {
3045   char *result = get_cell ();
3046   xsnprintf (result, CELLSIZE, "0x%s", phex_nz (num, sizeof (num)));
3047   return result;
3048 }
3049
3050 /* Converts a LONGEST number to a C-format hexadecimal literal and
3051    stores it in a static string.  Returns a pointer to this string
3052    that is valid until the next call.  The number is padded on the
3053    left with 0s to at least WIDTH characters.  */
3054 char *
3055 hex_string_custom (LONGEST num, int width)
3056 {
3057   char *result = get_cell ();
3058   char *result_end = result + CELLSIZE - 1;
3059   const char *hex = phex_nz (num, sizeof (num));
3060   int hex_len = strlen (hex);
3061
3062   if (hex_len > width)
3063     width = hex_len;
3064   if (width + 2 >= CELLSIZE)
3065     internal_error (__FILE__, __LINE__,
3066                     _("hex_string_custom: insufficient space to store result"));
3067
3068   strcpy (result_end - width - 2, "0x");
3069   memset (result_end - width, '0', width);
3070   strcpy (result_end - hex_len, hex);
3071   return result_end - width - 2;
3072 }
3073
3074 /* Convert VAL to a numeral in the given radix.  For
3075  * radix 10, IS_SIGNED may be true, indicating a signed quantity;
3076  * otherwise VAL is interpreted as unsigned.  If WIDTH is supplied, 
3077  * it is the minimum width (0-padded if needed).  USE_C_FORMAT means
3078  * to use C format in all cases.  If it is false, then 'x' 
3079  * and 'o' formats do not include a prefix (0x or leading 0). */
3080
3081 char *
3082 int_string (LONGEST val, int radix, int is_signed, int width, 
3083             int use_c_format)
3084 {
3085   switch (radix) 
3086     {
3087     case 16:
3088       {
3089         char *result;
3090         if (width == 0)
3091           result = hex_string (val);
3092         else
3093           result = hex_string_custom (val, width);
3094         if (! use_c_format)
3095           result += 2;
3096         return result;
3097       }
3098     case 10:
3099       {
3100         if (is_signed && val < 0)
3101           return decimal2str ("-", -val, width);
3102         else
3103           return decimal2str ("", val, width);
3104       }
3105     case 8:
3106       {
3107         char *result = octal2str (val, width);
3108         if (use_c_format || val == 0)
3109           return result;
3110         else
3111           return result + 1;
3112       }
3113     default:
3114       internal_error (__FILE__, __LINE__,
3115                       _("failed internal consistency check"));
3116     }
3117 }       
3118
3119 /* Convert a CORE_ADDR into a string.  */
3120 const char *
3121 core_addr_to_string (const CORE_ADDR addr)
3122 {
3123   char *str = get_cell ();
3124   strcpy (str, "0x");
3125   strcat (str, phex (addr, sizeof (addr)));
3126   return str;
3127 }
3128
3129 const char *
3130 core_addr_to_string_nz (const CORE_ADDR addr)
3131 {
3132   char *str = get_cell ();
3133   strcpy (str, "0x");
3134   strcat (str, phex_nz (addr, sizeof (addr)));
3135   return str;
3136 }
3137
3138 /* Convert a string back into a CORE_ADDR.  */
3139 CORE_ADDR
3140 string_to_core_addr (const char *my_string)
3141 {
3142   CORE_ADDR addr = 0;
3143
3144   if (my_string[0] == '0' && tolower (my_string[1]) == 'x')
3145     {
3146       /* Assume that it is in hex.  */
3147       int i;
3148       for (i = 2; my_string[i] != '\0'; i++)
3149         {
3150           if (isdigit (my_string[i]))
3151             addr = (my_string[i] - '0') + (addr * 16);
3152           else if (isxdigit (my_string[i]))
3153             addr = (tolower (my_string[i]) - 'a' + 0xa) + (addr * 16);
3154           else
3155             error (_("invalid hex \"%s\""), my_string);
3156         }
3157     }
3158   else
3159     {
3160       /* Assume that it is in decimal.  */
3161       int i;
3162       for (i = 0; my_string[i] != '\0'; i++)
3163         {
3164           if (isdigit (my_string[i]))
3165             addr = (my_string[i] - '0') + (addr * 10);
3166           else
3167             error (_("invalid decimal \"%s\""), my_string);
3168         }
3169     }
3170
3171   return addr;
3172 }
3173
3174 const char *
3175 host_address_to_string (const void *addr)
3176 {
3177   char *str = get_cell ();
3178
3179   xsnprintf (str, CELLSIZE, "0x%s", phex_nz ((uintptr_t) addr, sizeof (addr)));
3180   return str;
3181 }
3182
3183 char *
3184 gdb_realpath (const char *filename)
3185 {
3186   /* Method 1: The system has a compile time upper bound on a filename
3187      path.  Use that and realpath() to canonicalize the name.  This is
3188      the most common case.  Note that, if there isn't a compile time
3189      upper bound, you want to avoid realpath() at all costs.  */
3190 #if defined(HAVE_REALPATH)
3191   {
3192 # if defined (PATH_MAX)
3193     char buf[PATH_MAX];
3194 #  define USE_REALPATH
3195 # elif defined (MAXPATHLEN)
3196     char buf[MAXPATHLEN];
3197 #  define USE_REALPATH
3198 # endif
3199 # if defined (USE_REALPATH)
3200     const char *rp = realpath (filename, buf);
3201     if (rp == NULL)
3202       rp = filename;
3203     return xstrdup (rp);
3204 # endif
3205   }
3206 #endif /* HAVE_REALPATH */
3207
3208   /* Method 2: The host system (i.e., GNU) has the function
3209      canonicalize_file_name() which malloc's a chunk of memory and
3210      returns that, use that.  */
3211 #if defined(HAVE_CANONICALIZE_FILE_NAME)
3212   {
3213     char *rp = canonicalize_file_name (filename);
3214     if (rp == NULL)
3215       return xstrdup (filename);
3216     else
3217       return rp;
3218   }
3219 #endif
3220
3221   /* FIXME: cagney/2002-11-13:
3222
3223      Method 2a: Use realpath() with a NULL buffer.  Some systems, due
3224      to the problems described in in method 3, have modified their
3225      realpath() implementation so that it will allocate a buffer when
3226      NULL is passed in.  Before this can be used, though, some sort of
3227      configure time test would need to be added.  Otherwize the code
3228      will likely core dump.  */
3229
3230   /* Method 3: Now we're getting desperate!  The system doesn't have a
3231      compile time buffer size and no alternative function.  Query the
3232      OS, using pathconf(), for the buffer limit.  Care is needed
3233      though, some systems do not limit PATH_MAX (return -1 for
3234      pathconf()) making it impossible to pass a correctly sized buffer
3235      to realpath() (it could always overflow).  On those systems, we
3236      skip this.  */
3237 #if defined (HAVE_REALPATH) && defined (HAVE_UNISTD_H) && defined(HAVE_ALLOCA)
3238   {
3239     /* Find out the max path size.  */
3240     long path_max = pathconf ("/", _PC_PATH_MAX);
3241     if (path_max > 0)
3242       {
3243         /* PATH_MAX is bounded.  */
3244         char *buf = alloca (path_max);
3245         char *rp = realpath (filename, buf);
3246         return xstrdup (rp ? rp : filename);
3247       }
3248   }
3249 #endif
3250
3251   /* This system is a lost cause, just dup the buffer.  */
3252   return xstrdup (filename);
3253 }
3254
3255 /* Return a copy of FILENAME, with its directory prefix canonicalized
3256    by gdb_realpath.  */
3257
3258 char *
3259 xfullpath (const char *filename)
3260 {
3261   const char *base_name = lbasename (filename);
3262   char *dir_name;
3263   char *real_path;
3264   char *result;
3265
3266   /* Extract the basename of filename, and return immediately 
3267      a copy of filename if it does not contain any directory prefix. */
3268   if (base_name == filename)
3269     return xstrdup (filename);
3270
3271   dir_name = alloca ((size_t) (base_name - filename + 2));
3272   /* Allocate enough space to store the dir_name + plus one extra
3273      character sometimes needed under Windows (see below), and
3274      then the closing \000 character */
3275   strncpy (dir_name, filename, base_name - filename);
3276   dir_name[base_name - filename] = '\000';
3277
3278 #ifdef HAVE_DOS_BASED_FILE_SYSTEM
3279   /* We need to be careful when filename is of the form 'd:foo', which
3280      is equivalent of d:./foo, which is totally different from d:/foo.  */
3281   if (strlen (dir_name) == 2 && isalpha (dir_name[0]) && dir_name[1] == ':')
3282     {
3283       dir_name[2] = '.';
3284       dir_name[3] = '\000';
3285     }
3286 #endif
3287
3288   /* Canonicalize the directory prefix, and build the resulting
3289      filename. If the dirname realpath already contains an ending
3290      directory separator, avoid doubling it.  */
3291   real_path = gdb_realpath (dir_name);
3292   if (IS_DIR_SEPARATOR (real_path[strlen (real_path) - 1]))
3293     result = concat (real_path, base_name, (char *)NULL);
3294   else
3295     result = concat (real_path, SLASH_STRING, base_name, (char *)NULL);
3296
3297   xfree (real_path);
3298   return result;
3299 }
3300
3301
3302 /* This is the 32-bit CRC function used by the GNU separate debug
3303    facility.  An executable may contain a section named
3304    .gnu_debuglink, which holds the name of a separate executable file
3305    containing its debug info, and a checksum of that file's contents,
3306    computed using this function.  */
3307 unsigned long
3308 gnu_debuglink_crc32 (unsigned long crc, unsigned char *buf, size_t len)
3309 {
3310   static const unsigned long crc32_table[256] = {
3311     0x00000000, 0x77073096, 0xee0e612c, 0x990951ba, 0x076dc419,
3312     0x706af48f, 0xe963a535, 0x9e6495a3, 0x0edb8832, 0x79dcb8a4,
3313     0xe0d5e91e, 0x97d2d988, 0x09b64c2b, 0x7eb17cbd, 0xe7b82d07,
3314     0x90bf1d91, 0x1db71064, 0x6ab020f2, 0xf3b97148, 0x84be41de,
3315     0x1adad47d, 0x6ddde4eb, 0xf4d4b551, 0x83d385c7, 0x136c9856,
3316     0x646ba8c0, 0xfd62f97a, 0x8a65c9ec, 0x14015c4f, 0x63066cd9,
3317     0xfa0f3d63, 0x8d080df5, 0x3b6e20c8, 0x4c69105e, 0xd56041e4,
3318     0xa2677172, 0x3c03e4d1, 0x4b04d447, 0xd20d85fd, 0xa50ab56b,
3319     0x35b5a8fa, 0x42b2986c, 0xdbbbc9d6, 0xacbcf940, 0x32d86ce3,
3320     0x45df5c75, 0xdcd60dcf, 0xabd13d59, 0x26d930ac, 0x51de003a,
3321     0xc8d75180, 0xbfd06116, 0x21b4f4b5, 0x56b3c423, 0xcfba9599,
3322     0xb8bda50f, 0x2802b89e, 0x5f058808, 0xc60cd9b2, 0xb10be924,
3323     0x2f6f7c87, 0x58684c11, 0xc1611dab, 0xb6662d3d, 0x76dc4190,
3324     0x01db7106, 0x98d220bc, 0xefd5102a, 0x71b18589, 0x06b6b51f,
3325     0x9fbfe4a5, 0xe8b8d433, 0x7807c9a2, 0x0f00f934, 0x9609a88e,
3326     0xe10e9818, 0x7f6a0dbb, 0x086d3d2d, 0x91646c97, 0xe6635c01,
3327     0x6b6b51f4, 0x1c6c6162, 0x856530d8, 0xf262004e, 0x6c0695ed,
3328     0x1b01a57b, 0x8208f4c1, 0xf50fc457, 0x65b0d9c6, 0x12b7e950,
3329     0x8bbeb8ea, 0xfcb9887c, 0x62dd1ddf, 0x15da2d49, 0x8cd37cf3,
3330     0xfbd44c65, 0x4db26158, 0x3ab551ce, 0xa3bc0074, 0xd4bb30e2,
3331     0x4adfa541, 0x3dd895d7, 0xa4d1c46d, 0xd3d6f4fb, 0x4369e96a,
3332     0x346ed9fc, 0xad678846, 0xda60b8d0, 0x44042d73, 0x33031de5,
3333     0xaa0a4c5f, 0xdd0d7cc9, 0x5005713c, 0x270241aa, 0xbe0b1010,
3334     0xc90c2086, 0x5768b525, 0x206f85b3, 0xb966d409, 0xce61e49f,
3335     0x5edef90e, 0x29d9c998, 0xb0d09822, 0xc7d7a8b4, 0x59b33d17,
3336     0x2eb40d81, 0xb7bd5c3b, 0xc0ba6cad, 0xedb88320, 0x9abfb3b6,
3337     0x03b6e20c, 0x74b1d29a, 0xead54739, 0x9dd277af, 0x04db2615,
3338     0x73dc1683, 0xe3630b12, 0x94643b84, 0x0d6d6a3e, 0x7a6a5aa8,
3339     0xe40ecf0b, 0x9309ff9d, 0x0a00ae27, 0x7d079eb1, 0xf00f9344,
3340     0x8708a3d2, 0x1e01f268, 0x6906c2fe, 0xf762575d, 0x806567cb,
3341     0x196c3671, 0x6e6b06e7, 0xfed41b76, 0x89d32be0, 0x10da7a5a,
3342     0x67dd4acc, 0xf9b9df6f, 0x8ebeeff9, 0x17b7be43, 0x60b08ed5,
3343     0xd6d6a3e8, 0xa1d1937e, 0x38d8c2c4, 0x4fdff252, 0xd1bb67f1,
3344     0xa6bc5767, 0x3fb506dd, 0x48b2364b, 0xd80d2bda, 0xaf0a1b4c,
3345     0x36034af6, 0x41047a60, 0xdf60efc3, 0xa867df55, 0x316e8eef,
3346     0x4669be79, 0xcb61b38c, 0xbc66831a, 0x256fd2a0, 0x5268e236,
3347     0xcc0c7795, 0xbb0b4703, 0x220216b9, 0x5505262f, 0xc5ba3bbe,
3348     0xb2bd0b28, 0x2bb45a92, 0x5cb36a04, 0xc2d7ffa7, 0xb5d0cf31,
3349     0x2cd99e8b, 0x5bdeae1d, 0x9b64c2b0, 0xec63f226, 0x756aa39c,
3350     0x026d930a, 0x9c0906a9, 0xeb0e363f, 0x72076785, 0x05005713,
3351     0x95bf4a82, 0xe2b87a14, 0x7bb12bae, 0x0cb61b38, 0x92d28e9b,
3352     0xe5d5be0d, 0x7cdcefb7, 0x0bdbdf21, 0x86d3d2d4, 0xf1d4e242,
3353     0x68ddb3f8, 0x1fda836e, 0x81be16cd, 0xf6b9265b, 0x6fb077e1,
3354     0x18b74777, 0x88085ae6, 0xff0f6a70, 0x66063bca, 0x11010b5c,
3355     0x8f659eff, 0xf862ae69, 0x616bffd3, 0x166ccf45, 0xa00ae278,
3356     0xd70dd2ee, 0x4e048354, 0x3903b3c2, 0xa7672661, 0xd06016f7,
3357     0x4969474d, 0x3e6e77db, 0xaed16a4a, 0xd9d65adc, 0x40df0b66,
3358     0x37d83bf0, 0xa9bcae53, 0xdebb9ec5, 0x47b2cf7f, 0x30b5ffe9,
3359     0xbdbdf21c, 0xcabac28a, 0x53b39330, 0x24b4a3a6, 0xbad03605,
3360     0xcdd70693, 0x54de5729, 0x23d967bf, 0xb3667a2e, 0xc4614ab8,
3361     0x5d681b02, 0x2a6f2b94, 0xb40bbe37, 0xc30c8ea1, 0x5a05df1b,
3362     0x2d02ef8d
3363   };
3364   unsigned char *end;
3365
3366   crc = ~crc & 0xffffffff;
3367   for (end = buf + len; buf < end; ++buf)
3368     crc = crc32_table[(crc ^ *buf) & 0xff] ^ (crc >> 8);
3369   return ~crc & 0xffffffff;;
3370 }
3371
3372 ULONGEST
3373 align_up (ULONGEST v, int n)
3374 {
3375   /* Check that N is really a power of two.  */
3376   gdb_assert (n && (n & (n-1)) == 0);
3377   return (v + n - 1) & -n;
3378 }
3379
3380 ULONGEST
3381 align_down (ULONGEST v, int n)
3382 {
3383   /* Check that N is really a power of two.  */
3384   gdb_assert (n && (n & (n-1)) == 0);
3385   return (v & -n);
3386 }
3387
3388 /* Allocation function for the libiberty hash table which uses an
3389    obstack.  The obstack is passed as DATA.  */
3390
3391 void *
3392 hashtab_obstack_allocate (void *data, size_t size, size_t count)
3393 {
3394   unsigned int total = size * count;
3395   void *ptr = obstack_alloc ((struct obstack *) data, total);
3396   memset (ptr, 0, total);
3397   return ptr;
3398 }
3399
3400 /* Trivial deallocation function for the libiberty splay tree and hash
3401    table - don't deallocate anything.  Rely on later deletion of the
3402    obstack.  DATA will be the obstack, although it is not needed
3403    here.  */
3404
3405 void
3406 dummy_obstack_deallocate (void *object, void *data)
3407 {
3408   return;
3409 }
3410
3411 /* The bit offset of the highest byte in a ULONGEST, for overflow
3412    checking.  */
3413
3414 #define HIGH_BYTE_POSN ((sizeof (ULONGEST) - 1) * HOST_CHAR_BIT)
3415
3416 /* True (non-zero) iff DIGIT is a valid digit in radix BASE,
3417    where 2 <= BASE <= 36.  */
3418
3419 static int
3420 is_digit_in_base (unsigned char digit, int base)
3421 {
3422   if (!isalnum (digit))
3423     return 0;
3424   if (base <= 10)
3425     return (isdigit (digit) && digit < base + '0');
3426   else
3427     return (isdigit (digit) || tolower (digit) < base - 10 + 'a');
3428 }
3429
3430 static int
3431 digit_to_int (unsigned char c)
3432 {
3433   if (isdigit (c))
3434     return c - '0';
3435   else
3436     return tolower (c) - 'a' + 10;
3437 }
3438
3439 /* As for strtoul, but for ULONGEST results.  */
3440
3441 ULONGEST
3442 strtoulst (const char *num, const char **trailer, int base)
3443 {
3444   unsigned int high_part;
3445   ULONGEST result;
3446   int minus = 0;
3447   int i = 0;
3448
3449   /* Skip leading whitespace.  */
3450   while (isspace (num[i]))
3451     i++;
3452
3453   /* Handle prefixes.  */
3454   if (num[i] == '+')
3455     i++;
3456   else if (num[i] == '-')
3457     {
3458       minus = 1;
3459       i++;
3460     }
3461
3462   if (base == 0 || base == 16)
3463     {
3464       if (num[i] == '0' && (num[i + 1] == 'x' || num[i + 1] == 'X'))
3465         {
3466           i += 2;
3467           if (base == 0)
3468             base = 16;
3469         }
3470     }
3471
3472   if (base == 0 && num[i] == '0')
3473     base = 8;
3474
3475   if (base == 0)
3476     base = 10;
3477
3478   if (base < 2 || base > 36)
3479     {
3480       errno = EINVAL;
3481       return 0;
3482     }
3483
3484   result = high_part = 0;
3485   for (; is_digit_in_base (num[i], base); i += 1)
3486     {
3487       result = result * base + digit_to_int (num[i]);
3488       high_part = high_part * base + (unsigned int) (result >> HIGH_BYTE_POSN);
3489       result &= ((ULONGEST) 1 << HIGH_BYTE_POSN) - 1;
3490       if (high_part > 0xff)
3491         {
3492           errno = ERANGE;
3493           result = ~ (ULONGEST) 0;
3494           high_part = 0;
3495           minus = 0;
3496           break;
3497         }
3498     }
3499
3500   if (trailer != NULL)
3501     *trailer = &num[i];
3502
3503   result = result + ((ULONGEST) high_part << HIGH_BYTE_POSN);
3504   if (minus)
3505     return -result;
3506   else
3507     return result;
3508 }
3509
3510 /* Simple, portable version of dirname that does not modify its
3511    argument.  */
3512
3513 char *
3514 ldirname (const char *filename)
3515 {
3516   const char *base = lbasename (filename);
3517   char *dirname;
3518
3519   while (base > filename && IS_DIR_SEPARATOR (base[-1]))
3520     --base;
3521
3522   if (base == filename)
3523     return NULL;
3524
3525   dirname = xmalloc (base - filename + 2);
3526   memcpy (dirname, filename, base - filename);
3527
3528   /* On DOS based file systems, convert "d:foo" to "d:.", so that we
3529      create "d:./bar" later instead of the (different) "d:/bar".  */
3530   if (base - filename == 2 && IS_ABSOLUTE_PATH (base)
3531       && !IS_DIR_SEPARATOR (filename[0]))
3532     dirname[base++ - filename] = '.';
3533
3534   dirname[base - filename] = '\0';
3535   return dirname;
3536 }
3537
3538 /* Call libiberty's buildargv, and return the result.
3539    If buildargv fails due to out-of-memory, call nomem.
3540    Therefore, the returned value is guaranteed to be non-NULL,
3541    unless the parameter itself is NULL.  */
3542
3543 char **
3544 gdb_buildargv (const char *s)
3545 {
3546   char **argv = buildargv (s);
3547   if (s != NULL && argv == NULL)
3548     nomem (0);
3549   return argv;
3550 }
3551
3552 /* Provide a prototype to silence -Wmissing-prototypes.  */
3553 extern initialize_file_ftype _initialize_utils;
3554
3555 void
3556 _initialize_utils (void)
3557 {
3558   add_internal_problem_command (&internal_error_problem);
3559   add_internal_problem_command (&internal_warning_problem);
3560 }