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