1 /* Top level stuff for GDB, the GNU debugger.
2 Copyright 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995,
3 1996, 1997, 1998, 1999, 2000, 2001 Free Software Foundation, Inc.
5 This file is part of GDB.
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 2 of the License, or
10 (at your option) any later version.
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.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
24 #include "call-cmds.h"
29 #include "breakpoint.h"
31 #include "expression.h"
34 #include "terminal.h" /* For job_control. */
36 #include "completer.h"
40 /* readline include files */
41 #include <readline/readline.h>
42 #include <readline/history.h>
44 /* readline defines this. */
47 #include <sys/types.h>
51 #include "event-top.h"
52 #include "gdb_string.h"
60 /* From completer.c */
62 extern int is_complete_command (void (*func) (char *args, int from_tty));
64 /* From cli/cli-cmds.c */
66 extern void init_cmd_lists (void);
68 extern void init_cli_cmds (void);
70 extern void execute_user_command (struct cmd_list_element *c, char *args);
72 /* From cli/cli-setshow.c */
74 extern void do_setshow_command (char *, int, struct cmd_list_element *);
76 /* Exported to CLI cli/cli-cmds.c. */
78 void set_verbose (char *, int, struct cmd_list_element *);
80 void show_history (char *, int);
82 void set_history (char *, int);
84 void show_commands (char *, int);
86 void do_restore_instream_cleanup (void *stream);
88 /* Prototypes for local functions */
90 static void dont_repeat_command (char *, int);
92 static void init_signals (void);
95 static void stop_sig (int);
98 static char *readline_line_completion_function (char *, int);
100 static void init_main (void);
102 static void float_handler (int);
104 static void init_signals (void);
106 static void set_history_size_command (char *, int, struct cmd_list_element *);
108 static void do_nothing (int);
111 /* NOTE 1999-04-29: This function will be static again, once we modify
112 gdb to use the event loop as the default command loop and we merge
113 event-top.c into this file, top.c */
114 /* static */ int quit_cover (PTR);
116 static void disconnect (int);
119 /* Default command line prompt. This is overriden in some configs. */
121 #ifndef DEFAULT_PROMPT
122 #define DEFAULT_PROMPT "(gdb) "
125 /* Initialization file name for gdb. This is overridden in some configs. */
127 #ifndef GDBINIT_FILENAME
128 #define GDBINIT_FILENAME ".gdbinit"
130 char gdbinit[] = GDBINIT_FILENAME;
132 int inhibit_gdbinit = 0;
134 /* If nonzero, and GDB has been configured to be able to use windows,
135 attempt to open them upon startup. */
139 extern char lang_frame_mismatch_warn[]; /* language.c */
141 /* Flag for whether we want all the "from_tty" gubbish printed. */
143 int caution = 1; /* Default is yes, sigh. */
145 /* stdio stream that command input is being read from. Set to stdin normally.
146 Set by source_command to the file we are sourcing. Set to NULL if we are
147 executing a user-defined command or interacting via a GUI. */
151 /* Current working directory. */
153 char *current_directory;
155 /* The directory name is actually stored here (usually). */
156 char gdb_dirbuf[1024];
158 /* Function to call before reading a command, if nonzero.
159 The function receives two args: an input stream,
160 and a prompt string. */
162 void (*window_hook) (FILE *, char *);
167 /* gdb prints this when reading a command interactively */
168 static char *gdb_prompt_string; /* the global prompt string */
169 extern char *get_prompt (void); /* access function for prompt string */
171 /* Buffer used for reading command lines, and the size
172 allocated for it so far. */
177 /* Nonzero if the current command is modified by "server ". This
178 affects things like recording into the command history, commands
179 repeating on RETURN, etc. This is so a user interface (emacs, GUI,
180 whatever) can issue its own commands and also send along commands
181 from the user, and have the user not notice that the user interface
182 is issuing commands too. */
185 /* Baud rate specified for talking to serial target systems. Default
186 is left as -1, so targets can choose their own defaults. */
187 /* FIXME: This means that "show remotebaud" and gr_files_info can print -1
188 or (unsigned int)-1. This is a Bad User Interface. */
192 /* Timeout limit for response from target. */
194 /* The default value has been changed many times over the years. It
195 was originally 5 seconds. But that was thought to be a long time
196 to sit and wait, so it was changed to 2 seconds. That was thought
197 to be plenty unless the connection was going through some terminal
198 server or multiplexer or other form of hairy serial connection.
200 In mid-1996, remote_timeout was moved from remote.c to top.c and
201 it began being used in other remote-* targets. It appears that the
202 default was changed to 20 seconds at that time, perhaps because the
203 Hitachi E7000 ICE didn't always respond in a timely manner.
205 But if 5 seconds is a long time to sit and wait for retransmissions,
206 20 seconds is far worse. This demonstrates the difficulty of using
207 a single variable for all protocol timeouts.
209 As remote.c is used much more than remote-e7000.c, it was changed
210 back to 2 seconds in 1999. */
212 int remote_timeout = 2;
214 /* Non-zero tells remote* modules to output debugging info. */
216 int remote_debug = 0;
218 /* Non-zero means the target is running. Note: this is different from
219 saying that there is an active target and we are stopped at a
220 breakpoint, for instance. This is a real indicator whether the
221 target is off and running, which gdb is doing something else. */
222 int target_executing = 0;
224 /* Level of control structure. */
225 static int control_level;
227 /* Structure for arguments to user defined functions. */
228 #define MAXUSERARGS 10
231 struct user_args *next;
242 /* Signal to catch ^Z typed while reading a command: SIGTSTP or SIGCONT. */
246 #define STOP_SIGNAL SIGTSTP
247 static void stop_sig (int);
251 /* Some System V have job control but not sigsetmask(). */
252 #if !defined (HAVE_SIGSETMASK)
254 #define HAVE_SIGSETMASK 1
256 #define HAVE_SIGSETMASK 0
260 #if 0 == (HAVE_SIGSETMASK)
261 #define sigsetmask(n)
264 /* Hooks for alternate command interfaces. */
266 /* Called after most modules have been initialized, but before taking users
269 void (*init_ui_hook) (char *argv0);
271 /* This hook is called from within gdb's many mini-event loops which could
272 steal control from a real user interface's event loop. It returns
273 non-zero if the user is requesting a detach, zero otherwise. */
275 int (*ui_loop_hook) (int);
277 /* Called instead of command_loop at top level. Can be invoked via
278 return_to_top_level. */
280 void (*command_loop_hook) (void);
283 /* Called from print_frame_info to list the line we stopped in. */
285 void (*print_frame_info_listing_hook) (struct symtab * s, int line,
286 int stopline, int noerror);
287 /* Replaces most of query. */
289 int (*query_hook) (const char *, va_list);
291 /* Replaces most of warning. */
293 void (*warning_hook) (const char *, va_list);
295 /* These three functions support getting lines of text from the user. They
296 are used in sequence. First readline_begin_hook is called with a text
297 string that might be (for example) a message for the user to type in a
298 sequence of commands to be executed at a breakpoint. If this function
299 calls back to a GUI, it might take this opportunity to pop up a text
300 interaction window with this message. Next, readline_hook is called
301 with a prompt that is emitted prior to collecting the user input.
302 It can be called multiple times. Finally, readline_end_hook is called
303 to notify the GUI that we are done with the interaction window and it
306 void (*readline_begin_hook) (char *, ...);
307 char *(*readline_hook) (char *);
308 void (*readline_end_hook) (void);
310 /* Called as appropriate to notify the interface of the specified breakpoint
313 void (*create_breakpoint_hook) (struct breakpoint * bpt);
314 void (*delete_breakpoint_hook) (struct breakpoint * bpt);
315 void (*modify_breakpoint_hook) (struct breakpoint * bpt);
317 /* Called as appropriate to notify the interface that we have attached
318 to or detached from an already running process. */
320 void (*attach_hook) (void);
321 void (*detach_hook) (void);
323 /* Called during long calculations to allow GUI to repair window damage, and to
324 check for stop buttons, etc... */
326 void (*interactive_hook) (void);
328 /* Called when the registers have changed, as a hint to a GUI
329 to minimize window update. */
331 void (*registers_changed_hook) (void);
333 /* Tell the GUI someone changed the register REGNO. -1 means
334 that the caller does not know which register changed or
335 that several registers have changed (see value_assign). */
336 void (*register_changed_hook) (int regno);
338 /* Tell the GUI someone changed LEN bytes of memory at ADDR */
339 void (*memory_changed_hook) (CORE_ADDR addr, int len);
341 /* Called when going to wait for the target. Usually allows the GUI to run
342 while waiting for target events. */
344 ptid_t (*target_wait_hook) (ptid_t ptid,
345 struct target_waitstatus * status);
347 /* Used by UI as a wrapper around command execution. May do various things
348 like enabling/disabling buttons, etc... */
350 void (*call_command_hook) (struct cmd_list_element * c, char *cmd,
353 /* Called after a `set' command has finished. Is only run if the
354 `set' command succeeded. */
356 void (*set_hook) (struct cmd_list_element * c);
358 /* Called when the current thread changes. Argument is thread id. */
360 void (*context_hook) (int id);
362 /* Takes control from error (). Typically used to prevent longjmps out of the
363 middle of the GUI. Usually used in conjunction with a catch routine. */
365 NORETURN void (*error_hook) (void) ATTR_NORETURN;
368 /* One should use catch_errors rather than manipulating these
370 #if defined(HAVE_SIGSETJMP)
371 #define SIGJMP_BUF sigjmp_buf
372 #define SIGSETJMP(buf) sigsetjmp(buf, 1)
373 #define SIGLONGJMP(buf,val) siglongjmp(buf,val)
375 #define SIGJMP_BUF jmp_buf
376 #define SIGSETJMP(buf) setjmp(buf)
377 #define SIGLONGJMP(buf,val) longjmp(buf,val)
380 /* Where to go for return_to_top_level. */
381 static SIGJMP_BUF *catch_return;
383 /* Return for reason REASON to the nearest containing catch_errors(). */
386 return_to_top_level (enum return_reason reason)
391 /* Perhaps it would be cleaner to do this via the cleanup chain (not sure
392 I can think of a reason why that is vital, though). */
393 bpstat_clear_actions (stop_bpstat); /* Clear queued breakpoint commands */
395 disable_current_display ();
396 do_cleanups (ALL_CLEANUPS);
397 if (event_loop_p && target_can_async_p () && !target_executing)
398 do_exec_cleanups (ALL_CLEANUPS);
399 if (event_loop_p && sync_execution)
400 do_exec_error_cleanups (ALL_CLEANUPS);
402 if (annotation_level > 1)
413 /* Jump to the containing catch_errors() call, communicating REASON
414 to that call via setjmp's return value. Note that REASON can't
415 be zero, by definition in defs.h. */
417 (NORETURN void) SIGLONGJMP (*catch_return, (int) reason);
420 /* Call FUNC with arg ARGS, catching any errors. If there is no
421 error, return the value returned by FUNC. If there is an error,
422 print ERRSTRING, print the specific error message, then return
425 Must not be called with immediate_quit in effect (bad things might
426 happen, say we got a signal in the middle of a memcpy to quit_return).
427 This is an OK restriction; with very few exceptions immediate_quit can
428 be replaced by judicious use of QUIT.
430 MASK specifies what to catch; it is normally set to
431 RETURN_MASK_ALL, if for no other reason than that the code which
432 calls catch_errors might not be set up to deal with a quit which
433 isn't caught. But if the code can deal with it, it generally
434 should be RETURN_MASK_ERROR, unless for some reason it is more
435 useful to abort only the portion of the operation inside the
436 catch_errors. Note that quit should return to the command line
437 fairly quickly, even if some further processing is being done. */
439 /* MAYBE: cagney/1999-11-05: catch_errors() in conjunction with
440 error() et.al. could maintain a set of flags that indicate the the
441 current state of each of the longjmp buffers. This would give the
442 longjmp code the chance to detect a longjmp botch (before it gets
443 to longjmperror()). Prior to 1999-11-05 this wasn't possible as
444 code also randomly used a SET_TOP_LEVEL macro that directly
445 initialize the longjmp buffers. */
447 /* MAYBE: cagney/1999-11-05: Should the catch_errors and cleanups code
448 be consolidated into a single file instead of being distributed
449 between utils.c and top.c? */
452 catch_errors (catch_errors_ftype *func, PTR args, char *errstring,
455 SIGJMP_BUF *saved_catch;
458 struct cleanup *saved_cleanup_chain;
459 char *saved_error_pre_print;
460 char *saved_quit_pre_print;
462 /* Return value from SIGSETJMP(): enum return_reason if error or
463 quit caught, 0 otherwise. */
466 /* Override error/quit messages during FUNC. */
468 saved_error_pre_print = error_pre_print;
469 saved_quit_pre_print = quit_pre_print;
471 if (mask & RETURN_MASK_ERROR)
472 error_pre_print = errstring;
473 if (mask & RETURN_MASK_QUIT)
474 quit_pre_print = errstring;
476 /* Prevent error/quit during FUNC from calling cleanups established
479 saved_cleanup_chain = save_cleanups ();
481 /* Call FUNC, catching error/quit events. */
483 saved_catch = catch_return;
484 catch_return = &catch;
485 caught = SIGSETJMP (catch);
487 val = (*func) (args);
490 catch_return = saved_catch;
492 /* FIXME: cagney/1999-11-05: A correct FUNC implementation will
493 clean things up (restoring the cleanup chain) to the state they
494 were just prior to the call. Unfortunately, many FUNC's are not
495 that well behaved. This could be fixed by adding either a
496 do_cleanups call (to cover the problem) or an assertion check to
497 detect bad FUNCs code. */
499 /* Restore the cleanup chain and error/quit messages to their
502 restore_cleanups (saved_cleanup_chain);
504 if (mask & RETURN_MASK_QUIT)
505 quit_pre_print = saved_quit_pre_print;
506 if (mask & RETURN_MASK_ERROR)
507 error_pre_print = saved_error_pre_print;
509 /* Return normally if no error/quit event occurred. */
514 /* If the caller didn't request that the event be caught, relay the
515 event to the next containing catch_errors(). */
517 if (!(mask & RETURN_MASK (caught)))
518 return_to_top_level (caught);
520 /* Tell the caller that an event was caught.
522 FIXME: nsd/2000-02-22: When MASK is RETURN_MASK_ALL, the caller
523 can't tell what type of event occurred.
525 A possible fix is to add a new interface, catch_event(), that
526 returns enum return_reason after catching an error or a quit.
528 When returning normally, i.e. without catching an error or a
529 quit, catch_event() could return RETURN_NORMAL, which would be
530 added to enum return_reason. FUNC would return information
531 exclusively via ARGS.
533 Alternatively, normal catch_event() could return FUNC's return
534 value. The caller would need to be aware of potential overlap
535 with enum return_reason, which could be publicly restricted to
536 negative values to simplify return value processing in FUNC and
542 struct captured_command_args
544 catch_command_errors_ftype *command;
550 do_captured_command (void *data)
552 struct captured_command_args *context = data;
553 context->command (context->arg, context->from_tty);
554 /* FIXME: cagney/1999-11-07: Technically this do_cleanups() call
555 isn't needed. Instead an assertion check could be made that
556 simply confirmed that the called function correctly cleaned up
557 after itself. Unfortunately, old code (prior to 1999-11-04) in
558 main.c was calling SET_TOP_LEVEL(), calling the command function,
559 and then *always* calling do_cleanups(). For the moment we
560 remain ``bug compatible'' with that old code.. */
561 do_cleanups (ALL_CLEANUPS);
566 catch_command_errors (catch_command_errors_ftype * command,
567 char *arg, int from_tty, return_mask mask)
569 struct captured_command_args args;
570 args.command = command;
572 args.from_tty = from_tty;
573 return catch_errors (do_captured_command, &args, "", mask);
577 /* Handler for SIGHUP. */
581 disconnect (int signo)
583 catch_errors (quit_cover, NULL,
584 "Could not kill the program being debugged", RETURN_MASK_ALL);
585 signal (SIGHUP, SIG_DFL);
586 kill (getpid (), SIGHUP);
589 /* Just a little helper function for disconnect(). */
591 /* NOTE 1999-04-29: This function 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 */
597 caution = 0; /* Throw caution to the wind -- we're exiting.
598 This prevents asking the user dumb questions. */
599 quit_command ((char *) 0, 0);
602 #endif /* defined SIGHUP */
604 /* Line number we are currently in in a file which is being sourced. */
605 /* NOTE 1999-04-29: This variable will be static again, once we modify
606 gdb to use the event loop as the default command loop and we merge
607 event-top.c into this file, top.c */
608 /* static */ int source_line_number;
610 /* Name of the file we are sourcing. */
611 /* NOTE 1999-04-29: This variable will be static again, once we modify
612 gdb to use the event loop as the default command loop and we merge
613 event-top.c into this file, top.c */
614 /* static */ char *source_file_name;
616 /* Buffer containing the error_pre_print used by the source stuff.
618 /* NOTE 1999-04-29: This variable will be static again, once we modify
619 gdb to use the event loop as the default command loop and we merge
620 event-top.c into this file, top.c */
621 /* static */ char *source_error;
622 static int source_error_allocated;
624 /* Something to glom on to the start of error_pre_print if source_file_name
626 /* NOTE 1999-04-29: This variable will be static again, once we modify
627 gdb to use the event loop as the default command loop and we merge
628 event-top.c into this file, top.c */
629 /* static */ char *source_pre_error;
631 /* Clean up on error during a "source" command (or execution of a
632 user-defined command). */
635 do_restore_instream_cleanup (void *stream)
637 /* Restore the previous input stream. */
641 /* Read commands from STREAM. */
643 read_command_file (FILE *stream)
645 struct cleanup *cleanups;
647 cleanups = make_cleanup (do_restore_instream_cleanup, instream);
650 do_cleanups (cleanups);
653 extern void init_proc (void);
655 void (*pre_init_ui_hook) (void);
659 do_chdir_cleanup (void *old_dir)
667 gdb_init (char *argv0)
669 if (pre_init_ui_hook)
672 /* Run the init function of each source file */
674 getcwd (gdb_dirbuf, sizeof (gdb_dirbuf));
675 current_directory = gdb_dirbuf;
678 /* Make sure we return to the original directory upon exit, come
679 what may, since the OS doesn't do that for us. */
680 make_final_cleanup (do_chdir_cleanup, xstrdup (current_directory));
683 init_cmd_lists (); /* This needs to be done first */
684 initialize_targets (); /* Setup target_terminal macros for utils.c */
685 initialize_utils (); /* Make errors and warnings possible */
686 initialize_all_files ();
687 initialize_current_architecture ();
689 init_main (); /* But that omits this file! Do it now */
691 /* The signal handling mechanism is different depending whether or
692 not the async version is run. NOTE: in the future we plan to make
693 the event loop be the default engine of gdb, and this difference
696 async_init_signals ();
700 /* We need a default language for parsing expressions, so simple things like
701 "set width 0" won't fail if no language is explicitly set in a config file
702 or implicitly set by reading an executable during startup. */
703 set_language (language_c);
704 expected_language = current_language; /* don't warn about the change. */
707 /* Install the default UI */
710 uiout = cli_out_new (gdb_stdout);
712 /* All the interpreters should have had a look at things by now.
713 Initialize the selected interpreter. */
716 fprintf_unfiltered (gdb_stderr, "Interpreter `%s' unrecognized.\n",
724 init_ui_hook (argv0);
727 /* Execute the line P as a command.
728 Pass FROM_TTY as second argument to the defining function. */
731 execute_command (char *p, int from_tty)
733 register struct cmd_list_element *c;
734 register enum language flang;
735 static int warned = 0;
737 /* FIXME: These should really be in an appropriate header file */
738 extern void serial_log_command (const char *);
742 /* Force cleanup of any alloca areas if using C alloca instead of
746 /* This can happen when command_line_input hits end of file. */
750 serial_log_command (p);
752 while (*p == ' ' || *p == '\t')
759 c = lookup_cmd (&p, cmdlist, "", 0, 1);
761 /* If the target is running, we allow only a limited set of
763 if (event_loop_p && target_can_async_p () && target_executing)
764 if (!strcmp (c->name, "help")
765 && !strcmp (c->name, "pwd")
766 && !strcmp (c->name, "show")
767 && !strcmp (c->name, "stop"))
768 error ("Cannot execute this command while the target is running.");
770 /* Pass null arg rather than an empty one. */
773 /* Clear off trailing whitespace, except for set and complete command. */
775 && c->type != set_cmd
776 && !is_complete_command (c->function.cfunc))
778 p = arg + strlen (arg) - 1;
779 while (p >= arg && (*p == ' ' || *p == '\t'))
784 /* If this command has been pre-hooked, run the hook first. */
785 if ((c->hook_pre) && (!c->hook_in))
787 c->hook_in = 1; /* Prevent recursive hooking */
788 execute_user_command (c->hook_pre, (char *) 0);
789 c->hook_in = 0; /* Allow hook to work again once it is complete */
792 if (c->flags & DEPRECATED_WARN_USER)
793 deprecated_cmd_warning (&line);
795 if (c->class == class_user)
796 execute_user_command (c, arg);
797 else if (c->type == set_cmd || c->type == show_cmd)
798 do_setshow_command (arg, from_tty & caution, c);
799 else if (c->function.cfunc == NO_FUNCTION)
800 error ("That is not a command, just a help topic.");
801 else if (call_command_hook)
802 call_command_hook (c, arg, from_tty & caution);
804 (*c->function.cfunc) (arg, from_tty & caution);
806 /* If this command has been post-hooked, run the hook last. */
807 if ((c->hook_post) && (!c->hook_in))
809 c->hook_in = 1; /* Prevent recursive hooking */
810 execute_user_command (c->hook_post, (char *) 0);
811 c->hook_in = 0; /* allow hook to work again once it is complete */
816 /* Tell the user if the language has changed (except first time). */
817 if (current_language != expected_language)
819 if (language_mode == language_mode_auto)
821 language_info (1); /* Print what changed. */
826 /* Warn the user if the working language does not match the
827 language of the current frame. Only warn the user if we are
828 actually running the program, i.e. there is a stack. */
829 /* FIXME: This should be cacheing the frame and only running when
830 the frame changes. */
832 if (target_has_stack)
834 flang = get_frame_language ();
836 && flang != language_unknown
837 && flang != current_language->la_language)
839 printf_filtered ("%s\n", lang_frame_mismatch_warn);
845 /* Read commands from `instream' and execute them
846 until end of file or error reading instream. */
851 struct cleanup *old_chain;
853 int stdin_is_tty = ISATTY (stdin);
854 long time_at_cmd_start;
856 long space_at_cmd_start = 0;
858 extern int display_time;
859 extern int display_space;
861 while (instream && !feof (instream))
864 extern int insert_mode;
866 if (window_hook && instream == stdin)
867 (*window_hook) (instream, get_prompt ());
870 if (instream == stdin && stdin_is_tty)
871 reinitialize_more_filter ();
872 old_chain = make_cleanup (null_cleanup, 0);
875 /* A bit of paranoia: I want to make sure the "insert_mode" global
876 * is clear except when it is being used for command-line editing
877 * (see tuiIO.c, utils.c); otherwise normal output will
878 * get messed up in the TUI. So clear it before/after
879 * the command-line-input call. - RT
883 /* Get a command-line. This calls the readline package. */
884 command = command_line_input (instream == stdin ?
885 get_prompt () : (char *) NULL,
886 instream == stdin, "prompt");
893 time_at_cmd_start = get_run_time ();
898 extern char **environ;
899 char *lim = (char *) sbrk (0);
901 space_at_cmd_start = (long) (lim - (char *) &environ);
905 execute_command (command, instream == stdin);
906 /* Do any commands attached to breakpoint we stopped at. */
907 bpstat_do_actions (&stop_bpstat);
908 do_cleanups (old_chain);
912 long cmd_time = get_run_time () - time_at_cmd_start;
914 printf_unfiltered ("Command execution time: %ld.%06ld\n",
915 cmd_time / 1000000, cmd_time % 1000000);
921 extern char **environ;
922 char *lim = (char *) sbrk (0);
923 long space_now = lim - (char *) &environ;
924 long space_diff = space_now - space_at_cmd_start;
926 printf_unfiltered ("Space used: %ld (%c%ld for this command)\n",
928 (space_diff >= 0 ? '+' : '-'),
935 /* Read commands from `instream' and execute them until end of file or
936 error reading instream. This command loop doesnt care about any
937 such things as displaying time and space usage. If the user asks
938 for those, they won't work. */
940 simplified_command_loop (char *(*read_input_func) (char *),
941 void (*execute_command_func) (char *, int))
943 struct cleanup *old_chain;
945 int stdin_is_tty = ISATTY (stdin);
947 while (instream && !feof (instream))
950 if (instream == stdin && stdin_is_tty)
951 reinitialize_more_filter ();
952 old_chain = make_cleanup (null_cleanup, 0);
954 /* Get a command-line. */
955 command = (*read_input_func) (instream == stdin ?
956 get_prompt () : (char *) NULL);
961 (*execute_command_func) (command, instream == stdin);
963 /* Do any commands attached to breakpoint we stopped at. */
964 bpstat_do_actions (&stop_bpstat);
966 do_cleanups (old_chain);
970 /* Commands call this if they do not want to be repeated by null lines. */
978 /* If we aren't reading from standard input, we are saving the last
979 thing read from stdin in line and don't want to delete it. Null lines
980 won't repeat here in any case. */
981 if (instream == stdin)
985 /* Read a line from the stream "instream" without command line editing.
987 It prints PROMPT_ARG once at the start.
988 Action is compatible with "readline", e.g. space for the result is
989 malloc'd and should be freed by the caller.
991 A NULL return means end of file. */
993 gdb_readline (char *prompt_arg)
998 int result_size = 80;
1002 /* Don't use a _filtered function here. It causes the assumed
1003 character position to be off, since the newline we read from
1004 the user is not accounted for. */
1005 fputs_unfiltered (prompt_arg, gdb_stdout);
1006 /* OBSOLETE #ifdef MPW */
1007 /* OBSOLETE Move to a new line so the entered line doesn't have a prompt */
1008 /* OBSOLETE on the front of it. */
1009 /* OBSOLETE fputs_unfiltered ("\n", gdb_stdout); */
1010 /* OBSOLETE #endif *//* MPW */
1011 gdb_flush (gdb_stdout);
1014 result = (char *) xmalloc (result_size);
1018 /* Read from stdin if we are executing a user defined command.
1019 This is the right thing for prompt_for_continue, at least. */
1020 c = fgetc (instream ? instream : stdin);
1024 if (input_index > 0)
1025 /* The last line does not end with a newline. Return it, and
1026 if we are called again fgetc will still return EOF and
1027 we'll return NULL then. */
1034 #ifndef CRLF_SOURCE_FILES
1038 if (input_index > 0 && result[input_index - 1] == '\r')
1044 result[input_index++] = c;
1045 while (input_index >= result_size)
1048 result = (char *) xrealloc (result, result_size);
1052 result[input_index++] = '\0';
1056 /* Variables which control command line editing and history
1057 substitution. These variables are given default values at the end
1059 static int command_editing_p;
1060 /* NOTE 1999-04-29: This variable will be static again, once we modify
1061 gdb to use the event loop as the default command loop and we merge
1062 event-top.c into this file, top.c */
1063 /* static */ int history_expansion_p;
1064 static int write_history_p;
1065 static int history_size;
1066 static char *history_filename;
1068 /* Functions that are used as part of the fancy command line editing. */
1070 /* This can be used for functions which don't want to complete on symbols
1071 but don't want to complete on anything else either. */
1074 noop_completer (char *text, char *prefix)
1079 /* Line completion interface function for readline. */
1082 readline_line_completion_function (char *text, int matches)
1084 return line_completion_function (text, matches, rl_line_buffer, rl_point);
1089 stop_sig (int signo)
1091 #if STOP_SIGNAL == SIGTSTP
1092 signal (SIGTSTP, SIG_DFL);
1094 kill (getpid (), SIGTSTP);
1095 signal (SIGTSTP, stop_sig);
1097 signal (STOP_SIGNAL, stop_sig);
1099 printf_unfiltered ("%s", get_prompt ());
1100 gdb_flush (gdb_stdout);
1102 /* Forget about any previous command -- null line now will do nothing. */
1105 #endif /* STOP_SIGNAL */
1107 /* Initialize signal handlers. */
1109 do_nothing (int signo)
1111 /* Under System V the default disposition of a signal is reinstated after
1112 the signal is caught and delivered to an application process. On such
1113 systems one must restore the replacement signal handler if one wishes
1114 to continue handling the signal in one's program. On BSD systems this
1115 is not needed but it is harmless, and it simplifies the code to just do
1116 it unconditionally. */
1117 signal (signo, do_nothing);
1123 signal (SIGINT, request_quit);
1125 /* If SIGTRAP was set to SIG_IGN, then the SIG_IGN will get passed
1126 to the inferior and breakpoints will be ignored. */
1128 signal (SIGTRAP, SIG_DFL);
1131 /* If we initialize SIGQUIT to SIG_IGN, then the SIG_IGN will get
1132 passed to the inferior, which we don't want. It would be
1133 possible to do a "signal (SIGQUIT, SIG_DFL)" after we fork, but
1134 on BSD4.3 systems using vfork, that can affect the
1135 GDB process as well as the inferior (the signal handling tables
1136 might be in memory, shared between the two). Since we establish
1137 a handler for SIGQUIT, when we call exec it will set the signal
1138 to SIG_DFL for us. */
1139 signal (SIGQUIT, do_nothing);
1141 if (signal (SIGHUP, do_nothing) != SIG_IGN)
1142 signal (SIGHUP, disconnect);
1144 signal (SIGFPE, float_handler);
1146 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1147 signal (SIGWINCH, SIGWINCH_HANDLER);
1151 /* Read one line from the command input stream `instream'
1152 into the local static buffer `linebuffer' (whose current length
1154 The buffer is made bigger as necessary.
1155 Returns the address of the start of the line.
1157 NULL is returned for end of file.
1159 *If* the instream == stdin & stdin is a terminal, the line read
1160 is copied into the file line saver (global var char *line,
1161 length linesize) so that it can be duplicated.
1163 This routine either uses fancy command line editing or
1164 simple input as the user has requested. */
1167 command_line_input (char *prompt_arg, int repeat, char *annotation_suffix)
1169 static char *linebuffer = 0;
1170 static unsigned linelength = 0;
1174 char *local_prompt = prompt_arg;
1178 /* The annotation suffix must be non-NULL. */
1179 if (annotation_suffix == NULL)
1180 annotation_suffix = "";
1182 if (annotation_level > 1 && instream == stdin)
1184 local_prompt = alloca ((prompt_arg == NULL ? 0 : strlen (prompt_arg))
1185 + strlen (annotation_suffix) + 40);
1186 if (prompt_arg == NULL)
1187 local_prompt[0] = '\0';
1189 strcpy (local_prompt, prompt_arg);
1190 strcat (local_prompt, "\n\032\032");
1191 strcat (local_prompt, annotation_suffix);
1192 strcat (local_prompt, "\n");
1195 if (linebuffer == 0)
1198 linebuffer = (char *) xmalloc (linelength);
1203 /* Control-C quits instantly if typed while in this loop
1204 since it should not wait until the user types a newline. */
1210 signal (STOP_SIGNAL, handle_stop_sig);
1212 signal (STOP_SIGNAL, stop_sig);
1218 /* Make sure that all output has been output. Some machines may let
1219 you get away with leaving out some of the gdb_flush, but not all. */
1221 gdb_flush (gdb_stdout);
1222 gdb_flush (gdb_stderr);
1224 if (source_file_name != NULL)
1226 ++source_line_number;
1227 sprintf (source_error,
1228 "%s%s:%d: Error in sourced command file:\n",
1231 source_line_number);
1232 error_pre_print = source_error;
1235 if (annotation_level > 1 && instream == stdin)
1237 printf_unfiltered ("\n\032\032pre-");
1238 printf_unfiltered (annotation_suffix);
1239 printf_unfiltered ("\n");
1242 /* Don't use fancy stuff if not talking to stdin. */
1243 if (readline_hook && instream == NULL)
1245 rl = (*readline_hook) (local_prompt);
1247 else if (command_editing_p && instream == stdin && ISATTY (instream))
1249 rl = readline (local_prompt);
1253 rl = gdb_readline (local_prompt);
1256 if (annotation_level > 1 && instream == stdin)
1258 printf_unfiltered ("\n\032\032post-");
1259 printf_unfiltered (annotation_suffix);
1260 printf_unfiltered ("\n");
1263 if (!rl || rl == (char *) EOF)
1268 if (strlen (rl) + 1 + (p - linebuffer) > linelength)
1270 linelength = strlen (rl) + 1 + (p - linebuffer);
1271 nline = (char *) xrealloc (linebuffer, linelength);
1272 p += nline - linebuffer;
1276 /* Copy line. Don't copy null at end. (Leaves line alone
1277 if this was just a newline) */
1281 xfree (rl); /* Allocated in readline. */
1283 if (p == linebuffer || *(p - 1) != '\\')
1286 p--; /* Put on top of '\'. */
1287 local_prompt = (char *) 0;
1292 signal (STOP_SIGNAL, SIG_DFL);
1299 #define SERVER_COMMAND_LENGTH 7
1301 (p - linebuffer > SERVER_COMMAND_LENGTH)
1302 && STREQN (linebuffer, "server ", SERVER_COMMAND_LENGTH);
1305 /* Note that we don't set `line'. Between this and the check in
1306 dont_repeat, this insures that repeating will still do the
1309 return linebuffer + SERVER_COMMAND_LENGTH;
1312 /* Do history expansion if that is wished. */
1313 if (history_expansion_p && instream == stdin
1314 && ISATTY (instream))
1316 char *history_value;
1319 *p = '\0'; /* Insert null now. */
1320 expanded = history_expand (linebuffer, &history_value);
1323 /* Print the changes. */
1324 printf_unfiltered ("%s\n", history_value);
1326 /* If there was an error, call this function again. */
1329 xfree (history_value);
1330 return command_line_input (prompt_arg, repeat, annotation_suffix);
1332 if (strlen (history_value) > linelength)
1334 linelength = strlen (history_value) + 1;
1335 linebuffer = (char *) xrealloc (linebuffer, linelength);
1337 strcpy (linebuffer, history_value);
1338 p = linebuffer + strlen (linebuffer);
1339 xfree (history_value);
1343 /* If we just got an empty line, and that is supposed
1344 to repeat the previous command, return the value in the
1346 if (repeat && p == linebuffer)
1348 for (p1 = linebuffer; *p1 == ' ' || *p1 == '\t'; p1++);
1354 /* Add line to history if appropriate. */
1355 if (instream == stdin
1356 && ISATTY (stdin) && *linebuffer)
1357 add_history (linebuffer);
1359 /* Note: lines consisting solely of comments are added to the command
1360 history. This is useful when you type a command, and then
1361 realize you don't want to execute it quite yet. You can comment
1362 out the command and then later fetch it from the value history
1363 and remove the '#'. The kill ring is probably better, but some
1364 people are in the habit of commenting things out. */
1366 *p1 = '\0'; /* Found a comment. */
1368 /* Save into global buffer if appropriate. */
1371 if (linelength > linesize)
1373 line = xrealloc (line, linelength);
1374 linesize = linelength;
1376 strcpy (line, linebuffer);
1383 /* Print the GDB banner. */
1385 print_gdb_version (struct ui_file *stream)
1387 /* From GNU coding standards, first line is meant to be easy for a
1388 program to parse, and is just canonical program name and version
1389 number, which starts after last space. */
1392 /* Print it console style until a format is defined */
1393 fprintf_filtered (stream, "GNU gdb %s (MI_OUT)\n", version);
1395 fprintf_filtered (stream, "GNU gdb %s\n", version);
1398 /* Second line is a copyright notice. */
1400 fprintf_filtered (stream, "Copyright 2001 Free Software Foundation, Inc.\n");
1402 /* Following the copyright is a brief statement that the program is
1403 free software, that users are free to copy and change it on
1404 certain conditions, that it is covered by the GNU GPL, and that
1405 there is no warranty. */
1407 fprintf_filtered (stream, "\
1408 GDB is free software, covered by the GNU General Public License, and you are\n\
1409 welcome to change it and/or distribute copies of it under certain conditions.\n\
1410 Type \"show copying\" to see the conditions.\n\
1411 There is absolutely no warranty for GDB. Type \"show warranty\" for details.\n");
1413 /* After the required info we print the configuration information. */
1415 fprintf_filtered (stream, "This GDB was configured as \"");
1416 if (!STREQ (host_name, target_name))
1418 fprintf_filtered (stream, "--host=%s --target=%s", host_name, target_name);
1422 fprintf_filtered (stream, "%s", host_name);
1424 fprintf_filtered (stream, "\".");
1427 /* get_prompt: access method for the GDB prompt string. */
1429 #define MAX_PROMPT_SIZE 256
1432 * int get_prompt_1 (char * buf);
1434 * Work-horse for get_prompt (called via catch_errors).
1435 * Argument is buffer to hold the formatted prompt.
1437 * Returns: 1 for success (use formatted prompt)
1438 * 0 for failure (use gdb_prompt_string).
1441 static int gdb_prompt_escape;
1444 get_prompt_1 (void *data)
1446 char *formatted_prompt = data;
1450 local_prompt = PROMPT (0);
1452 local_prompt = gdb_prompt_string;
1455 if (gdb_prompt_escape == 0)
1457 return 0; /* do no formatting */
1460 /* formatted prompt */
1462 char fmt[40], *promptp, *outp, *tmp;
1469 struct type *arg_type, *elt_type;
1471 promptp = local_prompt;
1472 outp = formatted_prompt;
1474 while (*promptp != '\0')
1476 int available = MAX_PROMPT_SIZE - (outp - formatted_prompt) - 1;
1478 if (*promptp != gdb_prompt_escape)
1480 if (available >= 1) /* overflow protect */
1481 *outp++ = *promptp++;
1485 /* GDB prompt string contains escape char. Parse for arg.
1486 Two consecutive escape chars followed by arg followed by
1487 a comma means to insert the arg using a default format.
1488 Otherwise a printf format string may be included between
1489 the two escape chars. eg:
1490 %%foo, insert foo using default format
1491 %2.2f%foo, insert foo using "%2.2f" format
1492 A mismatch between the format string and the data type
1493 of "foo" is an error (which we don't know how to protect
1496 fmt[0] = '\0'; /* assume null format string */
1497 if (promptp[1] == gdb_prompt_escape) /* double esc char */
1499 promptp += 2; /* skip past two escape chars. */
1503 /* extract format string from between two esc chars */
1507 fmt[i++] = *promptp++; /* copy format string */
1509 while (i < sizeof (fmt) - 1 &&
1510 *promptp != gdb_prompt_escape &&
1513 if (*promptp != gdb_prompt_escape)
1514 error ("Syntax error at prompt position %d",
1515 promptp - local_prompt);
1518 promptp++; /* skip second escape char */
1519 fmt[i++] = '\0'; /* terminate the format string */
1523 arg_val = parse_to_comma_and_eval (&promptp);
1524 if (*promptp == ',')
1525 promptp++; /* skip past the comma */
1526 arg_type = check_typedef (VALUE_TYPE (arg_val));
1527 switch (TYPE_CODE (arg_type))
1529 case TYPE_CODE_ARRAY:
1530 elt_type = check_typedef (TYPE_TARGET_TYPE (arg_type));
1531 if (TYPE_LENGTH (arg_type) > 0 &&
1532 TYPE_LENGTH (elt_type) == 1 &&
1533 TYPE_CODE (elt_type) == TYPE_CODE_INT)
1535 int len = TYPE_LENGTH (arg_type);
1537 if (VALUE_LAZY (arg_val))
1538 value_fetch_lazy (arg_val);
1539 tmp = VALUE_CONTENTS (arg_val);
1541 if (len > available)
1542 len = available; /* overflow protect */
1544 /* FIXME: how to protect GDB from crashing
1545 from bad user-supplied format string? */
1547 sprintf (outp, fmt, tmp);
1549 strncpy (outp, tmp, len);
1554 elt_type = check_typedef (TYPE_TARGET_TYPE (arg_type));
1555 addrval = value_as_pointer (arg_val);
1557 if (TYPE_LENGTH (elt_type) == 1 &&
1558 TYPE_CODE (elt_type) == TYPE_CODE_INT &&
1561 /* display it as a string */
1562 char *default_fmt = "%s";
1566 /* Limiting the number of bytes that the following call
1567 will read protects us from sprintf overflow later. */
1568 i = target_read_string (addrval, /* src */
1570 available, /* len */
1572 if (err) /* read failed */
1573 error ("%s on target_read", safe_strerror (err));
1575 tmp[i] = '\0'; /* force-terminate string */
1576 /* FIXME: how to protect GDB from crashing
1577 from bad user-supplied format string? */
1578 sprintf (outp, fmt[0] == 0 ? default_fmt : fmt,
1584 /* display it as a pointer */
1585 char *default_fmt = "0x%x";
1587 /* FIXME: how to protect GDB from crashing
1588 from bad user-supplied format string? */
1589 if (available >= 16 /*? */ ) /* overflow protect */
1590 sprintf (outp, fmt[0] == 0 ? default_fmt : fmt,
1596 char *default_fmt = "%g";
1598 doubleval = value_as_double (arg_val);
1599 /* FIXME: how to protect GDB from crashing
1600 from bad user-supplied format string? */
1601 if (available >= 16 /*? */ ) /* overflow protect */
1602 sprintf (outp, fmt[0] == 0 ? default_fmt : fmt,
1603 (double) doubleval);
1608 char *default_fmt = "%d";
1610 longval = value_as_long (arg_val);
1611 /* FIXME: how to protect GDB from crashing
1612 from bad user-supplied format string? */
1613 if (available >= 16 /*? */ ) /* overflow protect */
1614 sprintf (outp, fmt[0] == 0 ? default_fmt : fmt,
1618 case TYPE_CODE_BOOL:
1620 /* no default format for bool */
1621 longval = value_as_long (arg_val);
1622 if (available >= 8 /*? */ ) /* overflow protect */
1625 strcpy (outp, "<true>");
1627 strcpy (outp, "<false>");
1631 case TYPE_CODE_ENUM:
1633 /* no default format for enum */
1634 longval = value_as_long (arg_val);
1635 len = TYPE_NFIELDS (arg_type);
1636 /* find enum name if possible */
1637 for (i = 0; i < len; i++)
1638 if (TYPE_FIELD_BITPOS (arg_type, i) == longval)
1639 break; /* match -- end loop */
1641 if (i < len) /* enum name found */
1643 char *name = TYPE_FIELD_NAME (arg_type, i);
1645 strncpy (outp, name, available);
1646 /* in casel available < strlen (name), */
1647 outp[available] = '\0';
1651 if (available >= 16 /*? */ ) /* overflow protect */
1652 sprintf (outp, "%ld", (long) longval);
1656 case TYPE_CODE_VOID:
1658 break; /* void type -- no output */
1660 error ("bad data type at prompt position %d",
1661 promptp - local_prompt);
1664 outp += strlen (outp);
1667 *outp++ = '\0'; /* terminate prompt string */
1675 static char buf[MAX_PROMPT_SIZE];
1677 if (catch_errors (get_prompt_1, buf, "bad formatted prompt: ",
1680 return &buf[0]; /* successful formatted prompt */
1684 /* Prompt could not be formatted. */
1688 return gdb_prompt_string;
1693 set_prompt (char *s)
1695 /* ??rehrauer: I don't know why this fails, since it looks as though
1696 assignments to prompt are wrapped in calls to savestring...
1701 PROMPT (0) = savestring (s, strlen (s));
1703 gdb_prompt_string = savestring (s, strlen (s));
1707 /* If necessary, make the user confirm that we should quit. Return
1708 non-zero if we should quit, zero if we shouldn't. */
1713 if (! ptid_equal (inferior_ptid, null_ptid) && target_has_execution)
1717 /* This is something of a hack. But there's no reliable way to
1718 see if a GUI is running. The `use_windows' variable doesn't
1721 s = "A debugging session is active.\nDo you still want to close the debugger?";
1722 else if (attach_flag)
1723 s = "The program is running. Quit anyway (and detach it)? ";
1725 s = "The program is running. Exit anyway? ";
1734 /* Quit without asking for confirmation. */
1737 quit_force (char *args, int from_tty)
1741 /* An optional expression may be used to cause gdb to terminate with the
1742 value of that expression. */
1745 value_ptr val = parse_and_eval (args);
1747 exit_code = (int) value_as_long (val);
1750 if (! ptid_equal (inferior_ptid, null_ptid) && target_has_execution)
1753 target_detach (args, from_tty);
1758 /* UDI wants this, to kill the TIP. */
1761 /* Save the history information if it is appropriate to do so. */
1762 if (write_history_p && history_filename)
1763 write_history (history_filename);
1765 do_final_cleanups (ALL_CLEANUPS); /* Do any final cleanups before exiting */
1768 /* tuiDo((TuiOpaqueFuncPtr)tuiCleanUp); */
1769 /* The above does not need to be inside a tuiDo(), since
1770 * it is not manipulating the curses screen, but rather,
1771 * it is tearing it down.
1780 /* Returns whether GDB is running on a terminal and whether the user
1781 desires that questions be asked of them on that terminal. */
1784 input_from_terminal_p (void)
1786 return gdb_has_a_terminal () && (instream == stdin) & caution;
1791 dont_repeat_command (char *ignored, int from_tty)
1793 *line = 0; /* Can't call dont_repeat here because we're not
1794 necessarily reading from stdin. */
1797 /* Functions to manipulate command line editing control variables. */
1799 /* Number of commands to print in each call to show_commands. */
1800 #define Hist_print 10
1802 show_commands (char *args, int from_tty)
1804 /* Index for history commands. Relative to history_base. */
1807 /* Number of the history entry which we are planning to display next.
1808 Relative to history_base. */
1811 /* The first command in the history which doesn't exist (i.e. one more
1812 than the number of the last command). Relative to history_base. */
1815 extern HIST_ENTRY *history_get (int);
1817 /* Print out some of the commands from the command history. */
1818 /* First determine the length of the history list. */
1819 hist_len = history_size;
1820 for (offset = 0; offset < history_size; offset++)
1822 if (!history_get (history_base + offset))
1831 if (args[0] == '+' && args[1] == '\0')
1832 /* "info editing +" should print from the stored position. */
1835 /* "info editing <exp>" should print around command number <exp>. */
1836 num = (parse_and_eval_long (args) - history_base) - Hist_print / 2;
1838 /* "show commands" means print the last Hist_print commands. */
1841 num = hist_len - Hist_print;
1847 /* If there are at least Hist_print commands, we want to display the last
1848 Hist_print rather than, say, the last 6. */
1849 if (hist_len - num < Hist_print)
1851 num = hist_len - Hist_print;
1856 for (offset = num; offset < num + Hist_print && offset < hist_len; offset++)
1858 printf_filtered ("%5d %s\n", history_base + offset,
1859 (history_get (history_base + offset))->line);
1862 /* The next command we want to display is the next one that we haven't
1866 /* If the user repeats this command with return, it should do what
1867 "show commands +" does. This is unnecessary if arg is null,
1868 because "show commands +" is not useful after "show commands". */
1869 if (from_tty && args)
1876 /* Called by do_setshow_command. */
1879 set_history_size_command (char *args, int from_tty, struct cmd_list_element *c)
1881 if (history_size == INT_MAX)
1882 unstifle_history ();
1883 else if (history_size >= 0)
1884 stifle_history (history_size);
1887 history_size = INT_MAX;
1888 error ("History size must be non-negative");
1894 set_history (char *args, int from_tty)
1896 printf_unfiltered ("\"set history\" must be followed by the name of a history subcommand.\n");
1897 help_list (sethistlist, "set history ", -1, gdb_stdout);
1902 show_history (char *args, int from_tty)
1904 cmd_show_list (showhistlist, from_tty, "");
1907 int info_verbose = 0; /* Default verbose msgs off */
1909 /* Called by do_setshow_command. An elaborate joke. */
1912 set_verbose (char *args, int from_tty, struct cmd_list_element *c)
1914 char *cmdname = "verbose";
1915 struct cmd_list_element *showcmd;
1917 showcmd = lookup_cmd_1 (&cmdname, showlist, NULL, 1);
1921 c->doc = "Set verbose printing of informational messages.";
1922 showcmd->doc = "Show verbose printing of informational messages.";
1926 c->doc = "Set verbosity.";
1927 showcmd->doc = "Show verbosity.";
1932 float_handler (int signo)
1934 /* This message is based on ANSI C, section 4.7. Note that integer
1935 divide by zero causes this, so "float" is a misnomer. */
1936 signal (SIGFPE, float_handler);
1937 error ("Erroneous arithmetic operation.");
1940 /* Init the history buffer. Note that we are called after the init file(s)
1941 * have been read so that the user can change the history file via his
1942 * .gdbinit file (for instance). The GDBHISTFILE environment variable
1943 * overrides all of this.
1951 tmpenv = getenv ("HISTSIZE");
1953 history_size = atoi (tmpenv);
1954 else if (!history_size)
1957 stifle_history (history_size);
1959 tmpenv = getenv ("GDBHISTFILE");
1961 history_filename = savestring (tmpenv, strlen (tmpenv));
1962 else if (!history_filename)
1964 /* We include the current directory so that if the user changes
1965 directories the file written will be the same as the one
1968 /* No leading dots in file names are allowed on MSDOS. */
1969 history_filename = concat (current_directory, "/_gdb_history", NULL);
1971 history_filename = concat (current_directory, "/.gdb_history", NULL);
1974 read_history (history_filename);
1980 struct cmd_list_element *c;
1982 /* If we are running the asynchronous version,
1983 we initialize the prompts differently. */
1986 gdb_prompt_string = savestring (DEFAULT_PROMPT, strlen (DEFAULT_PROMPT));
1990 /* initialize the prompt stack to a simple "(gdb) " prompt or to
1991 whatever the DEFAULT_PROMPT is. */
1992 the_prompts.top = 0;
1994 PROMPT (0) = savestring (DEFAULT_PROMPT, strlen (DEFAULT_PROMPT));
1996 /* Set things up for annotation_level > 1, if the user ever decides
1998 async_annotation_suffix = "prompt";
1999 /* Set the variable associated with the setshow prompt command. */
2000 new_async_prompt = savestring (PROMPT (0), strlen (PROMPT (0)));
2002 /* If gdb was started with --annotate=2, this is equivalent to
2003 the user entering the command 'set annotate 2' at the gdb
2004 prompt, so we need to do extra processing. */
2005 if (annotation_level > 1)
2006 set_async_annotation_level (NULL, 0, NULL);
2008 gdb_prompt_escape = 0; /* default to none. */
2010 /* Set the important stuff up for command editing. */
2011 command_editing_p = 1;
2012 history_expansion_p = 0;
2013 write_history_p = 0;
2015 /* Setup important stuff for command line editing. */
2016 rl_completion_entry_function = (int (*)()) readline_line_completion_function;
2017 rl_completer_word_break_characters =
2018 get_gdb_completer_word_break_characters ();
2019 rl_completer_quote_characters = get_gdb_completer_quote_characters ();
2020 rl_readline_name = "gdb";
2022 /* The set prompt command is different depending whether or not the
2023 async version is run. NOTE: this difference is going to
2024 disappear as we make the event loop be the default engine of
2029 (add_set_cmd ("prompt", class_support, var_string,
2030 (char *) &gdb_prompt_string, "Set gdb's prompt",
2036 c = add_set_cmd ("prompt", class_support, var_string,
2037 (char *) &new_async_prompt, "Set gdb's prompt",
2039 add_show_from_set (c, &showlist);
2040 c->function.sfunc = set_async_prompt;
2044 (add_set_cmd ("prompt-escape-char", class_support, var_zinteger,
2045 (char *) &gdb_prompt_escape,
2046 "Set escape character for formatting of gdb's prompt",
2050 add_com ("dont-repeat", class_support, dont_repeat_command, "Don't repeat this command.\n\
2051 Primarily used inside of user-defined commands that should not be repeated when\n\
2054 /* The set editing command is different depending whether or not the
2055 async version is run. NOTE: this difference is going to disappear
2056 as we make the event loop be the default engine of gdb. */
2060 (add_set_cmd ("editing", class_support, var_boolean, (char *) &command_editing_p,
2061 "Set editing of command lines as they are typed.\n\
2062 Use \"on\" to enable the editing, and \"off\" to disable it.\n\
2063 Without an argument, command line editing is enabled. To edit, use\n\
2064 EMACS-like or VI-like commands like control-P or ESC.", &setlist),
2069 c = add_set_cmd ("editing", class_support, var_boolean, (char *) &async_command_editing_p,
2070 "Set editing of command lines as they are typed.\n\
2071 Use \"on\" to enable the editing, and \"off\" to disable it.\n\
2072 Without an argument, command line editing is enabled. To edit, use\n\
2073 EMACS-like or VI-like commands like control-P or ESC.", &setlist);
2075 add_show_from_set (c, &showlist);
2076 c->function.sfunc = set_async_editing_command;
2080 (add_set_cmd ("save", no_class, var_boolean, (char *) &write_history_p,
2081 "Set saving of the history record on exit.\n\
2082 Use \"on\" to enable the saving, and \"off\" to disable it.\n\
2083 Without an argument, saving is enabled.", &sethistlist),
2086 c = add_set_cmd ("size", no_class, var_integer, (char *) &history_size,
2087 "Set the size of the command history, \n\
2088 ie. the number of previous commands to keep a record of.", &sethistlist);
2089 add_show_from_set (c, &showhistlist);
2090 c->function.sfunc = set_history_size_command;
2092 c = add_set_cmd ("filename", no_class, var_filename,
2093 (char *) &history_filename,
2094 "Set the filename in which to record the command history\n\
2095 (the list of previous commands of which a record is kept).", &sethistlist);
2096 c->completer = filename_completer;
2097 add_show_from_set (c, &showhistlist);
2100 (add_set_cmd ("confirm", class_support, var_boolean,
2102 "Set whether to confirm potentially dangerous operations.",
2106 /* The set annotate command is different depending whether or not
2107 the async version is run. NOTE: this difference is going to
2108 disappear as we make the event loop be the default engine of
2112 c = add_set_cmd ("annotate", class_obscure, var_zinteger,
2113 (char *) &annotation_level, "Set annotation_level.\n\
2114 0 == normal; 1 == fullname (for use when running under emacs)\n\
2115 2 == output annotated suitably for use by programs that control GDB.",
2117 c = add_show_from_set (c, &showlist);
2121 c = add_set_cmd ("annotate", class_obscure, var_zinteger,
2122 (char *) &annotation_level, "Set annotation_level.\n\
2123 0 == normal; 1 == fullname (for use when running under emacs)\n\
2124 2 == output annotated suitably for use by programs that control GDB.",
2126 add_show_from_set (c, &showlist);
2127 c->function.sfunc = set_async_annotation_level;
2132 (add_set_cmd ("exec-done-display", class_support, var_boolean, (char *) &exec_done_display_p,
2133 "Set notification of completion for asynchronous execution commands.\n\
2134 Use \"on\" to enable the notification, and \"off\" to disable it.", &setlist),