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 int (*target_wait_hook) (int pid, struct target_waitstatus * status);
346 /* Used by UI as a wrapper around command execution. May do various things
347 like enabling/disabling buttons, etc... */
349 void (*call_command_hook) (struct cmd_list_element * c, char *cmd,
352 /* Called after a `set' command has finished. Is only run if the
353 `set' command succeeded. */
355 void (*set_hook) (struct cmd_list_element * c);
357 /* Called when the current thread changes. Argument is thread id. */
359 void (*context_hook) (int id);
361 /* Takes control from error (). Typically used to prevent longjmps out of the
362 middle of the GUI. Usually used in conjunction with a catch routine. */
364 NORETURN void (*error_hook) (void) ATTR_NORETURN;
367 /* One should use catch_errors rather than manipulating these
369 #if defined(HAVE_SIGSETJMP)
370 #define SIGJMP_BUF sigjmp_buf
371 #define SIGSETJMP(buf) sigsetjmp(buf, 1)
372 #define SIGLONGJMP(buf,val) siglongjmp(buf,val)
374 #define SIGJMP_BUF jmp_buf
375 #define SIGSETJMP(buf) setjmp(buf)
376 #define SIGLONGJMP(buf,val) longjmp(buf,val)
379 /* Where to go for return_to_top_level. */
380 static SIGJMP_BUF *catch_return;
382 /* Return for reason REASON to the nearest containing catch_errors(). */
385 return_to_top_level (enum return_reason reason)
390 /* Perhaps it would be cleaner to do this via the cleanup chain (not sure
391 I can think of a reason why that is vital, though). */
392 bpstat_clear_actions (stop_bpstat); /* Clear queued breakpoint commands */
394 disable_current_display ();
395 do_cleanups (ALL_CLEANUPS);
396 if (event_loop_p && target_can_async_p () && !target_executing)
397 do_exec_cleanups (ALL_CLEANUPS);
398 if (event_loop_p && sync_execution)
399 do_exec_error_cleanups (ALL_CLEANUPS);
401 if (annotation_level > 1)
412 /* Jump to the containing catch_errors() call, communicating REASON
413 to that call via setjmp's return value. Note that REASON can't
414 be zero, by definition in defs.h. */
416 (NORETURN void) SIGLONGJMP (*catch_return, (int) reason);
419 /* Call FUNC with arg ARGS, catching any errors. If there is no
420 error, return the value returned by FUNC. If there is an error,
421 print ERRSTRING, print the specific error message, then return
424 Must not be called with immediate_quit in effect (bad things might
425 happen, say we got a signal in the middle of a memcpy to quit_return).
426 This is an OK restriction; with very few exceptions immediate_quit can
427 be replaced by judicious use of QUIT.
429 MASK specifies what to catch; it is normally set to
430 RETURN_MASK_ALL, if for no other reason than that the code which
431 calls catch_errors might not be set up to deal with a quit which
432 isn't caught. But if the code can deal with it, it generally
433 should be RETURN_MASK_ERROR, unless for some reason it is more
434 useful to abort only the portion of the operation inside the
435 catch_errors. Note that quit should return to the command line
436 fairly quickly, even if some further processing is being done. */
438 /* MAYBE: cagney/1999-11-05: catch_errors() in conjunction with
439 error() et.al. could maintain a set of flags that indicate the the
440 current state of each of the longjmp buffers. This would give the
441 longjmp code the chance to detect a longjmp botch (before it gets
442 to longjmperror()). Prior to 1999-11-05 this wasn't possible as
443 code also randomly used a SET_TOP_LEVEL macro that directly
444 initialize the longjmp buffers. */
446 /* MAYBE: cagney/1999-11-05: Should the catch_errors and cleanups code
447 be consolidated into a single file instead of being distributed
448 between utils.c and top.c? */
451 catch_errors (catch_errors_ftype *func, PTR args, char *errstring,
454 SIGJMP_BUF *saved_catch;
457 struct cleanup *saved_cleanup_chain;
458 char *saved_error_pre_print;
459 char *saved_quit_pre_print;
461 /* Return value from SIGSETJMP(): enum return_reason if error or
462 quit caught, 0 otherwise. */
465 /* Override error/quit messages during FUNC. */
467 saved_error_pre_print = error_pre_print;
468 saved_quit_pre_print = quit_pre_print;
470 if (mask & RETURN_MASK_ERROR)
471 error_pre_print = errstring;
472 if (mask & RETURN_MASK_QUIT)
473 quit_pre_print = errstring;
475 /* Prevent error/quit during FUNC from calling cleanups established
478 saved_cleanup_chain = save_cleanups ();
480 /* Call FUNC, catching error/quit events. */
482 saved_catch = catch_return;
483 catch_return = &catch;
484 caught = SIGSETJMP (catch);
486 val = (*func) (args);
489 catch_return = saved_catch;
491 /* FIXME: cagney/1999-11-05: A correct FUNC implementation will
492 clean things up (restoring the cleanup chain) to the state they
493 were just prior to the call. Unfortunately, many FUNC's are not
494 that well behaved. This could be fixed by adding either a
495 do_cleanups call (to cover the problem) or an assertion check to
496 detect bad FUNCs code. */
498 /* Restore the cleanup chain and error/quit messages to their
501 restore_cleanups (saved_cleanup_chain);
503 if (mask & RETURN_MASK_QUIT)
504 quit_pre_print = saved_quit_pre_print;
505 if (mask & RETURN_MASK_ERROR)
506 error_pre_print = saved_error_pre_print;
508 /* Return normally if no error/quit event occurred. */
513 /* If the caller didn't request that the event be caught, relay the
514 event to the next containing catch_errors(). */
516 if (!(mask & RETURN_MASK (caught)))
517 return_to_top_level (caught);
519 /* Tell the caller that an event was caught.
521 FIXME: nsd/2000-02-22: When MASK is RETURN_MASK_ALL, the caller
522 can't tell what type of event occurred.
524 A possible fix is to add a new interface, catch_event(), that
525 returns enum return_reason after catching an error or a quit.
527 When returning normally, i.e. without catching an error or a
528 quit, catch_event() could return RETURN_NORMAL, which would be
529 added to enum return_reason. FUNC would return information
530 exclusively via ARGS.
532 Alternatively, normal catch_event() could return FUNC's return
533 value. The caller would need to be aware of potential overlap
534 with enum return_reason, which could be publicly restricted to
535 negative values to simplify return value processing in FUNC and
541 struct captured_command_args
543 catch_command_errors_ftype *command;
549 do_captured_command (void *data)
551 struct captured_command_args *context = data;
552 context->command (context->arg, context->from_tty);
553 /* FIXME: cagney/1999-11-07: Technically this do_cleanups() call
554 isn't needed. Instead an assertion check could be made that
555 simply confirmed that the called function correctly cleaned up
556 after itself. Unfortunately, old code (prior to 1999-11-04) in
557 main.c was calling SET_TOP_LEVEL(), calling the command function,
558 and then *always* calling do_cleanups(). For the moment we
559 remain ``bug compatible'' with that old code.. */
560 do_cleanups (ALL_CLEANUPS);
565 catch_command_errors (catch_command_errors_ftype * command,
566 char *arg, int from_tty, return_mask mask)
568 struct captured_command_args args;
569 args.command = command;
571 args.from_tty = from_tty;
572 return catch_errors (do_captured_command, &args, "", mask);
576 /* Handler for SIGHUP. */
580 disconnect (int signo)
582 catch_errors (quit_cover, NULL,
583 "Could not kill the program being debugged", RETURN_MASK_ALL);
584 signal (SIGHUP, SIG_DFL);
585 kill (getpid (), SIGHUP);
588 /* Just a little helper function for disconnect(). */
590 /* NOTE 1999-04-29: This function 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 */
596 caution = 0; /* Throw caution to the wind -- we're exiting.
597 This prevents asking the user dumb questions. */
598 quit_command ((char *) 0, 0);
601 #endif /* defined SIGHUP */
603 /* Line number we are currently in in a file which is being sourced. */
604 /* NOTE 1999-04-29: This variable will be static again, once we modify
605 gdb to use the event loop as the default command loop and we merge
606 event-top.c into this file, top.c */
607 /* static */ int source_line_number;
609 /* Name of the file we are sourcing. */
610 /* NOTE 1999-04-29: This variable will be static again, once we modify
611 gdb to use the event loop as the default command loop and we merge
612 event-top.c into this file, top.c */
613 /* static */ char *source_file_name;
615 /* Buffer containing the error_pre_print used by the source stuff.
617 /* NOTE 1999-04-29: This variable will be static again, once we modify
618 gdb to use the event loop as the default command loop and we merge
619 event-top.c into this file, top.c */
620 /* static */ char *source_error;
621 static int source_error_allocated;
623 /* Something to glom on to the start of error_pre_print if source_file_name
625 /* NOTE 1999-04-29: This variable will be static again, once we modify
626 gdb to use the event loop as the default command loop and we merge
627 event-top.c into this file, top.c */
628 /* static */ char *source_pre_error;
630 /* Clean up on error during a "source" command (or execution of a
631 user-defined command). */
634 do_restore_instream_cleanup (void *stream)
636 /* Restore the previous input stream. */
640 /* Read commands from STREAM. */
642 read_command_file (FILE *stream)
644 struct cleanup *cleanups;
646 cleanups = make_cleanup (do_restore_instream_cleanup, instream);
649 do_cleanups (cleanups);
652 extern void init_proc (void);
654 void (*pre_init_ui_hook) (void);
658 do_chdir_cleanup (void *old_dir)
666 gdb_init (char *argv0)
668 if (pre_init_ui_hook)
671 /* Run the init function of each source file */
673 getcwd (gdb_dirbuf, sizeof (gdb_dirbuf));
674 current_directory = gdb_dirbuf;
677 /* Make sure we return to the original directory upon exit, come
678 what may, since the OS doesn't do that for us. */
679 make_final_cleanup (do_chdir_cleanup, xstrdup (current_directory));
682 init_cmd_lists (); /* This needs to be done first */
683 initialize_targets (); /* Setup target_terminal macros for utils.c */
684 initialize_utils (); /* Make errors and warnings possible */
685 initialize_all_files ();
686 initialize_current_architecture ();
688 init_main (); /* But that omits this file! Do it now */
690 /* The signal handling mechanism is different depending whether or
691 not the async version is run. NOTE: in the future we plan to make
692 the event loop be the default engine of gdb, and this difference
695 async_init_signals ();
699 /* We need a default language for parsing expressions, so simple things like
700 "set width 0" won't fail if no language is explicitly set in a config file
701 or implicitly set by reading an executable during startup. */
702 set_language (language_c);
703 expected_language = current_language; /* don't warn about the change. */
706 /* Install the default UI */
709 uiout = cli_out_new (gdb_stdout);
711 /* All the interpreters should have had a look at things by now.
712 Initialize the selected interpreter. */
715 fprintf_unfiltered (gdb_stderr, "Interpreter `%s' unrecognized.\n",
723 init_ui_hook (argv0);
726 /* Execute the line P as a command.
727 Pass FROM_TTY as second argument to the defining function. */
730 execute_command (char *p, int from_tty)
732 register struct cmd_list_element *c;
733 register enum language flang;
734 static int warned = 0;
736 /* FIXME: These should really be in an appropriate header file */
737 extern void serial_log_command (const char *);
741 /* Force cleanup of any alloca areas if using C alloca instead of
745 /* This can happen when command_line_input hits end of file. */
749 serial_log_command (p);
751 while (*p == ' ' || *p == '\t')
758 c = lookup_cmd (&p, cmdlist, "", 0, 1);
760 /* If the target is running, we allow only a limited set of
762 if (event_loop_p && target_can_async_p () && target_executing)
763 if (!strcmp (c->name, "help")
764 && !strcmp (c->name, "pwd")
765 && !strcmp (c->name, "show")
766 && !strcmp (c->name, "stop"))
767 error ("Cannot execute this command while the target is running.");
769 /* Pass null arg rather than an empty one. */
772 /* Clear off trailing whitespace, except for set and complete command. */
774 && c->type != set_cmd
775 && !is_complete_command (c->function.cfunc))
777 p = arg + strlen (arg) - 1;
778 while (p >= arg && (*p == ' ' || *p == '\t'))
783 /* If this command has been pre-hooked, run the hook first. */
784 if ((c->hook_pre) && (!c->hook_in))
786 c->hook_in = 1; /* Prevent recursive hooking */
787 execute_user_command (c->hook_pre, (char *) 0);
788 c->hook_in = 0; /* Allow hook to work again once it is complete */
791 if (c->flags & DEPRECATED_WARN_USER)
792 deprecated_cmd_warning (&line);
794 if (c->class == class_user)
795 execute_user_command (c, arg);
796 else if (c->type == set_cmd || c->type == show_cmd)
797 do_setshow_command (arg, from_tty & caution, c);
798 else if (c->function.cfunc == NO_FUNCTION)
799 error ("That is not a command, just a help topic.");
800 else if (call_command_hook)
801 call_command_hook (c, arg, from_tty & caution);
803 (*c->function.cfunc) (arg, from_tty & caution);
805 /* If this command has been post-hooked, run the hook last. */
806 if ((c->hook_post) && (!c->hook_in))
808 c->hook_in = 1; /* Prevent recursive hooking */
809 execute_user_command (c->hook_post, (char *) 0);
810 c->hook_in = 0; /* allow hook to work again once it is complete */
815 /* Tell the user if the language has changed (except first time). */
816 if (current_language != expected_language)
818 if (language_mode == language_mode_auto)
820 language_info (1); /* Print what changed. */
825 /* Warn the user if the working language does not match the
826 language of the current frame. Only warn the user if we are
827 actually running the program, i.e. there is a stack. */
828 /* FIXME: This should be cacheing the frame and only running when
829 the frame changes. */
831 if (target_has_stack)
833 flang = get_frame_language ();
835 && flang != language_unknown
836 && flang != current_language->la_language)
838 printf_filtered ("%s\n", lang_frame_mismatch_warn);
844 /* Read commands from `instream' and execute them
845 until end of file or error reading instream. */
850 struct cleanup *old_chain;
852 int stdin_is_tty = ISATTY (stdin);
853 long time_at_cmd_start;
855 long space_at_cmd_start = 0;
857 extern int display_time;
858 extern int display_space;
860 while (instream && !feof (instream))
863 extern int insert_mode;
865 if (window_hook && instream == stdin)
866 (*window_hook) (instream, get_prompt ());
869 if (instream == stdin && stdin_is_tty)
870 reinitialize_more_filter ();
871 old_chain = make_cleanup (null_cleanup, 0);
874 /* A bit of paranoia: I want to make sure the "insert_mode" global
875 * is clear except when it is being used for command-line editing
876 * (see tuiIO.c, utils.c); otherwise normal output will
877 * get messed up in the TUI. So clear it before/after
878 * the command-line-input call. - RT
882 /* Get a command-line. This calls the readline package. */
883 command = command_line_input (instream == stdin ?
884 get_prompt () : (char *) NULL,
885 instream == stdin, "prompt");
892 time_at_cmd_start = get_run_time ();
897 extern char **environ;
898 char *lim = (char *) sbrk (0);
900 space_at_cmd_start = (long) (lim - (char *) &environ);
904 execute_command (command, instream == stdin);
905 /* Do any commands attached to breakpoint we stopped at. */
906 bpstat_do_actions (&stop_bpstat);
907 do_cleanups (old_chain);
911 long cmd_time = get_run_time () - time_at_cmd_start;
913 printf_unfiltered ("Command execution time: %ld.%06ld\n",
914 cmd_time / 1000000, cmd_time % 1000000);
920 extern char **environ;
921 char *lim = (char *) sbrk (0);
922 long space_now = lim - (char *) &environ;
923 long space_diff = space_now - space_at_cmd_start;
925 printf_unfiltered ("Space used: %ld (%c%ld for this command)\n",
927 (space_diff >= 0 ? '+' : '-'),
934 /* Read commands from `instream' and execute them until end of file or
935 error reading instream. This command loop doesnt care about any
936 such things as displaying time and space usage. If the user asks
937 for those, they won't work. */
939 simplified_command_loop (char *(*read_input_func) (char *),
940 void (*execute_command_func) (char *, int))
942 struct cleanup *old_chain;
944 int stdin_is_tty = ISATTY (stdin);
946 while (instream && !feof (instream))
949 if (instream == stdin && stdin_is_tty)
950 reinitialize_more_filter ();
951 old_chain = make_cleanup (null_cleanup, 0);
953 /* Get a command-line. */
954 command = (*read_input_func) (instream == stdin ?
955 get_prompt () : (char *) NULL);
960 (*execute_command_func) (command, instream == stdin);
962 /* Do any commands attached to breakpoint we stopped at. */
963 bpstat_do_actions (&stop_bpstat);
965 do_cleanups (old_chain);
969 /* Commands call this if they do not want to be repeated by null lines. */
977 /* If we aren't reading from standard input, we are saving the last
978 thing read from stdin in line and don't want to delete it. Null lines
979 won't repeat here in any case. */
980 if (instream == stdin)
984 /* Read a line from the stream "instream" without command line editing.
986 It prints PROMPT_ARG once at the start.
987 Action is compatible with "readline", e.g. space for the result is
988 malloc'd and should be freed by the caller.
990 A NULL return means end of file. */
992 gdb_readline (char *prompt_arg)
997 int result_size = 80;
1001 /* Don't use a _filtered function here. It causes the assumed
1002 character position to be off, since the newline we read from
1003 the user is not accounted for. */
1004 fputs_unfiltered (prompt_arg, gdb_stdout);
1005 /* OBSOLETE #ifdef MPW */
1006 /* OBSOLETE Move to a new line so the entered line doesn't have a prompt */
1007 /* OBSOLETE on the front of it. */
1008 /* OBSOLETE fputs_unfiltered ("\n", gdb_stdout); */
1009 /* OBSOLETE #endif *//* MPW */
1010 gdb_flush (gdb_stdout);
1013 result = (char *) xmalloc (result_size);
1017 /* Read from stdin if we are executing a user defined command.
1018 This is the right thing for prompt_for_continue, at least. */
1019 c = fgetc (instream ? instream : stdin);
1023 if (input_index > 0)
1024 /* The last line does not end with a newline. Return it, and
1025 if we are called again fgetc will still return EOF and
1026 we'll return NULL then. */
1033 #ifndef CRLF_SOURCE_FILES
1037 if (input_index > 0 && result[input_index - 1] == '\r')
1043 result[input_index++] = c;
1044 while (input_index >= result_size)
1047 result = (char *) xrealloc (result, result_size);
1051 result[input_index++] = '\0';
1055 /* Variables which control command line editing and history
1056 substitution. These variables are given default values at the end
1058 static int command_editing_p;
1059 /* NOTE 1999-04-29: This variable will be static again, once we modify
1060 gdb to use the event loop as the default command loop and we merge
1061 event-top.c into this file, top.c */
1062 /* static */ int history_expansion_p;
1063 static int write_history_p;
1064 static int history_size;
1065 static char *history_filename;
1067 /* Functions that are used as part of the fancy command line editing. */
1069 /* This can be used for functions which don't want to complete on symbols
1070 but don't want to complete on anything else either. */
1073 noop_completer (char *text, char *prefix)
1078 /* Line completion interface function for readline. */
1081 readline_line_completion_function (char *text, int matches)
1083 return line_completion_function (text, matches, rl_line_buffer, rl_point);
1088 stop_sig (int signo)
1090 #if STOP_SIGNAL == SIGTSTP
1091 signal (SIGTSTP, SIG_DFL);
1093 kill (getpid (), SIGTSTP);
1094 signal (SIGTSTP, stop_sig);
1096 signal (STOP_SIGNAL, stop_sig);
1098 printf_unfiltered ("%s", get_prompt ());
1099 gdb_flush (gdb_stdout);
1101 /* Forget about any previous command -- null line now will do nothing. */
1104 #endif /* STOP_SIGNAL */
1106 /* Initialize signal handlers. */
1108 do_nothing (int signo)
1110 /* Under System V the default disposition of a signal is reinstated after
1111 the signal is caught and delivered to an application process. On such
1112 systems one must restore the replacement signal handler if one wishes
1113 to continue handling the signal in one's program. On BSD systems this
1114 is not needed but it is harmless, and it simplifies the code to just do
1115 it unconditionally. */
1116 signal (signo, do_nothing);
1122 signal (SIGINT, request_quit);
1124 /* If SIGTRAP was set to SIG_IGN, then the SIG_IGN will get passed
1125 to the inferior and breakpoints will be ignored. */
1127 signal (SIGTRAP, SIG_DFL);
1130 /* If we initialize SIGQUIT to SIG_IGN, then the SIG_IGN will get
1131 passed to the inferior, which we don't want. It would be
1132 possible to do a "signal (SIGQUIT, SIG_DFL)" after we fork, but
1133 on BSD4.3 systems using vfork, that can affect the
1134 GDB process as well as the inferior (the signal handling tables
1135 might be in memory, shared between the two). Since we establish
1136 a handler for SIGQUIT, when we call exec it will set the signal
1137 to SIG_DFL for us. */
1138 signal (SIGQUIT, do_nothing);
1140 if (signal (SIGHUP, do_nothing) != SIG_IGN)
1141 signal (SIGHUP, disconnect);
1143 signal (SIGFPE, float_handler);
1145 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1146 signal (SIGWINCH, SIGWINCH_HANDLER);
1150 /* Read one line from the command input stream `instream'
1151 into the local static buffer `linebuffer' (whose current length
1153 The buffer is made bigger as necessary.
1154 Returns the address of the start of the line.
1156 NULL is returned for end of file.
1158 *If* the instream == stdin & stdin is a terminal, the line read
1159 is copied into the file line saver (global var char *line,
1160 length linesize) so that it can be duplicated.
1162 This routine either uses fancy command line editing or
1163 simple input as the user has requested. */
1166 command_line_input (char *prompt_arg, int repeat, char *annotation_suffix)
1168 static char *linebuffer = 0;
1169 static unsigned linelength = 0;
1173 char *local_prompt = prompt_arg;
1177 /* The annotation suffix must be non-NULL. */
1178 if (annotation_suffix == NULL)
1179 annotation_suffix = "";
1181 if (annotation_level > 1 && instream == stdin)
1183 local_prompt = alloca ((prompt_arg == NULL ? 0 : strlen (prompt_arg))
1184 + strlen (annotation_suffix) + 40);
1185 if (prompt_arg == NULL)
1186 local_prompt[0] = '\0';
1188 strcpy (local_prompt, prompt_arg);
1189 strcat (local_prompt, "\n\032\032");
1190 strcat (local_prompt, annotation_suffix);
1191 strcat (local_prompt, "\n");
1194 if (linebuffer == 0)
1197 linebuffer = (char *) xmalloc (linelength);
1202 /* Control-C quits instantly if typed while in this loop
1203 since it should not wait until the user types a newline. */
1209 signal (STOP_SIGNAL, handle_stop_sig);
1211 signal (STOP_SIGNAL, stop_sig);
1217 /* Make sure that all output has been output. Some machines may let
1218 you get away with leaving out some of the gdb_flush, but not all. */
1220 gdb_flush (gdb_stdout);
1221 gdb_flush (gdb_stderr);
1223 if (source_file_name != NULL)
1225 ++source_line_number;
1226 sprintf (source_error,
1227 "%s%s:%d: Error in sourced command file:\n",
1230 source_line_number);
1231 error_pre_print = source_error;
1234 if (annotation_level > 1 && instream == stdin)
1236 printf_unfiltered ("\n\032\032pre-");
1237 printf_unfiltered (annotation_suffix);
1238 printf_unfiltered ("\n");
1241 /* Don't use fancy stuff if not talking to stdin. */
1242 if (readline_hook && instream == NULL)
1244 rl = (*readline_hook) (local_prompt);
1246 else if (command_editing_p && instream == stdin && ISATTY (instream))
1248 rl = readline (local_prompt);
1252 rl = gdb_readline (local_prompt);
1255 if (annotation_level > 1 && instream == stdin)
1257 printf_unfiltered ("\n\032\032post-");
1258 printf_unfiltered (annotation_suffix);
1259 printf_unfiltered ("\n");
1262 if (!rl || rl == (char *) EOF)
1267 if (strlen (rl) + 1 + (p - linebuffer) > linelength)
1269 linelength = strlen (rl) + 1 + (p - linebuffer);
1270 nline = (char *) xrealloc (linebuffer, linelength);
1271 p += nline - linebuffer;
1275 /* Copy line. Don't copy null at end. (Leaves line alone
1276 if this was just a newline) */
1280 xfree (rl); /* Allocated in readline. */
1282 if (p == linebuffer || *(p - 1) != '\\')
1285 p--; /* Put on top of '\'. */
1286 local_prompt = (char *) 0;
1291 signal (STOP_SIGNAL, SIG_DFL);
1298 #define SERVER_COMMAND_LENGTH 7
1300 (p - linebuffer > SERVER_COMMAND_LENGTH)
1301 && STREQN (linebuffer, "server ", SERVER_COMMAND_LENGTH);
1304 /* Note that we don't set `line'. Between this and the check in
1305 dont_repeat, this insures that repeating will still do the
1308 return linebuffer + SERVER_COMMAND_LENGTH;
1311 /* Do history expansion if that is wished. */
1312 if (history_expansion_p && instream == stdin
1313 && ISATTY (instream))
1315 char *history_value;
1318 *p = '\0'; /* Insert null now. */
1319 expanded = history_expand (linebuffer, &history_value);
1322 /* Print the changes. */
1323 printf_unfiltered ("%s\n", history_value);
1325 /* If there was an error, call this function again. */
1328 xfree (history_value);
1329 return command_line_input (prompt_arg, repeat, annotation_suffix);
1331 if (strlen (history_value) > linelength)
1333 linelength = strlen (history_value) + 1;
1334 linebuffer = (char *) xrealloc (linebuffer, linelength);
1336 strcpy (linebuffer, history_value);
1337 p = linebuffer + strlen (linebuffer);
1338 xfree (history_value);
1342 /* If we just got an empty line, and that is supposed
1343 to repeat the previous command, return the value in the
1345 if (repeat && p == linebuffer)
1347 for (p1 = linebuffer; *p1 == ' ' || *p1 == '\t'; p1++);
1353 /* Add line to history if appropriate. */
1354 if (instream == stdin
1355 && ISATTY (stdin) && *linebuffer)
1356 add_history (linebuffer);
1358 /* Note: lines consisting solely of comments are added to the command
1359 history. This is useful when you type a command, and then
1360 realize you don't want to execute it quite yet. You can comment
1361 out the command and then later fetch it from the value history
1362 and remove the '#'. The kill ring is probably better, but some
1363 people are in the habit of commenting things out. */
1365 *p1 = '\0'; /* Found a comment. */
1367 /* Save into global buffer if appropriate. */
1370 if (linelength > linesize)
1372 line = xrealloc (line, linelength);
1373 linesize = linelength;
1375 strcpy (line, linebuffer);
1382 /* Print the GDB banner. */
1384 print_gdb_version (struct ui_file *stream)
1386 /* From GNU coding standards, first line is meant to be easy for a
1387 program to parse, and is just canonical program name and version
1388 number, which starts after last space. */
1391 /* Print it console style until a format is defined */
1392 fprintf_filtered (stream, "GNU gdb %s (MI_OUT)\n", version);
1394 fprintf_filtered (stream, "GNU gdb %s\n", version);
1397 /* Second line is a copyright notice. */
1399 fprintf_filtered (stream, "Copyright 2001 Free Software Foundation, Inc.\n");
1401 /* Following the copyright is a brief statement that the program is
1402 free software, that users are free to copy and change it on
1403 certain conditions, that it is covered by the GNU GPL, and that
1404 there is no warranty. */
1406 fprintf_filtered (stream, "\
1407 GDB is free software, covered by the GNU General Public License, and you are\n\
1408 welcome to change it and/or distribute copies of it under certain conditions.\n\
1409 Type \"show copying\" to see the conditions.\n\
1410 There is absolutely no warranty for GDB. Type \"show warranty\" for details.\n");
1412 /* After the required info we print the configuration information. */
1414 fprintf_filtered (stream, "This GDB was configured as \"");
1415 if (!STREQ (host_name, target_name))
1417 fprintf_filtered (stream, "--host=%s --target=%s", host_name, target_name);
1421 fprintf_filtered (stream, "%s", host_name);
1423 fprintf_filtered (stream, "\".");
1426 /* get_prompt: access method for the GDB prompt string. */
1428 #define MAX_PROMPT_SIZE 256
1431 * int get_prompt_1 (char * buf);
1433 * Work-horse for get_prompt (called via catch_errors).
1434 * Argument is buffer to hold the formatted prompt.
1436 * Returns: 1 for success (use formatted prompt)
1437 * 0 for failure (use gdb_prompt_string).
1440 static int gdb_prompt_escape;
1443 get_prompt_1 (void *data)
1445 char *formatted_prompt = data;
1449 local_prompt = PROMPT (0);
1451 local_prompt = gdb_prompt_string;
1454 if (gdb_prompt_escape == 0)
1456 return 0; /* do no formatting */
1459 /* formatted prompt */
1461 char fmt[40], *promptp, *outp, *tmp;
1468 struct type *arg_type, *elt_type;
1470 promptp = local_prompt;
1471 outp = formatted_prompt;
1473 while (*promptp != '\0')
1475 int available = MAX_PROMPT_SIZE - (outp - formatted_prompt) - 1;
1477 if (*promptp != gdb_prompt_escape)
1479 if (available >= 1) /* overflow protect */
1480 *outp++ = *promptp++;
1484 /* GDB prompt string contains escape char. Parse for arg.
1485 Two consecutive escape chars followed by arg followed by
1486 a comma means to insert the arg using a default format.
1487 Otherwise a printf format string may be included between
1488 the two escape chars. eg:
1489 %%foo, insert foo using default format
1490 %2.2f%foo, insert foo using "%2.2f" format
1491 A mismatch between the format string and the data type
1492 of "foo" is an error (which we don't know how to protect
1495 fmt[0] = '\0'; /* assume null format string */
1496 if (promptp[1] == gdb_prompt_escape) /* double esc char */
1498 promptp += 2; /* skip past two escape chars. */
1502 /* extract format string from between two esc chars */
1506 fmt[i++] = *promptp++; /* copy format string */
1508 while (i < sizeof (fmt) - 1 &&
1509 *promptp != gdb_prompt_escape &&
1512 if (*promptp != gdb_prompt_escape)
1513 error ("Syntax error at prompt position %d",
1514 promptp - local_prompt);
1517 promptp++; /* skip second escape char */
1518 fmt[i++] = '\0'; /* terminate the format string */
1522 arg_val = parse_to_comma_and_eval (&promptp);
1523 if (*promptp == ',')
1524 promptp++; /* skip past the comma */
1525 arg_type = check_typedef (VALUE_TYPE (arg_val));
1526 switch (TYPE_CODE (arg_type))
1528 case TYPE_CODE_ARRAY:
1529 elt_type = check_typedef (TYPE_TARGET_TYPE (arg_type));
1530 if (TYPE_LENGTH (arg_type) > 0 &&
1531 TYPE_LENGTH (elt_type) == 1 &&
1532 TYPE_CODE (elt_type) == TYPE_CODE_INT)
1534 int len = TYPE_LENGTH (arg_type);
1536 if (VALUE_LAZY (arg_val))
1537 value_fetch_lazy (arg_val);
1538 tmp = VALUE_CONTENTS (arg_val);
1540 if (len > available)
1541 len = available; /* overflow protect */
1543 /* FIXME: how to protect GDB from crashing
1544 from bad user-supplied format string? */
1546 sprintf (outp, fmt, tmp);
1548 strncpy (outp, tmp, len);
1553 elt_type = check_typedef (TYPE_TARGET_TYPE (arg_type));
1554 addrval = value_as_pointer (arg_val);
1556 if (TYPE_LENGTH (elt_type) == 1 &&
1557 TYPE_CODE (elt_type) == TYPE_CODE_INT &&
1560 /* display it as a string */
1561 char *default_fmt = "%s";
1565 /* Limiting the number of bytes that the following call
1566 will read protects us from sprintf overflow later. */
1567 i = target_read_string (addrval, /* src */
1569 available, /* len */
1571 if (err) /* read failed */
1572 error ("%s on target_read", safe_strerror (err));
1574 tmp[i] = '\0'; /* force-terminate string */
1575 /* FIXME: how to protect GDB from crashing
1576 from bad user-supplied format string? */
1577 sprintf (outp, fmt[0] == 0 ? default_fmt : fmt,
1583 /* display it as a pointer */
1584 char *default_fmt = "0x%x";
1586 /* FIXME: how to protect GDB from crashing
1587 from bad user-supplied format string? */
1588 if (available >= 16 /*? */ ) /* overflow protect */
1589 sprintf (outp, fmt[0] == 0 ? default_fmt : fmt,
1595 char *default_fmt = "%g";
1597 doubleval = value_as_double (arg_val);
1598 /* FIXME: how to protect GDB from crashing
1599 from bad user-supplied format string? */
1600 if (available >= 16 /*? */ ) /* overflow protect */
1601 sprintf (outp, fmt[0] == 0 ? default_fmt : fmt,
1602 (double) doubleval);
1607 char *default_fmt = "%d";
1609 longval = value_as_long (arg_val);
1610 /* FIXME: how to protect GDB from crashing
1611 from bad user-supplied format string? */
1612 if (available >= 16 /*? */ ) /* overflow protect */
1613 sprintf (outp, fmt[0] == 0 ? default_fmt : fmt,
1617 case TYPE_CODE_BOOL:
1619 /* no default format for bool */
1620 longval = value_as_long (arg_val);
1621 if (available >= 8 /*? */ ) /* overflow protect */
1624 strcpy (outp, "<true>");
1626 strcpy (outp, "<false>");
1630 case TYPE_CODE_ENUM:
1632 /* no default format for enum */
1633 longval = value_as_long (arg_val);
1634 len = TYPE_NFIELDS (arg_type);
1635 /* find enum name if possible */
1636 for (i = 0; i < len; i++)
1637 if (TYPE_FIELD_BITPOS (arg_type, i) == longval)
1638 break; /* match -- end loop */
1640 if (i < len) /* enum name found */
1642 char *name = TYPE_FIELD_NAME (arg_type, i);
1644 strncpy (outp, name, available);
1645 /* in casel available < strlen (name), */
1646 outp[available] = '\0';
1650 if (available >= 16 /*? */ ) /* overflow protect */
1651 sprintf (outp, "%ld", (long) longval);
1655 case TYPE_CODE_VOID:
1657 break; /* void type -- no output */
1659 error ("bad data type at prompt position %d",
1660 promptp - local_prompt);
1663 outp += strlen (outp);
1666 *outp++ = '\0'; /* terminate prompt string */
1674 static char buf[MAX_PROMPT_SIZE];
1676 if (catch_errors (get_prompt_1, buf, "bad formatted prompt: ",
1679 return &buf[0]; /* successful formatted prompt */
1683 /* Prompt could not be formatted. */
1687 return gdb_prompt_string;
1692 set_prompt (char *s)
1694 /* ??rehrauer: I don't know why this fails, since it looks as though
1695 assignments to prompt are wrapped in calls to savestring...
1700 PROMPT (0) = savestring (s, strlen (s));
1702 gdb_prompt_string = savestring (s, strlen (s));
1706 /* If necessary, make the user confirm that we should quit. Return
1707 non-zero if we should quit, zero if we shouldn't. */
1712 if (inferior_pid != 0 && target_has_execution)
1716 /* This is something of a hack. But there's no reliable way to
1717 see if a GUI is running. The `use_windows' variable doesn't
1720 s = "A debugging session is active.\nDo you still want to close the debugger?";
1721 else if (attach_flag)
1722 s = "The program is running. Quit anyway (and detach it)? ";
1724 s = "The program is running. Exit anyway? ";
1733 /* Quit without asking for confirmation. */
1736 quit_force (char *args, int from_tty)
1740 /* An optional expression may be used to cause gdb to terminate with the
1741 value of that expression. */
1744 value_ptr val = parse_and_eval (args);
1746 exit_code = (int) value_as_long (val);
1749 if (inferior_pid != 0 && target_has_execution)
1752 target_detach (args, from_tty);
1757 /* UDI wants this, to kill the TIP. */
1760 /* Save the history information if it is appropriate to do so. */
1761 if (write_history_p && history_filename)
1762 write_history (history_filename);
1764 do_final_cleanups (ALL_CLEANUPS); /* Do any final cleanups before exiting */
1767 /* tuiDo((TuiOpaqueFuncPtr)tuiCleanUp); */
1768 /* The above does not need to be inside a tuiDo(), since
1769 * it is not manipulating the curses screen, but rather,
1770 * it is tearing it down.
1779 /* Returns whether GDB is running on a terminal and whether the user
1780 desires that questions be asked of them on that terminal. */
1783 input_from_terminal_p (void)
1785 return gdb_has_a_terminal () && (instream == stdin) & caution;
1790 dont_repeat_command (char *ignored, int from_tty)
1792 *line = 0; /* Can't call dont_repeat here because we're not
1793 necessarily reading from stdin. */
1796 /* Functions to manipulate command line editing control variables. */
1798 /* Number of commands to print in each call to show_commands. */
1799 #define Hist_print 10
1801 show_commands (char *args, int from_tty)
1803 /* Index for history commands. Relative to history_base. */
1806 /* Number of the history entry which we are planning to display next.
1807 Relative to history_base. */
1810 /* The first command in the history which doesn't exist (i.e. one more
1811 than the number of the last command). Relative to history_base. */
1814 extern HIST_ENTRY *history_get (int);
1816 /* Print out some of the commands from the command history. */
1817 /* First determine the length of the history list. */
1818 hist_len = history_size;
1819 for (offset = 0; offset < history_size; offset++)
1821 if (!history_get (history_base + offset))
1830 if (args[0] == '+' && args[1] == '\0')
1831 /* "info editing +" should print from the stored position. */
1834 /* "info editing <exp>" should print around command number <exp>. */
1835 num = (parse_and_eval_long (args) - history_base) - Hist_print / 2;
1837 /* "show commands" means print the last Hist_print commands. */
1840 num = hist_len - Hist_print;
1846 /* If there are at least Hist_print commands, we want to display the last
1847 Hist_print rather than, say, the last 6. */
1848 if (hist_len - num < Hist_print)
1850 num = hist_len - Hist_print;
1855 for (offset = num; offset < num + Hist_print && offset < hist_len; offset++)
1857 printf_filtered ("%5d %s\n", history_base + offset,
1858 (history_get (history_base + offset))->line);
1861 /* The next command we want to display is the next one that we haven't
1865 /* If the user repeats this command with return, it should do what
1866 "show commands +" does. This is unnecessary if arg is null,
1867 because "show commands +" is not useful after "show commands". */
1868 if (from_tty && args)
1875 /* Called by do_setshow_command. */
1878 set_history_size_command (char *args, int from_tty, struct cmd_list_element *c)
1880 if (history_size == INT_MAX)
1881 unstifle_history ();
1882 else if (history_size >= 0)
1883 stifle_history (history_size);
1886 history_size = INT_MAX;
1887 error ("History size must be non-negative");
1893 set_history (char *args, int from_tty)
1895 printf_unfiltered ("\"set history\" must be followed by the name of a history subcommand.\n");
1896 help_list (sethistlist, "set history ", -1, gdb_stdout);
1901 show_history (char *args, int from_tty)
1903 cmd_show_list (showhistlist, from_tty, "");
1906 int info_verbose = 0; /* Default verbose msgs off */
1908 /* Called by do_setshow_command. An elaborate joke. */
1911 set_verbose (char *args, int from_tty, struct cmd_list_element *c)
1913 char *cmdname = "verbose";
1914 struct cmd_list_element *showcmd;
1916 showcmd = lookup_cmd_1 (&cmdname, showlist, NULL, 1);
1920 c->doc = "Set verbose printing of informational messages.";
1921 showcmd->doc = "Show verbose printing of informational messages.";
1925 c->doc = "Set verbosity.";
1926 showcmd->doc = "Show verbosity.";
1931 float_handler (int signo)
1933 /* This message is based on ANSI C, section 4.7. Note that integer
1934 divide by zero causes this, so "float" is a misnomer. */
1935 signal (SIGFPE, float_handler);
1936 error ("Erroneous arithmetic operation.");
1939 /* Init the history buffer. Note that we are called after the init file(s)
1940 * have been read so that the user can change the history file via his
1941 * .gdbinit file (for instance). The GDBHISTFILE environment variable
1942 * overrides all of this.
1950 tmpenv = getenv ("HISTSIZE");
1952 history_size = atoi (tmpenv);
1953 else if (!history_size)
1956 stifle_history (history_size);
1958 tmpenv = getenv ("GDBHISTFILE");
1960 history_filename = savestring (tmpenv, strlen (tmpenv));
1961 else if (!history_filename)
1963 /* We include the current directory so that if the user changes
1964 directories the file written will be the same as the one
1967 /* No leading dots in file names are allowed on MSDOS. */
1968 history_filename = concat (current_directory, "/_gdb_history", NULL);
1970 history_filename = concat (current_directory, "/.gdb_history", NULL);
1973 read_history (history_filename);
1979 struct cmd_list_element *c;
1981 /* If we are running the asynchronous version,
1982 we initialize the prompts differently. */
1985 gdb_prompt_string = savestring (DEFAULT_PROMPT, strlen (DEFAULT_PROMPT));
1989 /* initialize the prompt stack to a simple "(gdb) " prompt or to
1990 whatever the DEFAULT_PROMPT is. */
1991 the_prompts.top = 0;
1993 PROMPT (0) = savestring (DEFAULT_PROMPT, strlen (DEFAULT_PROMPT));
1995 /* Set things up for annotation_level > 1, if the user ever decides
1997 async_annotation_suffix = "prompt";
1998 /* Set the variable associated with the setshow prompt command. */
1999 new_async_prompt = savestring (PROMPT (0), strlen (PROMPT (0)));
2001 /* If gdb was started with --annotate=2, this is equivalent to
2002 the user entering the command 'set annotate 2' at the gdb
2003 prompt, so we need to do extra processing. */
2004 if (annotation_level > 1)
2005 set_async_annotation_level (NULL, 0, NULL);
2007 gdb_prompt_escape = 0; /* default to none. */
2009 /* Set the important stuff up for command editing. */
2010 command_editing_p = 1;
2011 history_expansion_p = 0;
2012 write_history_p = 0;
2014 /* Setup important stuff for command line editing. */
2015 rl_completion_entry_function = (int (*)()) readline_line_completion_function;
2016 rl_completer_word_break_characters =
2017 get_gdb_completer_word_break_characters ();
2018 rl_completer_quote_characters = get_gdb_completer_quote_characters ();
2019 rl_readline_name = "gdb";
2021 /* The set prompt command is different depending whether or not the
2022 async version is run. NOTE: this difference is going to
2023 disappear as we make the event loop be the default engine of
2028 (add_set_cmd ("prompt", class_support, var_string,
2029 (char *) &gdb_prompt_string, "Set gdb's prompt",
2035 c = add_set_cmd ("prompt", class_support, var_string,
2036 (char *) &new_async_prompt, "Set gdb's prompt",
2038 add_show_from_set (c, &showlist);
2039 c->function.sfunc = set_async_prompt;
2043 (add_set_cmd ("prompt-escape-char", class_support, var_zinteger,
2044 (char *) &gdb_prompt_escape,
2045 "Set escape character for formatting of gdb's prompt",
2049 add_com ("dont-repeat", class_support, dont_repeat_command, "Don't repeat this command.\n\
2050 Primarily used inside of user-defined commands that should not be repeated when\n\
2053 /* The set editing command is different depending whether or not the
2054 async version is run. NOTE: this difference is going to disappear
2055 as we make the event loop be the default engine of gdb. */
2059 (add_set_cmd ("editing", class_support, var_boolean, (char *) &command_editing_p,
2060 "Set editing of command lines as they are typed.\n\
2061 Use \"on\" to enable the editing, and \"off\" to disable it.\n\
2062 Without an argument, command line editing is enabled. To edit, use\n\
2063 EMACS-like or VI-like commands like control-P or ESC.", &setlist),
2068 c = add_set_cmd ("editing", class_support, var_boolean, (char *) &async_command_editing_p,
2069 "Set editing of command lines as they are typed.\n\
2070 Use \"on\" to enable the editing, and \"off\" to disable it.\n\
2071 Without an argument, command line editing is enabled. To edit, use\n\
2072 EMACS-like or VI-like commands like control-P or ESC.", &setlist);
2074 add_show_from_set (c, &showlist);
2075 c->function.sfunc = set_async_editing_command;
2079 (add_set_cmd ("save", no_class, var_boolean, (char *) &write_history_p,
2080 "Set saving of the history record on exit.\n\
2081 Use \"on\" to enable the saving, and \"off\" to disable it.\n\
2082 Without an argument, saving is enabled.", &sethistlist),
2085 c = add_set_cmd ("size", no_class, var_integer, (char *) &history_size,
2086 "Set the size of the command history, \n\
2087 ie. the number of previous commands to keep a record of.", &sethistlist);
2088 add_show_from_set (c, &showhistlist);
2089 c->function.sfunc = set_history_size_command;
2091 c = add_set_cmd ("filename", no_class, var_filename,
2092 (char *) &history_filename,
2093 "Set the filename in which to record the command history\n\
2094 (the list of previous commands of which a record is kept).", &sethistlist);
2095 c->completer = filename_completer;
2096 add_show_from_set (c, &showhistlist);
2099 (add_set_cmd ("confirm", class_support, var_boolean,
2101 "Set whether to confirm potentially dangerous operations.",
2105 /* The set annotate command is different depending whether or not
2106 the async version is run. NOTE: this difference is going to
2107 disappear as we make the event loop be the default engine of
2111 c = add_set_cmd ("annotate", class_obscure, var_zinteger,
2112 (char *) &annotation_level, "Set annotation_level.\n\
2113 0 == normal; 1 == fullname (for use when running under emacs)\n\
2114 2 == output annotated suitably for use by programs that control GDB.",
2116 c = add_show_from_set (c, &showlist);
2120 c = add_set_cmd ("annotate", class_obscure, var_zinteger,
2121 (char *) &annotation_level, "Set annotation_level.\n\
2122 0 == normal; 1 == fullname (for use when running under emacs)\n\
2123 2 == output annotated suitably for use by programs that control GDB.",
2125 add_show_from_set (c, &showlist);
2126 c->function.sfunc = set_async_annotation_level;
2131 (add_set_cmd ("exec-done-display", class_support, var_boolean, (char *) &exec_done_display_p,
2132 "Set notification of completion for asynchronous execution commands.\n\
2133 Use \"on\" to enable the notification, and \"off\" to disable it.", &setlist),