2003-11-06 Andrew Cagney <cagney@redhat.com>
[external/binutils.git] / gdb / top.c
1 /* Top level stuff for GDB, the GNU debugger.
2
3    Copyright 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994,
4    1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
5    Free Software Foundation, Inc.
6
7    This file is part of GDB.
8
9    This program is free software; you can redistribute it and/or modify
10    it under the terms of the GNU General Public License as published by
11    the Free Software Foundation; either version 2 of the License, or
12    (at your option) any later version.
13
14    This program is distributed in the hope that it will be useful,
15    but WITHOUT ANY WARRANTY; without even the implied warranty of
16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17    GNU General Public License for more details.
18
19    You should have received a copy of the GNU General Public License
20    along with this program; if not, write to the Free Software
21    Foundation, Inc., 59 Temple Place - Suite 330,
22    Boston, MA 02111-1307, USA.  */
23
24 #include "defs.h"
25 #include "gdbcmd.h"
26 #include "call-cmds.h"
27 #include "cli/cli-cmds.h"
28 #include "cli/cli-script.h"
29 #include "cli/cli-setshow.h"
30 #include "cli/cli-decode.h"
31 #include "symtab.h"
32 #include "inferior.h"
33 #include <signal.h>
34 #include "target.h"
35 #include "breakpoint.h"
36 #include "gdbtypes.h"
37 #include "expression.h"
38 #include "value.h"
39 #include "language.h"
40 #include "terminal.h"           /* For job_control.  */
41 #include "annotate.h"
42 #include "completer.h"
43 #include "top.h"
44 #include "version.h"
45 #include "serial.h"
46 #include "doublest.h"
47 #include "gdb_assert.h"
48
49 /* readline include files */
50 #include <readline/readline.h>
51 #include <readline/history.h>
52
53 /* readline defines this.  */
54 #undef savestring
55
56 #include <sys/types.h>
57
58 #include <setjmp.h>
59
60 #include "event-top.h"
61 #include "gdb_string.h"
62 #include "gdb_stat.h"
63 #include <ctype.h>
64 #include "ui-out.h"
65 #include "cli-out.h"
66
67 /* Default command line prompt.  This is overriden in some configs. */
68
69 #ifndef DEFAULT_PROMPT
70 #define DEFAULT_PROMPT  "(gdb) "
71 #endif
72
73 /* Initialization file name for gdb.  This is overridden in some configs.  */
74
75 #ifndef GDBINIT_FILENAME
76 #define GDBINIT_FILENAME        ".gdbinit"
77 #endif
78 char gdbinit[] = GDBINIT_FILENAME;
79
80 int inhibit_gdbinit = 0;
81
82 /* If nonzero, and GDB has been configured to be able to use windows,
83    attempt to open them upon startup.  */
84
85 int use_windows = 0;
86
87 extern char lang_frame_mismatch_warn[];         /* language.c */
88
89 /* Flag for whether we want all the "from_tty" gubbish printed.  */
90
91 int caution = 1;                /* Default is yes, sigh. */
92
93 /* stdio stream that command input is being read from.  Set to stdin normally.
94    Set by source_command to the file we are sourcing.  Set to NULL if we are
95    executing a user-defined command or interacting via a GUI.  */
96
97 FILE *instream;
98
99 /* Current working directory.  */
100
101 char *current_directory;
102
103 /* The directory name is actually stored here (usually).  */
104 char gdb_dirbuf[1024];
105
106 /* Function to call before reading a command, if nonzero.
107    The function receives two args: an input stream,
108    and a prompt string.  */
109
110 void (*window_hook) (FILE *, char *);
111
112 int epoch_interface;
113 int xgdb_verbose;
114
115 /* gdb prints this when reading a command interactively */
116 static char *gdb_prompt_string; /* the global prompt string */
117
118 /* Buffer used for reading command lines, and the size
119    allocated for it so far.  */
120
121 char *line;
122 int linesize = 100;
123
124 /* Nonzero if the current command is modified by "server ".  This
125    affects things like recording into the command history, commands
126    repeating on RETURN, etc.  This is so a user interface (emacs, GUI,
127    whatever) can issue its own commands and also send along commands
128    from the user, and have the user not notice that the user interface
129    is issuing commands too.  */
130 int server_command;
131
132 /* Baud rate specified for talking to serial target systems.  Default
133    is left as -1, so targets can choose their own defaults.  */
134 /* FIXME: This means that "show remotebaud" and gr_files_info can print -1
135    or (unsigned int)-1.  This is a Bad User Interface.  */
136
137 int baud_rate = -1;
138
139 /* Timeout limit for response from target. */
140
141 /* The default value has been changed many times over the years.  It 
142    was originally 5 seconds.  But that was thought to be a long time 
143    to sit and wait, so it was changed to 2 seconds.  That was thought
144    to be plenty unless the connection was going through some terminal 
145    server or multiplexer or other form of hairy serial connection.
146
147    In mid-1996, remote_timeout was moved from remote.c to top.c and 
148    it began being used in other remote-* targets.  It appears that the
149    default was changed to 20 seconds at that time, perhaps because the
150    Renesas E7000 ICE didn't always respond in a timely manner.
151
152    But if 5 seconds is a long time to sit and wait for retransmissions,
153    20 seconds is far worse.  This demonstrates the difficulty of using 
154    a single variable for all protocol timeouts.
155
156    As remote.c is used much more than remote-e7000.c, it was changed 
157    back to 2 seconds in 1999. */
158
159 int remote_timeout = 2;
160
161 /* Non-zero tells remote* modules to output debugging info.  */
162
163 int remote_debug = 0;
164
165 /* Non-zero means the target is running. Note: this is different from
166    saying that there is an active target and we are stopped at a
167    breakpoint, for instance. This is a real indicator whether the
168    target is off and running, which gdb is doing something else. */
169 int target_executing = 0;
170
171 /* Level of control structure.  */
172 static int control_level;
173
174 /* Sbrk location on entry to main.  Used for statistics only.  */
175 #ifdef HAVE_SBRK
176 char *lim_at_start;
177 #endif
178
179 /* Signal to catch ^Z typed while reading a command: SIGTSTP or SIGCONT.  */
180
181 #ifndef STOP_SIGNAL
182 #ifdef SIGTSTP
183 #define STOP_SIGNAL SIGTSTP
184 static void stop_sig (int);
185 #endif
186 #endif
187
188 /* Hooks for alternate command interfaces.  */
189
190 /* Called after most modules have been initialized, but before taking users
191    command file.
192
193    If the UI fails to initialize and it wants GDB to continue
194    using the default UI, then it should clear this hook before returning. */
195
196 void (*init_ui_hook) (char *argv0);
197
198 /* This hook is called from within gdb's many mini-event loops which could
199    steal control from a real user interface's event loop. It returns
200    non-zero if the user is requesting a detach, zero otherwise. */
201
202 int (*ui_loop_hook) (int);
203
204 /* Called instead of command_loop at top level.  Can be invoked via
205    throw_exception().  */
206
207 void (*command_loop_hook) (void);
208
209
210 /* Called from print_frame_info to list the line we stopped in.  */
211
212 void (*print_frame_info_listing_hook) (struct symtab * s, int line,
213                                        int stopline, int noerror);
214 /* Replaces most of query.  */
215
216 int (*query_hook) (const char *, va_list);
217
218 /* Replaces most of warning.  */
219
220 void (*warning_hook) (const char *, va_list);
221
222 /* These three functions support getting lines of text from the user.  They
223    are used in sequence.  First readline_begin_hook is called with a text
224    string that might be (for example) a message for the user to type in a
225    sequence of commands to be executed at a breakpoint.  If this function
226    calls back to a GUI, it might take this opportunity to pop up a text
227    interaction window with this message.  Next, readline_hook is called
228    with a prompt that is emitted prior to collecting the user input.
229    It can be called multiple times.  Finally, readline_end_hook is called
230    to notify the GUI that we are done with the interaction window and it
231    can close it. */
232
233 void (*readline_begin_hook) (char *, ...);
234 char *(*readline_hook) (char *);
235 void (*readline_end_hook) (void);
236
237 /* Called as appropriate to notify the interface of the specified breakpoint
238    conditions.  */
239
240 void (*create_breakpoint_hook) (struct breakpoint * bpt);
241 void (*delete_breakpoint_hook) (struct breakpoint * bpt);
242 void (*modify_breakpoint_hook) (struct breakpoint * bpt);
243
244 /* Called as appropriate to notify the interface that we have attached
245    to or detached from an already running process. */
246
247 void (*attach_hook) (void);
248 void (*detach_hook) (void);
249
250 /* Called during long calculations to allow GUI to repair window damage, and to
251    check for stop buttons, etc... */
252
253 void (*interactive_hook) (void);
254
255 /* Called when the registers have changed, as a hint to a GUI
256    to minimize window update. */
257
258 void (*registers_changed_hook) (void);
259
260 /* Tell the GUI someone changed the register REGNO. -1 means
261    that the caller does not know which register changed or
262    that several registers have changed (see value_assign). */
263 void (*register_changed_hook) (int regno);
264
265 /* Tell the GUI someone changed LEN bytes of memory at ADDR */
266 void (*memory_changed_hook) (CORE_ADDR addr, int len);
267
268 /* Called when going to wait for the target.  Usually allows the GUI to run
269    while waiting for target events.  */
270
271 ptid_t (*target_wait_hook) (ptid_t ptid,
272                             struct target_waitstatus * status);
273
274 /* Used by UI as a wrapper around command execution.  May do various things
275    like enabling/disabling buttons, etc...  */
276
277 void (*call_command_hook) (struct cmd_list_element * c, char *cmd,
278                            int from_tty);
279
280 /* Called after a `set' command has finished.  Is only run if the
281    `set' command succeeded.  */
282
283 void (*set_hook) (struct cmd_list_element * c);
284
285 /* Called when the current thread changes.  Argument is thread id.  */
286
287 void (*context_hook) (int id);
288
289 /* Takes control from error ().  Typically used to prevent longjmps out of the
290    middle of the GUI.  Usually used in conjunction with a catch routine.  */
291
292 NORETURN void (*error_hook) (void) ATTR_NORETURN;
293 \f
294
295 /* One should use catch_errors rather than manipulating these
296    directly.  */
297 #if defined(HAVE_SIGSETJMP)
298 #define SIGJMP_BUF              sigjmp_buf
299 #define SIGSETJMP(buf)          sigsetjmp((buf), 1)
300 #define SIGLONGJMP(buf,val)     siglongjmp((buf), (val))
301 #else
302 #define SIGJMP_BUF              jmp_buf
303 #define SIGSETJMP(buf)          setjmp(buf)
304 #define SIGLONGJMP(buf,val)     longjmp((buf), (val))
305 #endif
306
307 /* Where to go for throw_exception().  */
308 static SIGJMP_BUF *catch_return;
309
310 /* Return for reason REASON to the nearest containing catch_errors().  */
311
312 NORETURN void
313 throw_exception (enum return_reason reason)
314 {
315   quit_flag = 0;
316   immediate_quit = 0;
317
318   /* Perhaps it would be cleaner to do this via the cleanup chain (not sure
319      I can think of a reason why that is vital, though).  */
320   bpstat_clear_actions (stop_bpstat);   /* Clear queued breakpoint commands */
321
322   disable_current_display ();
323   do_cleanups (ALL_CLEANUPS);
324   if (event_loop_p && target_can_async_p () && !target_executing)
325     do_exec_cleanups (ALL_CLEANUPS);
326   if (event_loop_p && sync_execution)
327     do_exec_error_cleanups (ALL_CLEANUPS);
328
329   if (annotation_level > 1)
330     switch (reason)
331       {
332       case RETURN_QUIT:
333         annotate_quit ();
334         break;
335       case RETURN_ERROR:
336         annotate_error ();
337         break;
338       }
339
340   /* Jump to the containing catch_errors() call, communicating REASON
341      to that call via setjmp's return value.  Note that REASON can't
342      be zero, by definition in defs.h. */
343
344   (NORETURN void) SIGLONGJMP (*catch_return, (int) reason);
345 }
346
347 /* Call FUNC() with args FUNC_UIOUT and FUNC_ARGS, catching any
348    errors.  Set FUNC_CAUGHT to an ``enum return_reason'' if the
349    function is aborted (using throw_exception() or zero if the
350    function returns normally.  Set FUNC_VAL to the value returned by
351    the function or 0 if the function was aborted.
352
353    Must not be called with immediate_quit in effect (bad things might
354    happen, say we got a signal in the middle of a memcpy to quit_return).
355    This is an OK restriction; with very few exceptions immediate_quit can
356    be replaced by judicious use of QUIT.
357
358    MASK specifies what to catch; it is normally set to
359    RETURN_MASK_ALL, if for no other reason than that the code which
360    calls catch_errors might not be set up to deal with a quit which
361    isn't caught.  But if the code can deal with it, it generally
362    should be RETURN_MASK_ERROR, unless for some reason it is more
363    useful to abort only the portion of the operation inside the
364    catch_errors.  Note that quit should return to the command line
365    fairly quickly, even if some further processing is being done.  */
366
367 /* MAYBE: cagney/1999-11-05: catch_errors() in conjunction with
368    error() et.al. could maintain a set of flags that indicate the the
369    current state of each of the longjmp buffers.  This would give the
370    longjmp code the chance to detect a longjmp botch (before it gets
371    to longjmperror()).  Prior to 1999-11-05 this wasn't possible as
372    code also randomly used a SET_TOP_LEVEL macro that directly
373    initialize the longjmp buffers. */
374
375 /* MAYBE: cagney/1999-11-05: Should the catch_errors and cleanups code
376    be consolidated into a single file instead of being distributed
377    between utils.c and top.c? */
378
379 static void
380 catcher (catch_exceptions_ftype *func,
381          struct ui_out *func_uiout,
382          void *func_args,
383          int *func_val,
384          enum return_reason *func_caught,
385          char *errstring,
386          return_mask mask)
387 {
388   SIGJMP_BUF *saved_catch;
389   SIGJMP_BUF catch;
390   struct cleanup *saved_cleanup_chain;
391   char *saved_error_pre_print;
392   char *saved_quit_pre_print;
393   struct ui_out *saved_uiout;
394
395   /* Return value from SIGSETJMP(): enum return_reason if error or
396      quit caught, 0 otherwise. */
397   int caught;
398
399   /* Return value from FUNC(): Hopefully non-zero. Explicitly set to
400      zero if an error quit was caught.  */
401   int val;
402
403   /* Override error/quit messages during FUNC. */
404
405   saved_error_pre_print = error_pre_print;
406   saved_quit_pre_print = quit_pre_print;
407
408   if (mask & RETURN_MASK_ERROR)
409     error_pre_print = errstring;
410   if (mask & RETURN_MASK_QUIT)
411     quit_pre_print = errstring;
412
413   /* Override the global ``struct ui_out'' builder.  */
414
415   saved_uiout = uiout;
416   uiout = func_uiout;
417
418   /* Prevent error/quit during FUNC from calling cleanups established
419      prior to here. */
420
421   saved_cleanup_chain = save_cleanups ();
422
423   /* Call FUNC, catching error/quit events. */
424
425   saved_catch = catch_return;
426   catch_return = &catch;
427   caught = SIGSETJMP (catch);
428   if (!caught)
429     val = (*func) (func_uiout, func_args);
430   else
431     val = 0;
432   catch_return = saved_catch;
433
434   /* FIXME: cagney/1999-11-05: A correct FUNC implementation will
435      clean things up (restoring the cleanup chain) to the state they
436      were just prior to the call.  Unfortunately, many FUNC's are not
437      that well behaved.  This could be fixed by adding either a
438      do_cleanups call (to cover the problem) or an assertion check to
439      detect bad FUNCs code. */
440
441   /* Restore the cleanup chain, the error/quit messages, and the uiout
442      builder, to their original states. */
443
444   restore_cleanups (saved_cleanup_chain);
445
446   uiout = saved_uiout;
447
448   if (mask & RETURN_MASK_QUIT)
449     quit_pre_print = saved_quit_pre_print;
450   if (mask & RETURN_MASK_ERROR)
451     error_pre_print = saved_error_pre_print;
452
453   /* Return normally if no error/quit event occurred or this catcher
454      can handle this exception.  The caller analyses the func return
455      values.  */
456
457   if (!caught || (mask & RETURN_MASK (caught)))
458     {
459       *func_val = val;
460       *func_caught = caught;
461       return;
462     }
463
464   /* The caller didn't request that the event be caught, relay the
465      event to the next containing catch_errors(). */
466
467   throw_exception (caught);
468 }
469
470 int
471 catch_exceptions (struct ui_out *uiout,
472                   catch_exceptions_ftype *func,
473                   void *func_args,
474                   char *errstring,
475                   return_mask mask)
476 {
477   int val;
478   enum return_reason caught;
479   catcher (func, uiout, func_args, &val, &caught, errstring, mask);
480   gdb_assert (val >= 0);
481   gdb_assert (caught <= 0);
482   if (caught < 0)
483     return caught;
484   return val;
485 }
486
487 struct catch_errors_args
488 {
489   catch_errors_ftype *func;
490   void *func_args;
491 };
492
493 static int
494 do_catch_errors (struct ui_out *uiout, void *data)
495 {
496   struct catch_errors_args *args = data;
497   return args->func (args->func_args);
498 }
499
500 int
501 catch_errors (catch_errors_ftype *func, void *func_args, char *errstring,
502               return_mask mask)
503 {
504   int val;
505   enum return_reason caught;
506   struct catch_errors_args args;
507   args.func = func;
508   args.func_args = func_args;
509   catcher (do_catch_errors, uiout, &args, &val, &caught, errstring, mask);
510   if (caught != 0)
511     return 0;
512   return val;
513 }
514
515 struct captured_command_args
516   {
517     catch_command_errors_ftype *command;
518     char *arg;
519     int from_tty;
520   };
521
522 static int
523 do_captured_command (void *data)
524 {
525   struct captured_command_args *context = data;
526   context->command (context->arg, context->from_tty);
527   /* FIXME: cagney/1999-11-07: Technically this do_cleanups() call
528      isn't needed.  Instead an assertion check could be made that
529      simply confirmed that the called function correctly cleaned up
530      after itself.  Unfortunately, old code (prior to 1999-11-04) in
531      main.c was calling SET_TOP_LEVEL(), calling the command function,
532      and then *always* calling do_cleanups().  For the moment we
533      remain ``bug compatible'' with that old code..  */
534   do_cleanups (ALL_CLEANUPS);
535   return 1;
536 }
537
538 int
539 catch_command_errors (catch_command_errors_ftype * command,
540                       char *arg, int from_tty, return_mask mask)
541 {
542   struct captured_command_args args;
543   args.command = command;
544   args.arg = arg;
545   args.from_tty = from_tty;
546   return catch_errors (do_captured_command, &args, "", mask);
547 }
548
549
550 /* Handler for SIGHUP.  */
551
552 #ifdef SIGHUP
553 /* Just a little helper function for disconnect().  */
554
555 /* NOTE 1999-04-29: This function will be static again, once we modify
556    gdb to use the event loop as the default command loop and we merge
557    event-top.c into this file, top.c */
558 /* static */ int
559 quit_cover (void *s)
560 {
561   caution = 0;                  /* Throw caution to the wind -- we're exiting.
562                                    This prevents asking the user dumb questions.  */
563   quit_command ((char *) 0, 0);
564   return 0;
565 }
566
567 static void
568 disconnect (int signo)
569 {
570   catch_errors (quit_cover, NULL,
571               "Could not kill the program being debugged", RETURN_MASK_ALL);
572   signal (SIGHUP, SIG_DFL);
573   kill (getpid (), SIGHUP);
574 }
575 #endif /* defined SIGHUP */
576 \f
577 /* Line number we are currently in in a file which is being sourced.  */
578 /* NOTE 1999-04-29: This variable will be static again, once we modify
579    gdb to use the event loop as the default command loop and we merge
580    event-top.c into this file, top.c */
581 /* static */ int source_line_number;
582
583 /* Name of the file we are sourcing.  */
584 /* NOTE 1999-04-29: This variable will be static again, once we modify
585    gdb to use the event loop as the default command loop and we merge
586    event-top.c into this file, top.c */
587 /* static */ char *source_file_name;
588
589 /* Buffer containing the error_pre_print used by the source stuff.
590    Malloc'd.  */
591 /* NOTE 1999-04-29: This variable will be static again, once we modify
592    gdb to use the event loop as the default command loop and we merge
593    event-top.c into this file, top.c */
594 /* static */ char *source_error;
595 static int source_error_allocated;
596
597 /* Something to glom on to the start of error_pre_print if source_file_name
598    is set.  */
599 /* NOTE 1999-04-29: This variable will be static again, once we modify
600    gdb to use the event loop as the default command loop and we merge
601    event-top.c into this file, top.c */
602 /* static */ char *source_pre_error;
603
604 /* Clean up on error during a "source" command (or execution of a
605    user-defined command).  */
606
607 void
608 do_restore_instream_cleanup (void *stream)
609 {
610   /* Restore the previous input stream.  */
611   instream = stream;
612 }
613
614 /* Read commands from STREAM.  */
615 void
616 read_command_file (FILE *stream)
617 {
618   struct cleanup *cleanups;
619
620   cleanups = make_cleanup (do_restore_instream_cleanup, instream);
621   instream = stream;
622   command_loop ();
623   do_cleanups (cleanups);
624 }
625 \f
626 void (*pre_init_ui_hook) (void);
627
628 #ifdef __MSDOS__
629 void
630 do_chdir_cleanup (void *old_dir)
631 {
632   chdir (old_dir);
633   xfree (old_dir);
634 }
635 #endif
636
637 /* Execute the line P as a command.
638    Pass FROM_TTY as second argument to the defining function.  */
639
640 void
641 execute_command (char *p, int from_tty)
642 {
643   struct cmd_list_element *c;
644   enum language flang;
645   static int warned = 0;
646   char *line;
647   
648   free_all_values ();
649
650   /* Force cleanup of any alloca areas if using C alloca instead of
651      a builtin alloca.  */
652   alloca (0);
653
654   /* This can happen when command_line_input hits end of file.  */
655   if (p == NULL)
656     return;
657
658   serial_log_command (p);
659
660   while (*p == ' ' || *p == '\t')
661     p++;
662   if (*p)
663     {
664       char *arg;
665       line = p;
666
667       c = lookup_cmd (&p, cmdlist, "", 0, 1);
668
669       /* If the target is running, we allow only a limited set of
670          commands. */
671       if (event_loop_p && target_can_async_p () && target_executing)
672         if (strcmp (c->name, "help") != 0
673             && strcmp (c->name, "pwd") != 0
674             && strcmp (c->name, "show") != 0
675             && strcmp (c->name, "stop") != 0)
676           error ("Cannot execute this command while the target is running.");
677
678       /* Pass null arg rather than an empty one.  */
679       arg = *p ? p : 0;
680
681       /* FIXME: cagney/2002-02-02: The c->type test is pretty dodgy
682          while the is_complete_command(cfunc) test is just plain
683          bogus.  They should both be replaced by a test of the form
684          c->strip_trailing_white_space_p.  */
685       /* NOTE: cagney/2002-02-02: The function.cfunc in the below
686          can't be replaced with func.  This is because it is the
687          cfunc, and not the func, that has the value that the
688          is_complete_command hack is testing for.  */
689       /* Clear off trailing whitespace, except for set and complete
690          command.  */
691       if (arg
692           && c->type != set_cmd
693           && !is_complete_command (c))
694         {
695           p = arg + strlen (arg) - 1;
696           while (p >= arg && (*p == ' ' || *p == '\t'))
697             p--;
698           *(p + 1) = '\0';
699         }
700
701       /* If this command has been pre-hooked, run the hook first. */
702       execute_cmd_pre_hook (c);
703
704       if (c->flags & DEPRECATED_WARN_USER)
705         deprecated_cmd_warning (&line);
706
707       if (c->class == class_user)
708         execute_user_command (c, arg);
709       else if (c->type == set_cmd || c->type == show_cmd)
710         do_setshow_command (arg, from_tty & caution, c);
711       else if (!cmd_func_p (c))
712         error ("That is not a command, just a help topic.");
713       else if (call_command_hook)
714         call_command_hook (c, arg, from_tty & caution);
715       else
716         cmd_func (c, arg, from_tty & caution);
717        
718       /* If this command has been post-hooked, run the hook last. */
719       execute_cmd_post_hook (c);
720
721     }
722
723   /* Tell the user if the language has changed (except first time).  */
724   if (current_language != expected_language)
725     {
726       if (language_mode == language_mode_auto)
727         {
728           language_info (1);    /* Print what changed.  */
729         }
730       warned = 0;
731     }
732
733   /* Warn the user if the working language does not match the
734      language of the current frame.  Only warn the user if we are
735      actually running the program, i.e. there is a stack. */
736   /* FIXME:  This should be cacheing the frame and only running when
737      the frame changes.  */
738
739   if (target_has_stack)
740     {
741       flang = get_frame_language ();
742       if (!warned
743           && flang != language_unknown
744           && flang != current_language->la_language)
745         {
746           printf_filtered ("%s\n", lang_frame_mismatch_warn);
747           warned = 1;
748         }
749     }
750 }
751
752 /* Read commands from `instream' and execute them
753    until end of file or error reading instream.  */
754
755 void
756 command_loop (void)
757 {
758   struct cleanup *old_chain;
759   char *command;
760   int stdin_is_tty = ISATTY (stdin);
761   long time_at_cmd_start;
762 #ifdef HAVE_SBRK
763   long space_at_cmd_start = 0;
764 #endif
765   extern int display_time;
766   extern int display_space;
767
768   while (instream && !feof (instream))
769     {
770       if (window_hook && instream == stdin)
771         (*window_hook) (instream, get_prompt ());
772
773       quit_flag = 0;
774       if (instream == stdin && stdin_is_tty)
775         reinitialize_more_filter ();
776       old_chain = make_cleanup (null_cleanup, 0);
777
778       /* Get a command-line. This calls the readline package. */
779       command = command_line_input (instream == stdin ?
780                                     get_prompt () : (char *) NULL,
781                                     instream == stdin, "prompt");
782       if (command == 0)
783         return;
784
785       time_at_cmd_start = get_run_time ();
786
787       if (display_space)
788         {
789 #ifdef HAVE_SBRK
790           char *lim = (char *) sbrk (0);
791           space_at_cmd_start = lim - lim_at_start;
792 #endif
793         }
794
795       execute_command (command, instream == stdin);
796       /* Do any commands attached to breakpoint we stopped at.  */
797       bpstat_do_actions (&stop_bpstat);
798       do_cleanups (old_chain);
799
800       if (display_time)
801         {
802           long cmd_time = get_run_time () - time_at_cmd_start;
803
804           printf_unfiltered ("Command execution time: %ld.%06ld\n",
805                              cmd_time / 1000000, cmd_time % 1000000);
806         }
807
808       if (display_space)
809         {
810 #ifdef HAVE_SBRK
811           char *lim = (char *) sbrk (0);
812           long space_now = lim - lim_at_start;
813           long space_diff = space_now - space_at_cmd_start;
814
815           printf_unfiltered ("Space used: %ld (%c%ld for this command)\n",
816                              space_now,
817                              (space_diff >= 0 ? '+' : '-'),
818                              space_diff);
819 #endif
820         }
821     }
822 }
823
824 /* Read commands from `instream' and execute them until end of file or
825    error reading instream. This command loop doesnt care about any
826    such things as displaying time and space usage. If the user asks
827    for those, they won't work. */
828 void
829 simplified_command_loop (char *(*read_input_func) (char *),
830                          void (*execute_command_func) (char *, int))
831 {
832   struct cleanup *old_chain;
833   char *command;
834   int stdin_is_tty = ISATTY (stdin);
835
836   while (instream && !feof (instream))
837     {
838       quit_flag = 0;
839       if (instream == stdin && stdin_is_tty)
840         reinitialize_more_filter ();
841       old_chain = make_cleanup (null_cleanup, 0);
842
843       /* Get a command-line. */
844       command = (*read_input_func) (instream == stdin ?
845                                     get_prompt () : (char *) NULL);
846
847       if (command == 0)
848         return;
849
850       (*execute_command_func) (command, instream == stdin);
851
852       /* Do any commands attached to breakpoint we stopped at.  */
853       bpstat_do_actions (&stop_bpstat);
854
855       do_cleanups (old_chain);
856     }
857 }
858 \f
859 /* Commands call this if they do not want to be repeated by null lines.  */
860
861 void
862 dont_repeat (void)
863 {
864   if (server_command)
865     return;
866
867   /* If we aren't reading from standard input, we are saving the last
868      thing read from stdin in line and don't want to delete it.  Null lines
869      won't repeat here in any case.  */
870   if (instream == stdin)
871     *line = 0;
872 }
873 \f
874 /* Read a line from the stream "instream" without command line editing.
875
876    It prints PROMPT_ARG once at the start.
877    Action is compatible with "readline", e.g. space for the result is
878    malloc'd and should be freed by the caller.
879
880    A NULL return means end of file.  */
881 char *
882 gdb_readline (char *prompt_arg)
883 {
884   int c;
885   char *result;
886   int input_index = 0;
887   int result_size = 80;
888
889   if (prompt_arg)
890     {
891       /* Don't use a _filtered function here.  It causes the assumed
892          character position to be off, since the newline we read from
893          the user is not accounted for.  */
894       fputs_unfiltered (prompt_arg, gdb_stdout);
895       gdb_flush (gdb_stdout);
896     }
897
898   result = (char *) xmalloc (result_size);
899
900   while (1)
901     {
902       /* Read from stdin if we are executing a user defined command.
903          This is the right thing for prompt_for_continue, at least.  */
904       c = fgetc (instream ? instream : stdin);
905
906       if (c == EOF)
907         {
908           if (input_index > 0)
909             /* The last line does not end with a newline.  Return it, and
910                if we are called again fgetc will still return EOF and
911                we'll return NULL then.  */
912             break;
913           xfree (result);
914           return NULL;
915         }
916
917       if (c == '\n')
918 #ifndef CRLF_SOURCE_FILES
919         break;
920 #else
921         {
922           if (input_index > 0 && result[input_index - 1] == '\r')
923             input_index--;
924           break;
925         }
926 #endif
927
928       result[input_index++] = c;
929       while (input_index >= result_size)
930         {
931           result_size *= 2;
932           result = (char *) xrealloc (result, result_size);
933         }
934     }
935
936   result[input_index++] = '\0';
937   return result;
938 }
939
940 /* Variables which control command line editing and history
941    substitution.  These variables are given default values at the end
942    of this file.  */
943 static int command_editing_p;
944 /* NOTE 1999-04-29: This variable will be static again, once we modify
945    gdb to use the event loop as the default command loop and we merge
946    event-top.c into this file, top.c */
947 /* static */ int history_expansion_p;
948 static int write_history_p;
949 static int history_size;
950 static char *history_filename;
951
952 /* This is like readline(), but it has some gdb-specific behavior.
953    gdb can use readline in both the synchronous and async modes during
954    a single gdb invocation.  At the ordinary top-level prompt we might
955    be using the async readline.  That means we can't use
956    rl_pre_input_hook, since it doesn't work properly in async mode.
957    However, for a secondary prompt (" >", such as occurs during a
958    `define'), gdb just calls readline() directly, running it in
959    synchronous mode.  So for operate-and-get-next to work in this
960    situation, we have to switch the hooks around.  That is what
961    gdb_readline_wrapper is for.  */
962 char *
963 gdb_readline_wrapper (char *prompt)
964 {
965   /* Set the hook that works in this case.  */
966   if (event_loop_p && after_char_processing_hook)
967     {
968       rl_pre_input_hook = (Function *) after_char_processing_hook;
969       after_char_processing_hook = NULL;
970     }
971
972   return readline (prompt);
973 }
974
975 \f
976 #ifdef STOP_SIGNAL
977 static void
978 stop_sig (int signo)
979 {
980 #if STOP_SIGNAL == SIGTSTP
981   signal (SIGTSTP, SIG_DFL);
982 #if HAVE_SIGPROCMASK
983   {
984     sigset_t zero;
985
986     sigemptyset (&zero);
987     sigprocmask (SIG_SETMASK, &zero, 0);
988   }
989 #elif HAVE_SIGSETMASK
990   sigsetmask (0);
991 #endif
992   kill (getpid (), SIGTSTP);
993   signal (SIGTSTP, stop_sig);
994 #else
995   signal (STOP_SIGNAL, stop_sig);
996 #endif
997   printf_unfiltered ("%s", get_prompt ());
998   gdb_flush (gdb_stdout);
999
1000   /* Forget about any previous command -- null line now will do nothing.  */
1001   dont_repeat ();
1002 }
1003 #endif /* STOP_SIGNAL */
1004
1005 /* Initialize signal handlers. */
1006 static void
1007 float_handler (int signo)
1008 {
1009   /* This message is based on ANSI C, section 4.7.  Note that integer
1010      divide by zero causes this, so "float" is a misnomer.  */
1011   signal (SIGFPE, float_handler);
1012   error ("Erroneous arithmetic operation.");
1013 }
1014
1015 static void
1016 do_nothing (int signo)
1017 {
1018   /* Under System V the default disposition of a signal is reinstated after
1019      the signal is caught and delivered to an application process.  On such
1020      systems one must restore the replacement signal handler if one wishes
1021      to continue handling the signal in one's program.  On BSD systems this
1022      is not needed but it is harmless, and it simplifies the code to just do
1023      it unconditionally. */
1024   signal (signo, do_nothing);
1025 }
1026
1027 static void
1028 init_signals (void)
1029 {
1030   signal (SIGINT, request_quit);
1031
1032   /* If SIGTRAP was set to SIG_IGN, then the SIG_IGN will get passed
1033      to the inferior and breakpoints will be ignored.  */
1034 #ifdef SIGTRAP
1035   signal (SIGTRAP, SIG_DFL);
1036 #endif
1037
1038   /* If we initialize SIGQUIT to SIG_IGN, then the SIG_IGN will get
1039      passed to the inferior, which we don't want.  It would be
1040      possible to do a "signal (SIGQUIT, SIG_DFL)" after we fork, but
1041      on BSD4.3 systems using vfork, that can affect the
1042      GDB process as well as the inferior (the signal handling tables
1043      might be in memory, shared between the two).  Since we establish
1044      a handler for SIGQUIT, when we call exec it will set the signal
1045      to SIG_DFL for us.  */
1046   signal (SIGQUIT, do_nothing);
1047 #ifdef SIGHUP
1048   if (signal (SIGHUP, do_nothing) != SIG_IGN)
1049     signal (SIGHUP, disconnect);
1050 #endif
1051   signal (SIGFPE, float_handler);
1052
1053 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1054   signal (SIGWINCH, SIGWINCH_HANDLER);
1055 #endif
1056 }
1057 \f
1058 /* The current saved history number from operate-and-get-next.
1059    This is -1 if not valid.  */
1060 static int operate_saved_history = -1;
1061
1062 /* This is put on the appropriate hook and helps operate-and-get-next
1063    do its work.  */
1064 static void
1065 gdb_rl_operate_and_get_next_completion (void)
1066 {
1067   int delta = where_history () - operate_saved_history;
1068   /* The `key' argument to rl_get_previous_history is ignored.  */
1069   rl_get_previous_history (delta, 0);
1070   operate_saved_history = -1;
1071
1072   /* readline doesn't automatically update the display for us.  */
1073   rl_redisplay ();
1074
1075   after_char_processing_hook = NULL;
1076   rl_pre_input_hook = NULL;
1077 }
1078
1079 /* This is a gdb-local readline command handler.  It accepts the
1080    current command line (like RET does) and, if this command was taken
1081    from the history, arranges for the next command in the history to
1082    appear on the command line when the prompt returns.
1083    We ignore the arguments.  */
1084 static int
1085 gdb_rl_operate_and_get_next (int count, int key)
1086 {
1087   int where;
1088
1089   if (event_loop_p)
1090     {
1091       /* Use the async hook.  */
1092       after_char_processing_hook = gdb_rl_operate_and_get_next_completion;
1093     }
1094   else
1095     {
1096       /* This hook only works correctly when we are using the
1097          synchronous readline.  */
1098       rl_pre_input_hook = (Function *) gdb_rl_operate_and_get_next_completion;
1099     }
1100
1101   /* Find the current line, and find the next line to use.  */
1102   where = where_history();
1103
1104   /* FIXME: kettenis/20020817: max_input_history is renamed into
1105      history_max_entries in readline-4.2.  When we do a new readline
1106      import, we should probably change it here too, even though
1107      readline maintains backwards compatibility for now by still
1108      defining max_input_history.  */
1109   if ((history_is_stifled () && (history_length >= max_input_history)) ||
1110       (where >= history_length - 1))
1111     operate_saved_history = where;
1112   else
1113     operate_saved_history = where + 1;
1114
1115   return rl_newline (1, key);
1116 }
1117 \f
1118 /* Read one line from the command input stream `instream'
1119    into the local static buffer `linebuffer' (whose current length
1120    is `linelength').
1121    The buffer is made bigger as necessary.
1122    Returns the address of the start of the line.
1123
1124    NULL is returned for end of file.
1125
1126    *If* the instream == stdin & stdin is a terminal, the line read
1127    is copied into the file line saver (global var char *line,
1128    length linesize) so that it can be duplicated.
1129
1130    This routine either uses fancy command line editing or
1131    simple input as the user has requested.  */
1132
1133 char *
1134 command_line_input (char *prompt_arg, int repeat, char *annotation_suffix)
1135 {
1136   static char *linebuffer = 0;
1137   static unsigned linelength = 0;
1138   char *p;
1139   char *p1;
1140   char *rl;
1141   char *local_prompt = prompt_arg;
1142   char *nline;
1143   char got_eof = 0;
1144
1145   /* The annotation suffix must be non-NULL.  */
1146   if (annotation_suffix == NULL)
1147     annotation_suffix = "";
1148
1149   if (annotation_level > 1 && instream == stdin)
1150     {
1151       local_prompt = alloca ((prompt_arg == NULL ? 0 : strlen (prompt_arg))
1152                              + strlen (annotation_suffix) + 40);
1153       if (prompt_arg == NULL)
1154         local_prompt[0] = '\0';
1155       else
1156         strcpy (local_prompt, prompt_arg);
1157       strcat (local_prompt, "\n\032\032");
1158       strcat (local_prompt, annotation_suffix);
1159       strcat (local_prompt, "\n");
1160     }
1161
1162   if (linebuffer == 0)
1163     {
1164       linelength = 80;
1165       linebuffer = (char *) xmalloc (linelength);
1166     }
1167
1168   p = linebuffer;
1169
1170   /* Control-C quits instantly if typed while in this loop
1171      since it should not wait until the user types a newline.  */
1172   immediate_quit++;
1173 #ifdef STOP_SIGNAL
1174   if (job_control)
1175     {
1176       if (event_loop_p)
1177         signal (STOP_SIGNAL, handle_stop_sig);
1178       else
1179         signal (STOP_SIGNAL, stop_sig);
1180     }
1181 #endif
1182
1183   while (1)
1184     {
1185       /* Make sure that all output has been output.  Some machines may let
1186          you get away with leaving out some of the gdb_flush, but not all.  */
1187       wrap_here ("");
1188       gdb_flush (gdb_stdout);
1189       gdb_flush (gdb_stderr);
1190
1191       if (source_file_name != NULL)
1192         {
1193           ++source_line_number;
1194           sprintf (source_error,
1195                    "%s%s:%d: Error in sourced command file:\n",
1196                    source_pre_error,
1197                    source_file_name,
1198                    source_line_number);
1199           error_pre_print = source_error;
1200         }
1201
1202       if (annotation_level > 1 && instream == stdin)
1203         {
1204           puts_unfiltered ("\n\032\032pre-");
1205           puts_unfiltered (annotation_suffix);
1206           puts_unfiltered ("\n");
1207         }
1208
1209       /* Don't use fancy stuff if not talking to stdin.  */
1210       if (readline_hook && instream == NULL)
1211         {
1212           rl = (*readline_hook) (local_prompt);
1213         }
1214       else if (command_editing_p && instream == stdin && ISATTY (instream))
1215         {
1216           rl = gdb_readline_wrapper (local_prompt);
1217         }
1218       else
1219         {
1220           rl = gdb_readline (local_prompt);
1221         }
1222
1223       if (annotation_level > 1 && instream == stdin)
1224         {
1225           puts_unfiltered ("\n\032\032post-");
1226           puts_unfiltered (annotation_suffix);
1227           puts_unfiltered ("\n");
1228         }
1229
1230       if (!rl || rl == (char *) EOF)
1231         {
1232           got_eof = 1;
1233           break;
1234         }
1235       if (strlen (rl) + 1 + (p - linebuffer) > linelength)
1236         {
1237           linelength = strlen (rl) + 1 + (p - linebuffer);
1238           nline = (char *) xrealloc (linebuffer, linelength);
1239           p += nline - linebuffer;
1240           linebuffer = nline;
1241         }
1242       p1 = rl;
1243       /* Copy line.  Don't copy null at end.  (Leaves line alone
1244          if this was just a newline)  */
1245       while (*p1)
1246         *p++ = *p1++;
1247
1248       xfree (rl);               /* Allocated in readline.  */
1249
1250       if (p == linebuffer || *(p - 1) != '\\')
1251         break;
1252
1253       p--;                      /* Put on top of '\'.  */
1254       local_prompt = (char *) 0;
1255     }
1256
1257 #ifdef STOP_SIGNAL
1258   if (job_control)
1259     signal (STOP_SIGNAL, SIG_DFL);
1260 #endif
1261   immediate_quit--;
1262
1263   if (got_eof)
1264     return NULL;
1265
1266 #define SERVER_COMMAND_LENGTH 7
1267   server_command =
1268     (p - linebuffer > SERVER_COMMAND_LENGTH)
1269     && strncmp (linebuffer, "server ", SERVER_COMMAND_LENGTH) == 0;
1270   if (server_command)
1271     {
1272       /* Note that we don't set `line'.  Between this and the check in
1273          dont_repeat, this insures that repeating will still do the
1274          right thing.  */
1275       *p = '\0';
1276       return linebuffer + SERVER_COMMAND_LENGTH;
1277     }
1278
1279   /* Do history expansion if that is wished.  */
1280   if (history_expansion_p && instream == stdin
1281       && ISATTY (instream))
1282     {
1283       char *history_value;
1284       int expanded;
1285
1286       *p = '\0';                /* Insert null now.  */
1287       expanded = history_expand (linebuffer, &history_value);
1288       if (expanded)
1289         {
1290           /* Print the changes.  */
1291           printf_unfiltered ("%s\n", history_value);
1292
1293           /* If there was an error, call this function again.  */
1294           if (expanded < 0)
1295             {
1296               xfree (history_value);
1297               return command_line_input (prompt_arg, repeat, annotation_suffix);
1298             }
1299           if (strlen (history_value) > linelength)
1300             {
1301               linelength = strlen (history_value) + 1;
1302               linebuffer = (char *) xrealloc (linebuffer, linelength);
1303             }
1304           strcpy (linebuffer, history_value);
1305           p = linebuffer + strlen (linebuffer);
1306           xfree (history_value);
1307         }
1308     }
1309
1310   /* If we just got an empty line, and that is supposed
1311      to repeat the previous command, return the value in the
1312      global buffer.  */
1313   if (repeat && p == linebuffer)
1314     return line;
1315   for (p1 = linebuffer; *p1 == ' ' || *p1 == '\t'; p1++);
1316   if (repeat && !*p1)
1317     return line;
1318
1319   *p = 0;
1320
1321   /* Add line to history if appropriate.  */
1322   if (instream == stdin
1323       && ISATTY (stdin) && *linebuffer)
1324     add_history (linebuffer);
1325
1326   /* Note: lines consisting solely of comments are added to the command
1327      history.  This is useful when you type a command, and then
1328      realize you don't want to execute it quite yet.  You can comment
1329      out the command and then later fetch it from the value history
1330      and remove the '#'.  The kill ring is probably better, but some
1331      people are in the habit of commenting things out.  */
1332   if (*p1 == '#')
1333     *p1 = '\0';                 /* Found a comment. */
1334
1335   /* Save into global buffer if appropriate.  */
1336   if (repeat)
1337     {
1338       if (linelength > linesize)
1339         {
1340           line = xrealloc (line, linelength);
1341           linesize = linelength;
1342         }
1343       strcpy (line, linebuffer);
1344       return line;
1345     }
1346
1347   return linebuffer;
1348 }
1349 \f
1350 /* Print the GDB banner. */
1351 void
1352 print_gdb_version (struct ui_file *stream)
1353 {
1354   /* From GNU coding standards, first line is meant to be easy for a
1355      program to parse, and is just canonical program name and version
1356      number, which starts after last space. */
1357
1358   fprintf_filtered (stream, "GNU gdb %s\n", version);
1359
1360   /* Second line is a copyright notice. */
1361
1362   fprintf_filtered (stream, "Copyright 2003 Free Software Foundation, Inc.\n");
1363
1364   /* Following the copyright is a brief statement that the program is
1365      free software, that users are free to copy and change it on
1366      certain conditions, that it is covered by the GNU GPL, and that
1367      there is no warranty. */
1368
1369   fprintf_filtered (stream, "\
1370 GDB is free software, covered by the GNU General Public License, and you are\n\
1371 welcome to change it and/or distribute copies of it under certain conditions.\n\
1372 Type \"show copying\" to see the conditions.\n\
1373 There is absolutely no warranty for GDB.  Type \"show warranty\" for details.\n");
1374
1375   /* After the required info we print the configuration information. */
1376
1377   fprintf_filtered (stream, "This GDB was configured as \"");
1378   if (!STREQ (host_name, target_name))
1379     {
1380       fprintf_filtered (stream, "--host=%s --target=%s", host_name, target_name);
1381     }
1382   else
1383     {
1384       fprintf_filtered (stream, "%s", host_name);
1385     }
1386   fprintf_filtered (stream, "\".");
1387 }
1388 \f
1389 /* get_prompt: access method for the GDB prompt string.  */
1390
1391 char *
1392 get_prompt (void)
1393 {
1394   if (event_loop_p)
1395     return PROMPT (0);
1396   else
1397     return gdb_prompt_string;
1398 }
1399
1400 void
1401 set_prompt (char *s)
1402 {
1403 /* ??rehrauer: I don't know why this fails, since it looks as though
1404    assignments to prompt are wrapped in calls to savestring...
1405    if (prompt != NULL)
1406    xfree (prompt);
1407  */
1408   if (event_loop_p)
1409     PROMPT (0) = savestring (s, strlen (s));
1410   else
1411     gdb_prompt_string = savestring (s, strlen (s));
1412 }
1413 \f
1414
1415 /* If necessary, make the user confirm that we should quit.  Return
1416    non-zero if we should quit, zero if we shouldn't.  */
1417
1418 int
1419 quit_confirm (void)
1420 {
1421   if (! ptid_equal (inferior_ptid, null_ptid) && target_has_execution)
1422     {
1423       char *s;
1424
1425       /* This is something of a hack.  But there's no reliable way to
1426          see if a GUI is running.  The `use_windows' variable doesn't
1427          cut it.  */
1428       if (init_ui_hook)
1429         s = "A debugging session is active.\nDo you still want to close the debugger?";
1430       else if (attach_flag)
1431         s = "The program is running.  Quit anyway (and detach it)? ";
1432       else
1433         s = "The program is running.  Exit anyway? ";
1434
1435       if (!query ("%s", s))
1436         return 0;
1437     }
1438
1439   return 1;
1440 }
1441
1442 /* Helper routine for quit_force that requires error handling.  */
1443
1444 struct qt_args
1445 {
1446   char *args;
1447   int from_tty;
1448 };
1449
1450 static int
1451 quit_target (void *arg)
1452 {
1453   struct qt_args *qt = (struct qt_args *)arg;
1454
1455   if (! ptid_equal (inferior_ptid, null_ptid) && target_has_execution)
1456     {
1457       if (attach_flag)
1458         target_detach (qt->args, qt->from_tty);
1459       else
1460         target_kill ();
1461     }
1462
1463   /* UDI wants this, to kill the TIP.  */
1464   target_close (&current_target, 1);
1465
1466   /* Save the history information if it is appropriate to do so.  */
1467   if (write_history_p && history_filename)
1468     write_history (history_filename);
1469
1470   do_final_cleanups (ALL_CLEANUPS);     /* Do any final cleanups before exiting */
1471
1472   return 0;
1473 }
1474
1475 /* Quit without asking for confirmation.  */
1476
1477 void
1478 quit_force (char *args, int from_tty)
1479 {
1480   int exit_code = 0;
1481   struct qt_args qt;
1482
1483   /* An optional expression may be used to cause gdb to terminate with the 
1484      value of that expression. */
1485   if (args)
1486     {
1487       struct value *val = parse_and_eval (args);
1488
1489       exit_code = (int) value_as_long (val);
1490     }
1491
1492   qt.args = args;
1493   qt.from_tty = from_tty;
1494
1495   /* We want to handle any quit errors and exit regardless.  */
1496   catch_errors (quit_target, &qt,
1497                 "Quitting: ", RETURN_MASK_ALL);
1498
1499   exit (exit_code);
1500 }
1501
1502 /* Returns whether GDB is running on a terminal and whether the user
1503    desires that questions be asked of them on that terminal.  */
1504
1505 int
1506 input_from_terminal_p (void)
1507 {
1508   return gdb_has_a_terminal () && (instream == stdin) & caution;
1509 }
1510 \f
1511 static void
1512 dont_repeat_command (char *ignored, int from_tty)
1513 {
1514   *line = 0;                    /* Can't call dont_repeat here because we're not
1515                                    necessarily reading from stdin.  */
1516 }
1517 \f
1518 /* Functions to manipulate command line editing control variables.  */
1519
1520 /* Number of commands to print in each call to show_commands.  */
1521 #define Hist_print 10
1522 void
1523 show_commands (char *args, int from_tty)
1524 {
1525   /* Index for history commands.  Relative to history_base.  */
1526   int offset;
1527
1528   /* Number of the history entry which we are planning to display next.
1529      Relative to history_base.  */
1530   static int num = 0;
1531
1532   /* The first command in the history which doesn't exist (i.e. one more
1533      than the number of the last command).  Relative to history_base.  */
1534   int hist_len;
1535
1536   /* Print out some of the commands from the command history.  */
1537   /* First determine the length of the history list.  */
1538   hist_len = history_size;
1539   for (offset = 0; offset < history_size; offset++)
1540     {
1541       if (!history_get (history_base + offset))
1542         {
1543           hist_len = offset;
1544           break;
1545         }
1546     }
1547
1548   if (args)
1549     {
1550       if (args[0] == '+' && args[1] == '\0')
1551         /* "info editing +" should print from the stored position.  */
1552         ;
1553       else
1554         /* "info editing <exp>" should print around command number <exp>.  */
1555         num = (parse_and_eval_long (args) - history_base) - Hist_print / 2;
1556     }
1557   /* "show commands" means print the last Hist_print commands.  */
1558   else
1559     {
1560       num = hist_len - Hist_print;
1561     }
1562
1563   if (num < 0)
1564     num = 0;
1565
1566   /* If there are at least Hist_print commands, we want to display the last
1567      Hist_print rather than, say, the last 6.  */
1568   if (hist_len - num < Hist_print)
1569     {
1570       num = hist_len - Hist_print;
1571       if (num < 0)
1572         num = 0;
1573     }
1574
1575   for (offset = num; offset < num + Hist_print && offset < hist_len; offset++)
1576     {
1577       printf_filtered ("%5d  %s\n", history_base + offset,
1578                        (history_get (history_base + offset))->line);
1579     }
1580
1581   /* The next command we want to display is the next one that we haven't
1582      displayed yet.  */
1583   num += Hist_print;
1584
1585   /* If the user repeats this command with return, it should do what
1586      "show commands +" does.  This is unnecessary if arg is null,
1587      because "show commands +" is not useful after "show commands".  */
1588   if (from_tty && args)
1589     {
1590       args[0] = '+';
1591       args[1] = '\0';
1592     }
1593 }
1594
1595 /* Called by do_setshow_command.  */
1596 static void
1597 set_history_size_command (char *args, int from_tty, struct cmd_list_element *c)
1598 {
1599   if (history_size == INT_MAX)
1600     unstifle_history ();
1601   else if (history_size >= 0)
1602     stifle_history (history_size);
1603   else
1604     {
1605       history_size = INT_MAX;
1606       error ("History size must be non-negative");
1607     }
1608 }
1609
1610 void
1611 set_history (char *args, int from_tty)
1612 {
1613   printf_unfiltered ("\"set history\" must be followed by the name of a history subcommand.\n");
1614   help_list (sethistlist, "set history ", -1, gdb_stdout);
1615 }
1616
1617 void
1618 show_history (char *args, int from_tty)
1619 {
1620   cmd_show_list (showhistlist, from_tty, "");
1621 }
1622
1623 int info_verbose = 0;           /* Default verbose msgs off */
1624
1625 /* Called by do_setshow_command.  An elaborate joke.  */
1626 void
1627 set_verbose (char *args, int from_tty, struct cmd_list_element *c)
1628 {
1629   char *cmdname = "verbose";
1630   struct cmd_list_element *showcmd;
1631
1632   showcmd = lookup_cmd_1 (&cmdname, showlist, NULL, 1);
1633
1634   if (info_verbose)
1635     {
1636       c->doc = "Set verbose printing of informational messages.";
1637       showcmd->doc = "Show verbose printing of informational messages.";
1638     }
1639   else
1640     {
1641       c->doc = "Set verbosity.";
1642       showcmd->doc = "Show verbosity.";
1643     }
1644 }
1645
1646 /* Init the history buffer.  Note that we are called after the init file(s)
1647  * have been read so that the user can change the history file via his
1648  * .gdbinit file (for instance).  The GDBHISTFILE environment variable
1649  * overrides all of this.
1650  */
1651
1652 void
1653 init_history (void)
1654 {
1655   char *tmpenv;
1656
1657   tmpenv = getenv ("HISTSIZE");
1658   if (tmpenv)
1659     history_size = atoi (tmpenv);
1660   else if (!history_size)
1661     history_size = 256;
1662
1663   stifle_history (history_size);
1664
1665   tmpenv = getenv ("GDBHISTFILE");
1666   if (tmpenv)
1667     history_filename = savestring (tmpenv, strlen (tmpenv));
1668   else if (!history_filename)
1669     {
1670       /* We include the current directory so that if the user changes
1671          directories the file written will be the same as the one
1672          that was read.  */
1673 #ifdef __MSDOS__
1674       /* No leading dots in file names are allowed on MSDOS.  */
1675       history_filename = concat (current_directory, "/_gdb_history", NULL);
1676 #else
1677       history_filename = concat (current_directory, "/.gdb_history", NULL);
1678 #endif
1679     }
1680   read_history (history_filename);
1681 }
1682
1683 static void
1684 init_main (void)
1685 {
1686   struct cmd_list_element *c;
1687
1688   /* If we are running the asynchronous version,
1689      we initialize the prompts differently. */
1690   if (!event_loop_p)
1691     {
1692       gdb_prompt_string = savestring (DEFAULT_PROMPT, strlen (DEFAULT_PROMPT));
1693     }
1694   else
1695     {
1696       /* initialize the prompt stack to a simple "(gdb) " prompt or to
1697          whatever the DEFAULT_PROMPT is. */
1698       the_prompts.top = 0;
1699       PREFIX (0) = "";
1700       PROMPT (0) = savestring (DEFAULT_PROMPT, strlen (DEFAULT_PROMPT));
1701       SUFFIX (0) = "";
1702       /* Set things up for annotation_level > 1, if the user ever decides
1703          to use it. */
1704       async_annotation_suffix = "prompt";
1705       /* Set the variable associated with the setshow prompt command. */
1706       new_async_prompt = savestring (PROMPT (0), strlen (PROMPT (0)));
1707
1708       /* If gdb was started with --annotate=2, this is equivalent to
1709          the user entering the command 'set annotate 2' at the gdb
1710          prompt, so we need to do extra processing. */
1711       if (annotation_level > 1)
1712         set_async_annotation_level (NULL, 0, NULL);
1713     }
1714
1715   /* Set the important stuff up for command editing.  */
1716   command_editing_p = 1;
1717   history_expansion_p = 0;
1718   write_history_p = 0;
1719
1720   /* Setup important stuff for command line editing.  */
1721   rl_completion_entry_function = readline_line_completion_function;
1722   rl_completer_word_break_characters = default_word_break_characters ();
1723   rl_completer_quote_characters = get_gdb_completer_quote_characters ();
1724   rl_readline_name = "gdb";
1725   rl_terminal_name = getenv ("TERM");
1726
1727   /* The name for this defun comes from Bash, where it originated.
1728      15 is Control-o, the same binding this function has in Bash.  */
1729   rl_add_defun ("operate-and-get-next", gdb_rl_operate_and_get_next, 15);
1730
1731   /* The set prompt command is different depending whether or not the
1732      async version is run. NOTE: this difference is going to
1733      disappear as we make the event loop be the default engine of
1734      gdb. */
1735   if (!event_loop_p)
1736     {
1737       add_show_from_set
1738         (add_set_cmd ("prompt", class_support, var_string,
1739                       (char *) &gdb_prompt_string, "Set gdb's prompt",
1740                       &setlist),
1741          &showlist);
1742     }
1743   else
1744     {
1745       c = add_set_cmd ("prompt", class_support, var_string,
1746                        (char *) &new_async_prompt, "Set gdb's prompt",
1747                        &setlist);
1748       add_show_from_set (c, &showlist);
1749       set_cmd_sfunc (c, set_async_prompt);
1750     }
1751
1752   add_com ("dont-repeat", class_support, dont_repeat_command, "Don't repeat this command.\n\
1753 Primarily used inside of user-defined commands that should not be repeated when\n\
1754 hitting return.");
1755
1756   /* The set editing command is different depending whether or not the
1757      async version is run. NOTE: this difference is going to disappear
1758      as we make the event loop be the default engine of gdb. */
1759   if (!event_loop_p)
1760     {
1761       add_show_from_set
1762         (add_set_cmd ("editing", class_support, var_boolean, (char *) &command_editing_p,
1763                       "Set editing of command lines as they are typed.\n\
1764 Use \"on\" to enable the editing, and \"off\" to disable it.\n\
1765 Without an argument, command line editing is enabled.  To edit, use\n\
1766 EMACS-like or VI-like commands like control-P or ESC.", &setlist),
1767          &showlist);
1768     }
1769   else
1770     {
1771       c = add_set_cmd ("editing", class_support, var_boolean, (char *) &async_command_editing_p,
1772                        "Set editing of command lines as they are typed.\n\
1773 Use \"on\" to enable the editing, and \"off\" to disable it.\n\
1774 Without an argument, command line editing is enabled.  To edit, use\n\
1775 EMACS-like or VI-like commands like control-P or ESC.", &setlist);
1776
1777       add_show_from_set (c, &showlist);
1778       set_cmd_sfunc (c, set_async_editing_command);
1779     }
1780
1781   add_show_from_set
1782     (add_set_cmd ("save", no_class, var_boolean, (char *) &write_history_p,
1783                   "Set saving of the history record on exit.\n\
1784 Use \"on\" to enable the saving, and \"off\" to disable it.\n\
1785 Without an argument, saving is enabled.", &sethistlist),
1786      &showhistlist);
1787
1788   c = add_set_cmd ("size", no_class, var_integer, (char *) &history_size,
1789                    "Set the size of the command history,\n\
1790 ie. the number of previous commands to keep a record of.", &sethistlist);
1791   add_show_from_set (c, &showhistlist);
1792   set_cmd_sfunc (c, set_history_size_command);
1793
1794   c = add_set_cmd ("filename", no_class, var_filename,
1795                    (char *) &history_filename,
1796                    "Set the filename in which to record the command history\n\
1797 (the list of previous commands of which a record is kept).", &sethistlist);
1798   set_cmd_completer (c, filename_completer);
1799   add_show_from_set (c, &showhistlist);
1800
1801   add_show_from_set
1802     (add_set_cmd ("confirm", class_support, var_boolean,
1803                   (char *) &caution,
1804                   "Set whether to confirm potentially dangerous operations.",
1805                   &setlist),
1806      &showlist);
1807
1808   /* The set annotate command is different depending whether or not
1809      the async version is run. NOTE: this difference is going to
1810      disappear as we make the event loop be the default engine of
1811      gdb. */
1812   if (!event_loop_p)
1813     {
1814       c = add_set_cmd ("annotate", class_obscure, var_zinteger,
1815                        (char *) &annotation_level, "Set annotation_level.\n\
1816 0 == normal;     1 == fullname (for use when running under emacs)\n\
1817 2 == output annotated suitably for use by programs that control GDB.",
1818                        &setlist);
1819       c = add_show_from_set (c, &showlist);
1820     }
1821   else
1822     {
1823       c = add_set_cmd ("annotate", class_obscure, var_zinteger,
1824                        (char *) &annotation_level, "Set annotation_level.\n\
1825 0 == normal;     1 == fullname (for use when running under emacs)\n\
1826 2 == output annotated suitably for use by programs that control GDB.",
1827                        &setlist);
1828       add_show_from_set (c, &showlist);
1829       set_cmd_sfunc (c, set_async_annotation_level);
1830     }
1831   if (event_loop_p)
1832     {
1833       add_show_from_set
1834         (add_set_cmd ("exec-done-display", class_support, var_boolean, (char *) &exec_done_display_p,
1835                       "Set notification of completion for asynchronous execution commands.\n\
1836 Use \"on\" to enable the notification, and \"off\" to disable it.", &setlist),
1837          &showlist);
1838     }
1839 }
1840
1841 void
1842 gdb_init (char *argv0)
1843 {
1844   if (pre_init_ui_hook)
1845     pre_init_ui_hook ();
1846
1847   /* Run the init function of each source file */
1848
1849   getcwd (gdb_dirbuf, sizeof (gdb_dirbuf));
1850   current_directory = gdb_dirbuf;
1851
1852 #ifdef __MSDOS__
1853   /* Make sure we return to the original directory upon exit, come
1854      what may, since the OS doesn't do that for us.  */
1855   make_final_cleanup (do_chdir_cleanup, xstrdup (current_directory));
1856 #endif
1857
1858   init_cmd_lists ();            /* This needs to be done first */
1859   initialize_targets ();        /* Setup target_terminal macros for utils.c */
1860   initialize_utils ();          /* Make errors and warnings possible */
1861   initialize_all_files ();
1862   initialize_current_architecture ();
1863   init_cli_cmds();
1864   init_main ();                 /* But that omits this file!  Do it now */
1865
1866   /* The signal handling mechanism is different depending whether or
1867      not the async version is run. NOTE: in the future we plan to make
1868      the event loop be the default engine of gdb, and this difference
1869      will disappear. */
1870   if (event_loop_p)
1871     async_init_signals ();
1872   else
1873     init_signals ();
1874
1875   /* We need a default language for parsing expressions, so simple things like
1876      "set width 0" won't fail if no language is explicitly set in a config file
1877      or implicitly set by reading an executable during startup. */
1878   set_language (language_c);
1879   expected_language = current_language;         /* don't warn about the change.  */
1880
1881   /* Allow another UI to initialize. If the UI fails to initialize, and
1882      it wants GDB to revert to the CLI, it should clear init_ui_hook. */
1883   if (init_ui_hook)
1884     init_ui_hook (argv0);
1885 }