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 /* Signal to catch ^Z typed while reading a command: SIGTSTP or SIGCONT. */
231 #define STOP_SIGNAL SIGTSTP
232 static void stop_sig (int);
236 /* Some System V have job control but not sigsetmask(). */
237 #if !defined (HAVE_SIGSETMASK)
239 #define HAVE_SIGSETMASK 1
241 #define HAVE_SIGSETMASK 0
245 #if 0 == (HAVE_SIGSETMASK)
246 #define sigsetmask(n)
249 /* Hooks for alternate command interfaces. */
251 /* Called after most modules have been initialized, but before taking users
254 void (*init_ui_hook) (char *argv0);
256 /* This hook is called from within gdb's many mini-event loops which could
257 steal control from a real user interface's event loop. It returns
258 non-zero if the user is requesting a detach, zero otherwise. */
260 int (*ui_loop_hook) (int);
262 /* Called instead of command_loop at top level. Can be invoked via
263 return_to_top_level. */
265 void (*command_loop_hook) (void);
268 /* Called from print_frame_info to list the line we stopped in. */
270 void (*print_frame_info_listing_hook) (struct symtab * s, int line,
271 int stopline, int noerror);
272 /* Replaces most of query. */
274 int (*query_hook) (const char *, va_list);
276 /* Replaces most of warning. */
278 void (*warning_hook) (const char *, va_list);
280 /* These three functions support getting lines of text from the user. They
281 are used in sequence. First readline_begin_hook is called with a text
282 string that might be (for example) a message for the user to type in a
283 sequence of commands to be executed at a breakpoint. If this function
284 calls back to a GUI, it might take this opportunity to pop up a text
285 interaction window with this message. Next, readline_hook is called
286 with a prompt that is emitted prior to collecting the user input.
287 It can be called multiple times. Finally, readline_end_hook is called
288 to notify the GUI that we are done with the interaction window and it
291 void (*readline_begin_hook) (char *, ...);
292 char *(*readline_hook) (char *);
293 void (*readline_end_hook) (void);
295 /* Called as appropriate to notify the interface of the specified breakpoint
298 void (*create_breakpoint_hook) (struct breakpoint * bpt);
299 void (*delete_breakpoint_hook) (struct breakpoint * bpt);
300 void (*modify_breakpoint_hook) (struct breakpoint * bpt);
302 /* Called as appropriate to notify the interface that we have attached
303 to or detached from an already running process. */
305 void (*attach_hook) (void);
306 void (*detach_hook) (void);
308 /* Called during long calculations to allow GUI to repair window damage, and to
309 check for stop buttons, etc... */
311 void (*interactive_hook) (void);
313 /* Called when the registers have changed, as a hint to a GUI
314 to minimize window update. */
316 void (*registers_changed_hook) (void);
318 /* Tell the GUI someone changed the register REGNO. -1 means
319 that the caller does not know which register changed or
320 that several registers have changed (see value_assign). */
321 void (*register_changed_hook) (int regno);
323 /* Tell the GUI someone changed LEN bytes of memory at ADDR */
324 void (*memory_changed_hook) (CORE_ADDR addr, int len);
326 /* Called when going to wait for the target. Usually allows the GUI to run
327 while waiting for target events. */
329 ptid_t (*target_wait_hook) (ptid_t ptid,
330 struct target_waitstatus * status);
332 /* Used by UI as a wrapper around command execution. May do various things
333 like enabling/disabling buttons, etc... */
335 void (*call_command_hook) (struct cmd_list_element * c, char *cmd,
338 /* Called after a `set' command has finished. Is only run if the
339 `set' command succeeded. */
341 void (*set_hook) (struct cmd_list_element * c);
343 /* Called when the current thread changes. Argument is thread id. */
345 void (*context_hook) (int id);
347 /* Takes control from error (). Typically used to prevent longjmps out of the
348 middle of the GUI. Usually used in conjunction with a catch routine. */
350 NORETURN void (*error_hook) (void) ATTR_NORETURN;
353 /* One should use catch_errors rather than manipulating these
355 #if defined(HAVE_SIGSETJMP)
356 #define SIGJMP_BUF sigjmp_buf
357 #define SIGSETJMP(buf) sigsetjmp(buf, 1)
358 #define SIGLONGJMP(buf,val) siglongjmp(buf,val)
360 #define SIGJMP_BUF jmp_buf
361 #define SIGSETJMP(buf) setjmp(buf)
362 #define SIGLONGJMP(buf,val) longjmp(buf,val)
365 /* Where to go for return_to_top_level. */
366 static SIGJMP_BUF *catch_return;
368 /* Return for reason REASON to the nearest containing catch_errors(). */
371 return_to_top_level (enum return_reason reason)
376 /* Perhaps it would be cleaner to do this via the cleanup chain (not sure
377 I can think of a reason why that is vital, though). */
378 bpstat_clear_actions (stop_bpstat); /* Clear queued breakpoint commands */
380 disable_current_display ();
381 do_cleanups (ALL_CLEANUPS);
382 if (event_loop_p && target_can_async_p () && !target_executing)
383 do_exec_cleanups (ALL_CLEANUPS);
384 if (event_loop_p && sync_execution)
385 do_exec_error_cleanups (ALL_CLEANUPS);
387 if (annotation_level > 1)
398 /* Jump to the containing catch_errors() call, communicating REASON
399 to that call via setjmp's return value. Note that REASON can't
400 be zero, by definition in defs.h. */
402 (NORETURN void) SIGLONGJMP (*catch_return, (int) reason);
405 /* Call FUNC with arg ARGS, catching any errors. If there is no
406 error, return the value returned by FUNC. If there is an error,
407 print ERRSTRING, print the specific error message, then return
410 Must not be called with immediate_quit in effect (bad things might
411 happen, say we got a signal in the middle of a memcpy to quit_return).
412 This is an OK restriction; with very few exceptions immediate_quit can
413 be replaced by judicious use of QUIT.
415 MASK specifies what to catch; it is normally set to
416 RETURN_MASK_ALL, if for no other reason than that the code which
417 calls catch_errors might not be set up to deal with a quit which
418 isn't caught. But if the code can deal with it, it generally
419 should be RETURN_MASK_ERROR, unless for some reason it is more
420 useful to abort only the portion of the operation inside the
421 catch_errors. Note that quit should return to the command line
422 fairly quickly, even if some further processing is being done. */
424 /* MAYBE: cagney/1999-11-05: catch_errors() in conjunction with
425 error() et.al. could maintain a set of flags that indicate the the
426 current state of each of the longjmp buffers. This would give the
427 longjmp code the chance to detect a longjmp botch (before it gets
428 to longjmperror()). Prior to 1999-11-05 this wasn't possible as
429 code also randomly used a SET_TOP_LEVEL macro that directly
430 initialize the longjmp buffers. */
432 /* MAYBE: cagney/1999-11-05: Should the catch_errors and cleanups code
433 be consolidated into a single file instead of being distributed
434 between utils.c and top.c? */
437 catch_errors (catch_errors_ftype *func, PTR args, char *errstring,
440 SIGJMP_BUF *saved_catch;
443 struct cleanup *saved_cleanup_chain;
444 char *saved_error_pre_print;
445 char *saved_quit_pre_print;
447 /* Return value from SIGSETJMP(): enum return_reason if error or
448 quit caught, 0 otherwise. */
451 /* Override error/quit messages during FUNC. */
453 saved_error_pre_print = error_pre_print;
454 saved_quit_pre_print = quit_pre_print;
456 if (mask & RETURN_MASK_ERROR)
457 error_pre_print = errstring;
458 if (mask & RETURN_MASK_QUIT)
459 quit_pre_print = errstring;
461 /* Prevent error/quit during FUNC from calling cleanups established
464 saved_cleanup_chain = save_cleanups ();
466 /* Call FUNC, catching error/quit events. */
468 saved_catch = catch_return;
469 catch_return = &catch;
470 caught = SIGSETJMP (catch);
472 val = (*func) (args);
475 catch_return = saved_catch;
477 /* FIXME: cagney/1999-11-05: A correct FUNC implementation will
478 clean things up (restoring the cleanup chain) to the state they
479 were just prior to the call. Unfortunately, many FUNC's are not
480 that well behaved. This could be fixed by adding either a
481 do_cleanups call (to cover the problem) or an assertion check to
482 detect bad FUNCs code. */
484 /* Restore the cleanup chain and error/quit messages to their
487 restore_cleanups (saved_cleanup_chain);
489 if (mask & RETURN_MASK_QUIT)
490 quit_pre_print = saved_quit_pre_print;
491 if (mask & RETURN_MASK_ERROR)
492 error_pre_print = saved_error_pre_print;
494 /* Return normally if no error/quit event occurred. */
499 /* If the caller didn't request that the event be caught, relay the
500 event to the next containing catch_errors(). */
502 if (!(mask & RETURN_MASK (caught)))
503 return_to_top_level (caught);
505 /* Tell the caller that an event was caught.
507 FIXME: nsd/2000-02-22: When MASK is RETURN_MASK_ALL, the caller
508 can't tell what type of event occurred.
510 A possible fix is to add a new interface, catch_event(), that
511 returns enum return_reason after catching an error or a quit.
513 When returning normally, i.e. without catching an error or a
514 quit, catch_event() could return RETURN_NORMAL, which would be
515 added to enum return_reason. FUNC would return information
516 exclusively via ARGS.
518 Alternatively, normal catch_event() could return FUNC's return
519 value. The caller would need to be aware of potential overlap
520 with enum return_reason, which could be publicly restricted to
521 negative values to simplify return value processing in FUNC and
527 struct captured_command_args
529 catch_command_errors_ftype *command;
535 do_captured_command (void *data)
537 struct captured_command_args *context = data;
538 context->command (context->arg, context->from_tty);
539 /* FIXME: cagney/1999-11-07: Technically this do_cleanups() call
540 isn't needed. Instead an assertion check could be made that
541 simply confirmed that the called function correctly cleaned up
542 after itself. Unfortunately, old code (prior to 1999-11-04) in
543 main.c was calling SET_TOP_LEVEL(), calling the command function,
544 and then *always* calling do_cleanups(). For the moment we
545 remain ``bug compatible'' with that old code.. */
546 do_cleanups (ALL_CLEANUPS);
551 catch_command_errors (catch_command_errors_ftype * command,
552 char *arg, int from_tty, return_mask mask)
554 struct captured_command_args args;
555 args.command = command;
557 args.from_tty = from_tty;
558 return catch_errors (do_captured_command, &args, "", mask);
562 /* Handler for SIGHUP. */
566 disconnect (int signo)
568 catch_errors (quit_cover, NULL,
569 "Could not kill the program being debugged", RETURN_MASK_ALL);
570 signal (SIGHUP, SIG_DFL);
571 kill (getpid (), SIGHUP);
574 /* Just a little helper function for disconnect(). */
576 /* NOTE 1999-04-29: This function will be static again, once we modify
577 gdb to use the event loop as the default command loop and we merge
578 event-top.c into this file, top.c */
582 caution = 0; /* Throw caution to the wind -- we're exiting.
583 This prevents asking the user dumb questions. */
584 quit_command ((char *) 0, 0);
587 #endif /* defined SIGHUP */
589 /* Line number we are currently in in a file which is being sourced. */
590 /* NOTE 1999-04-29: This variable will be static again, once we modify
591 gdb to use the event loop as the default command loop and we merge
592 event-top.c into this file, top.c */
593 /* static */ int source_line_number;
595 /* Name of the file we are sourcing. */
596 /* NOTE 1999-04-29: This variable will be static again, once we modify
597 gdb to use the event loop as the default command loop and we merge
598 event-top.c into this file, top.c */
599 /* static */ char *source_file_name;
601 /* Buffer containing the error_pre_print used by the source stuff.
603 /* NOTE 1999-04-29: This variable will be static again, once we modify
604 gdb to use the event loop as the default command loop and we merge
605 event-top.c into this file, top.c */
606 /* static */ char *source_error;
607 static int source_error_allocated;
609 /* Something to glom on to the start of error_pre_print if source_file_name
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_pre_error;
616 /* Clean up on error during a "source" command (or execution of a
617 user-defined command). */
620 do_restore_instream_cleanup (void *stream)
622 /* Restore the previous input stream. */
626 /* Read commands from STREAM. */
628 read_command_file (FILE *stream)
630 struct cleanup *cleanups;
632 cleanups = make_cleanup (do_restore_instream_cleanup, instream);
635 do_cleanups (cleanups);
638 extern void init_proc (void);
640 void (*pre_init_ui_hook) (void);
644 do_chdir_cleanup (void *old_dir)
652 gdb_init (char *argv0)
654 if (pre_init_ui_hook)
657 /* Run the init function of each source file */
659 getcwd (gdb_dirbuf, sizeof (gdb_dirbuf));
660 current_directory = gdb_dirbuf;
663 /* Make sure we return to the original directory upon exit, come
664 what may, since the OS doesn't do that for us. */
665 make_final_cleanup (do_chdir_cleanup, xstrdup (current_directory));
668 init_cmd_lists (); /* This needs to be done first */
669 initialize_targets (); /* Setup target_terminal macros for utils.c */
670 initialize_utils (); /* Make errors and warnings possible */
671 initialize_all_files ();
672 initialize_current_architecture ();
674 init_main (); /* But that omits this file! Do it now */
676 /* The signal handling mechanism is different depending whether or
677 not the async version is run. NOTE: in the future we plan to make
678 the event loop be the default engine of gdb, and this difference
681 async_init_signals ();
685 /* We need a default language for parsing expressions, so simple things like
686 "set width 0" won't fail if no language is explicitly set in a config file
687 or implicitly set by reading an executable during startup. */
688 set_language (language_c);
689 expected_language = current_language; /* don't warn about the change. */
692 /* Install the default UI */
695 uiout = cli_out_new (gdb_stdout);
697 /* All the interpreters should have had a look at things by now.
698 Initialize the selected interpreter. */
701 fprintf_unfiltered (gdb_stderr, "Interpreter `%s' unrecognized.\n",
709 init_ui_hook (argv0);
712 /* Execute the line P as a command.
713 Pass FROM_TTY as second argument to the defining function. */
716 execute_command (char *p, int from_tty)
718 register struct cmd_list_element *c;
719 register enum language flang;
720 static int warned = 0;
722 /* FIXME: These should really be in an appropriate header file */
723 extern void serial_log_command (const char *);
727 /* Force cleanup of any alloca areas if using C alloca instead of
731 /* This can happen when command_line_input hits end of file. */
735 serial_log_command (p);
737 while (*p == ' ' || *p == '\t')
744 c = lookup_cmd (&p, cmdlist, "", 0, 1);
746 /* If the target is running, we allow only a limited set of
748 if (event_loop_p && target_can_async_p () && target_executing)
749 if (!strcmp (c->name, "help")
750 && !strcmp (c->name, "pwd")
751 && !strcmp (c->name, "show")
752 && !strcmp (c->name, "stop"))
753 error ("Cannot execute this command while the target is running.");
755 /* Pass null arg rather than an empty one. */
758 /* Clear off trailing whitespace, except for set and complete command. */
760 && c->type != set_cmd
761 && !is_complete_command (c->function.cfunc))
763 p = arg + strlen (arg) - 1;
764 while (p >= arg && (*p == ' ' || *p == '\t'))
769 /* If this command has been pre-hooked, run the hook first. */
770 if ((c->hook_pre) && (!c->hook_in))
772 c->hook_in = 1; /* Prevent recursive hooking */
773 execute_user_command (c->hook_pre, (char *) 0);
774 c->hook_in = 0; /* Allow hook to work again once it is complete */
777 if (c->flags & DEPRECATED_WARN_USER)
778 deprecated_cmd_warning (&line);
780 if (c->class == class_user)
781 execute_user_command (c, arg);
782 else if (c->type == set_cmd || c->type == show_cmd)
783 do_setshow_command (arg, from_tty & caution, c);
784 else if (c->function.cfunc == NO_FUNCTION)
785 error ("That is not a command, just a help topic.");
786 else if (call_command_hook)
787 call_command_hook (c, arg, from_tty & caution);
789 (*c->function.cfunc) (arg, from_tty & caution);
791 /* If this command has been post-hooked, run the hook last. */
792 if ((c->hook_post) && (!c->hook_in))
794 c->hook_in = 1; /* Prevent recursive hooking */
795 execute_user_command (c->hook_post, (char *) 0);
796 c->hook_in = 0; /* allow hook to work again once it is complete */
801 /* Tell the user if the language has changed (except first time). */
802 if (current_language != expected_language)
804 if (language_mode == language_mode_auto)
806 language_info (1); /* Print what changed. */
811 /* Warn the user if the working language does not match the
812 language of the current frame. Only warn the user if we are
813 actually running the program, i.e. there is a stack. */
814 /* FIXME: This should be cacheing the frame and only running when
815 the frame changes. */
817 if (target_has_stack)
819 flang = get_frame_language ();
821 && flang != language_unknown
822 && flang != current_language->la_language)
824 printf_filtered ("%s\n", lang_frame_mismatch_warn);
830 /* Read commands from `instream' and execute them
831 until end of file or error reading instream. */
836 struct cleanup *old_chain;
838 int stdin_is_tty = ISATTY (stdin);
839 long time_at_cmd_start;
841 long space_at_cmd_start = 0;
843 extern int display_time;
844 extern int display_space;
846 while (instream && !feof (instream))
849 extern int insert_mode;
851 if (window_hook && instream == stdin)
852 (*window_hook) (instream, get_prompt ());
855 if (instream == stdin && stdin_is_tty)
856 reinitialize_more_filter ();
857 old_chain = make_cleanup (null_cleanup, 0);
860 /* A bit of paranoia: I want to make sure the "insert_mode" global
861 * is clear except when it is being used for command-line editing
862 * (see tuiIO.c, utils.c); otherwise normal output will
863 * get messed up in the TUI. So clear it before/after
864 * the command-line-input call. - RT
868 /* Get a command-line. This calls the readline package. */
869 command = command_line_input (instream == stdin ?
870 get_prompt () : (char *) NULL,
871 instream == stdin, "prompt");
878 time_at_cmd_start = get_run_time ();
883 extern char **environ;
884 char *lim = (char *) sbrk (0);
886 space_at_cmd_start = (long) (lim - (char *) &environ);
890 execute_command (command, instream == stdin);
891 /* Do any commands attached to breakpoint we stopped at. */
892 bpstat_do_actions (&stop_bpstat);
893 do_cleanups (old_chain);
897 long cmd_time = get_run_time () - time_at_cmd_start;
899 printf_unfiltered ("Command execution time: %ld.%06ld\n",
900 cmd_time / 1000000, cmd_time % 1000000);
906 extern char **environ;
907 char *lim = (char *) sbrk (0);
908 long space_now = lim - (char *) &environ;
909 long space_diff = space_now - space_at_cmd_start;
911 printf_unfiltered ("Space used: %ld (%c%ld for this command)\n",
913 (space_diff >= 0 ? '+' : '-'),
920 /* Read commands from `instream' and execute them until end of file or
921 error reading instream. This command loop doesnt care about any
922 such things as displaying time and space usage. If the user asks
923 for those, they won't work. */
925 simplified_command_loop (char *(*read_input_func) (char *),
926 void (*execute_command_func) (char *, int))
928 struct cleanup *old_chain;
930 int stdin_is_tty = ISATTY (stdin);
932 while (instream && !feof (instream))
935 if (instream == stdin && stdin_is_tty)
936 reinitialize_more_filter ();
937 old_chain = make_cleanup (null_cleanup, 0);
939 /* Get a command-line. */
940 command = (*read_input_func) (instream == stdin ?
941 get_prompt () : (char *) NULL);
946 (*execute_command_func) (command, instream == stdin);
948 /* Do any commands attached to breakpoint we stopped at. */
949 bpstat_do_actions (&stop_bpstat);
951 do_cleanups (old_chain);
955 /* Commands call this if they do not want to be repeated by null lines. */
963 /* If we aren't reading from standard input, we are saving the last
964 thing read from stdin in line and don't want to delete it. Null lines
965 won't repeat here in any case. */
966 if (instream == stdin)
970 /* Read a line from the stream "instream" without command line editing.
972 It prints PROMPT_ARG once at the start.
973 Action is compatible with "readline", e.g. space for the result is
974 malloc'd and should be freed by the caller.
976 A NULL return means end of file. */
978 gdb_readline (char *prompt_arg)
983 int result_size = 80;
987 /* Don't use a _filtered function here. It causes the assumed
988 character position to be off, since the newline we read from
989 the user is not accounted for. */
990 fputs_unfiltered (prompt_arg, gdb_stdout);
991 /* OBSOLETE #ifdef MPW */
992 /* OBSOLETE Move to a new line so the entered line doesn't have a prompt */
993 /* OBSOLETE on the front of it. */
994 /* OBSOLETE fputs_unfiltered ("\n", gdb_stdout); */
995 /* OBSOLETE #endif *//* MPW */
996 gdb_flush (gdb_stdout);
999 result = (char *) xmalloc (result_size);
1003 /* Read from stdin if we are executing a user defined command.
1004 This is the right thing for prompt_for_continue, at least. */
1005 c = fgetc (instream ? instream : stdin);
1009 if (input_index > 0)
1010 /* The last line does not end with a newline. Return it, and
1011 if we are called again fgetc will still return EOF and
1012 we'll return NULL then. */
1019 #ifndef CRLF_SOURCE_FILES
1023 if (input_index > 0 && result[input_index - 1] == '\r')
1029 result[input_index++] = c;
1030 while (input_index >= result_size)
1033 result = (char *) xrealloc (result, result_size);
1037 result[input_index++] = '\0';
1041 /* Variables which control command line editing and history
1042 substitution. These variables are given default values at the end
1044 static int command_editing_p;
1045 /* NOTE 1999-04-29: This variable will be static again, once we modify
1046 gdb to use the event loop as the default command loop and we merge
1047 event-top.c into this file, top.c */
1048 /* static */ int history_expansion_p;
1049 static int write_history_p;
1050 static int history_size;
1051 static char *history_filename;
1053 /* Functions that are used as part of the fancy command line editing. */
1055 /* This can be used for functions which don't want to complete on symbols
1056 but don't want to complete on anything else either. */
1059 noop_completer (char *text, char *prefix)
1064 /* Line completion interface function for readline. */
1067 readline_line_completion_function (char *text, int matches)
1069 return line_completion_function (text, matches, rl_line_buffer, rl_point);
1074 stop_sig (int signo)
1076 #if STOP_SIGNAL == SIGTSTP
1077 signal (SIGTSTP, SIG_DFL);
1079 kill (getpid (), SIGTSTP);
1080 signal (SIGTSTP, stop_sig);
1082 signal (STOP_SIGNAL, stop_sig);
1084 printf_unfiltered ("%s", get_prompt ());
1085 gdb_flush (gdb_stdout);
1087 /* Forget about any previous command -- null line now will do nothing. */
1090 #endif /* STOP_SIGNAL */
1092 /* Initialize signal handlers. */
1094 do_nothing (int signo)
1096 /* Under System V the default disposition of a signal is reinstated after
1097 the signal is caught and delivered to an application process. On such
1098 systems one must restore the replacement signal handler if one wishes
1099 to continue handling the signal in one's program. On BSD systems this
1100 is not needed but it is harmless, and it simplifies the code to just do
1101 it unconditionally. */
1102 signal (signo, do_nothing);
1108 signal (SIGINT, request_quit);
1110 /* If SIGTRAP was set to SIG_IGN, then the SIG_IGN will get passed
1111 to the inferior and breakpoints will be ignored. */
1113 signal (SIGTRAP, SIG_DFL);
1116 /* If we initialize SIGQUIT to SIG_IGN, then the SIG_IGN will get
1117 passed to the inferior, which we don't want. It would be
1118 possible to do a "signal (SIGQUIT, SIG_DFL)" after we fork, but
1119 on BSD4.3 systems using vfork, that can affect the
1120 GDB process as well as the inferior (the signal handling tables
1121 might be in memory, shared between the two). Since we establish
1122 a handler for SIGQUIT, when we call exec it will set the signal
1123 to SIG_DFL for us. */
1124 signal (SIGQUIT, do_nothing);
1126 if (signal (SIGHUP, do_nothing) != SIG_IGN)
1127 signal (SIGHUP, disconnect);
1129 signal (SIGFPE, float_handler);
1131 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1132 signal (SIGWINCH, SIGWINCH_HANDLER);
1136 /* Read one line from the command input stream `instream'
1137 into the local static buffer `linebuffer' (whose current length
1139 The buffer is made bigger as necessary.
1140 Returns the address of the start of the line.
1142 NULL is returned for end of file.
1144 *If* the instream == stdin & stdin is a terminal, the line read
1145 is copied into the file line saver (global var char *line,
1146 length linesize) so that it can be duplicated.
1148 This routine either uses fancy command line editing or
1149 simple input as the user has requested. */
1152 command_line_input (char *prompt_arg, int repeat, char *annotation_suffix)
1154 static char *linebuffer = 0;
1155 static unsigned linelength = 0;
1159 char *local_prompt = prompt_arg;
1163 /* The annotation suffix must be non-NULL. */
1164 if (annotation_suffix == NULL)
1165 annotation_suffix = "";
1167 if (annotation_level > 1 && instream == stdin)
1169 local_prompt = alloca ((prompt_arg == NULL ? 0 : strlen (prompt_arg))
1170 + strlen (annotation_suffix) + 40);
1171 if (prompt_arg == NULL)
1172 local_prompt[0] = '\0';
1174 strcpy (local_prompt, prompt_arg);
1175 strcat (local_prompt, "\n\032\032");
1176 strcat (local_prompt, annotation_suffix);
1177 strcat (local_prompt, "\n");
1180 if (linebuffer == 0)
1183 linebuffer = (char *) xmalloc (linelength);
1188 /* Control-C quits instantly if typed while in this loop
1189 since it should not wait until the user types a newline. */
1195 signal (STOP_SIGNAL, handle_stop_sig);
1197 signal (STOP_SIGNAL, stop_sig);
1203 /* Make sure that all output has been output. Some machines may let
1204 you get away with leaving out some of the gdb_flush, but not all. */
1206 gdb_flush (gdb_stdout);
1207 gdb_flush (gdb_stderr);
1209 if (source_file_name != NULL)
1211 ++source_line_number;
1212 sprintf (source_error,
1213 "%s%s:%d: Error in sourced command file:\n",
1216 source_line_number);
1217 error_pre_print = source_error;
1220 if (annotation_level > 1 && instream == stdin)
1222 printf_unfiltered ("\n\032\032pre-");
1223 printf_unfiltered (annotation_suffix);
1224 printf_unfiltered ("\n");
1227 /* Don't use fancy stuff if not talking to stdin. */
1228 if (readline_hook && instream == NULL)
1230 rl = (*readline_hook) (local_prompt);
1232 else if (command_editing_p && instream == stdin && ISATTY (instream))
1234 rl = readline (local_prompt);
1238 rl = gdb_readline (local_prompt);
1241 if (annotation_level > 1 && instream == stdin)
1243 printf_unfiltered ("\n\032\032post-");
1244 printf_unfiltered (annotation_suffix);
1245 printf_unfiltered ("\n");
1248 if (!rl || rl == (char *) EOF)
1253 if (strlen (rl) + 1 + (p - linebuffer) > linelength)
1255 linelength = strlen (rl) + 1 + (p - linebuffer);
1256 nline = (char *) xrealloc (linebuffer, linelength);
1257 p += nline - linebuffer;
1261 /* Copy line. Don't copy null at end. (Leaves line alone
1262 if this was just a newline) */
1266 xfree (rl); /* Allocated in readline. */
1268 if (p == linebuffer || *(p - 1) != '\\')
1271 p--; /* Put on top of '\'. */
1272 local_prompt = (char *) 0;
1277 signal (STOP_SIGNAL, SIG_DFL);
1284 #define SERVER_COMMAND_LENGTH 7
1286 (p - linebuffer > SERVER_COMMAND_LENGTH)
1287 && STREQN (linebuffer, "server ", SERVER_COMMAND_LENGTH);
1290 /* Note that we don't set `line'. Between this and the check in
1291 dont_repeat, this insures that repeating will still do the
1294 return linebuffer + SERVER_COMMAND_LENGTH;
1297 /* Do history expansion if that is wished. */
1298 if (history_expansion_p && instream == stdin
1299 && ISATTY (instream))
1301 char *history_value;
1304 *p = '\0'; /* Insert null now. */
1305 expanded = history_expand (linebuffer, &history_value);
1308 /* Print the changes. */
1309 printf_unfiltered ("%s\n", history_value);
1311 /* If there was an error, call this function again. */
1314 xfree (history_value);
1315 return command_line_input (prompt_arg, repeat, annotation_suffix);
1317 if (strlen (history_value) > linelength)
1319 linelength = strlen (history_value) + 1;
1320 linebuffer = (char *) xrealloc (linebuffer, linelength);
1322 strcpy (linebuffer, history_value);
1323 p = linebuffer + strlen (linebuffer);
1324 xfree (history_value);
1328 /* If we just got an empty line, and that is supposed
1329 to repeat the previous command, return the value in the
1331 if (repeat && p == linebuffer)
1333 for (p1 = linebuffer; *p1 == ' ' || *p1 == '\t'; p1++);
1339 /* Add line to history if appropriate. */
1340 if (instream == stdin
1341 && ISATTY (stdin) && *linebuffer)
1342 add_history (linebuffer);
1344 /* Note: lines consisting solely of comments are added to the command
1345 history. This is useful when you type a command, and then
1346 realize you don't want to execute it quite yet. You can comment
1347 out the command and then later fetch it from the value history
1348 and remove the '#'. The kill ring is probably better, but some
1349 people are in the habit of commenting things out. */
1351 *p1 = '\0'; /* Found a comment. */
1353 /* Save into global buffer if appropriate. */
1356 if (linelength > linesize)
1358 line = xrealloc (line, linelength);
1359 linesize = linelength;
1361 strcpy (line, linebuffer);
1368 /* Print the GDB banner. */
1370 print_gdb_version (struct ui_file *stream)
1372 /* From GNU coding standards, first line is meant to be easy for a
1373 program to parse, and is just canonical program name and version
1374 number, which starts after last space. */
1377 /* Print it console style until a format is defined */
1378 fprintf_filtered (stream, "GNU gdb %s (MI_OUT)\n", version);
1380 fprintf_filtered (stream, "GNU gdb %s\n", version);
1383 /* Second line is a copyright notice. */
1385 fprintf_filtered (stream, "Copyright 2001 Free Software Foundation, Inc.\n");
1387 /* Following the copyright is a brief statement that the program is
1388 free software, that users are free to copy and change it on
1389 certain conditions, that it is covered by the GNU GPL, and that
1390 there is no warranty. */
1392 fprintf_filtered (stream, "\
1393 GDB is free software, covered by the GNU General Public License, and you are\n\
1394 welcome to change it and/or distribute copies of it under certain conditions.\n\
1395 Type \"show copying\" to see the conditions.\n\
1396 There is absolutely no warranty for GDB. Type \"show warranty\" for details.\n");
1398 /* After the required info we print the configuration information. */
1400 fprintf_filtered (stream, "This GDB was configured as \"");
1401 if (!STREQ (host_name, target_name))
1403 fprintf_filtered (stream, "--host=%s --target=%s", host_name, target_name);
1407 fprintf_filtered (stream, "%s", host_name);
1409 fprintf_filtered (stream, "\".");
1412 /* get_prompt: access method for the GDB prompt string. */
1414 #define MAX_PROMPT_SIZE 256
1417 * int get_prompt_1 (char * buf);
1419 * Work-horse for get_prompt (called via catch_errors).
1420 * Argument is buffer to hold the formatted prompt.
1422 * Returns: 1 for success (use formatted prompt)
1423 * 0 for failure (use gdb_prompt_string).
1426 static int gdb_prompt_escape;
1429 get_prompt_1 (void *data)
1431 char *formatted_prompt = data;
1435 local_prompt = PROMPT (0);
1437 local_prompt = gdb_prompt_string;
1440 if (gdb_prompt_escape == 0)
1442 return 0; /* do no formatting */
1445 /* formatted prompt */
1447 char fmt[40], *promptp, *outp, *tmp;
1454 struct type *arg_type, *elt_type;
1456 promptp = local_prompt;
1457 outp = formatted_prompt;
1459 while (*promptp != '\0')
1461 int available = MAX_PROMPT_SIZE - (outp - formatted_prompt) - 1;
1463 if (*promptp != gdb_prompt_escape)
1465 if (available >= 1) /* overflow protect */
1466 *outp++ = *promptp++;
1470 /* GDB prompt string contains escape char. Parse for arg.
1471 Two consecutive escape chars followed by arg followed by
1472 a comma means to insert the arg using a default format.
1473 Otherwise a printf format string may be included between
1474 the two escape chars. eg:
1475 %%foo, insert foo using default format
1476 %2.2f%foo, insert foo using "%2.2f" format
1477 A mismatch between the format string and the data type
1478 of "foo" is an error (which we don't know how to protect
1481 fmt[0] = '\0'; /* assume null format string */
1482 if (promptp[1] == gdb_prompt_escape) /* double esc char */
1484 promptp += 2; /* skip past two escape chars. */
1488 /* extract format string from between two esc chars */
1492 fmt[i++] = *promptp++; /* copy format string */
1494 while (i < sizeof (fmt) - 1 &&
1495 *promptp != gdb_prompt_escape &&
1498 if (*promptp != gdb_prompt_escape)
1499 error ("Syntax error at prompt position %d",
1500 promptp - local_prompt);
1503 promptp++; /* skip second escape char */
1504 fmt[i++] = '\0'; /* terminate the format string */
1508 arg_val = parse_to_comma_and_eval (&promptp);
1509 if (*promptp == ',')
1510 promptp++; /* skip past the comma */
1511 arg_type = check_typedef (VALUE_TYPE (arg_val));
1512 switch (TYPE_CODE (arg_type))
1514 case TYPE_CODE_ARRAY:
1515 elt_type = check_typedef (TYPE_TARGET_TYPE (arg_type));
1516 if (TYPE_LENGTH (arg_type) > 0 &&
1517 TYPE_LENGTH (elt_type) == 1 &&
1518 TYPE_CODE (elt_type) == TYPE_CODE_INT)
1520 int len = TYPE_LENGTH (arg_type);
1522 if (VALUE_LAZY (arg_val))
1523 value_fetch_lazy (arg_val);
1524 tmp = VALUE_CONTENTS (arg_val);
1526 if (len > available)
1527 len = available; /* overflow protect */
1529 /* FIXME: how to protect GDB from crashing
1530 from bad user-supplied format string? */
1532 sprintf (outp, fmt, tmp);
1534 strncpy (outp, tmp, len);
1539 elt_type = check_typedef (TYPE_TARGET_TYPE (arg_type));
1540 addrval = value_as_pointer (arg_val);
1542 if (TYPE_LENGTH (elt_type) == 1 &&
1543 TYPE_CODE (elt_type) == TYPE_CODE_INT &&
1546 /* display it as a string */
1547 char *default_fmt = "%s";
1551 /* Limiting the number of bytes that the following call
1552 will read protects us from sprintf overflow later. */
1553 i = target_read_string (addrval, /* src */
1555 available, /* len */
1557 if (err) /* read failed */
1558 error ("%s on target_read", safe_strerror (err));
1560 tmp[i] = '\0'; /* force-terminate string */
1561 /* FIXME: how to protect GDB from crashing
1562 from bad user-supplied format string? */
1563 sprintf (outp, fmt[0] == 0 ? default_fmt : fmt,
1569 /* display it as a pointer */
1570 char *default_fmt = "0x%x";
1572 /* FIXME: how to protect GDB from crashing
1573 from bad user-supplied format string? */
1574 if (available >= 16 /*? */ ) /* overflow protect */
1575 sprintf (outp, fmt[0] == 0 ? default_fmt : fmt,
1581 char *default_fmt = "%g";
1583 doubleval = value_as_double (arg_val);
1584 /* FIXME: how to protect GDB from crashing
1585 from bad user-supplied format string? */
1586 if (available >= 16 /*? */ ) /* overflow protect */
1587 sprintf (outp, fmt[0] == 0 ? default_fmt : fmt,
1588 (double) doubleval);
1593 char *default_fmt = "%d";
1595 longval = value_as_long (arg_val);
1596 /* FIXME: how to protect GDB from crashing
1597 from bad user-supplied format string? */
1598 if (available >= 16 /*? */ ) /* overflow protect */
1599 sprintf (outp, fmt[0] == 0 ? default_fmt : fmt,
1603 case TYPE_CODE_BOOL:
1605 /* no default format for bool */
1606 longval = value_as_long (arg_val);
1607 if (available >= 8 /*? */ ) /* overflow protect */
1610 strcpy (outp, "<true>");
1612 strcpy (outp, "<false>");
1616 case TYPE_CODE_ENUM:
1618 /* no default format for enum */
1619 longval = value_as_long (arg_val);
1620 len = TYPE_NFIELDS (arg_type);
1621 /* find enum name if possible */
1622 for (i = 0; i < len; i++)
1623 if (TYPE_FIELD_BITPOS (arg_type, i) == longval)
1624 break; /* match -- end loop */
1626 if (i < len) /* enum name found */
1628 char *name = TYPE_FIELD_NAME (arg_type, i);
1630 strncpy (outp, name, available);
1631 /* in casel available < strlen (name), */
1632 outp[available] = '\0';
1636 if (available >= 16 /*? */ ) /* overflow protect */
1637 sprintf (outp, "%ld", (long) longval);
1641 case TYPE_CODE_VOID:
1643 break; /* void type -- no output */
1645 error ("bad data type at prompt position %d",
1646 promptp - local_prompt);
1649 outp += strlen (outp);
1652 *outp++ = '\0'; /* terminate prompt string */
1660 static char buf[MAX_PROMPT_SIZE];
1662 if (catch_errors (get_prompt_1, buf, "bad formatted prompt: ",
1665 return &buf[0]; /* successful formatted prompt */
1669 /* Prompt could not be formatted. */
1673 return gdb_prompt_string;
1678 set_prompt (char *s)
1680 /* ??rehrauer: I don't know why this fails, since it looks as though
1681 assignments to prompt are wrapped in calls to savestring...
1686 PROMPT (0) = savestring (s, strlen (s));
1688 gdb_prompt_string = savestring (s, strlen (s));
1692 /* If necessary, make the user confirm that we should quit. Return
1693 non-zero if we should quit, zero if we shouldn't. */
1698 if (! ptid_equal (inferior_ptid, null_ptid) && target_has_execution)
1702 /* This is something of a hack. But there's no reliable way to
1703 see if a GUI is running. The `use_windows' variable doesn't
1706 s = "A debugging session is active.\nDo you still want to close the debugger?";
1707 else if (attach_flag)
1708 s = "The program is running. Quit anyway (and detach it)? ";
1710 s = "The program is running. Exit anyway? ";
1719 /* Quit without asking for confirmation. */
1722 quit_force (char *args, int from_tty)
1726 /* An optional expression may be used to cause gdb to terminate with the
1727 value of that expression. */
1730 value_ptr val = parse_and_eval (args);
1732 exit_code = (int) value_as_long (val);
1735 if (! ptid_equal (inferior_ptid, null_ptid) && target_has_execution)
1738 target_detach (args, from_tty);
1743 /* UDI wants this, to kill the TIP. */
1746 /* Save the history information if it is appropriate to do so. */
1747 if (write_history_p && history_filename)
1748 write_history (history_filename);
1750 do_final_cleanups (ALL_CLEANUPS); /* Do any final cleanups before exiting */
1753 /* tuiDo((TuiOpaqueFuncPtr)tuiCleanUp); */
1754 /* The above does not need to be inside a tuiDo(), since
1755 * it is not manipulating the curses screen, but rather,
1756 * it is tearing it down.
1765 /* Returns whether GDB is running on a terminal and whether the user
1766 desires that questions be asked of them on that terminal. */
1769 input_from_terminal_p (void)
1771 return gdb_has_a_terminal () && (instream == stdin) & caution;
1776 dont_repeat_command (char *ignored, int from_tty)
1778 *line = 0; /* Can't call dont_repeat here because we're not
1779 necessarily reading from stdin. */
1782 /* Functions to manipulate command line editing control variables. */
1784 /* Number of commands to print in each call to show_commands. */
1785 #define Hist_print 10
1787 show_commands (char *args, int from_tty)
1789 /* Index for history commands. Relative to history_base. */
1792 /* Number of the history entry which we are planning to display next.
1793 Relative to history_base. */
1796 /* The first command in the history which doesn't exist (i.e. one more
1797 than the number of the last command). Relative to history_base. */
1800 extern HIST_ENTRY *history_get (int);
1802 /* Print out some of the commands from the command history. */
1803 /* First determine the length of the history list. */
1804 hist_len = history_size;
1805 for (offset = 0; offset < history_size; offset++)
1807 if (!history_get (history_base + offset))
1816 if (args[0] == '+' && args[1] == '\0')
1817 /* "info editing +" should print from the stored position. */
1820 /* "info editing <exp>" should print around command number <exp>. */
1821 num = (parse_and_eval_long (args) - history_base) - Hist_print / 2;
1823 /* "show commands" means print the last Hist_print commands. */
1826 num = hist_len - Hist_print;
1832 /* If there are at least Hist_print commands, we want to display the last
1833 Hist_print rather than, say, the last 6. */
1834 if (hist_len - num < Hist_print)
1836 num = hist_len - Hist_print;
1841 for (offset = num; offset < num + Hist_print && offset < hist_len; offset++)
1843 printf_filtered ("%5d %s\n", history_base + offset,
1844 (history_get (history_base + offset))->line);
1847 /* The next command we want to display is the next one that we haven't
1851 /* If the user repeats this command with return, it should do what
1852 "show commands +" does. This is unnecessary if arg is null,
1853 because "show commands +" is not useful after "show commands". */
1854 if (from_tty && args)
1861 /* Called by do_setshow_command. */
1864 set_history_size_command (char *args, int from_tty, struct cmd_list_element *c)
1866 if (history_size == INT_MAX)
1867 unstifle_history ();
1868 else if (history_size >= 0)
1869 stifle_history (history_size);
1872 history_size = INT_MAX;
1873 error ("History size must be non-negative");
1879 set_history (char *args, int from_tty)
1881 printf_unfiltered ("\"set history\" must be followed by the name of a history subcommand.\n");
1882 help_list (sethistlist, "set history ", -1, gdb_stdout);
1887 show_history (char *args, int from_tty)
1889 cmd_show_list (showhistlist, from_tty, "");
1892 int info_verbose = 0; /* Default verbose msgs off */
1894 /* Called by do_setshow_command. An elaborate joke. */
1897 set_verbose (char *args, int from_tty, struct cmd_list_element *c)
1899 char *cmdname = "verbose";
1900 struct cmd_list_element *showcmd;
1902 showcmd = lookup_cmd_1 (&cmdname, showlist, NULL, 1);
1906 c->doc = "Set verbose printing of informational messages.";
1907 showcmd->doc = "Show verbose printing of informational messages.";
1911 c->doc = "Set verbosity.";
1912 showcmd->doc = "Show verbosity.";
1917 float_handler (int signo)
1919 /* This message is based on ANSI C, section 4.7. Note that integer
1920 divide by zero causes this, so "float" is a misnomer. */
1921 signal (SIGFPE, float_handler);
1922 error ("Erroneous arithmetic operation.");
1925 /* Init the history buffer. Note that we are called after the init file(s)
1926 * have been read so that the user can change the history file via his
1927 * .gdbinit file (for instance). The GDBHISTFILE environment variable
1928 * overrides all of this.
1936 tmpenv = getenv ("HISTSIZE");
1938 history_size = atoi (tmpenv);
1939 else if (!history_size)
1942 stifle_history (history_size);
1944 tmpenv = getenv ("GDBHISTFILE");
1946 history_filename = savestring (tmpenv, strlen (tmpenv));
1947 else if (!history_filename)
1949 /* We include the current directory so that if the user changes
1950 directories the file written will be the same as the one
1953 /* No leading dots in file names are allowed on MSDOS. */
1954 history_filename = concat (current_directory, "/_gdb_history", NULL);
1956 history_filename = concat (current_directory, "/.gdb_history", NULL);
1959 read_history (history_filename);
1965 struct cmd_list_element *c;
1967 /* If we are running the asynchronous version,
1968 we initialize the prompts differently. */
1971 gdb_prompt_string = savestring (DEFAULT_PROMPT, strlen (DEFAULT_PROMPT));
1975 /* initialize the prompt stack to a simple "(gdb) " prompt or to
1976 whatever the DEFAULT_PROMPT is. */
1977 the_prompts.top = 0;
1979 PROMPT (0) = savestring (DEFAULT_PROMPT, strlen (DEFAULT_PROMPT));
1981 /* Set things up for annotation_level > 1, if the user ever decides
1983 async_annotation_suffix = "prompt";
1984 /* Set the variable associated with the setshow prompt command. */
1985 new_async_prompt = savestring (PROMPT (0), strlen (PROMPT (0)));
1987 /* If gdb was started with --annotate=2, this is equivalent to
1988 the user entering the command 'set annotate 2' at the gdb
1989 prompt, so we need to do extra processing. */
1990 if (annotation_level > 1)
1991 set_async_annotation_level (NULL, 0, NULL);
1993 gdb_prompt_escape = 0; /* default to none. */
1995 /* Set the important stuff up for command editing. */
1996 command_editing_p = 1;
1997 history_expansion_p = 0;
1998 write_history_p = 0;
2000 /* Setup important stuff for command line editing. */
2001 rl_completion_entry_function = (int (*)()) readline_line_completion_function;
2002 rl_completer_word_break_characters =
2003 get_gdb_completer_word_break_characters ();
2004 rl_completer_quote_characters = get_gdb_completer_quote_characters ();
2005 rl_readline_name = "gdb";
2007 /* The set prompt command is different depending whether or not the
2008 async version is run. NOTE: this difference is going to
2009 disappear as we make the event loop be the default engine of
2014 (add_set_cmd ("prompt", class_support, var_string,
2015 (char *) &gdb_prompt_string, "Set gdb's prompt",
2021 c = add_set_cmd ("prompt", class_support, var_string,
2022 (char *) &new_async_prompt, "Set gdb's prompt",
2024 add_show_from_set (c, &showlist);
2025 c->function.sfunc = set_async_prompt;
2029 (add_set_cmd ("prompt-escape-char", class_support, var_zinteger,
2030 (char *) &gdb_prompt_escape,
2031 "Set escape character for formatting of gdb's prompt",
2035 add_com ("dont-repeat", class_support, dont_repeat_command, "Don't repeat this command.\n\
2036 Primarily used inside of user-defined commands that should not be repeated when\n\
2039 /* The set editing command is different depending whether or not the
2040 async version is run. NOTE: this difference is going to disappear
2041 as we make the event loop be the default engine of gdb. */
2045 (add_set_cmd ("editing", class_support, var_boolean, (char *) &command_editing_p,
2046 "Set editing of command lines as they are typed.\n\
2047 Use \"on\" to enable the editing, and \"off\" to disable it.\n\
2048 Without an argument, command line editing is enabled. To edit, use\n\
2049 EMACS-like or VI-like commands like control-P or ESC.", &setlist),
2054 c = add_set_cmd ("editing", class_support, var_boolean, (char *) &async_command_editing_p,
2055 "Set editing of command lines as they are typed.\n\
2056 Use \"on\" to enable the editing, and \"off\" to disable it.\n\
2057 Without an argument, command line editing is enabled. To edit, use\n\
2058 EMACS-like or VI-like commands like control-P or ESC.", &setlist);
2060 add_show_from_set (c, &showlist);
2061 c->function.sfunc = set_async_editing_command;
2065 (add_set_cmd ("save", no_class, var_boolean, (char *) &write_history_p,
2066 "Set saving of the history record on exit.\n\
2067 Use \"on\" to enable the saving, and \"off\" to disable it.\n\
2068 Without an argument, saving is enabled.", &sethistlist),
2071 c = add_set_cmd ("size", no_class, var_integer, (char *) &history_size,
2072 "Set the size of the command history, \n\
2073 ie. the number of previous commands to keep a record of.", &sethistlist);
2074 add_show_from_set (c, &showhistlist);
2075 c->function.sfunc = set_history_size_command;
2077 c = add_set_cmd ("filename", no_class, var_filename,
2078 (char *) &history_filename,
2079 "Set the filename in which to record the command history\n\
2080 (the list of previous commands of which a record is kept).", &sethistlist);
2081 c->completer = filename_completer;
2082 add_show_from_set (c, &showhistlist);
2085 (add_set_cmd ("confirm", class_support, var_boolean,
2087 "Set whether to confirm potentially dangerous operations.",
2091 /* The set annotate command is different depending whether or not
2092 the async version is run. NOTE: this difference is going to
2093 disappear as we make the event loop be the default engine of
2097 c = add_set_cmd ("annotate", class_obscure, var_zinteger,
2098 (char *) &annotation_level, "Set annotation_level.\n\
2099 0 == normal; 1 == fullname (for use when running under emacs)\n\
2100 2 == output annotated suitably for use by programs that control GDB.",
2102 c = add_show_from_set (c, &showlist);
2106 c = add_set_cmd ("annotate", class_obscure, var_zinteger,
2107 (char *) &annotation_level, "Set annotation_level.\n\
2108 0 == normal; 1 == fullname (for use when running under emacs)\n\
2109 2 == output annotated suitably for use by programs that control GDB.",
2111 add_show_from_set (c, &showlist);
2112 c->function.sfunc = set_async_annotation_level;
2117 (add_set_cmd ("exec-done-display", class_support, var_boolean, (char *) &exec_done_display_p,
2118 "Set notification of completion for asynchronous execution commands.\n\
2119 Use \"on\" to enable the notification, and \"off\" to disable it.", &setlist),