3 Copyright (C) 2000-2014 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 3 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, see <http://www.gnu.org/licenses/>. */
21 #include "exceptions.h"
22 #include "arch-utils.h"
23 #include "dyn-string.h"
24 #include "readline/readline.h"
25 #include "readline/tilde.h"
26 #include "completer.h"
27 #include "target.h" /* For baud_rate, remote_debug and remote_timeout. */
28 #include "gdb_wait.h" /* For shell escape implementation. */
29 #include "gdb_regex.h" /* Used by apropos_command. */
31 #include "gdb_vfork.h"
33 #include "expression.h"
37 #include "filenames.h" /* For DOSish file names. */
41 #include "tracepoint.h"
42 #include "filestuff.h"
47 #include "cli/cli-decode.h"
48 #include "cli/cli-script.h"
49 #include "cli/cli-setshow.h"
50 #include "cli/cli-cmds.h"
51 #include "cli/cli-utils.h"
53 #include "extension.h"
56 #include "tui/tui.h" /* For tui_active et.al. */
61 /* Prototypes for local command functions */
63 static void complete_command (char *, int);
65 static void echo_command (char *, int);
67 static void pwd_command (char *, int);
69 static void show_version (char *, int);
71 static void help_command (char *, int);
73 static void show_command (char *, int);
75 static void info_command (char *, int);
77 static void show_debug (char *, int);
79 static void set_debug (char *, int);
81 static void show_user (char *, int);
83 static void make_command (char *, int);
85 static void shell_escape (char *, int);
87 static void edit_command (char *, int);
89 static void list_command (char *, int);
91 /* Prototypes for local utility functions */
93 static void ambiguous_line_spec (struct symtabs_and_lines *);
95 static void filter_sals (struct symtabs_and_lines *);
98 /* Limit the call depth of user-defined commands */
99 unsigned int max_user_call_depth;
101 /* Define all cmd_list_elements. */
103 /* Chain containing all defined commands. */
105 struct cmd_list_element *cmdlist;
107 /* Chain containing all defined info subcommands. */
109 struct cmd_list_element *infolist;
111 /* Chain containing all defined enable subcommands. */
113 struct cmd_list_element *enablelist;
115 /* Chain containing all defined disable subcommands. */
117 struct cmd_list_element *disablelist;
119 /* Chain containing all defined stop subcommands. */
121 struct cmd_list_element *stoplist;
123 /* Chain containing all defined delete subcommands. */
125 struct cmd_list_element *deletelist;
127 /* Chain containing all defined detach subcommands. */
129 struct cmd_list_element *detachlist;
131 /* Chain containing all defined kill subcommands. */
133 struct cmd_list_element *killlist;
135 /* Chain containing all defined set subcommands */
137 struct cmd_list_element *setlist;
139 /* Chain containing all defined unset subcommands */
141 struct cmd_list_element *unsetlist;
143 /* Chain containing all defined show subcommands. */
145 struct cmd_list_element *showlist;
147 /* Chain containing all defined \"set history\". */
149 struct cmd_list_element *sethistlist;
151 /* Chain containing all defined \"show history\". */
153 struct cmd_list_element *showhistlist;
155 /* Chain containing all defined \"unset history\". */
157 struct cmd_list_element *unsethistlist;
159 /* Chain containing all defined maintenance subcommands. */
161 struct cmd_list_element *maintenancelist;
163 /* Chain containing all defined "maintenance info" subcommands. */
165 struct cmd_list_element *maintenanceinfolist;
167 /* Chain containing all defined "maintenance print" subcommands. */
169 struct cmd_list_element *maintenanceprintlist;
171 struct cmd_list_element *setprintlist;
173 struct cmd_list_element *showprintlist;
175 struct cmd_list_element *setdebuglist;
177 struct cmd_list_element *showdebuglist;
179 struct cmd_list_element *setchecklist;
181 struct cmd_list_element *showchecklist;
183 /* Command tracing state. */
185 int source_verbose = 0;
186 int trace_commands = 0;
188 /* 'script-extension' option support. */
190 static const char script_ext_off[] = "off";
191 static const char script_ext_soft[] = "soft";
192 static const char script_ext_strict[] = "strict";
194 static const char *const script_ext_enums[] = {
201 static const char *script_ext_mode = script_ext_soft;
203 /* Utility used everywhere when at least one argument is needed and
207 error_no_arg (char *why)
209 error (_("Argument required (%s)."), why);
212 /* The "info" command is defined as a prefix, with allow_unknown = 0.
213 Therefore, its own definition is called only for "info" with no
217 info_command (char *arg, int from_tty)
219 printf_unfiltered (_("\"info\" must be followed by "
220 "the name of an info command.\n"));
221 help_list (infolist, "info ", all_commands, gdb_stdout);
224 /* The "show" command with no arguments shows all the settings. */
227 show_command (char *arg, int from_tty)
229 cmd_show_list (showlist, from_tty, "");
232 /* Provide documentation on command or list given by COMMAND. FROM_TTY
236 help_command (char *command, int from_tty)
238 help_cmd (command, gdb_stdout);
241 /* The "complete" command is used by Emacs to implement completion. */
244 complete_command (char *arg, int from_tty)
247 char *point, *arg_prefix;
248 VEC (char_ptr) *completions;
254 argpoint = strlen (arg);
256 /* complete_line assumes that its first argument is somewhere
257 within, and except for filenames at the beginning of, the word to
258 be completed. The following crude imitation of readline's
259 word-breaking tries to accomodate this. */
260 point = arg + argpoint;
263 if (strchr (rl_completer_word_break_characters, point[-1]) != 0)
268 arg_prefix = alloca (point - arg + 1);
269 memcpy (arg_prefix, arg, point - arg);
270 arg_prefix[point - arg] = 0;
272 completions = complete_line (point, arg, argpoint);
276 int ix, size = VEC_length (char_ptr, completions);
277 char *item, *prev = NULL;
279 qsort (VEC_address (char_ptr, completions), size,
280 sizeof (char *), compare_strings);
282 /* We do extra processing here since we only want to print each
284 for (ix = 0; VEC_iterate (char_ptr, completions, ix, item); ++ix)
286 if (prev == NULL || strcmp (item, prev) != 0)
288 printf_unfiltered ("%s%s\n", arg_prefix, item);
297 VEC_free (char_ptr, completions);
302 is_complete_command (struct cmd_list_element *c)
304 return cmd_cfunc_eq (c, complete_command);
308 show_version (char *args, int from_tty)
310 print_gdb_version (gdb_stdout);
311 printf_filtered ("\n");
315 show_configuration (char *args, int from_tty)
317 print_gdb_configuration (gdb_stdout);
320 /* Handle the quit command. */
323 quit_command (char *args, int from_tty)
325 if (!quit_confirm ())
326 error (_("Not confirmed."));
328 query_if_trace_running (from_tty);
330 quit_force (args, from_tty);
334 pwd_command (char *args, int from_tty)
337 error (_("The \"pwd\" command does not take an argument: %s"), args);
338 if (! getcwd (gdb_dirbuf, sizeof (gdb_dirbuf)))
339 error (_("Error finding name of working directory: %s"),
340 safe_strerror (errno));
342 if (strcmp (gdb_dirbuf, current_directory) != 0)
343 printf_unfiltered (_("Working directory %s\n (canonically %s).\n"),
344 current_directory, gdb_dirbuf);
346 printf_unfiltered (_("Working directory %s.\n"), current_directory);
350 cd_command (char *dir, int from_tty)
353 /* Found something other than leading repetitions of "/..". */
356 struct cleanup *cleanup;
358 /* If the new directory is absolute, repeat is a no-op; if relative,
359 repeat might be useful but is more likely to be a mistake. */
365 dir = tilde_expand (dir);
366 cleanup = make_cleanup (xfree, dir);
369 perror_with_name (dir);
371 #ifdef HAVE_DOS_BASED_FILE_SYSTEM
372 /* There's too much mess with DOSish names like "d:", "d:.",
373 "d:./foo" etc. Instead of having lots of special #ifdef'ed code,
374 simply get the canonicalized name of the current directory. */
375 dir = getcwd (gdb_dirbuf, sizeof (gdb_dirbuf));
379 if (IS_DIR_SEPARATOR (dir[len - 1]))
381 /* Remove the trailing slash unless this is a root directory
382 (including a drive letter on non-Unix systems). */
383 if (!(len == 1) /* "/" */
384 #ifdef HAVE_DOS_BASED_FILE_SYSTEM
385 && !(len == 3 && dir[1] == ':') /* "d:/" */
391 dir = savestring (dir, len);
392 if (IS_ABSOLUTE_PATH (dir))
393 current_directory = dir;
396 if (IS_DIR_SEPARATOR (current_directory[strlen (current_directory) - 1]))
397 current_directory = concat (current_directory, dir, (char *)NULL);
399 current_directory = concat (current_directory, SLASH_STRING,
404 /* Now simplify any occurrences of `.' and `..' in the pathname. */
407 for (p = current_directory; *p;)
409 if (IS_DIR_SEPARATOR (p[0]) && p[1] == '.'
410 && (p[2] == 0 || IS_DIR_SEPARATOR (p[2])))
411 memmove (p, p + 2, strlen (p + 2) + 1);
412 else if (IS_DIR_SEPARATOR (p[0]) && p[1] == '.' && p[2] == '.'
413 && (p[3] == 0 || IS_DIR_SEPARATOR (p[3])))
417 /* Search backwards for the directory just before the "/.."
418 and obliterate it and the "/..". */
421 while (q != current_directory && !IS_DIR_SEPARATOR (q[-1]))
424 if (q == current_directory)
425 /* current_directory is
426 a relative pathname ("can't happen"--leave it alone). */
430 memmove (q - 1, p + 3, strlen (p + 3) + 1);
435 /* We are dealing with leading repetitions of "/..", for
436 example "/../..", which is the Mach super-root. */
446 forget_cached_source_info ();
449 pwd_command ((char *) 0, 1);
451 do_cleanups (cleanup);
454 /* Show the current value of the 'script-extension' option. */
457 show_script_ext_mode (struct ui_file *file, int from_tty,
458 struct cmd_list_element *c, const char *value)
460 fprintf_filtered (file,
461 _("Script filename extension recognition is \"%s\".\n"),
465 /* Try to open SCRIPT_FILE.
466 If successful, the full path name is stored in *FULL_PATHP,
467 the stream is stored in *STREAMP, and return 1.
468 The caller is responsible for freeing *FULL_PATHP.
469 If not successful, return 0; errno is set for the last file
472 If SEARCH_PATH is non-zero, and the file isn't found in cwd,
473 search for it in the source search path. */
476 find_and_open_script (const char *script_file, int search_path,
477 FILE **streamp, char **full_pathp)
481 struct cleanup *old_cleanups;
482 int search_flags = OPF_TRY_CWD_FIRST | OPF_RETURN_REALPATH;
484 file = tilde_expand (script_file);
485 old_cleanups = make_cleanup (xfree, file);
488 search_flags |= OPF_SEARCH_IN_PATH;
490 /* Search for and open 'file' on the search path used for source
491 files. Put the full location in *FULL_PATHP. */
492 fd = openp (source_path, search_flags,
493 file, O_RDONLY, full_pathp);
497 int save_errno = errno;
498 do_cleanups (old_cleanups);
503 do_cleanups (old_cleanups);
505 *streamp = fdopen (fd, FOPEN_RT);
506 if (*streamp == NULL)
508 int save_errno = errno;
520 /* Load script FILE, which has already been opened as STREAM. */
523 source_script_from_stream (FILE *stream, const char *file)
525 if (script_ext_mode != script_ext_off)
527 const struct extension_language_defn *extlang
528 = get_ext_lang_of_file (file);
532 if (ext_lang_present_p (extlang))
534 script_sourcer_func *sourcer
535 = ext_lang_script_sourcer (extlang);
537 gdb_assert (sourcer != NULL);
538 sourcer (extlang, stream, file);
541 else if (script_ext_mode == script_ext_soft)
543 /* Assume the file is a gdb script.
544 This is handled below. */
547 throw_ext_lang_unsupported (extlang);
551 script_from_file (stream, file);
554 /* Worker to perform the "source" command.
556 If SEARCH_PATH is non-zero, and the file isn't found in cwd,
557 search for it in the source search path. */
560 source_script_with_search (const char *file, int from_tty, int search_path)
564 struct cleanup *old_cleanups;
566 if (file == NULL || *file == 0)
567 error (_("source command requires file name of file to source."));
569 if (!find_and_open_script (file, search_path, &stream, &full_path))
571 /* The script wasn't found, or was otherwise inaccessible.
572 If the source command was invoked interactively, throw an
573 error. Otherwise (e.g. if it was invoked by a script),
574 just emit a warning, rather than cause an error. */
576 perror_with_name (file);
579 perror_warning_with_name (file);
584 old_cleanups = make_cleanup (xfree, full_path);
585 make_cleanup_fclose (stream);
586 /* The python support reopens the file, so we need to pass full_path here
587 in case the file was found on the search path. It's useful to do this
588 anyway so that error messages show the actual file used. But only do
589 this if we (may have) used search_path, as printing the full path in
590 errors for the non-search case can be more noise than signal. */
591 source_script_from_stream (stream, search_path ? full_path : file);
592 do_cleanups (old_cleanups);
595 /* Wrapper around source_script_with_search to export it to main.c
596 for use in loading .gdbinit scripts. */
599 source_script (const char *file, int from_tty)
601 source_script_with_search (file, from_tty, 0);
604 /* Return the source_verbose global variable to its previous state
605 on exit from the source command, by whatever means. */
607 source_verbose_cleanup (void *old_value)
609 source_verbose = *(int *)old_value;
614 source_command (char *args, int from_tty)
616 struct cleanup *old_cleanups;
618 int *old_source_verbose = xmalloc (sizeof(int));
621 *old_source_verbose = source_verbose;
622 old_cleanups = make_cleanup (source_verbose_cleanup,
625 /* -v causes the source command to run in verbose mode.
626 -s causes the file to be searched in the source search path,
627 even if the file name contains a '/'.
628 We still have to be able to handle filenames with spaces in a
629 backward compatible way, so buildargv is not appropriate. */
633 while (args[0] != '\0')
635 /* Make sure leading white space does not break the
637 args = skip_spaces (args);
642 if (args[1] == 'v' && isspace (args[2]))
646 /* Skip passed -v. */
649 else if (args[1] == 's' && isspace (args[2]))
653 /* Skip passed -s. */
660 file = skip_spaces (args);
663 source_script_with_search (file, from_tty, search_path);
665 do_cleanups (old_cleanups);
670 echo_command (char *text, int from_tty)
672 const char *p = text;
676 while ((c = *p++) != '\0')
680 /* \ at end of argument is used after spaces
681 so they won't be lost. */
685 c = parse_escape (get_current_arch (), &p);
687 printf_filtered ("%c", c);
690 printf_filtered ("%c", c);
693 /* Force this output to appear now. */
695 gdb_flush (gdb_stdout);
699 shell_escape (char *arg, int from_tty)
701 #if defined(CANT_FORK) || \
702 (!defined(HAVE_WORKING_VFORK) && !defined(HAVE_WORKING_FORK))
703 /* If ARG is NULL, they want an inferior shell, but `system' just
704 reports if the shell is available when passed a NULL arg. */
705 int rc = system (arg ? arg : "");
708 arg = "inferior shell";
712 fprintf_unfiltered (gdb_stderr, "Cannot execute %s: %s\n", arg,
713 safe_strerror (errno));
714 gdb_flush (gdb_stderr);
718 fprintf_unfiltered (gdb_stderr, "%s exited with status %d\n", arg, rc);
719 gdb_flush (gdb_stderr);
722 /* Make sure to return to the directory GDB thinks it is, in case
723 the shell command we just ran changed it. */
724 chdir (current_directory);
726 #else /* Can fork. */
729 if ((pid = vfork ()) == 0)
731 const char *p, *user_shell;
735 if ((user_shell = (char *) getenv ("SHELL")) == NULL)
736 user_shell = "/bin/sh";
738 /* Get the name of the shell for arg0. */
739 p = lbasename (user_shell);
742 execl (user_shell, p, (char *) 0);
744 execl (user_shell, p, "-c", arg, (char *) 0);
746 fprintf_unfiltered (gdb_stderr, "Cannot execute %s: %s\n", user_shell,
747 safe_strerror (errno));
748 gdb_flush (gdb_stderr);
753 waitpid (pid, &status, 0);
755 error (_("Fork failed"));
756 #endif /* Can fork. */
760 edit_command (char *arg, int from_tty)
762 struct symtabs_and_lines sals;
763 struct symtab_and_line sal;
770 /* Pull in the current default source line if necessary. */
773 set_default_source_symtab_and_line ();
774 sal = get_current_source_symtab_and_line ();
777 /* Bare "edit" edits file with present line. */
782 error (_("No default source file yet."));
783 sal.line += get_lines_to_list () / 2;
787 /* Now should only be one argument -- decode it in SAL. */
790 sals = decode_line_1 (&arg1, DECODE_LINE_LIST_MODE, 0, 0);
800 ambiguous_line_spec (&sals);
809 error (_("Junk at end of line specification."));
811 /* If line was specified by address, first print exactly which
812 line, and which file. In this case, sal.symtab == 0 means
813 address is outside of all known source files, not that user
814 failed to give a filename. */
817 struct gdbarch *gdbarch;
820 error (_("No source file for address %s."),
821 paddress (get_current_arch (), sal.pc));
823 gdbarch = get_objfile_arch (sal.symtab->objfile);
824 sym = find_pc_function (sal.pc);
826 printf_filtered ("%s is in %s (%s:%d).\n",
827 paddress (gdbarch, sal.pc),
828 SYMBOL_PRINT_NAME (sym),
829 symtab_to_filename_for_display (sal.symtab),
832 printf_filtered ("%s is at %s:%d.\n",
833 paddress (gdbarch, sal.pc),
834 symtab_to_filename_for_display (sal.symtab),
838 /* If what was given does not imply a symtab, it must be an
839 undebuggable symbol which means no source code. */
842 error (_("No line number known for %s."), arg);
845 if ((editor = (char *) getenv ("EDITOR")) == NULL)
848 fn = symtab_to_fullname (sal.symtab);
850 /* Quote the file name, in case it has whitespace or other special
852 p = xstrprintf ("%s +%d \"%s\"", editor, sal.line, fn);
853 shell_escape (p, from_tty);
858 list_command (char *arg, int from_tty)
860 struct symtabs_and_lines sals, sals_end;
861 struct symtab_and_line sal = { 0 };
862 struct symtab_and_line sal_end = { 0 };
863 struct symtab_and_line cursal = { 0 };
872 /* Pull in the current default source line if necessary. */
873 if (arg == 0 || arg[0] == '+' || arg[0] == '-')
875 set_default_source_symtab_and_line ();
876 cursal = get_current_source_symtab_and_line ();
878 /* If this is the first "list" since we've set the current
879 source line, center the listing around that line. */
880 if (get_first_line_listed () == 0)
884 first = max (cursal.line - get_lines_to_list () / 2, 1);
886 /* A small special case --- if listing backwards, and we
887 should list only one line, list the preceding line,
888 instead of the exact line we've just shown after e.g.,
889 stopping for a breakpoint. */
890 if (arg != NULL && arg[0] == '-'
891 && get_lines_to_list () == 1 && first > 1)
894 print_source_lines (cursal.symtab, first,
895 first + get_lines_to_list (), 0);
900 /* "l" or "l +" lists next ten lines. */
902 if (arg == 0 || strcmp (arg, "+") == 0)
904 print_source_lines (cursal.symtab, cursal.line,
905 cursal.line + get_lines_to_list (), 0);
909 /* "l -" lists previous ten lines, the ones before the ten just
911 if (strcmp (arg, "-") == 0)
913 print_source_lines (cursal.symtab,
914 max (get_first_line_listed ()
915 - get_lines_to_list (), 1),
916 get_first_line_listed (), 0);
920 /* Now if there is only one argument, decode it in SAL
922 If there are two arguments, decode them in SAL and SAL_END
923 and clear NO_END; however, if one of the arguments is blank,
924 set DUMMY_BEG or DUMMY_END to record that fact. */
926 if (!have_full_symbols () && !have_partial_symbols ())
927 error (_("No symbol table is loaded. Use the \"file\" command."));
934 sals = decode_line_1 (&arg1, DECODE_LINE_LIST_MODE, 0, 0);
941 ambiguous_line_spec (&sals);
950 /* Record whether the BEG arg is all digits. */
952 for (p = arg; p != arg1 && *p >= '0' && *p <= '9'; p++);
953 linenum_beg = (p == arg1);
955 while (*arg1 == ' ' || *arg1 == '\t')
961 while (*arg1 == ' ' || *arg1 == '\t')
968 sals_end = decode_line_1 (&arg1, DECODE_LINE_LIST_MODE, 0, 0);
970 sals_end = decode_line_1 (&arg1, DECODE_LINE_LIST_MODE,
971 sal.symtab, sal.line);
972 filter_sals (&sals_end);
973 if (sals_end.nelts == 0)
975 if (sals_end.nelts > 1)
977 ambiguous_line_spec (&sals_end);
978 xfree (sals_end.sals);
981 sal_end = sals_end.sals[0];
982 xfree (sals_end.sals);
987 error (_("Junk at end of line specification."));
989 if (!no_end && !dummy_beg && !dummy_end
990 && sal.symtab != sal_end.symtab)
991 error (_("Specified start and end are in different files."));
992 if (dummy_beg && dummy_end)
993 error (_("Two empty args do not say what lines to list."));
995 /* If line was specified by address,
996 first print exactly which line, and which file.
998 In this case, sal.symtab == 0 means address is outside of all
999 known source files, not that user failed to give a filename. */
1002 struct gdbarch *gdbarch;
1004 if (sal.symtab == 0)
1005 error (_("No source file for address %s."),
1006 paddress (get_current_arch (), sal.pc));
1008 gdbarch = get_objfile_arch (sal.symtab->objfile);
1009 sym = find_pc_function (sal.pc);
1011 printf_filtered ("%s is in %s (%s:%d).\n",
1012 paddress (gdbarch, sal.pc),
1013 SYMBOL_PRINT_NAME (sym),
1014 symtab_to_filename_for_display (sal.symtab), sal.line);
1016 printf_filtered ("%s is at %s:%d.\n",
1017 paddress (gdbarch, sal.pc),
1018 symtab_to_filename_for_display (sal.symtab), sal.line);
1021 /* If line was not specified by just a line number, and it does not
1022 imply a symtab, it must be an undebuggable symbol which means no
1025 if (!linenum_beg && sal.symtab == 0)
1026 error (_("No line number known for %s."), arg);
1028 /* If this command is repeated with RET,
1029 turn it into the no-arg variant. */
1034 if (dummy_beg && sal_end.symtab == 0)
1035 error (_("No default source file yet. Do \"help list\"."));
1037 print_source_lines (sal_end.symtab,
1038 max (sal_end.line - (get_lines_to_list () - 1), 1),
1039 sal_end.line + 1, 0);
1040 else if (sal.symtab == 0)
1041 error (_("No default source file yet. Do \"help list\"."));
1044 int first_line = sal.line - get_lines_to_list () / 2;
1046 if (first_line < 1) first_line = 1;
1048 print_source_lines (sal.symtab,
1050 first_line + get_lines_to_list (),
1054 print_source_lines (sal.symtab, sal.line,
1056 ? sal.line + get_lines_to_list ()
1057 : sal_end.line + 1),
1061 /* Subroutine of disassemble_command to simplify it.
1062 Perform the disassembly.
1063 NAME is the name of the function if known, or NULL.
1064 [LOW,HIGH) are the range of addresses to disassemble.
1065 MIXED is non-zero to print source with the assembler. */
1068 print_disassembly (struct gdbarch *gdbarch, const char *name,
1069 CORE_ADDR low, CORE_ADDR high, int flags)
1072 if (!tui_is_window_visible (DISASSEM_WIN))
1075 printf_filtered ("Dump of assembler code ");
1077 printf_filtered ("for function %s:\n", name);
1079 printf_filtered ("from %s to %s:\n",
1080 paddress (gdbarch, low), paddress (gdbarch, high));
1082 /* Dump the specified range. */
1083 gdb_disassembly (gdbarch, current_uiout, 0, flags, -1, low, high);
1085 printf_filtered ("End of assembler dump.\n");
1086 gdb_flush (gdb_stdout);
1091 tui_show_assembly (gdbarch, low);
1096 /* Subroutine of disassemble_command to simplify it.
1097 Print a disassembly of the current function according to FLAGS. */
1100 disassemble_current_function (int flags)
1102 struct frame_info *frame;
1103 struct gdbarch *gdbarch;
1104 CORE_ADDR low, high, pc;
1107 frame = get_selected_frame (_("No frame selected."));
1108 gdbarch = get_frame_arch (frame);
1109 pc = get_frame_address_in_block (frame);
1110 if (find_pc_partial_function (pc, &name, &low, &high) == 0)
1111 error (_("No function contains program counter for selected frame."));
1113 /* NOTE: cagney/2003-02-13 The `tui_active' was previously
1116 /* FIXME: cagney/2004-02-07: This should be an observer. */
1117 low = tui_get_low_disassembly_address (gdbarch, low, pc);
1119 low += gdbarch_deprecated_function_start_offset (gdbarch);
1121 print_disassembly (gdbarch, name, low, high, flags);
1124 /* Dump a specified section of assembly code.
1128 - dump the assembly code for the function of the current pc
1129 disassemble [/mr] addr
1130 - dump the assembly code for the function at ADDR
1131 disassemble [/mr] low,high
1132 disassemble [/mr] low,+length
1133 - dump the assembly code in the range [LOW,HIGH), or [LOW,LOW+length)
1135 A /m modifier will include source code with the assembly.
1136 A /r modifier will include raw instructions in hex with the assembly. */
1139 disassemble_command (char *arg, int from_tty)
1141 struct gdbarch *gdbarch = get_current_arch ();
1142 CORE_ADDR low, high;
1157 error (_("Missing modifier."));
1159 while (*p && ! isspace (*p))
1164 flags |= DISASSEMBLY_SOURCE;
1167 flags |= DISASSEMBLY_RAW_INSN;
1170 error (_("Invalid disassembly modifier."));
1174 p = skip_spaces_const (p);
1179 flags |= DISASSEMBLY_OMIT_FNAME;
1180 disassemble_current_function (flags);
1184 pc = value_as_address (parse_to_comma_and_eval (&p));
1190 if (find_pc_partial_function (pc, &name, &low, &high) == 0)
1191 error (_("No function contains specified address."));
1193 /* NOTE: cagney/2003-02-13 The `tui_active' was previously
1196 /* FIXME: cagney/2004-02-07: This should be an observer. */
1197 low = tui_get_low_disassembly_address (gdbarch, low, pc);
1199 low += gdbarch_deprecated_function_start_offset (gdbarch);
1200 flags |= DISASSEMBLY_OMIT_FNAME;
1204 /* Two arguments. */
1207 p = skip_spaces_const (p);
1213 high = parse_and_eval_address (p);
1218 print_disassembly (gdbarch, name, low, high, flags);
1222 make_command (char *arg, int from_tty)
1230 p = xmalloc (sizeof ("make ") + strlen (arg));
1231 strcpy (p, "make ");
1232 strcpy (p + sizeof ("make ") - 1, arg);
1235 shell_escape (p, from_tty);
1239 show_user (char *args, int from_tty)
1241 struct cmd_list_element *c;
1242 extern struct cmd_list_element *cmdlist;
1246 const char *comname = args;
1248 c = lookup_cmd (&comname, cmdlist, "", 0, 1);
1249 /* c->user_commands would be NULL if it's a python/scheme command. */
1250 if (c->class != class_user || !c->user_commands)
1251 error (_("Not a user command."));
1252 show_user_1 (c, "", args, gdb_stdout);
1256 for (c = cmdlist; c; c = c->next)
1258 if (c->class == class_user || c->prefixlist != NULL)
1259 show_user_1 (c, "", c->name, gdb_stdout);
1264 /* Search through names of commands and documentations for a certain
1265 regular expression. */
1268 apropos_command (char *searchstr, int from_tty)
1273 if (searchstr == NULL)
1274 error (_("REGEXP string is empty"));
1276 code = regcomp (&pattern, searchstr, REG_ICASE);
1279 struct cleanup *cleanups;
1281 cleanups = make_regfree_cleanup (&pattern);
1282 apropos_cmd (gdb_stdout, cmdlist, &pattern, "");
1283 do_cleanups (cleanups);
1287 char *err = get_regcomp_error (code, &pattern);
1289 make_cleanup (xfree, err);
1290 error (_("Error in regular expression: %s"), err);
1294 /* Subroutine of alias_command to simplify it.
1295 Return the first N elements of ARGV flattened back to a string
1296 with a space separating each element.
1297 ARGV may not be NULL.
1298 This does not take care of quoting elements in case they contain spaces
1302 argv_to_dyn_string (char **argv, int n)
1305 dyn_string_t result = dyn_string_new (10);
1307 gdb_assert (argv != NULL);
1308 gdb_assert (n >= 0 && n <= countargv (argv));
1310 for (i = 0; i < n; ++i)
1313 dyn_string_append_char (result, ' ');
1314 dyn_string_append_cstr (result, argv[i]);
1320 /* Subroutine of alias_command to simplify it.
1321 Return TRUE if COMMAND exists, unambiguously. Otherwise FALSE. */
1324 valid_command_p (const char *command)
1326 struct cmd_list_element *c;
1328 c = lookup_cmd_1 (& command, cmdlist, NULL, 1);
1330 if (c == NULL || c == (struct cmd_list_element *) -1)
1333 /* This is the slightly tricky part.
1334 lookup_cmd_1 will return a pointer to the last part of COMMAND
1335 to match, leaving COMMAND pointing at the remainder. */
1336 while (*command == ' ' || *command == '\t')
1338 return *command == '\0';
1341 /* Make an alias of an existing command. */
1344 alias_command (char *args, int from_tty)
1346 int i, alias_argc, command_argc;
1347 int abbrev_flag = 0;
1348 char *args2, *equals, *alias, *command;
1349 char **alias_argv, **command_argv;
1350 dyn_string_t alias_dyn_string, command_dyn_string;
1351 struct cleanup *cleanup;
1352 static const char usage[] = N_("Usage: alias [-a] [--] ALIAS = COMMAND");
1354 if (args == NULL || strchr (args, '=') == NULL)
1357 args2 = xstrdup (args);
1358 cleanup = make_cleanup (xfree, args2);
1359 equals = strchr (args2, '=');
1361 alias_argv = gdb_buildargv (args2);
1362 make_cleanup_freeargv (alias_argv);
1363 command_argv = gdb_buildargv (equals + 1);
1364 make_cleanup_freeargv (command_argv);
1366 for (i = 0; alias_argv[i] != NULL; )
1368 if (strcmp (alias_argv[i], "-a") == 0)
1373 else if (strcmp (alias_argv[i], "--") == 0)
1382 if (alias_argv[0] == NULL || command_argv[0] == NULL
1383 || *alias_argv[0] == '\0' || *command_argv[0] == '\0')
1386 for (i = 0; alias_argv[i] != NULL; ++i)
1388 if (! valid_user_defined_cmd_name_p (alias_argv[i]))
1391 error (_("Invalid command name: %s"), alias_argv[i]);
1393 error (_("Invalid command element name: %s"), alias_argv[i]);
1397 alias_argc = countargv (alias_argv);
1398 command_argc = countargv (command_argv);
1400 /* COMMAND must exist.
1401 Reconstruct the command to remove any extraneous spaces,
1402 for better error messages. */
1403 command_dyn_string = argv_to_dyn_string (command_argv, command_argc);
1404 make_cleanup_dyn_string_delete (command_dyn_string);
1405 command = dyn_string_buf (command_dyn_string);
1406 if (! valid_command_p (command))
1407 error (_("Invalid command to alias to: %s"), command);
1409 /* ALIAS must not exist. */
1410 alias_dyn_string = argv_to_dyn_string (alias_argv, alias_argc);
1411 make_cleanup_dyn_string_delete (alias_dyn_string);
1412 alias = dyn_string_buf (alias_dyn_string);
1413 if (valid_command_p (alias))
1414 error (_("Alias already exists: %s"), alias);
1416 /* If ALIAS is one word, it is an alias for the entire COMMAND.
1417 Example: alias spe = set print elements
1419 Otherwise ALIAS and COMMAND must have the same number of words,
1420 and every word except the last must match; and the last word of
1421 ALIAS is made an alias of the last word of COMMAND.
1422 Example: alias set print elms = set pr elem
1423 Note that unambiguous abbreviations are allowed. */
1425 if (alias_argc == 1)
1427 /* add_cmd requires *we* allocate space for name, hence the xstrdup. */
1428 add_com_alias (xstrdup (alias_argv[0]), command, class_alias,
1433 dyn_string_t alias_prefix_dyn_string, command_prefix_dyn_string;
1434 const char *alias_prefix, *command_prefix;
1435 struct cmd_list_element *c_alias, *c_command;
1437 if (alias_argc != command_argc)
1438 error (_("Mismatched command length between ALIAS and COMMAND."));
1440 /* Create copies of ALIAS and COMMAND without the last word,
1441 and use that to verify the leading elements match. */
1442 alias_prefix_dyn_string =
1443 argv_to_dyn_string (alias_argv, alias_argc - 1);
1444 make_cleanup_dyn_string_delete (alias_prefix_dyn_string);
1445 command_prefix_dyn_string =
1446 argv_to_dyn_string (alias_argv, command_argc - 1);
1447 make_cleanup_dyn_string_delete (command_prefix_dyn_string);
1448 alias_prefix = dyn_string_buf (alias_prefix_dyn_string);
1449 command_prefix = dyn_string_buf (command_prefix_dyn_string);
1451 c_command = lookup_cmd_1 (& command_prefix, cmdlist, NULL, 1);
1452 /* We've already tried to look up COMMAND. */
1453 gdb_assert (c_command != NULL
1454 && c_command != (struct cmd_list_element *) -1);
1455 gdb_assert (c_command->prefixlist != NULL);
1456 c_alias = lookup_cmd_1 (& alias_prefix, cmdlist, NULL, 1);
1457 if (c_alias != c_command)
1458 error (_("ALIAS and COMMAND prefixes do not match."));
1460 /* add_cmd requires *we* allocate space for name, hence the xstrdup. */
1461 add_alias_cmd (xstrdup (alias_argv[alias_argc - 1]),
1462 command_argv[command_argc - 1],
1463 class_alias, abbrev_flag, c_command->prefixlist);
1466 do_cleanups (cleanup);
1469 /* Print a list of files and line numbers which a user may choose from
1470 in order to list a function which was specified ambiguously (as
1471 with `list classname::overloadedfuncname', for example). The
1472 vector in SALS provides the filenames and line numbers. */
1475 ambiguous_line_spec (struct symtabs_and_lines *sals)
1479 for (i = 0; i < sals->nelts; ++i)
1480 printf_filtered (_("file: \"%s\", line number: %d\n"),
1481 symtab_to_filename_for_display (sals->sals[i].symtab),
1482 sals->sals[i].line);
1485 /* Sort function for filter_sals. */
1488 compare_symtabs (const void *a, const void *b)
1490 const struct symtab_and_line *sala = a;
1491 const struct symtab_and_line *salb = b;
1494 if (!sala->symtab->dirname)
1496 if (salb->symtab->dirname)
1499 else if (!salb->symtab->dirname)
1501 if (sala->symtab->dirname)
1506 r = filename_cmp (sala->symtab->dirname, salb->symtab->dirname);
1511 r = filename_cmp (sala->symtab->filename, salb->symtab->filename);
1515 if (sala->line < salb->line)
1517 return sala->line == salb->line ? 0 : 1;
1520 /* Remove any SALs that do not match the current program space, or
1521 which appear to be "file:line" duplicates. */
1524 filter_sals (struct symtabs_and_lines *sals)
1529 for (i = 0; i < sals->nelts; ++i)
1531 if (sals->sals[i].pspace == current_program_space
1532 && sals->sals[i].symtab != NULL)
1534 sals->sals[out] = sals->sals[i];
1540 qsort (sals->sals, sals->nelts, sizeof (struct symtab_and_line),
1545 for (i = 1; i < sals->nelts; ++i)
1547 if (compare_symtabs (&sals->sals[prev], &sals->sals[i]))
1549 /* Symtabs differ. */
1550 sals->sals[out] = sals->sals[i];
1556 if (sals->nelts == 0)
1566 set_debug (char *arg, int from_tty)
1568 printf_unfiltered (_("\"set debug\" must be followed by "
1569 "the name of a debug subcommand.\n"));
1570 help_list (setdebuglist, "set debug ", all_commands, gdb_stdout);
1574 show_debug (char *args, int from_tty)
1576 cmd_show_list (showdebuglist, from_tty, "");
1580 init_cmd_lists (void)
1582 max_user_call_depth = 1024;
1586 show_info_verbose (struct ui_file *file, int from_tty,
1587 struct cmd_list_element *c,
1591 fprintf_filtered (file,
1592 _("Verbose printing of informational messages is %s.\n"),
1595 fprintf_filtered (file, _("Verbosity is %s.\n"), value);
1599 show_history_expansion_p (struct ui_file *file, int from_tty,
1600 struct cmd_list_element *c, const char *value)
1602 fprintf_filtered (file, _("History expansion on command input is %s.\n"),
1607 show_remote_debug (struct ui_file *file, int from_tty,
1608 struct cmd_list_element *c, const char *value)
1610 fprintf_filtered (file, _("Debugging of remote protocol is %s.\n"),
1615 show_remote_timeout (struct ui_file *file, int from_tty,
1616 struct cmd_list_element *c, const char *value)
1618 fprintf_filtered (file,
1619 _("Timeout limit to wait for target to respond is %s.\n"),
1624 show_max_user_call_depth (struct ui_file *file, int from_tty,
1625 struct cmd_list_element *c, const char *value)
1627 fprintf_filtered (file,
1628 _("The max call depth for user-defined commands is %s.\n"),
1634 initialize_file_ftype _initialize_cli_cmds;
1637 _initialize_cli_cmds (void)
1639 struct cmd_list_element *c;
1641 /* Define the classes of commands.
1642 They will appear in the help list in alphabetical order. */
1644 add_cmd ("internals", class_maintenance, NULL, _("\
1645 Maintenance commands.\n\
1646 Some gdb commands are provided just for use by gdb maintainers.\n\
1647 These commands are subject to frequent change, and may not be as\n\
1648 well documented as user commands."),
1650 add_cmd ("obscure", class_obscure, NULL, _("Obscure features."), &cmdlist);
1651 add_cmd ("aliases", class_alias, NULL,
1652 _("Aliases of other commands."), &cmdlist);
1653 add_cmd ("user-defined", class_user, NULL, _("\
1654 User-defined commands.\n\
1655 The commands in this class are those defined by the user.\n\
1656 Use the \"define\" command to define a command."), &cmdlist);
1657 add_cmd ("support", class_support, NULL, _("Support facilities."), &cmdlist);
1659 add_cmd ("status", class_info, NULL, _("Status inquiries."), &cmdlist);
1660 add_cmd ("files", class_files, NULL, _("Specifying and examining files."),
1662 add_cmd ("breakpoints", class_breakpoint, NULL,
1663 _("Making program stop at certain points."), &cmdlist);
1664 add_cmd ("data", class_vars, NULL, _("Examining data."), &cmdlist);
1665 add_cmd ("stack", class_stack, NULL, _("\
1666 Examining the stack.\n\
1667 The stack is made up of stack frames. Gdb assigns numbers to stack frames\n\
1668 counting from zero for the innermost (currently executing) frame.\n\n\
1669 At any time gdb identifies one frame as the \"selected\" frame.\n\
1670 Variable lookups are done with respect to the selected frame.\n\
1671 When the program being debugged stops, gdb selects the innermost frame.\n\
1672 The commands below can be used to select other frames by number or address."),
1674 add_cmd ("running", class_run, NULL, _("Running the program."), &cmdlist);
1676 /* Define general commands. */
1678 add_com ("pwd", class_files, pwd_command, _("\
1679 Print working directory. This is used for your program as well."));
1681 c = add_cmd ("cd", class_files, cd_command, _("\
1682 Set working directory to DIR for debugger and program being debugged.\n\
1683 The change does not take effect for the program being debugged\n\
1684 until the next time it is started."), &cmdlist);
1685 set_cmd_completer (c, filename_completer);
1687 add_com ("echo", class_support, echo_command, _("\
1688 Print a constant string. Give string as argument.\n\
1689 C escape sequences may be used in the argument.\n\
1690 No newline is added at the end of the argument;\n\
1691 use \"\\n\" if you want a newline to be printed.\n\
1692 Since leading and trailing whitespace are ignored in command arguments,\n\
1693 if you want to print some you must use \"\\\" before leading whitespace\n\
1694 to be printed or after trailing whitespace."));
1696 add_setshow_enum_cmd ("script-extension", class_support,
1697 script_ext_enums, &script_ext_mode, _("\
1698 Set mode for script filename extension recognition."), _("\
1699 Show mode for script filename extension recognition."), _("\
1700 off == no filename extension recognition (all sourced files are GDB scripts)\n\
1701 soft == evaluate script according to filename extension, fallback to GDB script"
1703 strict == evaluate script according to filename extension, error if not supported"
1706 show_script_ext_mode,
1707 &setlist, &showlist);
1709 add_com ("quit", class_support, quit_command, _("\
1711 Usage: quit [EXPR]\n\
1712 The optional expression EXPR, if present, is evaluated and the result\n\
1713 used as GDB's exit code. The default is zero."));
1714 c = add_com ("help", class_support, help_command,
1715 _("Print list of commands."));
1716 set_cmd_completer (c, command_completer);
1717 add_com_alias ("q", "quit", class_support, 1);
1718 add_com_alias ("h", "help", class_support, 1);
1720 add_setshow_boolean_cmd ("verbose", class_support, &info_verbose, _("\
1721 Set verbosity."), _("\
1722 Show verbosity."), NULL,
1725 &setlist, &showlist);
1727 add_prefix_cmd ("history", class_support, set_history,
1728 _("Generic command for setting command history parameters."),
1729 &sethistlist, "set history ", 0, &setlist);
1730 add_prefix_cmd ("history", class_support, show_history,
1731 _("Generic command for showing command history parameters."),
1732 &showhistlist, "show history ", 0, &showlist);
1734 add_setshow_boolean_cmd ("expansion", no_class, &history_expansion_p, _("\
1735 Set history expansion on command input."), _("\
1736 Show history expansion on command input."), _("\
1737 Without an argument, history expansion is enabled."),
1739 show_history_expansion_p,
1740 &sethistlist, &showhistlist);
1742 add_prefix_cmd ("info", class_info, info_command, _("\
1743 Generic command for showing things about the program being debugged."),
1744 &infolist, "info ", 0, &cmdlist);
1745 add_com_alias ("i", "info", class_info, 1);
1746 add_com_alias ("inf", "info", class_info, 1);
1748 add_com ("complete", class_obscure, complete_command,
1749 _("List the completions for the rest of the line as a command."));
1751 add_prefix_cmd ("show", class_info, show_command, _("\
1752 Generic command for showing things about the debugger."),
1753 &showlist, "show ", 0, &cmdlist);
1754 /* Another way to get at the same thing. */
1755 add_info ("set", show_command, _("Show all GDB settings."));
1757 add_cmd ("commands", no_set_class, show_commands, _("\
1758 Show the history of commands you typed.\n\
1759 You can supply a command number to start with, or a `+' to start after\n\
1760 the previous command number shown."),
1763 add_cmd ("version", no_set_class, show_version,
1764 _("Show what version of GDB this is."), &showlist);
1766 add_cmd ("configuration", no_set_class, show_configuration,
1767 _("Show how GDB was configured at build time."), &showlist);
1769 add_setshow_zinteger_cmd ("remote", no_class, &remote_debug, _("\
1770 Set debugging of remote protocol."), _("\
1771 Show debugging of remote protocol."), _("\
1772 When enabled, each packet sent or received with the remote target\n\
1776 &setdebuglist, &showdebuglist);
1778 add_setshow_zuinteger_unlimited_cmd ("remotetimeout", no_class,
1779 &remote_timeout, _("\
1780 Set timeout limit to wait for target to respond."), _("\
1781 Show timeout limit to wait for target to respond."), _("\
1782 This value is used to set the time limit for gdb to wait for a response\n\
1785 show_remote_timeout,
1786 &setlist, &showlist);
1788 add_prefix_cmd ("debug", no_class, set_debug,
1789 _("Generic command for setting gdb debugging flags"),
1790 &setdebuglist, "set debug ", 0, &setlist);
1792 add_prefix_cmd ("debug", no_class, show_debug,
1793 _("Generic command for showing gdb debugging flags"),
1794 &showdebuglist, "show debug ", 0, &showlist);
1796 c = add_com ("shell", class_support, shell_escape, _("\
1797 Execute the rest of the line as a shell command.\n\
1798 With no arguments, run an inferior shell."));
1799 set_cmd_completer (c, filename_completer);
1801 c = add_com ("edit", class_files, edit_command, _("\
1802 Edit specified file or function.\n\
1803 With no argument, edits file containing most recent line listed.\n\
1804 Editing targets can be specified in these ways:\n\
1805 FILE:LINENUM, to edit at that line in that file,\n\
1806 FUNCTION, to edit at the beginning of that function,\n\
1807 FILE:FUNCTION, to distinguish among like-named static functions.\n\
1808 *ADDRESS, to edit at the line containing that address.\n\
1809 Uses EDITOR environment variable contents as editor (or ex as default)."));
1811 c->completer = location_completer;
1813 add_com ("list", class_files, list_command, _("\
1814 List specified function or line.\n\
1815 With no argument, lists ten more lines after or around previous listing.\n\
1816 \"list -\" lists the ten lines before a previous ten-line listing.\n\
1817 One argument specifies a line, and ten lines are listed around that line.\n\
1818 Two arguments with comma between specify starting and ending lines to list.\n\
1819 Lines can be specified in these ways:\n\
1820 LINENUM, to list around that line in current file,\n\
1821 FILE:LINENUM, to list around that line in that file,\n\
1822 FUNCTION, to list around beginning of that function,\n\
1823 FILE:FUNCTION, to distinguish among like-named static functions.\n\
1824 *ADDRESS, to list around the line containing that address.\n\
1825 With two args if one is empty it stands for ten lines away from \
1829 add_com_alias ("l", "list", class_files, 1);
1831 add_com_alias ("v", "list", class_files, 1);
1834 add_com_alias ("file", "list", class_files, 1);
1836 c = add_com ("disassemble", class_vars, disassemble_command, _("\
1837 Disassemble a specified section of memory.\n\
1838 Default is the function surrounding the pc of the selected frame.\n\
1839 With a /m modifier, source lines are included (if available).\n\
1840 With a /r modifier, raw instructions in hex are included.\n\
1841 With a single argument, the function surrounding that address is dumped.\n\
1842 Two arguments (separated by a comma) are taken as a range of memory to dump,\n\
1843 in the form of \"start,end\", or \"start,+length\".\n\
1845 Note that the address is interpreted as an expression, not as a location\n\
1846 like in the \"break\" command.\n\
1847 So, for example, if you want to disassemble function bar in file foo.c\n\
1848 you must type \"disassemble 'foo.c'::bar\" and not \"disassemble foo.c:bar\"."));
1849 set_cmd_completer (c, location_completer);
1851 add_com_alias ("va", "disassemble", class_xdb, 0);
1853 add_com_alias ("!", "shell", class_support, 0);
1855 c = add_com ("make", class_support, make_command, _("\
1856 Run the ``make'' program using the rest of the line as arguments."));
1857 set_cmd_completer (c, filename_completer);
1858 add_cmd ("user", no_class, show_user, _("\
1859 Show definitions of non-python/scheme user defined commands.\n\
1860 Argument is the name of the user defined command.\n\
1861 With no argument, show definitions of all user defined commands."), &showlist);
1862 add_com ("apropos", class_support, apropos_command,
1863 _("Search for commands matching a REGEXP"));
1865 add_setshow_uinteger_cmd ("max-user-call-depth", no_class,
1866 &max_user_call_depth, _("\
1867 Set the max call depth for non-python/scheme user-defined commands."), _("\
1868 Show the max call depth for non-python/scheme user-defined commands."), NULL,
1870 show_max_user_call_depth,
1871 &setlist, &showlist);
1873 add_setshow_boolean_cmd ("trace-commands", no_class, &trace_commands, _("\
1874 Set tracing of GDB CLI commands."), _("\
1875 Show state of GDB CLI command tracing."), _("\
1876 When 'on', each command is displayed as it is executed."),
1879 &setlist, &showlist);
1881 c = add_com ("alias", class_support, alias_command, _("\
1882 Define a new command that is an alias of an existing command.\n\
1883 Usage: alias [-a] [--] ALIAS = COMMAND\n\
1884 ALIAS is the name of the alias command to create.\n\
1885 COMMAND is the command being aliased to.\n\
1886 If \"-a\" is specified, the command is an abbreviation,\n\
1887 and will not appear in help command list output.\n\
1890 Make \"spe\" an alias of \"set print elements\":\n\
1891 alias spe = set print elements\n\
1892 Make \"elms\" an alias of \"elements\" in the \"set print\" command:\n\
1893 alias -a set print elms = set print elements"));
1897 init_cli_cmds (void)
1899 struct cmd_list_element *c;
1900 char *source_help_text;
1902 source_help_text = xstrprintf (_("\
1903 Read commands from a file named FILE.\n\
1905 Usage: source [-s] [-v] FILE\n\
1906 -s: search for the script in the source search path,\n\
1907 even if FILE contains directories.\n\
1908 -v: each command in FILE is echoed as it is executed.\n\
1910 Note that the file \"%s\" is read automatically in this way\n\
1911 when GDB is started."), gdbinit);
1912 c = add_cmd ("source", class_support, source_command,
1913 source_help_text, &cmdlist);
1914 set_cmd_completer (c, filename_completer);