1 /* Top level `main' program for GDB, the GNU debugger.
2 Copyright 1986, 1987, 1988, 1989, 1990, 1991, 1992
3 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., 675 Mass Ave, Cambridge, MA 02139, USA. */
23 #include "call-cmds.h"
28 #include "breakpoint.h"
30 #include "expression.h"
35 /* readline include files */
39 /* readline defines this. */
43 #include <sys/types.h>
52 #include <sys/param.h>
56 #ifdef SET_STACK_LIMIT_HUGE
58 #include <sys/resource.h>
60 int original_stack_limit;
63 /* Prototypes for local functions */
66 symbol_completion_function PARAMS ((char *, int));
69 command_loop PARAMS ((void));
72 command_loop_marker PARAMS ((int));
75 print_gdb_version PARAMS ((void));
78 quit_command PARAMS ((char *, int));
81 initialize_main PARAMS ((void));
84 initialize_history PARAMS ((void));
87 initialize_cmd_lists PARAMS ((void));
90 float_handler PARAMS ((int));
93 source_command PARAMS ((char *, int));
96 cd_command PARAMS ((char *, int));
99 print_gnu_advertisement PARAMS ((void));
102 init_signals PARAMS ((void));
105 read_command_file PARAMS ((FILE *));
108 set_verbose PARAMS ((char *, int, struct cmd_list_element *));
111 show_history PARAMS ((char *, int));
114 set_history PARAMS ((char *, int));
117 set_history_size_command PARAMS ((char *, int, struct cmd_list_element *));
120 show_commands PARAMS ((char *, int));
123 echo_command PARAMS ((char *, int));
126 pwd_command PARAMS ((char *, int));
129 show_version PARAMS ((char *, int));
132 document_command PARAMS ((char *, int));
135 define_command PARAMS ((char *, int));
138 validate_comname PARAMS ((char *));
141 help_command PARAMS ((char *, int));
144 show_command PARAMS ((char *, int));
147 info_command PARAMS ((char *, int));
150 do_nothing PARAMS ((int));
153 disconnect PARAMS ((int));
156 source_cleanup PARAMS ((FILE *));
158 /* If this definition isn't overridden by the header files, assume
159 that isatty and fileno exist on this system. */
161 #define ISATTY(FP) (isatty (fileno (FP)))
164 /* Initialization file name for gdb. This is overridden in some configs. */
166 #ifndef GDBINIT_FILENAME
167 #define GDBINIT_FILENAME ".gdbinit"
169 char gdbinit[] = GDBINIT_FILENAME;
171 #define ALL_CLEANUPS ((struct cleanup *)0)
173 /* Version number of GDB, as a string. */
175 extern char *version;
177 /* Message to be printed before the error message, when an error occurs. */
179 extern char *error_pre_print;
181 /* Message to be printed before the warning message, when a warning occurs. */
183 extern char *warning_pre_print;
185 extern char lang_frame_mismatch_warn[]; /* language.c */
187 /* Whether GDB's stdin is on a terminal. */
189 extern int gdb_has_a_terminal; /* inflow.c */
191 /* Flag for whether we want all the "from_tty" gubbish printed. */
193 int caution = 1; /* Default is yes, sigh. */
196 * Define all cmd_list_element's
199 /* Chain containing all defined commands. */
201 struct cmd_list_element *cmdlist;
203 /* Chain containing all defined info subcommands. */
205 struct cmd_list_element *infolist;
207 /* Chain containing all defined enable subcommands. */
209 struct cmd_list_element *enablelist;
211 /* Chain containing all defined disable subcommands. */
213 struct cmd_list_element *disablelist;
215 /* Chain containing all defined delete subcommands. */
217 struct cmd_list_element *deletelist;
219 /* Chain containing all defined "enable breakpoint" subcommands. */
221 struct cmd_list_element *enablebreaklist;
223 /* Chain containing all defined set subcommands */
225 struct cmd_list_element *setlist;
227 /* Chain containing all defined unset subcommands */
229 struct cmd_list_element *unsetlist;
231 /* Chain containing all defined show subcommands. */
233 struct cmd_list_element *showlist;
235 /* Chain containing all defined \"set history\". */
237 struct cmd_list_element *sethistlist;
239 /* Chain containing all defined \"show history\". */
241 struct cmd_list_element *showhistlist;
243 /* Chain containing all defined \"unset history\". */
245 struct cmd_list_element *unsethistlist;
247 /* Chain containing all defined maintenance subcommands. */
250 struct cmd_list_element *maintenancelist;
253 /* Chain containing all defined "maintenance info" subcommands. */
256 struct cmd_list_element *maintenanceinfolist;
259 /* Chain containing all defined "maintenance print" subcommands. */
262 struct cmd_list_element *maintenanceprintlist;
265 struct cmd_list_element *setprintlist;
267 struct cmd_list_element *showprintlist;
269 struct cmd_list_element *setchecklist;
271 struct cmd_list_element *showchecklist;
273 /* stdio stream that command input is being read from. */
277 /* Current working directory. */
279 char *current_directory;
281 /* The directory name is actually stored here (usually). */
282 static char dirbuf[1024];
284 /* Function to call before reading a command, if nonzero.
285 The function receives two args: an input stream,
286 and a prompt string. */
288 void (*window_hook) PARAMS ((FILE *, char *));
290 extern int frame_file_full_name;
291 extern int mapped_symbol_files;
292 extern int readnow_symbol_files;
297 /* gdb prints this when reading a command interactively */
300 /* Buffer used for reading command lines, and the size
301 allocated for it so far. */
306 /* Baud rate specified for talking to serial target systems. Default
307 is left as a zero pointer, so targets can choose their own defaults. */
311 /* Signal to catch ^Z typed while reading a command: SIGTSTP or SIGCONT. */
315 #define STOP_SIGNAL SIGTSTP
316 static void stop_sig PARAMS ((int));
320 /* Some System V have job control but not sigsetmask(). */
321 #if !defined (HAVE_SIGSETMASK)
322 #define HAVE_SIGSETMASK !defined (USG)
325 #if 0 == (HAVE_SIGSETMASK)
326 #define sigsetmask(n)
329 /* This is how `error' returns to command level. */
331 jmp_buf to_top_level;
334 return_to_top_level ()
338 bpstat_clear_actions(stop_bpstat); /* Clear queued breakpoint commands */
339 disable_current_display ();
340 do_cleanups (ALL_CLEANUPS);
341 (NORETURN void) longjmp (to_top_level, 1);
344 /* Call FUNC with arg ARGS, catching any errors.
345 If there is no error, return the value returned by FUNC.
346 If there is an error, print ERRSTRING, print the specific error message,
350 catch_errors (func, args, errstring)
351 int (*func) PARAMS ((char *));
357 struct cleanup *saved_cleanup_chain;
358 char *saved_error_pre_print;
360 saved_cleanup_chain = save_cleanups ();
361 saved_error_pre_print = error_pre_print;
363 memcpy ((char *)saved, (char *)to_top_level, sizeof (jmp_buf));
364 error_pre_print = errstring;
366 if (setjmp (to_top_level) == 0)
367 val = (*func) (args);
371 restore_cleanups (saved_cleanup_chain);
373 error_pre_print = saved_error_pre_print;
374 memcpy ((char *)to_top_level, (char *)saved, sizeof (jmp_buf));
378 /* Handler for SIGHUP. */
384 kill_inferior_fast ();
385 signal (signo, SIG_DFL);
386 kill (getpid (), SIGHUP);
389 /* Clean up on error during a "source" command (or execution of a
390 user-defined command). */
393 source_cleanup (stream)
396 /* Restore the previous input stream. */
400 /* Read commands from STREAM. */
402 read_command_file (stream)
405 struct cleanup *cleanups;
407 cleanups = make_cleanup (source_cleanup, instream);
410 do_cleanups (cleanups);
419 static int inhibit_gdbinit = 0;
420 static int quiet = 0;
421 static int batch = 0;
423 /* Pointers to various arguments from command line. */
425 char *execarg = NULL;
426 char *corearg = NULL;
430 /* Pointers to all arguments of +command option. */
432 /* Allocated size of cmdarg. */
434 /* Number of elements of cmdarg used. */
437 /* Indices of all arguments of +directory option. */
439 /* Allocated size. */
441 /* Number of elements used. */
444 struct stat homebuf, cwdbuf;
445 char *homedir, *homeinit;
449 /* This needs to happen before the first use of malloc. */
450 init_malloc ((PTR) NULL);
452 #if defined (ALIGN_STACK_ON_STARTUP)
453 i = (int) &count & 0x3;
458 /* If error() is called from initialization code, just exit */
459 if (setjmp (to_top_level)) {
464 cmdarg = (char **) xmalloc (cmdsize * sizeof (*cmdarg));
467 dirarg = (char **) xmalloc (dirsize * sizeof (*dirarg));
471 line = (char *) xmalloc (linesize);
472 line[0] = '\0'; /* Terminate saved (now empty) cmd line */
475 getcwd (dirbuf, sizeof (dirbuf));
476 current_directory = dirbuf;
478 #ifdef SET_STACK_LIMIT_HUGE
482 /* Set the stack limit huge so that alloca (particularly stringtab
483 * in dbxread.c) does not fail. */
484 getrlimit (RLIMIT_STACK, &rlim);
485 original_stack_limit = rlim.rlim_cur;
486 rlim.rlim_cur = rlim.rlim_max;
487 setrlimit (RLIMIT_STACK, &rlim);
489 #endif /* SET_STACK_LIMIT_HUGE */
491 /* Parse arguments and options. */
494 static int print_help;
495 /* When var field is 0, use flag field to record the equivalent
496 short option (or arbitrary numbers starting at 10 for those
497 with no equivalent). */
498 static struct option long_options[] =
500 {"readnow", no_argument, &readnow_symbol_files, 1},
501 {"r", no_argument, &readnow_symbol_files, 1},
502 {"mapped", no_argument, &mapped_symbol_files, 1},
503 {"m", no_argument, &mapped_symbol_files, 1},
504 {"quiet", no_argument, &quiet, 1},
505 {"q", no_argument, &quiet, 1},
506 {"nx", no_argument, &inhibit_gdbinit, 1},
507 {"n", no_argument, &inhibit_gdbinit, 1},
508 {"batch", no_argument, &batch, 1},
509 {"epoch", no_argument, &epoch_interface, 1},
510 {"fullname", no_argument, &frame_file_full_name, 1},
511 {"f", no_argument, &frame_file_full_name, 1},
512 {"help", no_argument, &print_help, 1},
513 {"se", required_argument, 0, 10},
514 {"symbols", required_argument, 0, 's'},
515 {"s", required_argument, 0, 's'},
516 {"exec", required_argument, 0, 'e'},
517 {"e", required_argument, 0, 'e'},
518 {"core", required_argument, 0, 'c'},
519 {"c", required_argument, 0, 'c'},
520 {"command", required_argument, 0, 'x'},
521 {"x", required_argument, 0, 'x'},
522 {"directory", required_argument, 0, 'd'},
523 {"cd", required_argument, 0, 11},
524 {"tty", required_argument, 0, 't'},
525 {"baud", required_argument, 0, 'b'},
526 {"b", required_argument, 0, 'b'},
527 /* Allow machine descriptions to add more options... */
528 #ifdef ADDITIONAL_OPTIONS
531 {0, no_argument, 0, 0},
538 c = getopt_long_only (argc, argv, "",
539 long_options, &option_index);
543 /* Long option that takes an argument. */
544 if (c == 0 && long_options[option_index].flag == 0)
545 c = long_options[option_index].val;
550 /* Long option that just sets a flag. */
569 cmdarg[ncmd++] = optarg;
573 cmdarg = (char **) xrealloc ((char *)cmdarg,
574 cmdsize * sizeof (*cmdarg));
578 dirarg[ndir++] = optarg;
582 dirarg = (char **) xrealloc ((char *)dirarg,
583 dirsize * sizeof (*dirarg));
595 #ifdef ADDITIONAL_OPTION_CASES
596 ADDITIONAL_OPTION_CASES
599 fprintf_filtered (stderr,
600 "Use `%s +help' for a complete list of options.\n",
609 This is GDB, the GNU debugger. Use the command\n\
610 gdb [options] [executable [core-file]]\n\
611 to enter the debugger.\n\
613 Options available are:\n\
614 -help Print this message.\n\
615 -quiet Do not print version number on startup.\n\
616 -fullname Output information used by emacs-GDB interface.\n\
617 -epoch Output information used by epoch emacs-GDB interface.\n\
618 -batch Exit after processing options.\n\
619 -nx Do not read .gdbinit file.\n\
620 -tty=TTY Use TTY for input/output by the program being debugged.\n\
621 -cd=DIR Change current directory to DIR.\n\
622 -directory=DIR Search for source files in DIR.\n\
623 -command=FILE Execute GDB commands from FILE.\n\
624 -symbols=SYMFILE Read symbols from SYMFILE.\n\
625 -exec=EXECFILE Use EXECFILE as the executable.\n\
626 -se=FILE Use FILE as symbol file and executable file.\n\
627 -core=COREFILE Analyze the core dump COREFILE.\n\
628 -b BAUDRATE Set serial port baud rate used for remote debugging.\n\
629 -mapped Use mapped symbol files if supported on this system.\n\
630 -readnow Fully read symbol files on first access.\n\
632 #ifdef ADDITIONAL_OPTION_HELP
633 fputs (ADDITIONAL_OPTION_HELP, stderr);
636 For more information, type \"help\" from within GDB, or consult the\n\
637 GDB manual (available as on-line info or a printed manual).\n", stderr);
638 /* Exiting after printing this message seems like
639 the most useful thing to do. */
643 /* OK, that's all the options. The other arguments are filenames. */
645 for (; optind < argc; optind++)
649 symarg = argv[optind];
650 execarg = argv[optind];
653 corearg = argv[optind];
656 fprintf_filtered (stderr,
657 "Excess command line arguments ignored. (%s%s)\n",
658 argv[optind], (optind == argc - 1) ? "" : " ...");
665 /* Run the init function of each source file */
667 initialize_cmd_lists (); /* This needs to be done first */
668 initialize_all_files ();
669 initialize_main (); /* But that omits this file! Do it now */
674 /* Print all the junk at the top, with trailing "..." if we are about
675 to read a symbol file (possibly slowly). */
676 print_gnu_advertisement ();
677 print_gdb_version ();
679 printf_filtered ("..");
681 fflush (stdout); /* Force to screen during slow operations */
684 error_pre_print = "\n\n";
685 /* We may get more than one warning, don't double space all of them... */
686 warning_pre_print = "\nwarning: ";
688 /* We need a default language for parsing expressions, so simple things like
689 "set width 0" won't fail if no language is explicitly set in a config file
690 or implicitly set by reading an executable during startup. */
691 set_language (language_c);
693 /* Read and execute $HOME/.gdbinit file, if it exists. This is done
694 *before* all the command line arguments are processed; it sets
695 global parameters, which are independent of what file you are
696 debugging or what directory you are in. */
697 homedir = getenv ("HOME");
700 homeinit = (char *) alloca (strlen (getenv ("HOME")) +
701 strlen (gdbinit) + 10);
702 strcpy (homeinit, getenv ("HOME"));
703 strcat (homeinit, "/");
704 strcat (homeinit, gdbinit);
705 if (!inhibit_gdbinit && access (homeinit, R_OK) == 0)
707 if (!setjmp (to_top_level))
708 source_command (homeinit, 0);
710 do_cleanups (ALL_CLEANUPS);
712 /* Do stats; no need to do them elsewhere since we'll only
713 need them if homedir is set. Make sure that they are
714 zero in case one of them fails (this guarantees that they
715 won't match if either exists). */
717 memset (&homebuf, 0, sizeof (struct stat));
718 memset (&cwdbuf, 0, sizeof (struct stat));
720 stat (homeinit, &homebuf);
721 stat (gdbinit, &cwdbuf); /* We'll only need this if
725 /* Now perform all the actions indicated by the arguments. */
728 if (!setjmp (to_top_level))
730 cd_command (cdarg, 0);
734 do_cleanups (ALL_CLEANUPS);
736 for (i = 0; i < ndir; i++)
737 if (!setjmp (to_top_level))
738 directory_command (dirarg[i], 0);
740 do_cleanups (ALL_CLEANUPS);
744 && strcmp (execarg, symarg) == 0)
746 /* The exec file and the symbol-file are the same. If we can't open
747 it, better only print one error message. */
748 if (!setjmp (to_top_level))
750 exec_file_command (execarg, !batch);
751 symbol_file_command (symarg, 0);
757 if (!setjmp (to_top_level))
758 exec_file_command (execarg, !batch);
760 if (!setjmp (to_top_level))
761 symbol_file_command (symarg, 0);
763 do_cleanups (ALL_CLEANUPS);
765 /* After the symbol file has been read, print a newline to get us
766 beyond the copyright line... But errors should still set off
767 the error message with a (single) blank line. */
769 printf_filtered ("\n");
770 error_pre_print = "\n";
771 warning_pre_print = "\nwarning: ";
774 if (!setjmp (to_top_level))
775 core_file_command (corearg, !batch);
776 else if (isdigit (corearg[0]) && !setjmp (to_top_level))
777 attach_command (corearg, !batch);
778 do_cleanups (ALL_CLEANUPS);
781 if (!setjmp (to_top_level))
782 tty_command (ttyarg, !batch);
783 do_cleanups (ALL_CLEANUPS);
785 #ifdef ADDITIONAL_OPTION_HANDLER
786 ADDITIONAL_OPTION_HANDLER;
789 /* Error messages should no longer be distinguished with extra output. */
791 warning_pre_print = "warning: ";
793 /* Read the .gdbinit file in the current directory, *if* it isn't
794 the same as the $HOME/.gdbinit file (it should exist, also). */
797 || memcmp ((char *) &homebuf, (char *) &cwdbuf, sizeof (struct stat)))
798 if (!inhibit_gdbinit && access (gdbinit, R_OK) == 0)
800 if (!setjmp (to_top_level))
801 source_command (gdbinit, 0);
803 do_cleanups (ALL_CLEANUPS);
805 for (i = 0; i < ncmd; i++)
807 if (!setjmp (to_top_level))
809 if (cmdarg[i][0] == '-' && cmdarg[i][1] == '\0')
810 read_command_file (stdin);
812 source_command (cmdarg[i], !batch);
813 do_cleanups (ALL_CLEANUPS);
818 /* Read in the old history after all the command files have been read. */
819 initialize_history();
823 /* We have hit the end of the batch file. */
827 /* Do any host- or target-specific hacks. This is used for i960 targets
828 to force the user to set a nindy target and spec its parameters. */
830 #ifdef BEFORE_MAIN_LOOP_HOOK
831 BEFORE_MAIN_LOOP_HOOK;
834 /* The command loop. */
838 if (!setjmp (to_top_level))
840 do_cleanups (ALL_CLEANUPS); /* Do complete cleanup */
842 quit_command ((char *)0, instream == stdin);
845 /* No exit -- exit is through quit_command. */
848 /* Execute the line P as a command.
849 Pass FROM_TTY as second argument to the defining function. */
852 execute_command (p, from_tty)
856 register struct cmd_list_element *c;
857 register struct command_line *cmdlines;
858 register enum language flang;
859 static const struct language_defn *saved_language = 0;
860 static int warned = 0;
864 /* This can happen when command_line_input hits end of file. */
868 while (*p == ' ' || *p == '\t') p++;
873 c = lookup_cmd (&p, cmdlist, "", 0, 1);
874 /* Pass null arg rather than an empty one. */
876 if (c->class == class_user)
878 struct cleanup *old_chain;
881 error ("User-defined commands cannot take arguments.");
882 cmdlines = c->user_commands;
887 /* Set the instream to 0, indicating execution of a
888 user-defined function. */
889 old_chain = make_cleanup (source_cleanup, instream);
890 instream = (FILE *) 0;
893 execute_command (cmdlines->line, 0);
894 cmdlines = cmdlines->next;
896 do_cleanups (old_chain);
898 else if (c->type == set_cmd || c->type == show_cmd)
899 do_setshow_command (arg, from_tty & caution, c);
900 else if (c->function.cfunc == NO_FUNCTION)
901 error ("That is not a command, just a help topic.");
903 (*c->function.cfunc) (arg, from_tty & caution);
906 /* Tell the user if the language has changed (except first time). */
907 if (current_language != saved_language)
909 if (language_mode == language_mode_auto) {
911 language_info (1); /* Print what changed. */
913 saved_language = current_language;
917 /* Warn the user if the working language does not match the
918 language of the current frame. Only warn the user if we are
919 actually running the program, i.e. there is a stack. */
920 /* FIXME: This should be cacheing the frame and only running when
921 the frame changes. */
922 if (target_has_stack)
924 flang = get_frame_language ();
926 && flang != language_unknown
927 && flang != current_language->la_language)
929 printf_filtered ("%s\n", lang_frame_mismatch_warn);
937 command_loop_marker (foo)
942 /* Read commands from `instream' and execute them
943 until end of file or error reading instream. */
947 struct cleanup *old_chain;
949 int stdin_is_tty = ISATTY (stdin);
951 while (!feof (instream))
953 if (window_hook && instream == stdin)
954 (*window_hook) (instream, prompt);
957 if (instream == stdin && stdin_is_tty)
958 reinitialize_more_filter ();
959 old_chain = make_cleanup (command_loop_marker, 0);
960 command = command_line_input (instream == stdin ? prompt : (char *) NULL,
964 execute_command (command, instream == stdin);
965 /* Do any commands attached to breakpoint we stopped at. */
966 bpstat_do_actions (&stop_bpstat);
967 do_cleanups (old_chain);
971 /* Commands call this if they do not want to be repeated by null lines. */
976 /* If we aren't reading from standard input, we are saving the last
977 thing read from stdin in line and don't want to delete it. Null lines
978 won't repeat here in any case. */
979 if (instream == stdin)
983 /* Read a line from the stream "instream" without command line editing.
985 It prints PRROMPT once at the start.
986 Action is compatible with "readline", e.g. space for the result is
987 malloc'd and should be freed by the caller.
989 A NULL return means end of file. */
991 gdb_readline (prrompt)
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 (prrompt, stdout);
1008 result = (char *) xmalloc (result_size);
1012 /* Read from stdin if we are executing a user defined command.
1013 This is the right thing for prompt_for_continue, at least. */
1014 c = fgetc (instream ? instream : stdin);
1025 result[input_index++] = c;
1026 while (input_index >= result_size)
1029 result = (char *) xrealloc (result, result_size);
1033 result[input_index++] = '\0';
1037 /* Variables which control command line editing and history
1038 substitution. These variables are given default values at the end
1040 static int command_editing_p;
1041 static int history_expansion_p;
1042 static int write_history_p;
1043 static int history_size;
1044 static char *history_filename;
1046 /* Variables which are necessary for fancy command line editing. */
1047 char *gdb_completer_word_break_characters =
1048 " \t\n!@#$%^&*()+=|~`}{[]\"';:?/>.<,-";
1050 /* When completing on command names, we remove '-' from the list of
1051 word break characters, since we use it in command names. If the
1052 readline library sees one in any of the current completion strings,
1053 it thinks that the string needs to be quoted and automatically supplies
1055 char *gdb_completer_command_word_break_characters =
1056 " \t\n!@#$%^&*()+=|~`}{[]\"';:?/>.<,";
1058 /* Characters that can be used to quote completion strings. Note that we
1059 can't include '"' because the gdb C parser treats such quoted sequences
1061 char *gdb_completer_quote_characters =
1064 /* Functions that are used as part of the fancy command line editing. */
1066 /* This can be used for functions which don't want to complete on symbols
1067 but don't want to complete on anything else either. */
1070 noop_completer (text)
1076 /* Generate symbol names one by one for the completer. Each time we are
1077 called return another potential completion to the caller.
1079 TEXT is what we expect the symbol to start with.
1081 MATCHES is the number of matches that have currently been collected from
1082 calling this completion function. When zero, then we need to initialize,
1083 otherwise the initialization has already taken place and we can just
1084 return the next potential completion string.
1086 Returns NULL if there are no more completions, else a pointer to a string
1087 which is a possible completion.
1089 RL_LINE_BUFFER is available to be looked at; it contains the entire text
1090 of the line. RL_POINT is the offset in that line of the cursor. You
1091 should pretend that the line ends at RL_POINT. */
1094 symbol_completion_function (text, matches)
1098 static char **list = (char **)NULL; /* Cache of completions */
1099 static int index; /* Next cached completion */
1100 char *output = NULL;
1101 char *tmp_command, *p;
1102 struct cmd_list_element *c, *result_list;
1103 extern char *rl_line_buffer;
1104 extern int rl_point;
1108 /* The caller is beginning to accumulate a new set of completions, so
1109 we need to find all of them now, and cache them for returning one at
1110 a time on future calls. */
1114 /* Free the storage used by LIST, but not by the strings inside.
1115 This is because rl_complete_internal () frees the strings. */
1121 /* Choose the default set of word break characters to break completions.
1122 If we later find out that we are doing completions on command strings
1123 (as opposed to strings supplied by the individual command completer
1124 functions, which can be any string) then we will switch to the
1125 special word break set for command strings, which leaves out the
1126 '-' character used in some commands. */
1128 rl_completer_word_break_characters =
1129 gdb_completer_word_break_characters;
1131 /* Decide whether to complete on a list of gdb commands or on symbols. */
1132 tmp_command = (char *) alloca (rl_point + 1);
1135 strncpy (tmp_command, rl_line_buffer, rl_point);
1136 tmp_command[rl_point] = '\0';
1140 /* An empty line we want to consider ambiguous; that is, it
1141 could be any command. */
1142 c = (struct cmd_list_element *) -1;
1147 c = lookup_cmd_1 (&p, cmdlist, &result_list, 1);
1150 /* Move p up to the next interesting thing. */
1151 while (*p == ' ' || *p == '\t')
1158 /* He's typed something unrecognizable. Sigh. */
1161 else if (c == (struct cmd_list_element *) -1)
1163 /* If we didn't recognize everything up to the thing that
1164 needs completing, and we don't know what command it is
1165 yet, we are in trouble. */
1167 if (p + strlen(text) != tmp_command + rl_point)
1169 /* This really should not produce an error. Better would
1170 be to pretend to hit RETURN here; this would produce a
1171 response like "Ambiguous command: foo, foobar, etc",
1172 and leave the line available for re-entry with ^P.
1173 Instead, this error blows away the user's typed input
1174 without any way to get it back. */
1175 error (" Unrecognized command.");
1178 /* He's typed something ambiguous. This is easier. */
1181 list = complete_on_cmdlist (*result_list->prefixlist, text);
1185 list = complete_on_cmdlist (cmdlist, text);
1187 rl_completer_word_break_characters =
1188 gdb_completer_command_word_break_characters;
1192 /* If we've gotten this far, gdb has recognized a full
1193 command. There are several possibilities:
1195 1) We need to complete on the command.
1196 2) We need to complete on the possibilities coming after
1198 2) We need to complete the text of what comes after the
1203 /* Always (might be longer versions of thie command). */
1204 list = complete_on_cmdlist (result_list, text);
1205 rl_completer_word_break_characters =
1206 gdb_completer_command_word_break_characters;
1208 else if (!*p && !*text)
1212 list = complete_on_cmdlist (*c->prefixlist, "");
1213 rl_completer_word_break_characters =
1214 gdb_completer_command_word_break_characters;
1218 list = (*c->completer) ("");
1223 if (c->prefixlist && !c->allow_unknown)
1225 /* Something like "info adsfkdj". But error() is not the
1226 proper response; just return no completions instead. */
1231 list = (*c->completer) (text);
1237 /* If we found a list of potential completions during initialization then
1238 dole them out one at a time. The vector of completions is NULL
1239 terminated, so after returning the last one, return NULL (and continue
1240 to do so) each time we are called after that, until a new list is
1245 output = list[index];
1255 /* Skip over a possibly quoted word (as defined by the quote characters
1256 and word break characters the completer uses). Returns pointer to the
1257 location after the "word". */
1263 char quote_char = '\0';
1266 for (scan = str; *scan != '\0'; scan++)
1268 if (quote_char != '\0')
1270 /* Ignore everything until the matching close quote char */
1271 if (*scan == quote_char)
1273 /* Found matching close quote. */
1278 else if (strchr (gdb_completer_quote_characters, *scan))
1280 /* Found start of a quoted string. */
1283 else if (strchr (gdb_completer_word_break_characters, *scan))
1297 #if STOP_SIGNAL == SIGTSTP
1298 signal (SIGTSTP, SIG_DFL);
1300 kill (getpid (), SIGTSTP);
1301 signal (SIGTSTP, stop_sig);
1303 signal (STOP_SIGNAL, stop_sig);
1305 printf_filtered ("%s", prompt);
1308 /* Forget about any previous command -- null line now will do nothing. */
1311 #endif /* STOP_SIGNAL */
1313 /* Initialize signal handlers. */
1323 signal (SIGINT, request_quit);
1325 /* If we initialize SIGQUIT to SIG_IGN, then the SIG_IGN will get
1326 passed to the inferior, which we don't want. It would be
1327 possible to do a "signal (SIGQUIT, SIG_DFL)" after we fork, but
1328 on BSD4.3 systems using vfork, that can affect the
1329 GDB process as well as the inferior (the signal handling tables
1330 might be in memory, shared between the two). Since we establish
1331 a handler for SIGQUIT, when we call exec it will set the signal
1332 to SIG_DFL for us. */
1333 signal (SIGQUIT, do_nothing);
1334 if (signal (SIGHUP, do_nothing) != SIG_IGN)
1335 signal (SIGHUP, disconnect);
1336 signal (SIGFPE, float_handler);
1338 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1339 signal (SIGWINCH, SIGWINCH_HANDLER);
1343 /* Read one line from the command input stream `instream'
1344 into the local static buffer `linebuffer' (whose current length
1346 The buffer is made bigger as necessary.
1347 Returns the address of the start of the line.
1349 NULL is returned for end of file.
1351 *If* the instream == stdin & stdin is a terminal, the line read
1352 is copied into the file line saver (global var char *line,
1353 length linesize) so that it can be duplicated.
1355 This routine either uses fancy command line editing or
1356 simple input as the user has requested. */
1359 command_line_input (prrompt, repeat)
1363 static char *linebuffer = 0;
1364 static unsigned linelength = 0;
1368 char *local_prompt = prrompt;
1373 if (linebuffer == 0)
1376 linebuffer = (char *) xmalloc (linelength);
1381 /* Control-C quits instantly if typed while in this loop
1382 since it should not wait until the user types a newline. */
1385 signal (STOP_SIGNAL, stop_sig);
1390 /* Reports are that some Sys V's don't flush stdout/err on reads
1391 from stdin, when stdin/out are sockets rather than ttys. So we
1392 have to do it ourselves, to make emacs-gdb and xxgdb work.
1393 On other machines, doing this once per input should be a cheap nop. */
1397 /* Don't use fancy stuff if not talking to stdin. */
1398 if (command_editing_p && instream == stdin
1399 && ISATTY (instream))
1400 rl = readline (local_prompt);
1402 rl = gdb_readline (local_prompt);
1404 if (!rl || rl == (char *) EOF)
1409 if (strlen(rl) + 1 + (p - linebuffer) > linelength)
1411 linelength = strlen(rl) + 1 + (p - linebuffer);
1412 nline = (char *) xrealloc (linebuffer, linelength);
1413 p += nline - linebuffer;
1417 /* Copy line. Don't copy null at end. (Leaves line alone
1418 if this was just a newline) */
1422 free (rl); /* Allocated in readline. */
1424 if (p == linebuffer || *(p - 1) != '\\')
1427 p--; /* Put on top of '\'. */
1428 local_prompt = (char *) 0;
1432 signal (SIGTSTP, SIG_DFL);
1439 /* Do history expansion if that is wished. */
1440 if (history_expansion_p && instream == stdin
1441 && ISATTY (instream))
1443 char *history_value;
1446 *p = '\0'; /* Insert null now. */
1447 expanded = history_expand (linebuffer, &history_value);
1450 /* Print the changes. */
1451 printf_filtered ("%s\n", history_value);
1453 /* If there was an error, call this function again. */
1456 free (history_value);
1457 return command_line_input (prrompt, repeat);
1459 if (strlen (history_value) > linelength)
1461 linelength = strlen (history_value) + 1;
1462 linebuffer = (char *) xrealloc (linebuffer, linelength);
1464 strcpy (linebuffer, history_value);
1465 p = linebuffer + strlen(linebuffer);
1466 free (history_value);
1470 /* If we just got an empty line, and that is supposed
1471 to repeat the previous command, return the value in the
1475 if (p == linebuffer)
1478 while (*p1 == ' ' || *p1 == '\t')
1486 /* Add line to history if appropriate. */
1487 if (instream == stdin
1488 && ISATTY (stdin) && *linebuffer)
1489 add_history (linebuffer);
1491 /* Note: lines consisting soley of comments are added to the command
1492 history. This is useful when you type a command, and then
1493 realize you don't want to execute it quite yet. You can comment
1494 out the command and then later fetch it from the value history
1495 and remove the '#'. The kill ring is probably better, but some
1496 people are in the habit of commenting things out. */
1498 while ((c = *p1++) != '\0')
1501 while ((c = *p1++) != '"')
1503 /* Make sure an escaped '"' doesn't make us think the string
1511 while ((c = *p1++) != '\'')
1513 /* Make sure an escaped '\'' doesn't make us think the string
1522 /* Found a comment. */
1528 /* Save into global buffer if appropriate. */
1531 if (linelength > linesize)
1533 line = xrealloc (line, linelength);
1534 linesize = linelength;
1536 strcpy (line, linebuffer);
1543 /* Read lines from the input stream
1544 and accumulate them in a chain of struct command_line's
1545 which is then returned. */
1547 struct command_line *
1548 read_command_lines ()
1550 struct command_line *first = 0;
1551 register struct command_line *next, *tail = 0;
1552 register char *p, *p1;
1553 struct cleanup *old_chain = 0;
1558 p = command_line_input ((char *) NULL, instream == stdin);
1560 /* Treat end of file like "end". */
1563 /* Remove leading and trailing blanks. */
1564 while (*p == ' ' || *p == '\t') p++;
1565 p1 = p + strlen (p);
1566 while (p1 != p && (p1[-1] == ' ' || p1[-1] == '\t')) p1--;
1568 /* Is this "end"? */
1569 if (p1 - p == 3 && !strncmp (p, "end", 3))
1572 /* No => add this line to the chain of command lines. */
1573 next = (struct command_line *) xmalloc (sizeof (struct command_line));
1574 next->line = savestring (p, p1 - p);
1582 /* We just read the first line.
1583 From now on, arrange to throw away the lines we have
1584 if we quit or get an error while inside this function. */
1586 old_chain = make_cleanup (free_command_lines, &first);
1593 /* Now we are about to return the chain to our caller,
1594 so freeing it becomes his responsibility. */
1596 discard_cleanups (old_chain);
1600 /* Free a chain of struct command_line's. */
1603 free_command_lines (lptr)
1604 struct command_line **lptr;
1606 register struct command_line *l = *lptr;
1607 register struct command_line *next;
1618 /* Add an element to the list of info subcommands. */
1621 add_info (name, fun, doc)
1623 void (*fun) PARAMS ((char *, int));
1626 add_cmd (name, no_class, fun, doc, &infolist);
1629 /* Add an alias to the list of info subcommands. */
1632 add_info_alias (name, oldname, abbrev_flag)
1637 add_alias_cmd (name, oldname, 0, abbrev_flag, &infolist);
1640 /* The "info" command is defined as a prefix, with allow_unknown = 0.
1641 Therefore, its own definition is called only for "info" with no args. */
1645 info_command (arg, from_tty)
1649 printf_filtered ("\"info\" must be followed by the name of an info command.\n");
1650 help_list (infolist, "info ", -1, stdout);
1653 /* The "show" command with no arguments shows all the settings. */
1657 show_command (arg, from_tty)
1661 cmd_show_list (showlist, from_tty, "");
1664 /* Add an element to the list of commands. */
1667 add_com (name, class, fun, doc)
1669 enum command_class class;
1670 void (*fun) PARAMS ((char *, int));
1673 add_cmd (name, class, fun, doc, &cmdlist);
1676 /* Add an alias or abbreviation command to the list of commands. */
1679 add_com_alias (name, oldname, class, abbrev_flag)
1682 enum command_class class;
1685 add_alias_cmd (name, oldname, class, abbrev_flag, &cmdlist);
1692 error ("Argument required (%s).", why);
1697 help_command (command, from_tty)
1699 int from_tty; /* Ignored */
1701 help_cmd (command, stdout);
1705 validate_comname (comname)
1711 error_no_arg ("name of command to define");
1716 if (!isalnum(*p) && *p != '-')
1717 error ("Junk in argument list: \"%s\"", p);
1722 /* This is just a placeholder in the command data structures. */
1724 user_defined_command (ignore, from_tty)
1731 define_command (comname, from_tty)
1735 register struct command_line *cmds;
1736 register struct cmd_list_element *c, *newc;
1737 char *tem = comname;
1739 validate_comname (comname);
1741 /* Look it up, and verify that we got an exact match. */
1742 c = lookup_cmd (&tem, cmdlist, "", -1, 1);
1743 if (c && 0 != strcmp (comname, c->name))
1748 if (c->class == class_user || c->class == class_alias)
1749 tem = "Redefine command \"%s\"? ";
1751 tem = "Really redefine built-in command \"%s\"? ";
1752 if (!query (tem, c->name))
1753 error ("Command \"%s\" not redefined.", c->name);
1756 comname = savestring (comname, strlen (comname));
1758 /* If the rest of the commands will be case insensetive, this one
1759 should behave in the same manner. */
1760 for (tem = comname; *tem; tem++)
1761 if (isupper(*tem)) *tem = tolower(*tem);
1765 printf_filtered ("Type commands for definition of \"%s\".\n\
1766 End with a line saying just \"end\".\n", comname);
1770 cmds = read_command_lines ();
1772 if (c && c->class == class_user)
1773 free_command_lines (&c->user_commands);
1775 newc = add_cmd (comname, class_user, user_defined_command,
1776 (c && c->class == class_user)
1777 ? c->doc : savestring ("User-defined.", 13), &cmdlist);
1778 newc->user_commands = cmds;
1782 document_command (comname, from_tty)
1786 struct command_line *doclines;
1787 register struct cmd_list_element *c;
1788 char *tem = comname;
1790 validate_comname (comname);
1792 c = lookup_cmd (&tem, cmdlist, "", 0, 1);
1794 if (c->class != class_user)
1795 error ("Command \"%s\" is built-in.", comname);
1798 printf_filtered ("Type documentation for \"%s\".\n\
1799 End with a line saying just \"end\".\n", comname);
1801 doclines = read_command_lines ();
1803 if (c->doc) free (c->doc);
1806 register struct command_line *cl1;
1807 register int len = 0;
1809 for (cl1 = doclines; cl1; cl1 = cl1->next)
1810 len += strlen (cl1->line) + 1;
1812 c->doc = (char *) xmalloc (len + 1);
1815 for (cl1 = doclines; cl1; cl1 = cl1->next)
1817 strcat (c->doc, cl1->line);
1819 strcat (c->doc, "\n");
1823 free_command_lines (&doclines);
1827 print_gnu_advertisement()
1830 GDB is free software and you are welcome to distribute copies of it\n\
1831 under certain conditions; type \"show copying\" to see the conditions.\n\
1832 There is absolutely no warranty for GDB; type \"show warranty\" for details.\n\
1837 print_gdb_version ()
1840 GDB %s, Copyright 1992 Free Software Foundation, Inc.",
1846 show_version (args, from_tty)
1851 print_gnu_advertisement ();
1852 print_gdb_version ();
1853 printf_filtered ("\n");
1857 /* xgdb calls this to reprint the usual GDB prompt. */
1862 printf_filtered ("%s", prompt);
1867 quit_command (args, from_tty)
1871 if (inferior_pid != 0 && target_has_execution)
1873 if (query ("The program is running. Quit anyway? "))
1878 error ("Not confirmed.");
1880 /* Save the history information if it is appropriate to do so. */
1881 if (write_history_p && history_filename)
1882 write_history (history_filename);
1886 /* Returns whether GDB is running on a terminal and whether the user
1887 desires that questions be asked of them on that terminal. */
1890 input_from_terminal_p ()
1892 return gdb_has_a_terminal && (instream == stdin) & caution;
1897 pwd_command (args, from_tty)
1901 if (args) error ("The \"pwd\" command does not take an argument: %s", args);
1902 getcwd (dirbuf, sizeof (dirbuf));
1904 if (strcmp (dirbuf, current_directory))
1905 printf_filtered ("Working directory %s\n (canonically %s).\n",
1906 current_directory, dirbuf);
1908 printf_filtered ("Working directory %s.\n", current_directory);
1912 cd_command (dir, from_tty)
1919 /* If the new directory is absolute, repeat is a no-op; if relative,
1920 repeat might be useful but is more likely to be a mistake. */
1924 error_no_arg ("new working directory");
1926 dir = tilde_expand (dir);
1927 make_cleanup (free, dir);
1929 if (chdir (dir) < 0)
1930 perror_with_name (dir);
1933 dir = savestring (dir, len - (len > 1 && dir[len-1] == '/'));
1935 current_directory = dir;
1938 current_directory = concat (current_directory, "/", dir, NULL);
1942 /* Now simplify any occurrences of `.' and `..' in the pathname. */
1950 for (p = current_directory; *p;)
1952 if (!strncmp (p, "/./", 2)
1953 && (p[2] == 0 || p[2] == '/'))
1955 else if (!strncmp (p, "/..", 3)
1956 && (p[3] == 0 || p[3] == '/')
1957 && p != current_directory)
1960 while (q != current_directory && q[-1] != '/') q--;
1961 if (q != current_directory)
1971 forget_cached_source_info ();
1974 pwd_command ((char *) 0, 1);
1979 source_command (args, from_tty)
1984 struct cleanup *cleanups;
1988 /* Let source without arguments read .gdbinit. */
1991 file = tilde_expand (file);
1992 make_cleanup (free, file);
1994 stream = fopen (file, "r");
1996 perror_with_name (file);
1998 cleanups = make_cleanup (fclose, stream);
2000 read_command_file (stream);
2002 do_cleanups (cleanups);
2007 echo_command (text, from_tty)
2019 /* \ at end of argument is used after spaces
2020 so they won't be lost. */
2024 c = parse_escape (&p);
2026 printf_filtered ("%c", c);
2029 printf_filtered ("%c", c);
2032 /* Force this output to appear now. */
2038 /* Functions to manipulate command line editing control variables. */
2040 /* Number of commands to print in each call to show_commands. */
2041 #define Hist_print 10
2043 show_commands (args, from_tty)
2047 /* Index for history commands. Relative to history_base. */
2050 /* Number of the history entry which we are planning to display next.
2051 Relative to history_base. */
2054 /* The first command in the history which doesn't exist (i.e. one more
2055 than the number of the last command). Relative to history_base. */
2058 extern struct _hist_entry *history_get PARAMS ((int));
2059 extern int history_base;
2061 /* Print out some of the commands from the command history. */
2062 /* First determine the length of the history list. */
2063 hist_len = history_size;
2064 for (offset = 0; offset < history_size; offset++)
2066 if (!history_get (history_base + offset))
2075 if (args[0] == '+' && args[1] == '\0')
2076 /* "info editing +" should print from the stored position. */
2079 /* "info editing <exp>" should print around command number <exp>. */
2080 num = (parse_and_eval_address (args) - history_base) - Hist_print / 2;
2082 /* "show commands" means print the last Hist_print commands. */
2085 num = hist_len - Hist_print;
2091 /* If there are at least Hist_print commands, we want to display the last
2092 Hist_print rather than, say, the last 6. */
2093 if (hist_len - num < Hist_print)
2095 num = hist_len - Hist_print;
2100 for (offset = num; offset < num + Hist_print && offset < hist_len; offset++)
2102 printf_filtered ("%5d %s\n", history_base + offset,
2103 (history_get (history_base + offset))->line);
2106 /* The next command we want to display is the next one that we haven't
2110 /* If the user repeats this command with return, it should do what
2111 "show commands +" does. This is unnecessary if arg is null,
2112 because "show commands +" is not useful after "show commands". */
2113 if (from_tty && args)
2120 /* Called by do_setshow_command. */
2123 set_history_size_command (args, from_tty, c)
2126 struct cmd_list_element *c;
2128 if (history_size == UINT_MAX)
2129 unstifle_history ();
2130 else if (history_size >= 0)
2131 stifle_history (history_size);
2134 history_size = UINT_MAX;
2135 error ("History size must be non-negative");
2141 set_history (args, from_tty)
2145 printf_filtered ("\"set history\" must be followed by the name of a history subcommand.\n");
2146 help_list (sethistlist, "set history ", -1, stdout);
2151 show_history (args, from_tty)
2155 cmd_show_list (showhistlist, from_tty, "");
2158 int info_verbose = 0; /* Default verbose msgs off */
2160 /* Called by do_setshow_command. An elaborate joke. */
2163 set_verbose (args, from_tty, c)
2166 struct cmd_list_element *c;
2168 char *cmdname = "verbose";
2169 struct cmd_list_element *showcmd;
2171 showcmd = lookup_cmd_1 (&cmdname, showlist, NULL, 1);
2175 c->doc = "Set verbose printing of informational messages.";
2176 showcmd->doc = "Show verbose printing of informational messages.";
2180 c->doc = "Set verbosity.";
2181 showcmd->doc = "Show verbosity.";
2186 float_handler (signo)
2189 /* This message is based on ANSI C, section 4.7. Note that integer
2190 divide by zero causes this, so "float" is a misnomer. */
2191 error ("Erroneous arithmetic operation.");
2194 /* Return whether we are running a batch file or from terminal. */
2198 return !(instream == stdin && ISATTY (stdin));
2203 initialize_cmd_lists ()
2210 enablebreaklist = NULL;
2215 showhistlist = NULL;
2216 unsethistlist = NULL;
2217 #if MAINTENANCE_CMDS
2218 maintenancelist = NULL;
2219 maintenanceinfolist = NULL;
2220 maintenanceprintlist = NULL;
2222 setprintlist = NULL;
2223 showprintlist = NULL;
2224 setchecklist = NULL;
2225 showchecklist = NULL;
2228 /* Init the history buffer. Note that we are called after the init file(s)
2229 * have been read so that the user can change the history file via his
2230 * .gdbinit file (for instance). The GDBHISTFILE environment variable
2231 * overrides all of this.
2235 initialize_history()
2239 tmpenv = getenv ("HISTSIZE");
2241 history_size = atoi (tmpenv);
2242 else if (!history_size)
2245 stifle_history (history_size);
2247 tmpenv = getenv ("GDBHISTFILE");
2249 history_filename = savestring (tmpenv, strlen(tmpenv));
2250 else if (!history_filename) {
2251 /* We include the current directory so that if the user changes
2252 directories the file written will be the same as the one
2254 history_filename = concat (current_directory, "/.gdb_history", NULL);
2256 read_history (history_filename);
2262 struct cmd_list_element *c;
2264 #ifdef DEFAULT_PROMPT
2265 prompt = savestring (DEFAULT_PROMPT, strlen(DEFAULT_PROMPT));
2267 prompt = savestring ("(gdb) ", 6);
2270 /* Set the important stuff up for command editing. */
2271 command_editing_p = 1;
2272 history_expansion_p = 0;
2273 write_history_p = 0;
2275 /* Setup important stuff for command line editing. */
2276 rl_completion_entry_function = (int (*)()) symbol_completion_function;
2277 rl_completer_word_break_characters = gdb_completer_word_break_characters;
2278 rl_completer_quote_characters = gdb_completer_quote_characters;
2279 rl_readline_name = "gdb";
2281 /* Define the classes of commands.
2282 They will appear in the help list in the reverse of this order. */
2284 add_cmd ("internals", class_maintenance, NO_FUNCTION,
2285 "Maintenance commands.\n\
2286 Some gdb commands are provided just for use by gdb maintainers.\n\
2287 These commands are subject to frequent change, and may not be as\n\
2288 well documented as user commands.",
2290 add_cmd ("obscure", class_obscure, NO_FUNCTION, "Obscure features.", &cmdlist);
2291 add_cmd ("aliases", class_alias, NO_FUNCTION, "Aliases of other commands.", &cmdlist);
2292 add_cmd ("user-defined", class_user, NO_FUNCTION, "User-defined commands.\n\
2293 The commands in this class are those defined by the user.\n\
2294 Use the \"define\" command to define a command.", &cmdlist);
2295 add_cmd ("support", class_support, NO_FUNCTION, "Support facilities.", &cmdlist);
2296 add_cmd ("status", class_info, NO_FUNCTION, "Status inquiries.", &cmdlist);
2297 add_cmd ("files", class_files, NO_FUNCTION, "Specifying and examining files.", &cmdlist);
2298 add_cmd ("breakpoints", class_breakpoint, NO_FUNCTION, "Making program stop at certain points.", &cmdlist);
2299 add_cmd ("data", class_vars, NO_FUNCTION, "Examining data.", &cmdlist);
2300 add_cmd ("stack", class_stack, NO_FUNCTION, "Examining the stack.\n\
2301 The stack is made up of stack frames. Gdb assigns numbers to stack frames\n\
2302 counting from zero for the innermost (currently executing) frame.\n\n\
2303 At any time gdb identifies one frame as the \"selected\" frame.\n\
2304 Variable lookups are done with respect to the selected frame.\n\
2305 When the program being debugged stops, gdb selects the innermost frame.\n\
2306 The commands below can be used to select other frames by number or address.",
2308 add_cmd ("running", class_run, NO_FUNCTION, "Running the program.", &cmdlist);
2310 add_com ("pwd", class_files, pwd_command,
2311 "Print working directory. This is used for your program as well.");
2312 add_com ("cd", class_files, cd_command,
2313 "Set working directory to DIR for debugger and program being debugged.\n\
2314 The change does not take effect for the program being debugged\n\
2315 until the next time it is started.");
2318 (add_set_cmd ("prompt", class_support, var_string, (char *)&prompt,
2323 add_com ("echo", class_support, echo_command,
2324 "Print a constant string. Give string as argument.\n\
2325 C escape sequences may be used in the argument.\n\
2326 No newline is added at the end of the argument;\n\
2327 use \"\\n\" if you want a newline to be printed.\n\
2328 Since leading and trailing whitespace are ignored in command arguments,\n\
2329 if you want to print some you must use \"\\\" before leading whitespace\n\
2330 to be printed or after trailing whitespace.");
2331 add_com ("document", class_support, document_command,
2332 "Document a user-defined command.\n\
2333 Give command name as argument. Give documentation on following lines.\n\
2334 End with a line of just \"end\".");
2335 add_com ("define", class_support, define_command,
2336 "Define a new command name. Command name is argument.\n\
2337 Definition appears on following lines, one command per line.\n\
2338 End with a line of just \"end\".\n\
2339 Use the \"document\" command to give documentation for the new command.\n\
2340 Commands defined in this way do not take arguments.");
2343 add_com ("source", class_support, source_command,
2344 "Read commands from a file named FILE.\n\
2345 Note that the file \"" GDBINIT_FILENAME "\" is read automatically in this way\n\
2346 when gdb is started.");
2348 /* Punt file name, we can't help it easily. */
2349 add_com ("source", class_support, source_command,
2350 "Read commands from a file named FILE.\n\
2351 Note that the file \".gdbinit\" is read automatically in this way\n\
2352 when gdb is started.");
2355 add_com ("quit", class_support, quit_command, "Exit gdb.");
2356 add_com ("help", class_support, help_command, "Print list of commands.");
2357 add_com_alias ("q", "quit", class_support, 1);
2358 add_com_alias ("h", "help", class_support, 1);
2361 c = add_set_cmd ("verbose", class_support, var_boolean, (char *)&info_verbose,
2364 add_show_from_set (c, &showlist);
2365 c->function.sfunc = set_verbose;
2366 set_verbose (NULL, 0, c);
2369 (add_set_cmd ("editing", class_support, var_boolean, (char *)&command_editing_p,
2370 "Set editing of command lines as they are typed.\n\
2371 Use \"on\" to enable to enable the editing, and \"off\" to disable it.\n\
2372 Without an argument, command line editing is enabled. To edit, use\n\
2373 EMACS-like or VI-like commands like control-P or ESC.", &setlist),
2376 add_prefix_cmd ("history", class_support, set_history,
2377 "Generic command for setting command history parameters.",
2378 &sethistlist, "set history ", 0, &setlist);
2379 add_prefix_cmd ("history", class_support, show_history,
2380 "Generic command for showing command history parameters.",
2381 &showhistlist, "show history ", 0, &showlist);
2384 (add_set_cmd ("expansion", no_class, var_boolean, (char *)&history_expansion_p,
2385 "Set history expansion on command input.\n\
2386 Without an argument, history expansion is enabled.", &sethistlist),
2390 (add_set_cmd ("save", no_class, var_boolean, (char *)&write_history_p,
2391 "Set saving of the history record on exit.\n\
2392 Use \"on\" to enable to enable the saving, and \"off\" to disable it.\n\
2393 Without an argument, saving is enabled.", &sethistlist),
2396 c = add_set_cmd ("size", no_class, var_uinteger, (char *)&history_size,
2397 "Set the size of the command history, \n\
2398 ie. the number of previous commands to keep a record of.", &sethistlist);
2399 add_show_from_set (c, &showhistlist);
2400 c->function.sfunc = set_history_size_command;
2403 (add_set_cmd ("filename", no_class, var_filename, (char *)&history_filename,
2404 "Set the filename in which to record the command history\n\
2405 (the list of previous commands of which a record is kept).", &sethistlist),
2409 (add_set_cmd ("confirm", class_support, var_boolean,
2411 "Set whether to confirm potentially dangerous operations.",
2415 add_prefix_cmd ("info", class_info, info_command,
2416 "Generic command for showing things about the program being debugged.",
2417 &infolist, "info ", 0, &cmdlist);
2418 add_com_alias ("i", "info", class_info, 1);
2420 add_prefix_cmd ("show", class_info, show_command,
2421 "Generic command for showing things about the debugger.",
2422 &showlist, "show ", 0, &cmdlist);
2423 /* Another way to get at the same thing. */
2424 add_info ("set", show_command, "Show all GDB settings.");
2426 add_cmd ("commands", no_class, show_commands,
2427 "Show the the history of commands you typed.\n\
2428 You can supply a command number to start with, or a `+' to start after\n\
2429 the previous command number shown.",
2432 add_cmd ("version", no_class, show_version,
2433 "Show what version of GDB this is.", &showlist);