* cli/cli-cmds.c (set_debug): Fix cut-n-paste error.
[external/binutils.git] / gdb / cli / cli-cmds.c
1 /* GDB CLI commands.
2
3    Copyright (C) 2000, 2001, 2002, 2003, 2004, 2005, 2007, 2008, 2009
4    Free Software Foundation, Inc.
5
6    This file is part of GDB.
7
8    This program is free software; you can redistribute it and/or modify
9    it under the terms of the GNU General Public License as published by
10    the Free Software Foundation; either version 3 of the License, or
11    (at your option) any later version.
12
13    This program is distributed in the hope that it will be useful,
14    but WITHOUT ANY WARRANTY; without even the implied warranty of
15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16    GNU General Public License for more details.
17
18    You should have received a copy of the GNU General Public License
19    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
20
21 #include "defs.h"
22 #include "readline/readline.h"
23 #include "readline/tilde.h"
24 #include "completer.h"
25 #include "target.h"      /* For baud_rate, remote_debug and remote_timeout */
26 #include "gdb_wait.h"           /* For shell escape implementation */
27 #include "gdb_regex.h"          /* Used by apropos_command */
28 #include "gdb_string.h"
29 #include "gdb_vfork.h"
30 #include "linespec.h"
31 #include "expression.h"
32 #include "frame.h"
33 #include "value.h"
34 #include "language.h"
35 #include "filenames.h"          /* for DOSish file names */
36 #include "objfiles.h"
37 #include "source.h"
38 #include "disasm.h"
39
40 #include "ui-out.h"
41
42 #include "top.h"
43 #include "cli/cli-decode.h"
44 #include "cli/cli-script.h"
45 #include "cli/cli-setshow.h"
46 #include "cli/cli-cmds.h"
47
48 #ifdef TUI
49 #include "tui/tui.h"            /* For tui_active et.al.   */
50 #endif
51
52 #include <fcntl.h>
53
54 /* Prototypes for local command functions */
55
56 static void complete_command (char *, int);
57
58 static void echo_command (char *, int);
59
60 static void pwd_command (char *, int);
61
62 static void show_version (char *, int);
63
64 static void help_command (char *, int);
65
66 static void show_command (char *, int);
67
68 static void info_command (char *, int);
69
70 static void show_debug (char *, int);
71
72 static void set_debug (char *, int);
73
74 static void show_user (char *, int);
75
76 static void make_command (char *, int);
77
78 static void shell_escape (char *, int);
79
80 static void edit_command (char *, int);
81
82 static void list_command (char *, int);
83
84 void apropos_command (char *, int);
85
86 /* Prototypes for local utility functions */
87
88 static void ambiguous_line_spec (struct symtabs_and_lines *);
89 \f
90 /* Limit the call depth of user-defined commands */
91 int max_user_call_depth;
92
93 /* Define all cmd_list_elements.  */
94
95 /* Chain containing all defined commands.  */
96
97 struct cmd_list_element *cmdlist;
98
99 /* Chain containing all defined info subcommands.  */
100
101 struct cmd_list_element *infolist;
102
103 /* Chain containing all defined enable subcommands. */
104
105 struct cmd_list_element *enablelist;
106
107 /* Chain containing all defined disable subcommands. */
108
109 struct cmd_list_element *disablelist;
110
111 /* Chain containing all defined toggle subcommands. */
112
113 struct cmd_list_element *togglelist;
114
115 /* Chain containing all defined stop subcommands. */
116
117 struct cmd_list_element *stoplist;
118
119 /* Chain containing all defined delete subcommands. */
120
121 struct cmd_list_element *deletelist;
122
123 /* Chain containing all defined detach subcommands. */
124
125 struct cmd_list_element *detachlist;
126
127 /* Chain containing all defined "enable breakpoint" subcommands. */
128
129 struct cmd_list_element *enablebreaklist;
130
131 /* Chain containing all defined set subcommands */
132
133 struct cmd_list_element *setlist;
134
135 /* Chain containing all defined unset subcommands */
136
137 struct cmd_list_element *unsetlist;
138
139 /* Chain containing all defined show subcommands.  */
140
141 struct cmd_list_element *showlist;
142
143 /* Chain containing all defined \"set history\".  */
144
145 struct cmd_list_element *sethistlist;
146
147 /* Chain containing all defined \"show history\".  */
148
149 struct cmd_list_element *showhistlist;
150
151 /* Chain containing all defined \"unset history\".  */
152
153 struct cmd_list_element *unsethistlist;
154
155 /* Chain containing all defined maintenance subcommands. */
156
157 struct cmd_list_element *maintenancelist;
158
159 /* Chain containing all defined "maintenance info" subcommands. */
160
161 struct cmd_list_element *maintenanceinfolist;
162
163 /* Chain containing all defined "maintenance print" subcommands. */
164
165 struct cmd_list_element *maintenanceprintlist;
166
167 struct cmd_list_element *setprintlist;
168
169 struct cmd_list_element *showprintlist;
170
171 struct cmd_list_element *setdebuglist;
172
173 struct cmd_list_element *showdebuglist;
174
175 struct cmd_list_element *setchecklist;
176
177 struct cmd_list_element *showchecklist;
178
179 /* Command tracing state.  */
180
181 int source_verbose = 0;
182 int trace_commands = 0;
183 \f
184 /* Utility used everywhere when at least one argument is needed and
185    none is supplied. */
186
187 void
188 error_no_arg (char *why)
189 {
190   error (_("Argument required (%s)."), why);
191 }
192
193 /* The "info" command is defined as a prefix, with allow_unknown = 0.
194    Therefore, its own definition is called only for "info" with no args.  */
195
196 static void
197 info_command (char *arg, int from_tty)
198 {
199   printf_unfiltered (_("\"info\" must be followed by the name of an info command.\n"));
200   help_list (infolist, "info ", -1, gdb_stdout);
201 }
202
203 /* The "show" command with no arguments shows all the settings.  */
204
205 static void
206 show_command (char *arg, int from_tty)
207 {
208   cmd_show_list (showlist, from_tty, "");
209 }
210 \f
211 /* Provide documentation on command or list given by COMMAND.  FROM_TTY
212    is ignored.  */
213
214 static void
215 help_command (char *command, int from_tty)
216 {
217   help_cmd (command, gdb_stdout);
218 }
219 \f
220 /* String compare function for qsort.  */
221 static int
222 compare_strings (const void *arg1, const void *arg2)
223 {
224   const char **s1 = (const char **) arg1;
225   const char **s2 = (const char **) arg2;
226   return strcmp (*s1, *s2);
227 }
228
229 /* The "complete" command is used by Emacs to implement completion.  */
230
231 static void
232 complete_command (char *arg, int from_tty)
233 {
234   int i;
235   int argpoint;
236   char **completions, *point, *arg_prefix;
237
238   dont_repeat ();
239
240   if (arg == NULL)
241     arg = "";
242   argpoint = strlen (arg);
243
244   /* complete_line assumes that its first argument is somewhere within,
245      and except for filenames at the beginning of, the word to be completed.
246      The following crude imitation of readline's word-breaking tries to
247      accomodate this.  */
248   point = arg + argpoint;
249   while (point > arg)
250     {
251       if (strchr (rl_completer_word_break_characters, point[-1]) != 0)
252         break;
253       point--;
254     }
255
256   arg_prefix = alloca (point - arg + 1);
257   memcpy (arg_prefix, arg, point - arg);
258   arg_prefix[point - arg] = 0;
259
260   completions = complete_line (point, arg, argpoint);
261
262   if (completions)
263     {
264       int item, size;
265
266       for (size = 0; completions[size]; ++size)
267         ;
268       qsort (completions, size, sizeof (char *), compare_strings);
269
270       /* We do extra processing here since we only want to print each
271          unique item once.  */
272       item = 0;
273       while (item < size)
274         {
275           int next_item;
276           printf_unfiltered ("%s%s\n", arg_prefix, completions[item]);
277           next_item = item + 1;
278           while (next_item < size
279                  && ! strcmp (completions[item], completions[next_item]))
280             {
281               xfree (completions[next_item]);
282               ++next_item;
283             }
284
285           xfree (completions[item]);
286           item = next_item;
287         }
288
289       xfree (completions);
290     }
291 }
292
293 int
294 is_complete_command (struct cmd_list_element *c)
295 {
296   return cmd_cfunc_eq (c, complete_command);
297 }
298
299 static void
300 show_version (char *args, int from_tty)
301 {
302   immediate_quit++;
303   print_gdb_version (gdb_stdout);
304   printf_filtered ("\n");
305   immediate_quit--;
306 }
307
308 /* Handle the quit command.  */
309
310 void
311 quit_command (char *args, int from_tty)
312 {
313   if (!quit_confirm ())
314     error (_("Not confirmed."));
315   quit_force (args, from_tty);
316 }
317
318 static void
319 pwd_command (char *args, int from_tty)
320 {
321   if (args)
322     error (_("The \"pwd\" command does not take an argument: %s"), args);
323   if (! getcwd (gdb_dirbuf, sizeof (gdb_dirbuf)))
324     error (_("Error finding name of working directory: %s"),
325            safe_strerror (errno));
326
327   if (strcmp (gdb_dirbuf, current_directory) != 0)
328     printf_unfiltered (_("Working directory %s\n (canonically %s).\n"),
329                        current_directory, gdb_dirbuf);
330   else
331     printf_unfiltered (_("Working directory %s.\n"), current_directory);
332 }
333
334 void
335 cd_command (char *dir, int from_tty)
336 {
337   int len;
338   /* Found something other than leading repetitions of "/..".  */
339   int found_real_path;
340   char *p;
341
342   /* If the new directory is absolute, repeat is a no-op; if relative,
343      repeat might be useful but is more likely to be a mistake.  */
344   dont_repeat ();
345
346   if (dir == 0)
347     error_no_arg (_("new working directory"));
348
349   dir = tilde_expand (dir);
350   make_cleanup (xfree, dir);
351
352   if (chdir (dir) < 0)
353     perror_with_name (dir);
354
355 #ifdef HAVE_DOS_BASED_FILE_SYSTEM
356   /* There's too much mess with DOSish names like "d:", "d:.",
357      "d:./foo" etc.  Instead of having lots of special #ifdef'ed code,
358      simply get the canonicalized name of the current directory.  */
359   dir = getcwd (gdb_dirbuf, sizeof (gdb_dirbuf));
360 #endif
361
362   len = strlen (dir);
363   if (IS_DIR_SEPARATOR (dir[len - 1]))
364     {
365       /* Remove the trailing slash unless this is a root directory
366          (including a drive letter on non-Unix systems).  */
367       if (!(len == 1)           /* "/" */
368 #ifdef HAVE_DOS_BASED_FILE_SYSTEM
369           && !(len == 3 && dir[1] == ':') /* "d:/" */
370 #endif
371           )
372         len--;
373     }
374
375   dir = savestring (dir, len);
376   if (IS_ABSOLUTE_PATH (dir))
377     current_directory = dir;
378   else
379     {
380       if (IS_DIR_SEPARATOR (current_directory[strlen (current_directory) - 1]))
381         current_directory = concat (current_directory, dir, (char *)NULL);
382       else
383         current_directory = concat (current_directory, SLASH_STRING,
384                                     dir, (char *)NULL);
385       xfree (dir);
386     }
387
388   /* Now simplify any occurrences of `.' and `..' in the pathname.  */
389
390   found_real_path = 0;
391   for (p = current_directory; *p;)
392     {
393       if (IS_DIR_SEPARATOR (p[0]) && p[1] == '.'
394           && (p[2] == 0 || IS_DIR_SEPARATOR (p[2])))
395         strcpy (p, p + 2);
396       else if (IS_DIR_SEPARATOR (p[0]) && p[1] == '.' && p[2] == '.'
397                && (p[3] == 0 || IS_DIR_SEPARATOR (p[3])))
398         {
399           if (found_real_path)
400             {
401               /* Search backwards for the directory just before the "/.."
402                  and obliterate it and the "/..".  */
403               char *q = p;
404               while (q != current_directory && !IS_DIR_SEPARATOR (q[-1]))
405                 --q;
406
407               if (q == current_directory)
408                 /* current_directory is
409                    a relative pathname ("can't happen"--leave it alone).  */
410                 ++p;
411               else
412                 {
413                   strcpy (q - 1, p + 3);
414                   p = q - 1;
415                 }
416             }
417           else
418             /* We are dealing with leading repetitions of "/..", for example
419                "/../..", which is the Mach super-root.  */
420             p += 3;
421         }
422       else
423         {
424           found_real_path = 1;
425           ++p;
426         }
427     }
428
429   forget_cached_source_info ();
430
431   if (from_tty)
432     pwd_command ((char *) 0, 1);
433 }
434 \f
435 void
436 source_script (char *file, int from_tty)
437 {
438   FILE *stream;
439   struct cleanup *old_cleanups;
440   char *full_pathname = NULL;
441   int fd;
442
443   if (file == NULL || *file == 0)
444     {
445       error (_("source command requires file name of file to source."));
446     }
447
448   file = tilde_expand (file);
449   old_cleanups = make_cleanup (xfree, file);
450
451   /* Search for and open 'file' on the search path used for source
452      files.  Put the full location in 'full_pathname'.  */
453   fd = openp (source_path, OPF_TRY_CWD_FIRST,
454               file, O_RDONLY, 0, &full_pathname);
455   make_cleanup (xfree, full_pathname);
456
457   /* Use the full path name, if it is found.  */
458   if (full_pathname != NULL && fd != -1)
459     {
460       file = full_pathname;
461     }
462
463   if (fd == -1)
464     {
465       if (from_tty)
466         perror_with_name (file);
467       else
468         {
469           do_cleanups (old_cleanups);
470           return;
471         }
472     }
473
474   stream = fdopen (fd, FOPEN_RT);
475   script_from_file (stream, file);
476
477   do_cleanups (old_cleanups);
478 }
479
480 /* Return the source_verbose global variable to its previous state
481    on exit from the source command, by whatever means.  */
482 static void
483 source_verbose_cleanup (void *old_value)
484 {
485   source_verbose = *(int *)old_value;
486   xfree (old_value);
487 }
488
489 static void
490 source_command (char *args, int from_tty)
491 {
492   struct cleanup *old_cleanups;
493   char *file = args;
494   int *old_source_verbose = xmalloc (sizeof(int));
495
496   *old_source_verbose = source_verbose;
497   old_cleanups = make_cleanup (source_verbose_cleanup, old_source_verbose);
498
499   /* -v causes the source command to run in verbose mode.
500      We still have to be able to handle filenames with spaces in a
501      backward compatible way, so buildargv is not appropriate.  */
502
503   if (args)
504     {
505       /* Make sure leading white space does not break the comparisons.  */
506       while (isspace(args[0]))
507         args++;
508
509       /* Is -v the first thing in the string?  */
510       if (args[0] == '-' && args[1] == 'v' && isspace (args[2]))
511         {
512           source_verbose = 1;
513
514           /* Trim -v and whitespace from the filename.  */
515           file = &args[3];
516           while (isspace (file[0]))
517             file++;
518         }
519     }
520
521   source_script (file, from_tty);
522 }
523
524
525 static void
526 echo_command (char *text, int from_tty)
527 {
528   char *p = text;
529   int c;
530
531   if (text)
532     while ((c = *p++) != '\0')
533       {
534         if (c == '\\')
535           {
536             /* \ at end of argument is used after spaces
537                so they won't be lost.  */
538             if (*p == 0)
539               return;
540
541             c = parse_escape (&p);
542             if (c >= 0)
543               printf_filtered ("%c", c);
544           }
545         else
546           printf_filtered ("%c", c);
547       }
548
549   /* Force this output to appear now.  */
550   wrap_here ("");
551   gdb_flush (gdb_stdout);
552 }
553
554 static void
555 shell_escape (char *arg, int from_tty)
556 {
557 #if defined(CANT_FORK) || \
558       (!defined(HAVE_WORKING_VFORK) && !defined(HAVE_WORKING_FORK))
559   /* If ARG is NULL, they want an inferior shell, but `system' just
560      reports if the shell is available when passed a NULL arg.  */
561   int rc = system (arg ? arg : "");
562
563   if (!arg)
564     arg = "inferior shell";
565
566   if (rc == -1)
567     {
568       fprintf_unfiltered (gdb_stderr, "Cannot execute %s: %s\n", arg,
569                           safe_strerror (errno));
570       gdb_flush (gdb_stderr);
571     }
572   else if (rc)
573     {
574       fprintf_unfiltered (gdb_stderr, "%s exited with status %d\n", arg, rc);
575       gdb_flush (gdb_stderr);
576     }
577 #ifdef GLOBAL_CURDIR
578   /* Make sure to return to the directory GDB thinks it is, in case the
579      shell command we just ran changed it.  */
580   chdir (current_directory);
581 #endif
582 #else /* Can fork.  */
583   int rc, status, pid;
584
585   if ((pid = vfork ()) == 0)
586     {
587       char *p, *user_shell;
588
589       if ((user_shell = (char *) getenv ("SHELL")) == NULL)
590         user_shell = "/bin/sh";
591
592       /* Get the name of the shell for arg0 */
593       if ((p = strrchr (user_shell, '/')) == NULL)
594         p = user_shell;
595       else
596         p++;                    /* Get past '/' */
597
598       if (!arg)
599         execl (user_shell, p, (char *) 0);
600       else
601         execl (user_shell, p, "-c", arg, (char *) 0);
602
603       fprintf_unfiltered (gdb_stderr, "Cannot execute %s: %s\n", user_shell,
604                           safe_strerror (errno));
605       gdb_flush (gdb_stderr);
606       _exit (0177);
607     }
608
609   if (pid != -1)
610     while ((rc = wait (&status)) != pid && rc != -1)
611       ;
612   else
613     error (_("Fork failed"));
614 #endif /* Can fork.  */
615 }
616
617 static void
618 edit_command (char *arg, int from_tty)
619 {
620   struct symtabs_and_lines sals;
621   struct symtab_and_line sal;
622   struct symbol *sym;
623   char *arg1;
624   char *editor;
625   char *p, *fn;
626
627   /* Pull in the current default source line if necessary.  */
628   if (arg == 0)
629     {
630       set_default_source_symtab_and_line ();
631       sal = get_current_source_symtab_and_line ();
632     }
633
634   /* bare "edit" edits file with present line.  */
635
636   if (arg == 0)
637     {
638       if (sal.symtab == 0)
639         error (_("No default source file yet."));
640       sal.line += get_lines_to_list () / 2;
641     }
642   else
643     {
644
645       /* Now should only be one argument -- decode it in SAL.  */
646
647       arg1 = arg;
648       sals = decode_line_1 (&arg1, 0, 0, 0, 0, 0);
649
650       if (! sals.nelts)
651         {
652           /*  C++  */
653           return;
654         }
655       if (sals.nelts > 1)
656         {
657           ambiguous_line_spec (&sals);
658           xfree (sals.sals);
659           return;
660         }
661
662       sal = sals.sals[0];
663       xfree (sals.sals);
664
665       if (*arg1)
666         error (_("Junk at end of line specification."));
667
668       /* If line was specified by address,
669          first print exactly which line, and which file.
670          In this case, sal.symtab == 0 means address is outside
671          of all known source files, not that user failed to give a filename.  */
672       if (*arg == '*')
673         {
674           if (sal.symtab == 0)
675             /* FIXME-32x64--assumes sal.pc fits in long.  */
676             error (_("No source file for address %s."),
677                    hex_string ((unsigned long) sal.pc));
678           sym = find_pc_function (sal.pc);
679           if (sym)
680             printf_filtered ("%s is in %s (%s:%d).\n", paddress (sal.pc),
681                              SYMBOL_PRINT_NAME (sym), sal.symtab->filename,
682                              sal.line);
683           else
684             printf_filtered ("%s is at %s:%d.\n", paddress (sal.pc),
685                              sal.symtab->filename, sal.line);
686         }
687
688       /* If what was given does not imply a symtab, it must be an undebuggable
689          symbol which means no source code.  */
690
691       if (sal.symtab == 0)
692         error (_("No line number known for %s."), arg);
693     }
694
695   if ((editor = (char *) getenv ("EDITOR")) == NULL)
696       editor = "/bin/ex";
697
698   /* If we don't already know the full absolute file name of the
699      source file, find it now.  */
700   if (!sal.symtab->fullname)
701     {
702       fn = symtab_to_fullname (sal.symtab);
703       if (!fn)
704         fn = "unknown";
705     }
706   else
707     fn = sal.symtab->fullname;
708
709   /* Quote the file name, in case it has whitespace or other special
710      characters.  */
711   p = xstrprintf ("%s +%d \"%s\"", editor, sal.line, fn);
712   shell_escape (p, from_tty);
713   xfree (p);
714 }
715
716 static void
717 list_command (char *arg, int from_tty)
718 {
719   struct symtabs_and_lines sals, sals_end;
720   struct symtab_and_line sal = { 0 };
721   struct symtab_and_line sal_end = { 0 };
722   struct symtab_and_line cursal = { 0 };
723   struct symbol *sym;
724   char *arg1;
725   int no_end = 1;
726   int dummy_end = 0;
727   int dummy_beg = 0;
728   int linenum_beg = 0;
729   char *p;
730
731   /* Pull in the current default source line if necessary */
732   if (arg == 0 || arg[0] == '+' || arg[0] == '-')
733     {
734       set_default_source_symtab_and_line ();
735       cursal = get_current_source_symtab_and_line ();
736     }
737
738   /* "l" or "l +" lists next ten lines.  */
739
740   if (arg == 0 || strcmp (arg, "+") == 0)
741     {
742       print_source_lines (cursal.symtab, cursal.line,
743                           cursal.line + get_lines_to_list (), 0);
744       return;
745     }
746
747   /* "l -" lists previous ten lines, the ones before the ten just listed.  */
748   if (strcmp (arg, "-") == 0)
749     {
750       print_source_lines (cursal.symtab,
751                           max (get_first_line_listed () - get_lines_to_list (), 1),
752                           get_first_line_listed (), 0);
753       return;
754     }
755
756   /* Now if there is only one argument, decode it in SAL
757      and set NO_END.
758      If there are two arguments, decode them in SAL and SAL_END
759      and clear NO_END; however, if one of the arguments is blank,
760      set DUMMY_BEG or DUMMY_END to record that fact.  */
761
762   if (!have_full_symbols () && !have_partial_symbols ())
763     error (_("No symbol table is loaded.  Use the \"file\" command."));
764
765   arg1 = arg;
766   if (*arg1 == ',')
767     dummy_beg = 1;
768   else
769     {
770       sals = decode_line_1 (&arg1, 0, 0, 0, 0, 0);
771
772       if (!sals.nelts)
773         return;                 /*  C++  */
774       if (sals.nelts > 1)
775         {
776           ambiguous_line_spec (&sals);
777           xfree (sals.sals);
778           return;
779         }
780
781       sal = sals.sals[0];
782       xfree (sals.sals);
783     }
784
785   /* Record whether the BEG arg is all digits.  */
786
787   for (p = arg; p != arg1 && *p >= '0' && *p <= '9'; p++);
788   linenum_beg = (p == arg1);
789
790   while (*arg1 == ' ' || *arg1 == '\t')
791     arg1++;
792   if (*arg1 == ',')
793     {
794       no_end = 0;
795       arg1++;
796       while (*arg1 == ' ' || *arg1 == '\t')
797         arg1++;
798       if (*arg1 == 0)
799         dummy_end = 1;
800       else
801         {
802           if (dummy_beg)
803             sals_end = decode_line_1 (&arg1, 0, 0, 0, 0, 0);
804           else
805             sals_end = decode_line_1 (&arg1, 0, sal.symtab, sal.line, 0, 0);
806           if (sals_end.nelts == 0)
807             return;
808           if (sals_end.nelts > 1)
809             {
810               ambiguous_line_spec (&sals_end);
811               xfree (sals_end.sals);
812               return;
813             }
814           sal_end = sals_end.sals[0];
815           xfree (sals_end.sals);
816         }
817     }
818
819   if (*arg1)
820     error (_("Junk at end of line specification."));
821
822   if (!no_end && !dummy_beg && !dummy_end
823       && sal.symtab != sal_end.symtab)
824     error (_("Specified start and end are in different files."));
825   if (dummy_beg && dummy_end)
826     error (_("Two empty args do not say what lines to list."));
827
828   /* if line was specified by address,
829      first print exactly which line, and which file.
830      In this case, sal.symtab == 0 means address is outside
831      of all known source files, not that user failed to give a filename.  */
832   if (*arg == '*')
833     {
834       if (sal.symtab == 0)
835         /* FIXME-32x64--assumes sal.pc fits in long.  */
836         error (_("No source file for address %s."),
837                hex_string ((unsigned long) sal.pc));
838       sym = find_pc_function (sal.pc);
839       if (sym)
840         printf_filtered ("%s is in %s (%s:%d).\n",
841                          paddress (sal.pc), SYMBOL_PRINT_NAME (sym),
842                          sal.symtab->filename, sal.line);
843       else
844         printf_filtered ("%s is at %s:%d.\n", paddress (sal.pc),
845                          sal.symtab->filename, sal.line);
846     }
847
848   /* If line was not specified by just a line number,
849      and it does not imply a symtab, it must be an undebuggable symbol
850      which means no source code.  */
851
852   if (!linenum_beg && sal.symtab == 0)
853     error (_("No line number known for %s."), arg);
854
855   /* If this command is repeated with RET,
856      turn it into the no-arg variant.  */
857
858   if (from_tty)
859     *arg = 0;
860
861   if (dummy_beg && sal_end.symtab == 0)
862     error (_("No default source file yet.  Do \"help list\"."));
863   if (dummy_beg)
864     print_source_lines (sal_end.symtab,
865                         max (sal_end.line - (get_lines_to_list () - 1), 1),
866                         sal_end.line + 1, 0);
867   else if (sal.symtab == 0)
868     error (_("No default source file yet.  Do \"help list\"."));
869   else if (no_end)
870     {
871       int first_line = sal.line - get_lines_to_list () / 2;
872
873       if (first_line < 1) first_line = 1;
874
875       print_source_lines (sal.symtab,
876                           first_line,
877                           first_line + get_lines_to_list (),
878                           0);
879     }
880   else
881     print_source_lines (sal.symtab, sal.line,
882                         (dummy_end
883                          ? sal.line + get_lines_to_list ()
884                          : sal_end.line + 1),
885                         0);
886 }
887
888 /* Subroutine of disassemble_command to simplify it.
889    Perform the disassembly.
890    NAME is the name of the function if known, or NULL.
891    [LOW,HIGH) are the range of addresses to disassemble.
892    MIXED is non-zero to print source with the assembler.  */
893
894 static void
895 print_disassembly (const char *name, CORE_ADDR low, CORE_ADDR high, int mixed)
896 {
897 #if defined(TUI)
898   if (!tui_is_window_visible (DISASSEM_WIN))
899 #endif
900     {
901       printf_filtered ("Dump of assembler code ");
902       if (name != NULL)
903         printf_filtered ("for function %s:\n", name);
904       else
905         printf_filtered ("from %s to %s:\n", paddress (low), paddress (high));
906
907       /* Dump the specified range.  */
908       gdb_disassembly (uiout, 0, 0, mixed, -1, low, high);
909
910       printf_filtered ("End of assembler dump.\n");
911       gdb_flush (gdb_stdout);
912     }
913 #if defined(TUI)
914   else
915     {
916       tui_show_assembly (low);
917     }
918 #endif
919 }
920
921 /* Subroutine of disassemble_command to simplify it.
922    Print a disassembly of the current function.
923    MIXED is non-zero to print source with the assembler.  */
924
925 static void
926 disassemble_current_function (int mixed)
927 {
928   CORE_ADDR low, high, pc;
929   char *name;
930
931   pc = get_frame_pc (get_selected_frame (_("No frame selected.")));
932   if (find_pc_partial_function (pc, &name, &low, &high) == 0)
933     error (_("No function contains program counter for selected frame."));
934 #if defined(TUI)
935   /* NOTE: cagney/2003-02-13 The `tui_active' was previously
936      `tui_version'.  */
937   if (tui_active)
938     /* FIXME: cagney/2004-02-07: This should be an observer.  */
939     low = tui_get_low_disassembly_address (low, pc);
940 #endif
941   low += gdbarch_deprecated_function_start_offset (current_gdbarch);
942
943   print_disassembly (name, low, high, mixed);
944 }
945
946 /* Dump a specified section of assembly code.
947
948    Usage:
949      disassemble [/m]
950        - dump the assembly code for the function of the current pc
951      disassemble [/m] addr
952        - dump the assembly code for the function at ADDR
953      disassemble [/m] low high
954        - dump the assembly code in the range [LOW,HIGH)
955
956    A /m modifier will include source code with the assembly.  */
957
958 static void
959 disassemble_command (char *arg, int from_tty)
960 {
961   CORE_ADDR low, high;
962   char *name;
963   CORE_ADDR pc, pc_masked;
964   char *space_index;
965   int mixed_source_and_assembly;
966
967   name = NULL;
968   mixed_source_and_assembly = 0;
969
970   if (arg && *arg == '/')
971     {
972       ++arg;
973
974       if (*arg == '\0')
975         error (_("Missing modifier."));
976
977       while (*arg && ! isspace (*arg))
978         {
979           switch (*arg++)
980             {
981             case 'm':
982               mixed_source_and_assembly = 1;
983               break;
984             default:
985               error (_("Invalid disassembly modifier."));
986             }
987         }
988
989       while (isspace (*arg))
990         ++arg;
991     }
992
993   if (! arg || ! *arg)
994     {
995       disassemble_current_function (mixed_source_and_assembly);
996       return;
997     }
998
999   /* FIXME: 'twould be nice to allow spaces in the expression for the first
1000      arg.  Allow comma separater too?  */
1001
1002   if (!(space_index = (char *) strchr (arg, ' ')))
1003     {
1004       /* One argument.  */
1005       pc = parse_and_eval_address (arg);
1006       if (find_pc_partial_function (pc, &name, &low, &high) == 0)
1007         error (_("No function contains specified address."));
1008 #if defined(TUI)
1009       /* NOTE: cagney/2003-02-13 The `tui_active' was previously
1010          `tui_version'.  */
1011       if (tui_active)
1012         /* FIXME: cagney/2004-02-07: This should be an observer.  */
1013         low = tui_get_low_disassembly_address (low, pc);
1014 #endif
1015       low += gdbarch_deprecated_function_start_offset (current_gdbarch);
1016     }
1017   else
1018     {
1019       /* Two arguments.  */
1020       *space_index = '\0';
1021       low = parse_and_eval_address (arg);
1022       high = parse_and_eval_address (space_index + 1);
1023     }
1024
1025   print_disassembly (name, low, high, mixed_source_and_assembly);
1026 }
1027
1028 static void
1029 make_command (char *arg, int from_tty)
1030 {
1031   char *p;
1032
1033   if (arg == 0)
1034     p = "make";
1035   else
1036     {
1037       p = xmalloc (sizeof ("make ") + strlen (arg));
1038       strcpy (p, "make ");
1039       strcpy (p + sizeof ("make ") - 1, arg);
1040     }
1041
1042   shell_escape (p, from_tty);
1043 }
1044
1045 static void
1046 show_user (char *args, int from_tty)
1047 {
1048   struct cmd_list_element *c;
1049   extern struct cmd_list_element *cmdlist;
1050
1051   if (args)
1052     {
1053       c = lookup_cmd (&args, cmdlist, "", 0, 1);
1054       if (c->class != class_user)
1055         error (_("Not a user command."));
1056       show_user_1 (c, gdb_stdout);
1057     }
1058   else
1059     {
1060       for (c = cmdlist; c; c = c->next)
1061         {
1062           if (c->class == class_user)
1063             show_user_1 (c, gdb_stdout);
1064         }
1065     }
1066 }
1067
1068 /* Search through names of commands and documentations for a certain
1069    regular expression.
1070 */
1071 void 
1072 apropos_command (char *searchstr, int from_tty)
1073 {
1074   extern struct cmd_list_element *cmdlist; /*This is the main command list*/
1075   regex_t pattern;
1076   char *pattern_fastmap;
1077   char errorbuffer[512];
1078   pattern_fastmap = xcalloc (256, sizeof (char));
1079   if (searchstr == NULL)
1080       error (_("REGEXP string is empty"));
1081
1082   if (regcomp(&pattern,searchstr,REG_ICASE) == 0)
1083     {
1084       pattern.fastmap=pattern_fastmap;
1085       re_compile_fastmap(&pattern);
1086       apropos_cmd (gdb_stdout,cmdlist,&pattern,"");
1087     }
1088   else
1089     {
1090       regerror(regcomp(&pattern,searchstr,REG_ICASE),NULL,errorbuffer,512);
1091       error (_("Error in regular expression:%s"),errorbuffer);
1092     }
1093   xfree (pattern_fastmap);
1094 }
1095 \f
1096 /* Print a list of files and line numbers which a user may choose from
1097    in order to list a function which was specified ambiguously (as with
1098    `list classname::overloadedfuncname', for example).  The vector in
1099    SALS provides the filenames and line numbers.  */
1100
1101 static void
1102 ambiguous_line_spec (struct symtabs_and_lines *sals)
1103 {
1104   int i;
1105
1106   for (i = 0; i < sals->nelts; ++i)
1107     printf_filtered (_("file: \"%s\", line number: %d\n"),
1108                      sals->sals[i].symtab->filename, sals->sals[i].line);
1109 }
1110
1111 static void
1112 set_debug (char *arg, int from_tty)
1113 {
1114   printf_unfiltered (_("\"set debug\" must be followed by the name of a debug subcommand.\n"));
1115   help_list (setdebuglist, "set debug ", -1, gdb_stdout);
1116 }
1117
1118 static void
1119 show_debug (char *args, int from_tty)
1120 {
1121   cmd_show_list (showdebuglist, from_tty, "");
1122 }
1123
1124 void
1125 init_cmd_lists (void)
1126 {
1127   max_user_call_depth = 1024;
1128
1129   cmdlist = NULL;
1130   infolist = NULL;
1131   enablelist = NULL;
1132   disablelist = NULL;
1133   togglelist = NULL;
1134   stoplist = NULL;
1135   deletelist = NULL;
1136   detachlist = NULL;
1137   enablebreaklist = NULL;
1138   setlist = NULL;
1139   unsetlist = NULL;
1140   showlist = NULL;
1141   sethistlist = NULL;
1142   showhistlist = NULL;
1143   unsethistlist = NULL;
1144   maintenancelist = NULL;
1145   maintenanceinfolist = NULL;
1146   maintenanceprintlist = NULL;
1147   setprintlist = NULL;
1148   showprintlist = NULL;
1149   setchecklist = NULL;
1150   showchecklist = NULL;
1151 }
1152
1153 static void
1154 show_info_verbose (struct ui_file *file, int from_tty,
1155                    struct cmd_list_element *c,
1156                    const char *value)
1157 {
1158   if (info_verbose)
1159     fprintf_filtered (file, _("\
1160 Verbose printing of informational messages is %s.\n"), value);
1161   else
1162     fprintf_filtered (file, _("Verbosity is %s.\n"), value);
1163 }
1164
1165 static void
1166 show_history_expansion_p (struct ui_file *file, int from_tty,
1167                           struct cmd_list_element *c, const char *value)
1168 {
1169   fprintf_filtered (file, _("History expansion on command input is %s.\n"),
1170                     value);
1171 }
1172
1173 static void
1174 show_baud_rate (struct ui_file *file, int from_tty,
1175                 struct cmd_list_element *c, const char *value)
1176 {
1177   fprintf_filtered (file, _("Baud rate for remote serial I/O is %s.\n"),
1178                     value);
1179 }
1180
1181 static void
1182 show_remote_debug (struct ui_file *file, int from_tty,
1183                    struct cmd_list_element *c, const char *value)
1184 {
1185   fprintf_filtered (file, _("Debugging of remote protocol is %s.\n"),
1186                     value);
1187 }
1188
1189 static void
1190 show_remote_timeout (struct ui_file *file, int from_tty,
1191                      struct cmd_list_element *c, const char *value)
1192 {
1193   fprintf_filtered (file, _("\
1194 Timeout limit to wait for target to respond is %s.\n"),
1195                     value);
1196 }
1197
1198 static void
1199 show_max_user_call_depth (struct ui_file *file, int from_tty,
1200                           struct cmd_list_element *c, const char *value)
1201 {
1202   fprintf_filtered (file, _("\
1203 The max call depth for user-defined commands is %s.\n"),
1204                     value);
1205 }
1206
1207 \f
1208 void
1209 init_cli_cmds (void)
1210 {
1211   struct cmd_list_element *c;
1212   char *source_help_text;
1213
1214   /* Define the classes of commands.
1215      They will appear in the help list in the reverse of this order.  */
1216
1217   add_cmd ("internals", class_maintenance, NULL, _("\
1218 Maintenance commands.\n\
1219 Some gdb commands are provided just for use by gdb maintainers.\n\
1220 These commands are subject to frequent change, and may not be as\n\
1221 well documented as user commands."),
1222            &cmdlist);
1223   add_cmd ("obscure", class_obscure, NULL, _("Obscure features."), &cmdlist);
1224   add_cmd ("aliases", class_alias, NULL, _("Aliases of other commands."), &cmdlist);
1225   add_cmd ("user-defined", class_user, NULL, _("\
1226 User-defined commands.\n\
1227 The commands in this class are those defined by the user.\n\
1228 Use the \"define\" command to define a command."), &cmdlist);
1229   add_cmd ("support", class_support, NULL, _("Support facilities."), &cmdlist);
1230   if (!dbx_commands)
1231     add_cmd ("status", class_info, NULL, _("Status inquiries."), &cmdlist);
1232   add_cmd ("files", class_files, NULL, _("Specifying and examining files."),
1233            &cmdlist);
1234   add_cmd ("breakpoints", class_breakpoint, NULL,
1235            _("Making program stop at certain points."), &cmdlist);
1236   add_cmd ("data", class_vars, NULL, _("Examining data."), &cmdlist);
1237   add_cmd ("stack", class_stack, NULL, _("\
1238 Examining the stack.\n\
1239 The stack is made up of stack frames.  Gdb assigns numbers to stack frames\n\
1240 counting from zero for the innermost (currently executing) frame.\n\n\
1241 At any time gdb identifies one frame as the \"selected\" frame.\n\
1242 Variable lookups are done with respect to the selected frame.\n\
1243 When the program being debugged stops, gdb selects the innermost frame.\n\
1244 The commands below can be used to select other frames by number or address."),
1245            &cmdlist);
1246   add_cmd ("running", class_run, NULL, _("Running the program."), &cmdlist);
1247
1248   /* Define general commands. */
1249
1250   c = add_com ("pwd", class_files, pwd_command, _("\
1251 Print working directory.  This is used for your program as well."));
1252   set_cmd_no_selected_thread_ok (c);
1253
1254   c = add_cmd ("cd", class_files, cd_command, _("\
1255 Set working directory to DIR for debugger and program being debugged.\n\
1256 The change does not take effect for the program being debugged\n\
1257 until the next time it is started."), &cmdlist);
1258   set_cmd_completer (c, filename_completer);
1259
1260   add_com ("echo", class_support, echo_command, _("\
1261 Print a constant string.  Give string as argument.\n\
1262 C escape sequences may be used in the argument.\n\
1263 No newline is added at the end of the argument;\n\
1264 use \"\\n\" if you want a newline to be printed.\n\
1265 Since leading and trailing whitespace are ignored in command arguments,\n\
1266 if you want to print some you must use \"\\\" before leading whitespace\n\
1267 to be printed or after trailing whitespace."));
1268   add_com ("document", class_support, document_command, _("\
1269 Document a user-defined command.\n\
1270 Give command name as argument.  Give documentation on following lines.\n\
1271 End with a line of just \"end\"."));
1272   add_com ("define", class_support, define_command, _("\
1273 Define a new command name.  Command name is argument.\n\
1274 Definition appears on following lines, one command per line.\n\
1275 End with a line of just \"end\".\n\
1276 Use the \"document\" command to give documentation for the new command.\n\
1277 Commands defined in this way may have up to ten arguments."));
1278
1279   source_help_text = xstrprintf (_("\
1280 Read commands from a file named FILE.\n\
1281 Optional -v switch (before the filename) causes each command in\n\
1282 FILE to be echoed as it is executed.\n\
1283 Note that the file \"%s\" is read automatically in this way\n\
1284 when GDB is started."), gdbinit);
1285   c = add_cmd ("source", class_support, source_command,
1286                source_help_text, &cmdlist);
1287   set_cmd_completer (c, filename_completer);
1288
1289   add_com ("quit", class_support, quit_command, _("Exit gdb."));
1290   c = add_com ("help", class_support, help_command,
1291                _("Print list of commands."));
1292   set_cmd_completer (c, command_completer);
1293   set_cmd_no_selected_thread_ok (c);
1294   add_com_alias ("q", "quit", class_support, 1);
1295   add_com_alias ("h", "help", class_support, 1);
1296
1297   add_setshow_boolean_cmd ("verbose", class_support, &info_verbose, _("\
1298 Set verbosity."), _("\
1299 Show verbosity."), NULL,
1300                            set_verbose,
1301                            show_info_verbose,
1302                            &setlist, &showlist);
1303
1304   add_prefix_cmd ("history", class_support, set_history,
1305                   _("Generic command for setting command history parameters."),
1306                   &sethistlist, "set history ", 0, &setlist);
1307   add_prefix_cmd ("history", class_support, show_history,
1308                   _("Generic command for showing command history parameters."),
1309                   &showhistlist, "show history ", 0, &showlist);
1310
1311   add_setshow_boolean_cmd ("expansion", no_class, &history_expansion_p, _("\
1312 Set history expansion on command input."), _("\
1313 Show history expansion on command input."), _("\
1314 Without an argument, history expansion is enabled."),
1315                            NULL,
1316                            show_history_expansion_p,
1317                            &sethistlist, &showhistlist);
1318
1319   c = add_prefix_cmd ("info", class_info, info_command, _("\
1320 Generic command for showing things about the program being debugged."),
1321                       &infolist, "info ", 0, &cmdlist);
1322   set_cmd_no_selected_thread_ok (c);
1323   add_com_alias ("i", "info", class_info, 1);
1324
1325   add_com ("complete", class_obscure, complete_command,
1326            _("List the completions for the rest of the line as a command."));
1327
1328   c = add_prefix_cmd ("show", class_info, show_command, _("\
1329 Generic command for showing things about the debugger."),
1330                       &showlist, "show ", 0, &cmdlist);
1331   set_cmd_no_selected_thread_ok (c);
1332   /* Another way to get at the same thing.  */
1333   add_info ("set", show_command, _("Show all GDB settings."));
1334
1335   add_cmd ("commands", no_class, show_commands, _("\
1336 Show the history of commands you typed.\n\
1337 You can supply a command number to start with, or a `+' to start after\n\
1338 the previous command number shown."),
1339            &showlist);
1340
1341   add_cmd ("version", no_class, show_version,
1342            _("Show what version of GDB this is."), &showlist);
1343
1344   add_com ("while", class_support, while_command, _("\
1345 Execute nested commands WHILE the conditional expression is non zero.\n\
1346 The conditional expression must follow the word `while' and must in turn be\n\
1347 followed by a new line.  The nested commands must be entered one per line,\n\
1348 and should be terminated by the word `end'."));
1349
1350   add_com ("if", class_support, if_command, _("\
1351 Execute nested commands once IF the conditional expression is non zero.\n\
1352 The conditional expression must follow the word `if' and must in turn be\n\
1353 followed by a new line.  The nested commands must be entered one per line,\n\
1354 and should be terminated by the word 'else' or `end'.  If an else clause\n\
1355 is used, the same rules apply to its nested commands as to the first ones."));
1356
1357   /* If target is open when baud changes, it doesn't take effect until the
1358      next open (I think, not sure).  */
1359   add_setshow_zinteger_cmd ("remotebaud", no_class, &baud_rate, _("\
1360 Set baud rate for remote serial I/O."), _("\
1361 Show baud rate for remote serial I/O."), _("\
1362 This value is used to set the speed of the serial port when debugging\n\
1363 using remote targets."),
1364                             NULL,
1365                             show_baud_rate,
1366                             &setlist, &showlist);
1367
1368   add_setshow_zinteger_cmd ("remote", no_class, &remote_debug, _("\
1369 Set debugging of remote protocol."), _("\
1370 Show debugging of remote protocol."), _("\
1371 When enabled, each packet sent or received with the remote target\n\
1372 is displayed."),
1373                             NULL,
1374                             show_remote_debug,
1375                             &setdebuglist, &showdebuglist);
1376
1377   add_setshow_integer_cmd ("remotetimeout", no_class, &remote_timeout, _("\
1378 Set timeout limit to wait for target to respond."), _("\
1379 Show timeout limit to wait for target to respond."), _("\
1380 This value is used to set the time limit for gdb to wait for a response\n\
1381 from the target."),
1382                            NULL,
1383                            show_remote_timeout,
1384                            &setlist, &showlist);
1385
1386   add_prefix_cmd ("debug", no_class, set_debug,
1387                   _("Generic command for setting gdb debugging flags"),
1388                   &setdebuglist, "set debug ", 0, &setlist);
1389
1390   add_prefix_cmd ("debug", no_class, show_debug,
1391                   _("Generic command for showing gdb debugging flags"),
1392                   &showdebuglist, "show debug ", 0, &showlist);
1393
1394   c = add_com ("shell", class_support, shell_escape, _("\
1395 Execute the rest of the line as a shell command.\n\
1396 With no arguments, run an inferior shell."));
1397   set_cmd_completer (c, filename_completer);
1398
1399   c = add_com ("edit", class_files, edit_command, _("\
1400 Edit specified file or function.\n\
1401 With no argument, edits file containing most recent line listed.\n\
1402 Editing targets can be specified in these ways:\n\
1403   FILE:LINENUM, to edit at that line in that file,\n\
1404   FUNCTION, to edit at the beginning of that function,\n\
1405   FILE:FUNCTION, to distinguish among like-named static functions.\n\
1406   *ADDRESS, to edit at the line containing that address.\n\
1407 Uses EDITOR environment variable contents as editor (or ex as default)."));
1408
1409   c->completer = location_completer;
1410
1411   add_com ("list", class_files, list_command, _("\
1412 List specified function or line.\n\
1413 With no argument, lists ten more lines after or around previous listing.\n\
1414 \"list -\" lists the ten lines before a previous ten-line listing.\n\
1415 One argument specifies a line, and ten lines are listed around that line.\n\
1416 Two arguments with comma between specify starting and ending lines to list.\n\
1417 Lines can be specified in these ways:\n\
1418   LINENUM, to list around that line in current file,\n\
1419   FILE:LINENUM, to list around that line in that file,\n\
1420   FUNCTION, to list around beginning of that function,\n\
1421   FILE:FUNCTION, to distinguish among like-named static functions.\n\
1422   *ADDRESS, to list around the line containing that address.\n\
1423 With two args if one is empty it stands for ten lines away from the other arg."));
1424
1425   if (!xdb_commands)
1426     add_com_alias ("l", "list", class_files, 1);
1427   else
1428     add_com_alias ("v", "list", class_files, 1);
1429
1430   if (dbx_commands)
1431     add_com_alias ("file", "list", class_files, 1);
1432
1433   c = add_com ("disassemble", class_vars, disassemble_command, _("\
1434 Disassemble a specified section of memory.\n\
1435 Default is the function surrounding the pc of the selected frame.\n\
1436 With a /m modifier, source lines are included (if available).\n\
1437 With a single argument, the function surrounding that address is dumped.\n\
1438 Two arguments are taken as a range of memory to dump."));
1439   set_cmd_completer (c, location_completer);
1440   if (xdb_commands)
1441     add_com_alias ("va", "disassemble", class_xdb, 0);
1442
1443   /* NOTE: cagney/2000-03-20: Being able to enter ``(gdb) !ls'' would
1444      be a really useful feature.  Unfortunately, the below wont do
1445      this.  Instead it adds support for the form ``(gdb) ! ls''
1446      (i.e. the space is required).  If the ``!'' command below is
1447      added the complains about no ``!'' command would be replaced by
1448      complains about how the ``!'' command is broken :-) */
1449   if (xdb_commands)
1450     add_com_alias ("!", "shell", class_support, 0);
1451
1452   c = add_com ("make", class_support, make_command, _("\
1453 Run the ``make'' program using the rest of the line as arguments."));
1454   set_cmd_completer (c, filename_completer);
1455   add_cmd ("user", no_class, show_user, _("\
1456 Show definitions of user defined commands.\n\
1457 Argument is the name of the user defined command.\n\
1458 With no argument, show definitions of all user defined commands."), &showlist);
1459   add_com ("apropos", class_support, apropos_command,
1460            _("Search for commands matching a REGEXP"));
1461
1462   add_setshow_integer_cmd ("max-user-call-depth", no_class,
1463                            &max_user_call_depth, _("\
1464 Set the max call depth for user-defined commands."), _("\
1465 Show the max call depth for user-defined commands."), NULL,
1466                            NULL,
1467                            show_max_user_call_depth,
1468                            &setlist, &showlist);
1469
1470   add_setshow_boolean_cmd ("trace-commands", no_class, &trace_commands, _("\
1471 Set tracing of GDB CLI commands."), _("\
1472 Show state of GDB CLI command tracing."), _("\
1473 When 'on', each command is displayed as it is executed."),
1474                            NULL,
1475                            NULL,
1476                            &setlist, &showlist);
1477 }