PR python/17372 - Python hangs when displaying help()
[external/binutils.git] / gdb / top.c
1 /* Top level stuff for GDB, the GNU debugger.
2
3    Copyright (C) 1986-2014 Free Software Foundation, Inc.
4
5    This file is part of GDB.
6
7    This program is free software; you can redistribute it and/or modify
8    it under the terms of the GNU General Public License as published by
9    the Free Software Foundation; either version 3 of the License, or
10    (at your option) any later version.
11
12    This program is distributed in the hope that it will be useful,
13    but WITHOUT ANY WARRANTY; without even the implied warranty of
14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15    GNU General Public License for more details.
16
17    You should have received a copy of the GNU General Public License
18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
19
20 #include "defs.h"
21 #include "gdbcmd.h"
22 #include "cli/cli-cmds.h"
23 #include "cli/cli-script.h"
24 #include "cli/cli-setshow.h"
25 #include "cli/cli-decode.h"
26 #include "symtab.h"
27 #include "inferior.h"
28 #include "infrun.h"
29 #include <signal.h>
30 #include "target.h"
31 #include "target-dcache.h"
32 #include "breakpoint.h"
33 #include "gdbtypes.h"
34 #include "expression.h"
35 #include "value.h"
36 #include "language.h"
37 #include "terminal.h"           /* For job_control.  */
38 #include "annotate.h"
39 #include "completer.h"
40 #include "top.h"
41 #include "version.h"
42 #include "serial.h"
43 #include "doublest.h"
44 #include "main.h"
45 #include "event-loop.h"
46 #include "gdbthread.h"
47 #include "extension.h"
48 #include "interps.h"
49 #include "observer.h"
50 #include "maint.h"
51 #include "filenames.h"
52
53 /* readline include files.  */
54 #include "readline/readline.h"
55 #include "readline/history.h"
56
57 /* readline defines this.  */
58 #undef savestring
59
60 #include <sys/types.h>
61
62 #include "event-top.h"
63 #include <sys/stat.h>
64 #include <ctype.h>
65 #include "ui-out.h"
66 #include "cli-out.h"
67 #include "tracepoint.h"
68 #include "inf-loop.h"
69
70 extern void initialize_all_files (void);
71
72 #define PROMPT(X) the_prompts.prompt_stack[the_prompts.top + X].prompt
73 #define PREFIX(X) the_prompts.prompt_stack[the_prompts.top + X].prefix
74 #define SUFFIX(X) the_prompts.prompt_stack[the_prompts.top + X].suffix
75
76 /* Default command line prompt.  This is overriden in some configs.  */
77
78 #ifndef DEFAULT_PROMPT
79 #define DEFAULT_PROMPT  "(gdb) "
80 #endif
81
82 /* Initialization file name for gdb.  This is host-dependent.  */
83
84 const char gdbinit[] = GDBINIT;
85
86 int inhibit_gdbinit = 0;
87
88 extern char lang_frame_mismatch_warn[];         /* language.c */
89
90 /* Flag for whether we want to confirm potentially dangerous
91    operations.  Default is yes.  */
92
93 int confirm = 1;
94
95 static void
96 show_confirm (struct ui_file *file, int from_tty,
97               struct cmd_list_element *c, const char *value)
98 {
99   fprintf_filtered (file, _("Whether to confirm potentially "
100                             "dangerous operations is %s.\n"),
101                     value);
102 }
103
104 /* stdio stream that command input is being read from.  Set to stdin
105    normally.  Set by source_command to the file we are sourcing.  Set
106    to NULL if we are executing a user-defined command or interacting
107    via a GUI.  */
108
109 FILE *instream;
110
111 /* Flag to indicate whether a user defined command is currently running.  */
112
113 int in_user_command;
114
115 /* Current working directory.  */
116
117 char *current_directory;
118
119 /* The directory name is actually stored here (usually).  */
120 char gdb_dirbuf[1024];
121
122 /* Function to call before reading a command, if nonzero.
123    The function receives two args: an input stream,
124    and a prompt string.  */
125
126 void (*window_hook) (FILE *, char *);
127
128 /* Buffer used for reading command lines, and the size
129    allocated for it so far.  */
130
131 char *saved_command_line;
132 int saved_command_line_size = 100;
133
134 /* Nonzero if the current command is modified by "server ".  This
135    affects things like recording into the command history, commands
136    repeating on RETURN, etc.  This is so a user interface (emacs, GUI,
137    whatever) can issue its own commands and also send along commands
138    from the user, and have the user not notice that the user interface
139    is issuing commands too.  */
140 int server_command;
141
142 /* Timeout limit for response from target.  */
143
144 /* The default value has been changed many times over the years.  It 
145    was originally 5 seconds.  But that was thought to be a long time 
146    to sit and wait, so it was changed to 2 seconds.  That was thought
147    to be plenty unless the connection was going through some terminal 
148    server or multiplexer or other form of hairy serial connection.
149
150    In mid-1996, remote_timeout was moved from remote.c to top.c and 
151    it began being used in other remote-* targets.  It appears that the
152    default was changed to 20 seconds at that time, perhaps because the
153    Renesas E7000 ICE didn't always respond in a timely manner.
154
155    But if 5 seconds is a long time to sit and wait for retransmissions,
156    20 seconds is far worse.  This demonstrates the difficulty of using 
157    a single variable for all protocol timeouts.
158
159    As remote.c is used much more than remote-e7000.c, it was changed 
160    back to 2 seconds in 1999.  */
161
162 int remote_timeout = 2;
163
164 /* Non-zero tells remote* modules to output debugging info.  */
165
166 int remote_debug = 0;
167
168 /* Sbrk location on entry to main.  Used for statistics only.  */
169 #ifdef HAVE_SBRK
170 char *lim_at_start;
171 #endif
172
173 /* Hooks for alternate command interfaces.  */
174
175 /* Called after most modules have been initialized, but before taking
176    users command file.
177
178    If the UI fails to initialize and it wants GDB to continue using
179    the default UI, then it should clear this hook before returning.  */
180
181 void (*deprecated_init_ui_hook) (char *argv0);
182
183 /* This hook is called from within gdb's many mini-event loops which
184    could steal control from a real user interface's event loop.  It
185    returns non-zero if the user is requesting a detach, zero
186    otherwise.  */
187
188 int (*deprecated_ui_loop_hook) (int);
189
190
191 /* Called from print_frame_info to list the line we stopped in.  */
192
193 void (*deprecated_print_frame_info_listing_hook) (struct symtab * s, 
194                                                   int line,
195                                                   int stopline, 
196                                                   int noerror);
197 /* Replaces most of query.  */
198
199 int (*deprecated_query_hook) (const char *, va_list);
200
201 /* Replaces most of warning.  */
202
203 void (*deprecated_warning_hook) (const char *, va_list);
204
205 /* These three functions support getting lines of text from the user.
206    They are used in sequence.  First deprecated_readline_begin_hook is
207    called with a text string that might be (for example) a message for
208    the user to type in a sequence of commands to be executed at a
209    breakpoint.  If this function calls back to a GUI, it might take
210    this opportunity to pop up a text interaction window with this
211    message.  Next, deprecated_readline_hook is called with a prompt
212    that is emitted prior to collecting the user input.  It can be
213    called multiple times.  Finally, deprecated_readline_end_hook is
214    called to notify the GUI that we are done with the interaction
215    window and it can close it.  */
216
217 void (*deprecated_readline_begin_hook) (char *, ...);
218 char *(*deprecated_readline_hook) (char *);
219 void (*deprecated_readline_end_hook) (void);
220
221 /* Called as appropriate to notify the interface that we have attached
222    to or detached from an already running process.  */
223
224 void (*deprecated_attach_hook) (void);
225 void (*deprecated_detach_hook) (void);
226
227 /* Called during long calculations to allow GUI to repair window
228    damage, and to check for stop buttons, etc...  */
229
230 void (*deprecated_interactive_hook) (void);
231
232 /* Tell the GUI someone changed the register REGNO.  -1 means
233    that the caller does not know which register changed or
234    that several registers have changed (see value_assign).  */
235 void (*deprecated_register_changed_hook) (int regno);
236
237 /* Called when going to wait for the target.  Usually allows the GUI
238    to run while waiting for target events.  */
239
240 ptid_t (*deprecated_target_wait_hook) (ptid_t ptid,
241                                        struct target_waitstatus *status,
242                                        int options);
243
244 /* Used by UI as a wrapper around command execution.  May do various
245    things like enabling/disabling buttons, etc...  */
246
247 void (*deprecated_call_command_hook) (struct cmd_list_element * c, 
248                                       char *cmd, int from_tty);
249
250 /* Called when the current thread changes.  Argument is thread id.  */
251
252 void (*deprecated_context_hook) (int id);
253
254 /* Handler for SIGHUP.  */
255
256 #ifdef SIGHUP
257 /* NOTE 1999-04-29: This function will be static again, once we modify
258    gdb to use the event loop as the default command loop and we merge
259    event-top.c into this file, top.c.  */
260 /* static */ void
261 quit_cover (void)
262 {
263   /* Stop asking user for confirmation --- we're exiting.  This
264      prevents asking the user dumb questions.  */
265   confirm = 0;
266   quit_command ((char *) 0, 0);
267 }
268 #endif /* defined SIGHUP */
269 \f
270 /* Line number we are currently in, in a file which is being sourced.  */
271 /* NOTE 1999-04-29: This variable will be static again, once we modify
272    gdb to use the event loop as the default command loop and we merge
273    event-top.c into this file, top.c.  */
274 /* static */ int source_line_number;
275
276 /* Name of the file we are sourcing.  */
277 /* NOTE 1999-04-29: This variable will be static again, once we modify
278    gdb to use the event loop as the default command loop and we merge
279    event-top.c into this file, top.c.  */
280 /* static */ const char *source_file_name;
281
282 /* Clean up on error during a "source" command (or execution of a
283    user-defined command).  */
284
285 void
286 do_restore_instream_cleanup (void *stream)
287 {
288   /* Restore the previous input stream.  */
289   instream = stream;
290 }
291
292 /* Read commands from STREAM.  */
293 void
294 read_command_file (FILE *stream)
295 {
296   struct cleanup *cleanups;
297
298   cleanups = make_cleanup (do_restore_instream_cleanup, instream);
299   instream = stream;
300   command_loop ();
301   do_cleanups (cleanups);
302 }
303 \f
304 void (*pre_init_ui_hook) (void);
305
306 #ifdef __MSDOS__
307 static void
308 do_chdir_cleanup (void *old_dir)
309 {
310   chdir (old_dir);
311   xfree (old_dir);
312 }
313 #endif
314
315 struct cleanup *
316 prepare_execute_command (void)
317 {
318   struct value *mark;
319   struct cleanup *cleanup;
320
321   mark = value_mark ();
322   cleanup = make_cleanup_value_free_to_mark (mark);
323
324   /* With multiple threads running while the one we're examining is
325      stopped, the dcache can get stale without us being able to detect
326      it.  For the duration of the command, though, use the dcache to
327      help things like backtrace.  */
328   if (non_stop)
329     target_dcache_invalidate ();
330
331   return cleanup;
332 }
333
334 /* Tell the user if the language has changed (except first time) after
335    executing a command.  */
336
337 void
338 check_frame_language_change (void)
339 {
340   static int warned = 0;
341
342   /* First make sure that a new frame has been selected, in case the
343      command or the hooks changed the program state.  */
344   deprecated_safe_get_selected_frame ();
345   if (current_language != expected_language)
346     {
347       if (language_mode == language_mode_auto && info_verbose)
348         {
349           language_info (1);    /* Print what changed.  */
350         }
351       warned = 0;
352     }
353
354   /* Warn the user if the working language does not match the language
355      of the current frame.  Only warn the user if we are actually
356      running the program, i.e. there is a stack.  */
357   /* FIXME: This should be cacheing the frame and only running when
358      the frame changes.  */
359
360   if (has_stack_frames ())
361     {
362       enum language flang;
363
364       flang = get_frame_language ();
365       if (!warned
366           && flang != language_unknown
367           && flang != current_language->la_language)
368         {
369           printf_filtered ("%s\n", lang_frame_mismatch_warn);
370           warned = 1;
371         }
372     }
373 }
374
375 /* See top.h.  */
376
377 void
378 maybe_wait_sync_command_done (int was_sync)
379 {
380   /* If the interpreter is in sync mode (we're running a user
381      command's list, running command hooks or similars), and we
382      just ran a synchronous command that started the target, wait
383      for that command to end.  */
384   if (!interpreter_async && !was_sync && sync_execution)
385     {
386       while (gdb_do_one_event () >= 0)
387         if (!sync_execution)
388           break;
389     }
390 }
391
392 /* Execute the line P as a command, in the current user context.
393    Pass FROM_TTY as second argument to the defining function.  */
394
395 void
396 execute_command (char *p, int from_tty)
397 {
398   struct cleanup *cleanup_if_error, *cleanup;
399   struct cmd_list_element *c;
400   char *line;
401
402   cleanup_if_error = make_bpstat_clear_actions_cleanup ();
403   cleanup = prepare_execute_command ();
404
405   /* Force cleanup of any alloca areas if using C alloca instead of
406      a builtin alloca.  */
407   alloca (0);
408
409   /* This can happen when command_line_input hits end of file.  */
410   if (p == NULL)
411     {
412       do_cleanups (cleanup);
413       discard_cleanups (cleanup_if_error);
414       return;
415     }
416
417   target_log_command (p);
418
419   while (*p == ' ' || *p == '\t')
420     p++;
421   if (*p)
422     {
423       const char *cmd = p;
424       char *arg;
425       int was_sync = sync_execution;
426
427       line = p;
428
429       /* If trace-commands is set then this will print this command.  */
430       print_command_trace (p);
431
432       c = lookup_cmd (&cmd, cmdlist, "", 0, 1);
433       p = (char *) cmd;
434
435       /* Pass null arg rather than an empty one.  */
436       arg = *p ? p : 0;
437
438       /* FIXME: cagney/2002-02-02: The c->type test is pretty dodgy
439          while the is_complete_command(cfunc) test is just plain
440          bogus.  They should both be replaced by a test of the form
441          c->strip_trailing_white_space_p.  */
442       /* NOTE: cagney/2002-02-02: The function.cfunc in the below
443          can't be replaced with func.  This is because it is the
444          cfunc, and not the func, that has the value that the
445          is_complete_command hack is testing for.  */
446       /* Clear off trailing whitespace, except for set and complete
447          command.  */
448       if (arg
449           && c->type != set_cmd
450           && !is_complete_command (c))
451         {
452           p = arg + strlen (arg) - 1;
453           while (p >= arg && (*p == ' ' || *p == '\t'))
454             p--;
455           *(p + 1) = '\0';
456         }
457
458       /* If this command has been pre-hooked, run the hook first.  */
459       execute_cmd_pre_hook (c);
460
461       if (c->deprecated_warn_user)
462         deprecated_cmd_warning (line);
463
464       /* c->user_commands would be NULL in the case of a python command.  */
465       if (c->class == class_user && c->user_commands)
466         execute_user_command (c, arg);
467       else if (c->type == set_cmd)
468         do_set_command (arg, from_tty, c);
469       else if (c->type == show_cmd)
470         do_show_command (arg, from_tty, c);
471       else if (!cmd_func_p (c))
472         error (_("That is not a command, just a help topic."));
473       else if (deprecated_call_command_hook)
474         deprecated_call_command_hook (c, arg, from_tty);
475       else
476         cmd_func (c, arg, from_tty);
477
478       maybe_wait_sync_command_done (was_sync);
479
480       /* If this command has been post-hooked, run the hook last.  */
481       execute_cmd_post_hook (c);
482
483     }
484
485   check_frame_language_change ();
486
487   do_cleanups (cleanup);
488   discard_cleanups (cleanup_if_error);
489 }
490
491 /* Run execute_command for P and FROM_TTY.  Capture its output into the
492    returned string, do not display it to the screen.  BATCH_FLAG will be
493    temporarily set to true.  */
494
495 char *
496 execute_command_to_string (char *p, int from_tty)
497 {
498   struct ui_file *str_file;
499   struct cleanup *cleanup;
500   char *retval;
501
502   /* GDB_STDOUT should be better already restored during these
503      restoration callbacks.  */
504   cleanup = set_batch_flag_and_make_cleanup_restore_page_info ();
505
506   make_cleanup_restore_integer (&interpreter_async);
507   interpreter_async = 0;
508
509   str_file = mem_fileopen ();
510
511   make_cleanup_ui_file_delete (str_file);
512   make_cleanup_restore_ui_file (&gdb_stdout);
513   make_cleanup_restore_ui_file (&gdb_stderr);
514   make_cleanup_restore_ui_file (&gdb_stdlog);
515   make_cleanup_restore_ui_file (&gdb_stdtarg);
516   make_cleanup_restore_ui_file (&gdb_stdtargerr);
517
518   if (ui_out_redirect (current_uiout, str_file) < 0)
519     warning (_("Current output protocol does not support redirection"));
520   else
521     make_cleanup_ui_out_redirect_pop (current_uiout);
522
523   gdb_stdout = str_file;
524   gdb_stderr = str_file;
525   gdb_stdlog = str_file;
526   gdb_stdtarg = str_file;
527   gdb_stdtargerr = str_file;
528
529   execute_command (p, from_tty);
530
531   retval = ui_file_xstrdup (str_file, NULL);
532
533   do_cleanups (cleanup);
534
535   return retval;
536 }
537
538 /* Read commands from `instream' and execute them
539    until end of file or error reading instream.  */
540
541 void
542 command_loop (void)
543 {
544   struct cleanup *old_chain;
545   char *command;
546   int stdin_is_tty = ISATTY (stdin);
547
548   while (instream && !feof (instream))
549     {
550       if (window_hook && instream == stdin)
551         (*window_hook) (instream, get_prompt ());
552
553       clear_quit_flag ();
554       if (instream == stdin && stdin_is_tty)
555         reinitialize_more_filter ();
556       old_chain = make_cleanup (null_cleanup, 0);
557
558       /* Get a command-line.  This calls the readline package.  */
559       command = command_line_input (instream == stdin ?
560                                     get_prompt () : (char *) NULL,
561                                     instream == stdin, "prompt");
562       if (command == 0)
563         {
564           do_cleanups (old_chain);
565           return;
566         }
567
568       make_command_stats_cleanup (1);
569
570       /* Do not execute commented lines.  */
571       if (command[0] != '#')
572         {
573           execute_command (command, instream == stdin);
574
575           /* Do any commands attached to breakpoint we are stopped at.  */
576           bpstat_do_actions ();
577         }
578       do_cleanups (old_chain);
579     }
580 }
581 \f
582 /* When nonzero, cause dont_repeat to do nothing.  This should only be
583    set via prevent_dont_repeat.  */
584
585 static int suppress_dont_repeat = 0;
586
587 /* Commands call this if they do not want to be repeated by null lines.  */
588
589 void
590 dont_repeat (void)
591 {
592   if (suppress_dont_repeat || server_command)
593     return;
594
595   /* If we aren't reading from standard input, we are saving the last
596      thing read from stdin in line and don't want to delete it.  Null
597      lines won't repeat here in any case.  */
598   if (instream == stdin)
599     *saved_command_line = 0;
600 }
601
602 /* Prevent dont_repeat from working, and return a cleanup that
603    restores the previous state.  */
604
605 struct cleanup *
606 prevent_dont_repeat (void)
607 {
608   struct cleanup *result = make_cleanup_restore_integer (&suppress_dont_repeat);
609
610   suppress_dont_repeat = 1;
611   return result;
612 }
613
614 \f
615 /* Read a line from the stream "instream" without command line editing.
616
617    It prints PROMPT_ARG once at the start.
618    Action is compatible with "readline", e.g. space for the result is
619    malloc'd and should be freed by the caller.
620
621    A NULL return means end of file.  */
622 char *
623 gdb_readline (char *prompt_arg)
624 {
625   int c;
626   char *result;
627   int input_index = 0;
628   int result_size = 80;
629
630   if (prompt_arg)
631     {
632       /* Don't use a _filtered function here.  It causes the assumed
633          character position to be off, since the newline we read from
634          the user is not accounted for.  */
635       fputs_unfiltered (prompt_arg, gdb_stdout);
636       gdb_flush (gdb_stdout);
637     }
638
639   result = (char *) xmalloc (result_size);
640
641   while (1)
642     {
643       /* Read from stdin if we are executing a user defined command.
644          This is the right thing for prompt_for_continue, at least.  */
645       c = fgetc (instream ? instream : stdin);
646
647       if (c == EOF)
648         {
649           if (input_index > 0)
650             /* The last line does not end with a newline.  Return it, and
651                if we are called again fgetc will still return EOF and
652                we'll return NULL then.  */
653             break;
654           xfree (result);
655           return NULL;
656         }
657
658       if (c == '\n')
659         {
660           if (input_index > 0 && result[input_index - 1] == '\r')
661             input_index--;
662           break;
663         }
664
665       result[input_index++] = c;
666       while (input_index >= result_size)
667         {
668           result_size *= 2;
669           result = (char *) xrealloc (result, result_size);
670         }
671     }
672
673   result[input_index++] = '\0';
674   return result;
675 }
676
677 /* Variables which control command line editing and history
678    substitution.  These variables are given default values at the end
679    of this file.  */
680 static int command_editing_p;
681
682 /* NOTE 1999-04-29: This variable will be static again, once we modify
683    gdb to use the event loop as the default command loop and we merge
684    event-top.c into this file, top.c.  */
685
686 /* static */ int history_expansion_p;
687
688 static int write_history_p;
689 static void
690 show_write_history_p (struct ui_file *file, int from_tty,
691                       struct cmd_list_element *c, const char *value)
692 {
693   fprintf_filtered (file, _("Saving of the history record on exit is %s.\n"),
694                     value);
695 }
696
697 /* The variable associated with the "set/show history size"
698    command.  */
699 static unsigned int history_size_setshow_var;
700
701 static void
702 show_history_size (struct ui_file *file, int from_tty,
703                    struct cmd_list_element *c, const char *value)
704 {
705   fprintf_filtered (file, _("The size of the command history is %s.\n"),
706                     value);
707 }
708
709 static char *history_filename;
710 static void
711 show_history_filename (struct ui_file *file, int from_tty,
712                        struct cmd_list_element *c, const char *value)
713 {
714   fprintf_filtered (file, _("The filename in which to record "
715                             "the command history is \"%s\".\n"),
716                     value);
717 }
718
719 /* This is like readline(), but it has some gdb-specific behavior.
720    gdb may want readline in both the synchronous and async modes during
721    a single gdb invocation.  At the ordinary top-level prompt we might
722    be using the async readline.  That means we can't use
723    rl_pre_input_hook, since it doesn't work properly in async mode.
724    However, for a secondary prompt (" >", such as occurs during a
725    `define'), gdb wants a synchronous response.
726
727    We used to call readline() directly, running it in synchronous
728    mode.  But mixing modes this way is not supported, and as of
729    readline 5.x it no longer works; the arrow keys come unbound during
730    the synchronous call.  So we make a nested call into the event
731    loop.  That's what gdb_readline_wrapper is for.  */
732
733 /* A flag set as soon as gdb_readline_wrapper_line is called; we can't
734    rely on gdb_readline_wrapper_result, which might still be NULL if
735    the user types Control-D for EOF.  */
736 static int gdb_readline_wrapper_done;
737
738 /* The result of the current call to gdb_readline_wrapper, once a newline
739    is seen.  */
740 static char *gdb_readline_wrapper_result;
741
742 /* Any intercepted hook.  Operate-and-get-next sets this, expecting it
743    to be called after the newline is processed (which will redisplay
744    the prompt).  But in gdb_readline_wrapper we will not get a new
745    prompt until the next call, or until we return to the event loop.
746    So we disable this hook around the newline and restore it before we
747    return.  */
748 static void (*saved_after_char_processing_hook) (void);
749
750 /* This function is called when readline has seen a complete line of
751    text.  */
752
753 static void
754 gdb_readline_wrapper_line (char *line)
755 {
756   gdb_assert (!gdb_readline_wrapper_done);
757   gdb_readline_wrapper_result = line;
758   gdb_readline_wrapper_done = 1;
759
760   /* Prevent operate-and-get-next from acting too early.  */
761   saved_after_char_processing_hook = after_char_processing_hook;
762   after_char_processing_hook = NULL;
763
764   /* Prevent parts of the prompt from being redisplayed if annotations
765      are enabled, and readline's state getting out of sync.  We'll
766      reinstall the callback handler, which puts the terminal in raw
767      mode (or in readline lingo, in prepped state), when we're next
768      ready to process user input, either in display_gdb_prompt, or if
769      we're handling an asynchronous target event and running in the
770      background, just before returning to the event loop to process
771      further input (or more target events).  */
772   if (async_command_editing_p)
773     gdb_rl_callback_handler_remove ();
774 }
775
776 struct gdb_readline_wrapper_cleanup
777   {
778     void (*handler_orig) (char *);
779     int already_prompted_orig;
780
781     /* Whether the target was async.  */
782     int target_is_async_orig;
783   };
784
785 static void
786 gdb_readline_wrapper_cleanup (void *arg)
787 {
788   struct gdb_readline_wrapper_cleanup *cleanup = arg;
789
790   rl_already_prompted = cleanup->already_prompted_orig;
791
792   gdb_assert (input_handler == gdb_readline_wrapper_line);
793   input_handler = cleanup->handler_orig;
794
795   /* Don't restore our input handler in readline yet.  That would make
796      readline prep the terminal (putting it in raw mode), while the
797      line we just read may trigger execution of a command that expects
798      the terminal in the default cooked/canonical mode, such as e.g.,
799      running Python's interactive online help utility.  See
800      gdb_readline_wrapper_line for when we'll reinstall it.  */
801
802   gdb_readline_wrapper_result = NULL;
803   gdb_readline_wrapper_done = 0;
804
805   after_char_processing_hook = saved_after_char_processing_hook;
806   saved_after_char_processing_hook = NULL;
807
808   if (cleanup->target_is_async_orig)
809     target_async (inferior_event_handler, 0);
810
811   xfree (cleanup);
812 }
813
814 char *
815 gdb_readline_wrapper (char *prompt)
816 {
817   struct cleanup *back_to;
818   struct gdb_readline_wrapper_cleanup *cleanup;
819   char *retval;
820
821   cleanup = xmalloc (sizeof (*cleanup));
822   cleanup->handler_orig = input_handler;
823   input_handler = gdb_readline_wrapper_line;
824
825   cleanup->already_prompted_orig = rl_already_prompted;
826
827   cleanup->target_is_async_orig = target_is_async_p ();
828
829   back_to = make_cleanup (gdb_readline_wrapper_cleanup, cleanup);
830
831   if (cleanup->target_is_async_orig)
832     target_async (NULL, NULL);
833
834   /* Display our prompt and prevent double prompt display.  */
835   display_gdb_prompt (prompt);
836   rl_already_prompted = 1;
837
838   if (after_char_processing_hook)
839     (*after_char_processing_hook) ();
840   gdb_assert (after_char_processing_hook == NULL);
841
842   while (gdb_do_one_event () >= 0)
843     if (gdb_readline_wrapper_done)
844       break;
845
846   retval = gdb_readline_wrapper_result;
847   do_cleanups (back_to);
848   return retval;
849 }
850
851 \f
852 /* The current saved history number from operate-and-get-next.
853    This is -1 if not valid.  */
854 static int operate_saved_history = -1;
855
856 /* This is put on the appropriate hook and helps operate-and-get-next
857    do its work.  */
858 static void
859 gdb_rl_operate_and_get_next_completion (void)
860 {
861   int delta = where_history () - operate_saved_history;
862
863   /* The `key' argument to rl_get_previous_history is ignored.  */
864   rl_get_previous_history (delta, 0);
865   operate_saved_history = -1;
866
867   /* readline doesn't automatically update the display for us.  */
868   rl_redisplay ();
869
870   after_char_processing_hook = NULL;
871   rl_pre_input_hook = NULL;
872 }
873
874 /* This is a gdb-local readline command handler.  It accepts the
875    current command line (like RET does) and, if this command was taken
876    from the history, arranges for the next command in the history to
877    appear on the command line when the prompt returns.
878    We ignore the arguments.  */
879 static int
880 gdb_rl_operate_and_get_next (int count, int key)
881 {
882   int where;
883
884   /* Use the async hook.  */
885   after_char_processing_hook = gdb_rl_operate_and_get_next_completion;
886
887   /* Find the current line, and find the next line to use.  */
888   where = where_history();
889
890   if ((history_is_stifled () && (history_length >= history_max_entries))
891       || (where >= history_length - 1))
892     operate_saved_history = where;
893   else
894     operate_saved_history = where + 1;
895
896   return rl_newline (1, key);
897 }
898 \f
899 /* Read one line from the command input stream `instream'
900    into the local static buffer `linebuffer' (whose current length
901    is `linelength').
902    The buffer is made bigger as necessary.
903    Returns the address of the start of the line.
904
905    NULL is returned for end of file.
906
907    *If* the instream == stdin & stdin is a terminal, the line read
908    is copied into the file line saver (global var char *line,
909    length linesize) so that it can be duplicated.
910
911    This routine either uses fancy command line editing or
912    simple input as the user has requested.  */
913
914 char *
915 command_line_input (char *prompt_arg, int repeat, char *annotation_suffix)
916 {
917   static char *linebuffer = 0;
918   static unsigned linelength = 0;
919   char *p;
920   char *p1;
921   char *rl;
922   char *local_prompt = prompt_arg;
923   char *nline;
924   char got_eof = 0;
925
926   /* The annotation suffix must be non-NULL.  */
927   if (annotation_suffix == NULL)
928     annotation_suffix = "";
929
930   if (annotation_level > 1 && instream == stdin)
931     {
932       local_prompt = alloca ((prompt_arg == NULL ? 0 : strlen (prompt_arg))
933                              + strlen (annotation_suffix) + 40);
934       if (prompt_arg == NULL)
935         local_prompt[0] = '\0';
936       else
937         strcpy (local_prompt, prompt_arg);
938       strcat (local_prompt, "\n\032\032");
939       strcat (local_prompt, annotation_suffix);
940       strcat (local_prompt, "\n");
941     }
942
943   if (linebuffer == 0)
944     {
945       linelength = 80;
946       linebuffer = (char *) xmalloc (linelength);
947     }
948
949   p = linebuffer;
950
951   /* Control-C quits instantly if typed while in this loop
952      since it should not wait until the user types a newline.  */
953   immediate_quit++;
954   QUIT;
955 #ifdef STOP_SIGNAL
956   if (job_control)
957     signal (STOP_SIGNAL, handle_stop_sig);
958 #endif
959
960   while (1)
961     {
962       /* Make sure that all output has been output.  Some machines may
963          let you get away with leaving out some of the gdb_flush, but
964          not all.  */
965       wrap_here ("");
966       gdb_flush (gdb_stdout);
967       gdb_flush (gdb_stderr);
968
969       if (source_file_name != NULL)
970         ++source_line_number;
971
972       if (annotation_level > 1 && instream == stdin)
973         {
974           puts_unfiltered ("\n\032\032pre-");
975           puts_unfiltered (annotation_suffix);
976           puts_unfiltered ("\n");
977         }
978
979       /* Don't use fancy stuff if not talking to stdin.  */
980       if (deprecated_readline_hook && input_from_terminal_p ())
981         {
982           rl = (*deprecated_readline_hook) (local_prompt);
983         }
984       else if (command_editing_p && input_from_terminal_p ())
985         {
986           rl = gdb_readline_wrapper (local_prompt);
987         }
988       else
989         {
990           rl = gdb_readline (local_prompt);
991         }
992
993       if (annotation_level > 1 && instream == stdin)
994         {
995           puts_unfiltered ("\n\032\032post-");
996           puts_unfiltered (annotation_suffix);
997           puts_unfiltered ("\n");
998         }
999
1000       if (!rl || rl == (char *) EOF)
1001         {
1002           got_eof = 1;
1003           break;
1004         }
1005       if (strlen (rl) + 1 + (p - linebuffer) > linelength)
1006         {
1007           linelength = strlen (rl) + 1 + (p - linebuffer);
1008           nline = (char *) xrealloc (linebuffer, linelength);
1009           p += nline - linebuffer;
1010           linebuffer = nline;
1011         }
1012       p1 = rl;
1013       /* Copy line.  Don't copy null at end.  (Leaves line alone
1014          if this was just a newline).  */
1015       while (*p1)
1016         *p++ = *p1++;
1017
1018       xfree (rl);               /* Allocated in readline.  */
1019
1020       if (p == linebuffer || *(p - 1) != '\\')
1021         break;
1022
1023       p--;                      /* Put on top of '\'.  */
1024       local_prompt = (char *) 0;
1025     }
1026
1027 #ifdef STOP_SIGNAL
1028   if (job_control)
1029     signal (STOP_SIGNAL, SIG_DFL);
1030 #endif
1031   immediate_quit--;
1032
1033   if (got_eof)
1034     return NULL;
1035
1036 #define SERVER_COMMAND_LENGTH 7
1037   server_command =
1038     (p - linebuffer > SERVER_COMMAND_LENGTH)
1039     && strncmp (linebuffer, "server ", SERVER_COMMAND_LENGTH) == 0;
1040   if (server_command)
1041     {
1042       /* Note that we don't set `line'.  Between this and the check in
1043          dont_repeat, this insures that repeating will still do the
1044          right thing.  */
1045       *p = '\0';
1046       return linebuffer + SERVER_COMMAND_LENGTH;
1047     }
1048
1049   /* Do history expansion if that is wished.  */
1050   if (history_expansion_p && instream == stdin
1051       && ISATTY (instream))
1052     {
1053       char *history_value;
1054       int expanded;
1055
1056       *p = '\0';                /* Insert null now.  */
1057       expanded = history_expand (linebuffer, &history_value);
1058       if (expanded)
1059         {
1060           /* Print the changes.  */
1061           printf_unfiltered ("%s\n", history_value);
1062
1063           /* If there was an error, call this function again.  */
1064           if (expanded < 0)
1065             {
1066               xfree (history_value);
1067               return command_line_input (prompt_arg, repeat,
1068                                          annotation_suffix);
1069             }
1070           if (strlen (history_value) > linelength)
1071             {
1072               linelength = strlen (history_value) + 1;
1073               linebuffer = (char *) xrealloc (linebuffer, linelength);
1074             }
1075           strcpy (linebuffer, history_value);
1076           p = linebuffer + strlen (linebuffer);
1077         }
1078       xfree (history_value);
1079     }
1080
1081   /* If we just got an empty line, and that is supposed to repeat the
1082      previous command, return the value in the global buffer.  */
1083   if (repeat && p == linebuffer)
1084     return saved_command_line;
1085   for (p1 = linebuffer; *p1 == ' ' || *p1 == '\t'; p1++);
1086   if (repeat && !*p1)
1087     return saved_command_line;
1088
1089   *p = 0;
1090
1091   /* Add line to history if appropriate.  */
1092   if (*linebuffer && input_from_terminal_p ())
1093     add_history (linebuffer);
1094
1095   /* Save into global buffer if appropriate.  */
1096   if (repeat)
1097     {
1098       if (linelength > saved_command_line_size)
1099         {
1100           saved_command_line = xrealloc (saved_command_line, linelength);
1101           saved_command_line_size = linelength;
1102         }
1103       strcpy (saved_command_line, linebuffer);
1104       return saved_command_line;
1105     }
1106
1107   return linebuffer;
1108 }
1109 \f
1110 /* Print the GDB banner.  */
1111 void
1112 print_gdb_version (struct ui_file *stream)
1113 {
1114   /* From GNU coding standards, first line is meant to be easy for a
1115      program to parse, and is just canonical program name and version
1116      number, which starts after last space.  */
1117
1118   fprintf_filtered (stream, "GNU gdb %s%s\n", PKGVERSION, version);
1119
1120   /* Second line is a copyright notice.  */
1121
1122   fprintf_filtered (stream,
1123                     "Copyright (C) 2014 Free Software Foundation, Inc.\n");
1124
1125   /* Following the copyright is a brief statement that the program is
1126      free software, that users are free to copy and change it on
1127      certain conditions, that it is covered by the GNU GPL, and that
1128      there is no warranty.  */
1129
1130   fprintf_filtered (stream, "\
1131 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>\
1132 \nThis is free software: you are free to change and redistribute it.\n\
1133 There is NO WARRANTY, to the extent permitted by law.  Type \"show copying\"\n\
1134 and \"show warranty\" for details.\n");
1135
1136   /* After the required info we print the configuration information.  */
1137
1138   fprintf_filtered (stream, "This GDB was configured as \"");
1139   if (strcmp (host_name, target_name) != 0)
1140     {
1141       fprintf_filtered (stream, "--host=%s --target=%s",
1142                         host_name, target_name);
1143     }
1144   else
1145     {
1146       fprintf_filtered (stream, "%s", host_name);
1147     }
1148   fprintf_filtered (stream, "\".\n\
1149 Type \"show configuration\" for configuration details.");
1150
1151   if (REPORT_BUGS_TO[0])
1152     {
1153       fprintf_filtered (stream,
1154                         _("\nFor bug reporting instructions, please see:\n"));
1155       fprintf_filtered (stream, "%s.\n", REPORT_BUGS_TO);
1156     }
1157   fprintf_filtered (stream,
1158                     _("Find the GDB manual and other documentation \
1159 resources online at:\n<http://www.gnu.org/software/gdb/documentation/>.\n"));
1160   fprintf_filtered (stream, _("For help, type \"help\".\n"));
1161   fprintf_filtered (stream, _("Type \"apropos word\" to search for \
1162 commands related to \"word\"."));
1163 }
1164
1165 /* Print the details of GDB build-time configuration.  */
1166 void
1167 print_gdb_configuration (struct ui_file *stream)
1168 {
1169   fprintf_filtered (stream, _("\
1170 This GDB was configured as follows:\n\
1171    configure --host=%s --target=%s\n\
1172 "), host_name, target_name);
1173   fprintf_filtered (stream, _("\
1174              --with-auto-load-dir=%s\n\
1175              --with-auto-load-safe-path=%s\n\
1176 "), AUTO_LOAD_DIR, AUTO_LOAD_SAFE_PATH);
1177 #if HAVE_LIBEXPAT
1178   fprintf_filtered (stream, _("\
1179              --with-expat\n\
1180 "));
1181 #else
1182   fprintf_filtered (stream, _("\
1183              --without-expat\n\
1184 "));
1185 #endif
1186   if (GDB_DATADIR[0])
1187     fprintf_filtered (stream, _("\
1188              --with-gdb-datadir=%s%s\n\
1189 "), GDB_DATADIR, GDB_DATADIR_RELOCATABLE ? " (relocatable)" : "");
1190 #ifdef ICONV_BIN
1191   fprintf_filtered (stream, _("\
1192              --with-iconv-bin=%s%s\n\
1193 "), ICONV_BIN, ICONV_BIN_RELOCATABLE ? " (relocatable)" : "");
1194 #endif
1195   if (JIT_READER_DIR[0])
1196     fprintf_filtered (stream, _("\
1197              --with-jit-reader-dir=%s%s\n\
1198 "), JIT_READER_DIR, JIT_READER_DIR_RELOCATABLE ? " (relocatable)" : "");
1199 #if HAVE_LIBUNWIND_IA64_H
1200   fprintf_filtered (stream, _("\
1201              --with-libunwind-ia64\n\
1202 "));
1203 #else
1204   fprintf_filtered (stream, _("\
1205              --without-libunwind-ia64\n\
1206 "));
1207 #endif
1208 #if HAVE_LIBLZMA
1209   fprintf_filtered (stream, _("\
1210              --with-lzma\n\
1211 "));
1212 #else
1213   fprintf_filtered (stream, _("\
1214              --without-lzma\n\
1215 "));
1216 #endif
1217 #ifdef WITH_PYTHON_PATH
1218   fprintf_filtered (stream, _("\
1219              --with-python=%s%s\n\
1220 "), WITH_PYTHON_PATH, PYTHON_PATH_RELOCATABLE ? " (relocatable)" : "");
1221 #endif
1222 #if HAVE_GUILE
1223   fprintf_filtered (stream, _("\
1224              --with-guile\n\
1225 "));
1226 #else
1227   fprintf_filtered (stream, _("\
1228              --without-guile\n\
1229 "));
1230 #endif
1231 #ifdef RELOC_SRCDIR
1232   fprintf_filtered (stream, _("\
1233              --with-relocated-sources=%s\n\
1234 "), RELOC_SRCDIR);
1235 #endif
1236   if (DEBUGDIR[0])
1237     fprintf_filtered (stream, _("\
1238              --with-separate-debug-dir=%s%s\n\
1239 "), DEBUGDIR, DEBUGDIR_RELOCATABLE ? " (relocatable)" : "");
1240   if (TARGET_SYSTEM_ROOT[0])
1241     fprintf_filtered (stream, _("\
1242              --with-sysroot=%s%s\n\
1243 "), TARGET_SYSTEM_ROOT, TARGET_SYSTEM_ROOT_RELOCATABLE ? " (relocatable)" : "");
1244   if (SYSTEM_GDBINIT[0])
1245     fprintf_filtered (stream, _("\
1246              --with-system-gdbinit=%s%s\n\
1247 "), SYSTEM_GDBINIT, SYSTEM_GDBINIT_RELOCATABLE ? " (relocatable)" : "");
1248 #if HAVE_ZLIB_H
1249   fprintf_filtered (stream, _("\
1250              --with-zlib\n\
1251 "));
1252 #else
1253   fprintf_filtered (stream, _("\
1254              --without-zlib\n\
1255 "));
1256 #endif
1257 #if HAVE_LIBBABELTRACE
1258     fprintf_filtered (stream, _("\
1259              --with-babeltrace\n\
1260 "));
1261 #else
1262     fprintf_filtered (stream, _("\
1263              --without-babeltrace\n\
1264 "));
1265 #endif
1266     /* We assume "relocatable" will be printed at least once, thus we always
1267        print this text.  It's a reasonably safe assumption for now.  */
1268     fprintf_filtered (stream, _("\n\
1269 (\"Relocatable\" means the directory can be moved with the GDB installation\n\
1270 tree, and GDB will still find it.)\n\
1271 "));
1272 }
1273 \f
1274
1275 /* The current top level prompt, settable with "set prompt", and/or
1276    with the python `gdb.prompt_hook' hook.  */
1277 static char *top_prompt;
1278
1279 /* Access method for the GDB prompt string.  */
1280
1281 char *
1282 get_prompt (void)
1283 {
1284   return top_prompt;
1285 }
1286
1287 /* Set method for the GDB prompt string.  */
1288
1289 void
1290 set_prompt (const char *s)
1291 {
1292   char *p = xstrdup (s);
1293
1294   xfree (top_prompt);
1295   top_prompt = p;
1296 }
1297 \f
1298
1299 struct qt_args
1300 {
1301   char *args;
1302   int from_tty;
1303 };
1304
1305 /* Callback for iterate_over_inferiors.  Kills or detaches the given
1306    inferior, depending on how we originally gained control of it.  */
1307
1308 static int
1309 kill_or_detach (struct inferior *inf, void *args)
1310 {
1311   struct qt_args *qt = args;
1312   struct thread_info *thread;
1313
1314   if (inf->pid == 0)
1315     return 0;
1316
1317   thread = any_thread_of_process (inf->pid);
1318   if (thread != NULL)
1319     {
1320       switch_to_thread (thread->ptid);
1321
1322       /* Leave core files alone.  */
1323       if (target_has_execution)
1324         {
1325           if (inf->attach_flag)
1326             target_detach (qt->args, qt->from_tty);
1327           else
1328             target_kill ();
1329         }
1330     }
1331
1332   return 0;
1333 }
1334
1335 /* Callback for iterate_over_inferiors.  Prints info about what GDB
1336    will do to each inferior on a "quit".  ARG points to a struct
1337    ui_out where output is to be collected.  */
1338
1339 static int
1340 print_inferior_quit_action (struct inferior *inf, void *arg)
1341 {
1342   struct ui_file *stb = arg;
1343
1344   if (inf->pid == 0)
1345     return 0;
1346
1347   if (inf->attach_flag)
1348     fprintf_filtered (stb,
1349                       _("\tInferior %d [%s] will be detached.\n"), inf->num,
1350                       target_pid_to_str (pid_to_ptid (inf->pid)));
1351   else
1352     fprintf_filtered (stb,
1353                       _("\tInferior %d [%s] will be killed.\n"), inf->num,
1354                       target_pid_to_str (pid_to_ptid (inf->pid)));
1355
1356   return 0;
1357 }
1358
1359 /* If necessary, make the user confirm that we should quit.  Return
1360    non-zero if we should quit, zero if we shouldn't.  */
1361
1362 int
1363 quit_confirm (void)
1364 {
1365   struct ui_file *stb;
1366   struct cleanup *old_chain;
1367   char *str;
1368   int qr;
1369
1370   /* Don't even ask if we're only debugging a core file inferior.  */
1371   if (!have_live_inferiors ())
1372     return 1;
1373
1374   /* Build the query string as a single string.  */
1375   stb = mem_fileopen ();
1376   old_chain = make_cleanup_ui_file_delete (stb);
1377
1378   fprintf_filtered (stb, _("A debugging session is active.\n\n"));
1379   iterate_over_inferiors (print_inferior_quit_action, stb);
1380   fprintf_filtered (stb, _("\nQuit anyway? "));
1381
1382   str = ui_file_xstrdup (stb, NULL);
1383   make_cleanup (xfree, str);
1384
1385   qr = query ("%s", str);
1386   do_cleanups (old_chain);
1387   return qr;
1388 }
1389
1390 /* Quit without asking for confirmation.  */
1391
1392 void
1393 quit_force (char *args, int from_tty)
1394 {
1395   int exit_code = 0;
1396   struct qt_args qt;
1397   volatile struct gdb_exception ex;
1398
1399   /* An optional expression may be used to cause gdb to terminate with the 
1400      value of that expression.  */
1401   if (args)
1402     {
1403       struct value *val = parse_and_eval (args);
1404
1405       exit_code = (int) value_as_long (val);
1406     }
1407   else if (return_child_result)
1408     exit_code = return_child_result_value;
1409
1410   qt.args = args;
1411   qt.from_tty = from_tty;
1412
1413   /* Wrappers to make the code below a bit more readable.  */
1414 #define DO_TRY \
1415   TRY_CATCH (ex, RETURN_MASK_ALL)
1416
1417 #define DO_PRINT_EX \
1418   if (ex.reason < 0) \
1419     exception_print (gdb_stderr, ex)
1420
1421   /* We want to handle any quit errors and exit regardless.  */
1422
1423   /* Get out of tfind mode, and kill or detach all inferiors.  */
1424   DO_TRY
1425     {
1426       disconnect_tracing ();
1427       iterate_over_inferiors (kill_or_detach, &qt);
1428     }
1429   DO_PRINT_EX;
1430
1431   /* Give all pushed targets a chance to do minimal cleanup, and pop
1432      them all out.  */
1433   DO_TRY
1434     {
1435       pop_all_targets ();
1436     }
1437   DO_PRINT_EX;
1438
1439   /* Save the history information if it is appropriate to do so.  */
1440   DO_TRY
1441     {
1442       if (write_history_p && history_filename
1443           && input_from_terminal_p ())
1444         write_history (history_filename);
1445     }
1446   DO_PRINT_EX;
1447
1448   /* Do any final cleanups before exiting.  */
1449   DO_TRY
1450     {
1451       do_final_cleanups (all_cleanups ());
1452     }
1453   DO_PRINT_EX;
1454
1455   exit (exit_code);
1456 }
1457
1458 /* Returns whether GDB is running on a terminal and input is
1459    currently coming from that terminal.  */
1460
1461 int
1462 input_from_terminal_p (void)
1463 {
1464   if (batch_flag)
1465     return 0;
1466
1467   if (gdb_has_a_terminal () && instream == stdin)
1468     return 1;
1469
1470   /* If INSTREAM is unset, and we are not in a user command, we
1471      must be in Insight.  That's like having a terminal, for our
1472      purposes.  */
1473   if (instream == NULL && !in_user_command)
1474     return 1;
1475
1476   return 0;
1477 }
1478 \f
1479 static void
1480 dont_repeat_command (char *ignored, int from_tty)
1481 {
1482   /* Can't call dont_repeat here because we're not necessarily reading
1483      from stdin.  */
1484   *saved_command_line = 0;
1485 }
1486 \f
1487 /* Functions to manipulate command line editing control variables.  */
1488
1489 /* Number of commands to print in each call to show_commands.  */
1490 #define Hist_print 10
1491 void
1492 show_commands (char *args, int from_tty)
1493 {
1494   /* Index for history commands.  Relative to history_base.  */
1495   int offset;
1496
1497   /* Number of the history entry which we are planning to display next.
1498      Relative to history_base.  */
1499   static int num = 0;
1500
1501   /* Print out some of the commands from the command history.  */
1502
1503   if (args)
1504     {
1505       if (args[0] == '+' && args[1] == '\0')
1506         /* "info editing +" should print from the stored position.  */
1507         ;
1508       else
1509         /* "info editing <exp>" should print around command number <exp>.  */
1510         num = (parse_and_eval_long (args) - history_base) - Hist_print / 2;
1511     }
1512   /* "show commands" means print the last Hist_print commands.  */
1513   else
1514     {
1515       num = history_length - Hist_print;
1516     }
1517
1518   if (num < 0)
1519     num = 0;
1520
1521   /* If there are at least Hist_print commands, we want to display the last
1522      Hist_print rather than, say, the last 6.  */
1523   if (history_length - num < Hist_print)
1524     {
1525       num = history_length - Hist_print;
1526       if (num < 0)
1527         num = 0;
1528     }
1529
1530   for (offset = num;
1531        offset < num + Hist_print && offset < history_length;
1532        offset++)
1533     {
1534       printf_filtered ("%5d  %s\n", history_base + offset,
1535                        (history_get (history_base + offset))->line);
1536     }
1537
1538   /* The next command we want to display is the next one that we haven't
1539      displayed yet.  */
1540   num += Hist_print;
1541
1542   /* If the user repeats this command with return, it should do what
1543      "show commands +" does.  This is unnecessary if arg is null,
1544      because "show commands +" is not useful after "show commands".  */
1545   if (from_tty && args)
1546     {
1547       args[0] = '+';
1548       args[1] = '\0';
1549     }
1550 }
1551
1552 /* Called by do_setshow_command.  */
1553 static void
1554 set_history_size_command (char *args, int from_tty, struct cmd_list_element *c)
1555 {
1556   /* Readline's history interface works with 'int', so it can only
1557      handle history sizes up to INT_MAX.  The command itself is
1558      uinteger, so UINT_MAX means "unlimited", but we only get that if
1559      the user does "set history size 0" -- "set history size <UINT_MAX>"
1560      throws out-of-range.  */
1561   if (history_size_setshow_var > INT_MAX
1562       && history_size_setshow_var != UINT_MAX)
1563     {
1564       unsigned int new_value = history_size_setshow_var;
1565
1566       /* Restore previous value before throwing.  */
1567       if (history_is_stifled ())
1568         history_size_setshow_var = history_max_entries;
1569       else
1570         history_size_setshow_var = UINT_MAX;
1571
1572       error (_("integer %u out of range"), new_value);
1573     }
1574
1575   /* Commit the new value to readline's history.  */
1576   if (history_size_setshow_var == UINT_MAX)
1577     unstifle_history ();
1578   else
1579     stifle_history (history_size_setshow_var);
1580 }
1581
1582 void
1583 set_history (char *args, int from_tty)
1584 {
1585   printf_unfiltered (_("\"set history\" must be followed "
1586                        "by the name of a history subcommand.\n"));
1587   help_list (sethistlist, "set history ", all_commands, gdb_stdout);
1588 }
1589
1590 void
1591 show_history (char *args, int from_tty)
1592 {
1593   cmd_show_list (showhistlist, from_tty, "");
1594 }
1595
1596 int info_verbose = 0;           /* Default verbose msgs off.  */
1597
1598 /* Called by do_setshow_command.  An elaborate joke.  */
1599 void
1600 set_verbose (char *args, int from_tty, struct cmd_list_element *c)
1601 {
1602   const char *cmdname = "verbose";
1603   struct cmd_list_element *showcmd;
1604
1605   showcmd = lookup_cmd_1 (&cmdname, showlist, NULL, 1);
1606   gdb_assert (showcmd != NULL && showcmd != CMD_LIST_AMBIGUOUS);
1607
1608   if (info_verbose)
1609     {
1610       c->doc = "Set verbose printing of informational messages.";
1611       showcmd->doc = "Show verbose printing of informational messages.";
1612     }
1613   else
1614     {
1615       c->doc = "Set verbosity.";
1616       showcmd->doc = "Show verbosity.";
1617     }
1618 }
1619
1620 /* Init the history buffer.  Note that we are called after the init file(s)
1621    have been read so that the user can change the history file via his
1622    .gdbinit file (for instance).  The GDBHISTFILE environment variable
1623    overrides all of this.  */
1624
1625 void
1626 init_history (void)
1627 {
1628   char *tmpenv;
1629
1630   tmpenv = getenv ("HISTSIZE");
1631   if (tmpenv)
1632     {
1633       int var;
1634
1635       var = atoi (tmpenv);
1636       if (var < 0)
1637         {
1638           /* Prefer ending up with no history rather than overflowing
1639              readline's history interface, which uses signed 'int'
1640              everywhere.  */
1641           var = 0;
1642         }
1643
1644       history_size_setshow_var = var;
1645     }
1646   /* If the init file hasn't set a size yet, pick the default.  */
1647   else if (history_size_setshow_var == 0)
1648     history_size_setshow_var = 256;
1649
1650   /* Note that unlike "set history size 0", "HISTSIZE=0" really sets
1651      the history size to 0...  */
1652   stifle_history (history_size_setshow_var);
1653
1654   tmpenv = getenv ("GDBHISTFILE");
1655   if (tmpenv)
1656     history_filename = xstrdup (tmpenv);
1657   else if (!history_filename)
1658     {
1659       /* We include the current directory so that if the user changes
1660          directories the file written will be the same as the one
1661          that was read.  */
1662 #ifdef __MSDOS__
1663       /* No leading dots in file names are allowed on MSDOS.  */
1664       history_filename = concat (current_directory, "/_gdb_history",
1665                                  (char *)NULL);
1666 #else
1667       history_filename = concat (current_directory, "/.gdb_history",
1668                                  (char *)NULL);
1669 #endif
1670     }
1671   read_history (history_filename);
1672 }
1673
1674 static void
1675 show_prompt (struct ui_file *file, int from_tty,
1676              struct cmd_list_element *c, const char *value)
1677 {
1678   fprintf_filtered (file, _("Gdb's prompt is \"%s\".\n"), value);
1679 }
1680
1681 static void
1682 show_async_command_editing_p (struct ui_file *file, int from_tty,
1683                               struct cmd_list_element *c, const char *value)
1684 {
1685   fprintf_filtered (file, _("Editing of command lines as "
1686                             "they are typed is %s.\n"),
1687                     value);
1688 }
1689
1690 static void
1691 show_annotation_level (struct ui_file *file, int from_tty,
1692                        struct cmd_list_element *c, const char *value)
1693 {
1694   fprintf_filtered (file, _("Annotation_level is %s.\n"), value);
1695 }
1696
1697 static void
1698 show_exec_done_display_p (struct ui_file *file, int from_tty,
1699                           struct cmd_list_element *c, const char *value)
1700 {
1701   fprintf_filtered (file, _("Notification of completion for "
1702                             "asynchronous execution commands is %s.\n"),
1703                     value);
1704 }
1705
1706 /* New values of the "data-directory" parameter are staged here.  */
1707 static char *staged_gdb_datadir;
1708
1709 /* "set" command for the gdb_datadir configuration variable.  */
1710
1711 static void
1712 set_gdb_datadir (char *args, int from_tty, struct cmd_list_element *c)
1713 {
1714   set_gdb_data_directory (staged_gdb_datadir);
1715   observer_notify_gdb_datadir_changed ();
1716 }
1717
1718 /* "show" command for the gdb_datadir configuration variable.  */
1719
1720 static void
1721 show_gdb_datadir (struct ui_file *file, int from_tty,
1722                   struct cmd_list_element *c, const char *value)
1723 {
1724   fprintf_filtered (file, _("GDB's data directory is \"%s\".\n"),
1725                     gdb_datadir);
1726 }
1727
1728 static void
1729 set_history_filename (char *args, int from_tty, struct cmd_list_element *c)
1730 {
1731   /* We include the current directory so that if the user changes
1732      directories the file written will be the same as the one
1733      that was read.  */
1734   if (!IS_ABSOLUTE_PATH (history_filename))
1735     history_filename = reconcat (history_filename, current_directory, "/", 
1736                                  history_filename, (char *) NULL);
1737 }
1738
1739 static void
1740 init_main (void)
1741 {
1742   /* Initialize the prompt to a simple "(gdb) " prompt or to whatever
1743      the DEFAULT_PROMPT is.  */
1744   set_prompt (DEFAULT_PROMPT);
1745
1746   /* Set things up for annotation_level > 1, if the user ever decides
1747      to use it.  */
1748   async_annotation_suffix = "prompt";
1749
1750   /* Set the important stuff up for command editing.  */
1751   command_editing_p = 1;
1752   history_expansion_p = 0;
1753   write_history_p = 0;
1754
1755   /* Setup important stuff for command line editing.  */
1756   rl_completion_word_break_hook = gdb_completion_word_break_characters;
1757   rl_completion_entry_function = readline_line_completion_function;
1758   rl_completer_word_break_characters = default_word_break_characters ();
1759   rl_completer_quote_characters = get_gdb_completer_quote_characters ();
1760   rl_readline_name = "gdb";
1761   rl_terminal_name = getenv ("TERM");
1762
1763   /* The name for this defun comes from Bash, where it originated.
1764      15 is Control-o, the same binding this function has in Bash.  */
1765   rl_add_defun ("operate-and-get-next", gdb_rl_operate_and_get_next, 15);
1766
1767   add_setshow_string_cmd ("prompt", class_support,
1768                           &top_prompt,
1769                           _("Set gdb's prompt"),
1770                           _("Show gdb's prompt"),
1771                           NULL, NULL,
1772                           show_prompt,
1773                           &setlist, &showlist);
1774
1775   add_com ("dont-repeat", class_support, dont_repeat_command, _("\
1776 Don't repeat this command.\nPrimarily \
1777 used inside of user-defined commands that should not be repeated when\n\
1778 hitting return."));
1779
1780   add_setshow_boolean_cmd ("editing", class_support,
1781                            &async_command_editing_p, _("\
1782 Set editing of command lines as they are typed."), _("\
1783 Show editing of command lines as they are typed."), _("\
1784 Use \"on\" to enable the editing, and \"off\" to disable it.\n\
1785 Without an argument, command line editing is enabled.  To edit, use\n\
1786 EMACS-like or VI-like commands like control-P or ESC."),
1787                            set_async_editing_command,
1788                            show_async_command_editing_p,
1789                            &setlist, &showlist);
1790
1791   add_setshow_boolean_cmd ("save", no_class, &write_history_p, _("\
1792 Set saving of the history record on exit."), _("\
1793 Show saving of the history record on exit."), _("\
1794 Use \"on\" to enable the saving, and \"off\" to disable it.\n\
1795 Without an argument, saving is enabled."),
1796                            NULL,
1797                            show_write_history_p,
1798                            &sethistlist, &showhistlist);
1799
1800   add_setshow_uinteger_cmd ("size", no_class, &history_size_setshow_var, _("\
1801 Set the size of the command history,"), _("\
1802 Show the size of the command history,"), _("\
1803 ie. the number of previous commands to keep a record of.\n\
1804 If set to \"unlimited\", the number of commands kept in the history\n\
1805 list is unlimited.  This defaults to the value of the environment\n\
1806 variable \"HISTSIZE\", or to 256 if this variable is not set."),
1807                             set_history_size_command,
1808                             show_history_size,
1809                             &sethistlist, &showhistlist);
1810
1811   add_setshow_filename_cmd ("filename", no_class, &history_filename, _("\
1812 Set the filename in which to record the command history"), _("\
1813 Show the filename in which to record the command history"), _("\
1814 (the list of previous commands of which a record is kept)."),
1815                             set_history_filename,
1816                             show_history_filename,
1817                             &sethistlist, &showhistlist);
1818
1819   add_setshow_boolean_cmd ("confirm", class_support, &confirm, _("\
1820 Set whether to confirm potentially dangerous operations."), _("\
1821 Show whether to confirm potentially dangerous operations."), NULL,
1822                            NULL,
1823                            show_confirm,
1824                            &setlist, &showlist);
1825
1826   add_setshow_zinteger_cmd ("annotate", class_obscure, &annotation_level, _("\
1827 Set annotation_level."), _("\
1828 Show annotation_level."), _("\
1829 0 == normal;     1 == fullname (for use when running under emacs)\n\
1830 2 == output annotated suitably for use by programs that control GDB."),
1831                             NULL,
1832                             show_annotation_level,
1833                             &setlist, &showlist);
1834
1835   add_setshow_boolean_cmd ("exec-done-display", class_support,
1836                            &exec_done_display_p, _("\
1837 Set notification of completion for asynchronous execution commands."), _("\
1838 Show notification of completion for asynchronous execution commands."), _("\
1839 Use \"on\" to enable the notification, and \"off\" to disable it."),
1840                            NULL,
1841                            show_exec_done_display_p,
1842                            &setlist, &showlist);
1843
1844   add_setshow_filename_cmd ("data-directory", class_maintenance,
1845                            &staged_gdb_datadir, _("Set GDB's data directory."),
1846                            _("Show GDB's data directory."),
1847                            _("\
1848 When set, GDB uses the specified path to search for data files."),
1849                            set_gdb_datadir, show_gdb_datadir,
1850                            &setlist,
1851                            &showlist);
1852 }
1853
1854 void
1855 gdb_init (char *argv0)
1856 {
1857   if (pre_init_ui_hook)
1858     pre_init_ui_hook ();
1859
1860   /* Run the init function of each source file.  */
1861
1862 #ifdef __MSDOS__
1863   /* Make sure we return to the original directory upon exit, come
1864      what may, since the OS doesn't do that for us.  */
1865   make_final_cleanup (do_chdir_cleanup, xstrdup (current_directory));
1866 #endif
1867
1868   init_cmd_lists ();        /* This needs to be done first.  */
1869   initialize_targets ();    /* Setup target_terminal macros for utils.c.  */
1870   initialize_utils ();      /* Make errors and warnings possible.  */
1871
1872   /* Here is where we call all the _initialize_foo routines.  */
1873   initialize_all_files ();
1874
1875   /* This creates the current_program_space.  Do this after all the
1876      _initialize_foo routines have had a chance to install their
1877      per-sspace data keys.  Also do this before
1878      initialize_current_architecture is called, because it accesses
1879      exec_bfd of the current program space.  */
1880   initialize_progspace ();
1881   initialize_inferiors ();
1882   initialize_current_architecture ();
1883   init_cli_cmds();
1884   initialize_event_loop ();
1885   init_main ();                 /* But that omits this file!  Do it now.  */
1886
1887   initialize_stdin_serial ();
1888
1889   async_init_signals ();
1890
1891   /* We need a default language for parsing expressions, so simple
1892      things like "set width 0" won't fail if no language is explicitly
1893      set in a config file or implicitly set by reading an executable
1894      during startup.  */
1895   set_language (language_c);
1896   expected_language = current_language; /* Don't warn about the change.  */
1897
1898   /* Allow another UI to initialize.  If the UI fails to initialize,
1899      and it wants GDB to revert to the CLI, it should clear
1900      deprecated_init_ui_hook.  */
1901   if (deprecated_init_ui_hook)
1902     deprecated_init_ui_hook (argv0);
1903
1904   /* Python initialization, for example, can require various commands to be
1905      installed.  For example "info pretty-printer" needs the "info"
1906      prefix to be installed.  Keep things simple and just do final
1907      script initialization here.  */
1908   finish_ext_lang_initialization ();
1909 }