1 /* Parser for linespec for the GNU debugger, GDB.
3 Copyright (C) 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995,
4 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2007, 2008,
5 2009, 2010 Free Software Foundation, Inc.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
31 #include "completer.h"
33 #include "cp-support.h"
34 #include "parser-defs.h"
36 #include "objc-lang.h"
38 #include "exceptions.h"
41 #include "mi/mi-cmds.h"
43 #include "arch-utils.h"
45 /* We share this one with symtab.c, but it is not exported widely. */
47 extern char *operator_chars (char *, char **);
49 /* Prototypes for local functions */
51 static void initialize_defaults (struct symtab **default_symtab,
54 static struct symtabs_and_lines decode_indirect (char **argptr);
56 static char *locate_first_half (char **argptr, int *is_quote_enclosed);
58 static struct symtabs_and_lines decode_objc (char **argptr,
60 struct symtab *file_symtab,
64 static struct symtabs_and_lines decode_compound (char **argptr,
71 static struct symbol *lookup_prefix_sym (char **argptr, char *p);
73 static struct symtabs_and_lines find_method (int funfirstline,
78 struct symbol *sym_class,
81 static NORETURN void cplusplus_error (const char *name,
83 ATTR_NORETURN ATTRIBUTE_PRINTF (2, 3);
85 static int total_number_of_methods (struct type *type);
87 static int find_methods (struct type *, char *,
88 enum language, struct symbol **);
90 static int add_matching_methods (int method_counter, struct type *t,
91 enum language language,
92 struct symbol **sym_arr);
94 static int add_constructors (int method_counter, struct type *t,
95 enum language language,
96 struct symbol **sym_arr);
98 static void build_canonical_line_spec (struct symtab_and_line *,
101 static char *find_toplevel_char (char *s, char c);
103 static int is_objc_method_format (const char *s);
105 static struct symtabs_and_lines decode_line_2 (struct symbol *[],
108 static struct symtab *symtab_from_filename (char **argptr,
109 char *p, int is_quote_enclosed,
113 symtabs_and_lines decode_all_digits (char **argptr,
114 struct symtab *default_symtab,
117 struct symtab *file_symtab,
120 static struct symtabs_and_lines decode_dollar (char *copy,
122 struct symtab *default_symtab,
124 struct symtab *file_symtab);
126 static struct symtabs_and_lines decode_variable (char *copy,
129 struct symtab *file_symtab,
133 symtabs_and_lines symbol_found (int funfirstline,
137 struct symtab *file_symtab);
140 symtabs_and_lines minsym_found (int funfirstline,
141 struct minimal_symbol *msymbol);
143 /* Helper functions. */
145 /* Issue a helpful hint on using the command completion feature on
146 single quoted demangled C++ symbols as part of the completion
150 cplusplus_error (const char *name, const char *fmt, ...)
152 struct ui_file *tmp_stream;
154 tmp_stream = mem_fileopen ();
155 make_cleanup_ui_file_delete (tmp_stream);
159 va_start (args, fmt);
160 vfprintf_unfiltered (tmp_stream, fmt, args);
164 while (*name == '\'')
166 fprintf_unfiltered (tmp_stream,
167 ("Hint: try '%s<TAB> or '%s<ESC-?>\n"
168 "(Note leading single quote.)"),
171 message = ui_file_xstrdup (tmp_stream, NULL);
172 make_cleanup (xfree, message);
173 throw_error (NOT_FOUND_ERROR, "%s", message);
176 /* Return the number of methods described for TYPE, including the
177 methods from types it derives from. This can't be done in the symbol
178 reader because the type of the baseclass might still be stubbed
179 when the definition of the derived class is parsed. */
182 total_number_of_methods (struct type *type)
187 CHECK_TYPEDEF (type);
188 if (! HAVE_CPLUS_STRUCT (type))
190 count = TYPE_NFN_FIELDS_TOTAL (type);
192 for (n = 0; n < TYPE_N_BASECLASSES (type); n++)
193 count += total_number_of_methods (TYPE_BASECLASS (type, n));
198 /* Recursive helper function for decode_line_1.
199 Look for methods named NAME in type T.
200 Return number of matches.
201 Put matches in SYM_ARR, which should have been allocated with
202 a size of total_number_of_methods (T) * sizeof (struct symbol *).
203 Note that this function is g++ specific. */
206 find_methods (struct type *t, char *name, enum language language,
207 struct symbol **sym_arr)
211 char *class_name = type_name_no_tag (t);
213 /* Ignore this class if it doesn't have a name. This is ugly, but
214 unless we figure out how to get the physname without the name of
215 the class, then the loop can't do any good. */
217 && (lookup_symbol_in_language (class_name, (struct block *) NULL,
218 STRUCT_DOMAIN, language, (int *) NULL)))
221 int name_len = strlen (name);
225 /* Loop over each method name. At this level, all overloads of a name
226 are counted as a single name. There is an inner loop which loops over
229 for (method_counter = TYPE_NFN_FIELDS (t) - 1;
233 char *method_name = TYPE_FN_FIELDLIST_NAME (t, method_counter);
236 if (strncmp (method_name, "__", 2) == 0 ||
237 strncmp (method_name, "op", 2) == 0 ||
238 strncmp (method_name, "type", 4) == 0)
240 if (cplus_demangle_opname (method_name, dem_opname, DMGL_ANSI))
241 method_name = dem_opname;
242 else if (cplus_demangle_opname (method_name, dem_opname, 0))
243 method_name = dem_opname;
246 if (strcmp_iw (name, method_name) == 0)
247 /* Find all the overloaded methods with that name. */
248 i1 += add_matching_methods (method_counter, t, language,
250 else if (strncmp (class_name, name, name_len) == 0
251 && (class_name[name_len] == '\0'
252 || class_name[name_len] == '<'))
253 i1 += add_constructors (method_counter, t, language,
258 /* Only search baseclasses if there is no match yet, since names in
259 derived classes override those in baseclasses.
261 FIXME: The above is not true; it is only true of member functions
262 if they have the same number of arguments (??? - section 13.1 of the
263 ARM says the function members are not in the same scope but doesn't
264 really spell out the rules in a way I understand. In any case, if
265 the number of arguments differ this is a case in which we can overload
266 rather than hiding without any problem, and gcc 2.4.5 does overload
267 rather than hiding in this case). */
270 for (ibase = 0; ibase < TYPE_N_BASECLASSES (t); ibase++)
271 i1 += find_methods (TYPE_BASECLASS (t, ibase), name,
272 language, sym_arr + i1);
277 /* Add the symbols associated to methods of the class whose type is T
278 and whose name matches the method indexed by METHOD_COUNTER in the
279 array SYM_ARR. Return the number of methods added. */
282 add_matching_methods (int method_counter, struct type *t,
283 enum language language, struct symbol **sym_arr)
288 for (field_counter = TYPE_FN_FIELDLIST_LENGTH (t, method_counter) - 1;
295 f = TYPE_FN_FIELDLIST1 (t, method_counter);
297 if (TYPE_FN_FIELD_STUB (f, field_counter))
301 tmp_name = gdb_mangle_name (t,
304 phys_name = alloca (strlen (tmp_name) + 1);
305 strcpy (phys_name, tmp_name);
309 phys_name = TYPE_FN_FIELD_PHYSNAME (f, field_counter);
311 sym_arr[i1] = lookup_symbol_in_language (phys_name,
319 /* This error message gets printed, but the method
320 still seems to be found
321 fputs_filtered("(Cannot find method ", gdb_stdout);
322 fprintf_symbol_filtered (gdb_stdout, phys_name,
324 DMGL_PARAMS | DMGL_ANSI);
325 fputs_filtered(" - possibly inlined.)\n", gdb_stdout);
333 /* Add the symbols associated to constructors of the class whose type
334 is CLASS_TYPE and which are indexed by by METHOD_COUNTER to the
335 array SYM_ARR. Return the number of methods added. */
338 add_constructors (int method_counter, struct type *t,
339 enum language language, struct symbol **sym_arr)
344 /* For GCC 3.x and stabs, constructors and destructors
345 have names like __base_ctor and __complete_dtor.
346 Check the physname for now if we're looking for a
349 = TYPE_FN_FIELDLIST_LENGTH (t, method_counter) - 1;
356 f = TYPE_FN_FIELDLIST1 (t, method_counter);
358 /* GCC 3.x will never produce stabs stub methods, so
359 we don't need to handle this case. */
360 if (TYPE_FN_FIELD_STUB (f, field_counter))
362 phys_name = TYPE_FN_FIELD_PHYSNAME (f, field_counter);
363 if (! is_constructor_name (phys_name))
366 /* If this method is actually defined, include it in the
368 sym_arr[i1] = lookup_symbol_in_language (phys_name,
379 /* Helper function for decode_line_1.
380 Build a canonical line spec in CANONICAL if it is non-NULL and if
381 the SAL has a symtab.
382 If SYMNAME is non-NULL the canonical line spec is `filename:symname'.
383 If SYMNAME is NULL the line number from SAL is used and the canonical
384 line spec is `filename:linenum'. */
387 build_canonical_line_spec (struct symtab_and_line *sal, char *symname,
390 char **canonical_arr;
391 char *canonical_name;
393 struct symtab *s = sal->symtab;
395 if (s == (struct symtab *) NULL
396 || s->filename == (char *) NULL
397 || canonical == (char ***) NULL)
400 canonical_arr = (char **) xmalloc (sizeof (char *));
401 *canonical = canonical_arr;
403 filename = s->filename;
406 canonical_name = xmalloc (strlen (filename) + strlen (symname) + 2);
407 sprintf (canonical_name, "%s:%s", filename, symname);
411 canonical_name = xmalloc (strlen (filename) + 30);
412 sprintf (canonical_name, "%s:%d", filename, sal->line);
414 canonical_arr[0] = canonical_name;
419 /* Find an instance of the character C in the string S that is outside
420 of all parenthesis pairs, single-quoted strings, and double-quoted
421 strings. Also, ignore the char within a template name, like a ','
422 within foo<int, int>. */
425 find_toplevel_char (char *s, char c)
427 int quoted = 0; /* zero if we're not in quotes;
428 '"' if we're in a double-quoted string;
429 '\'' if we're in a single-quoted string. */
430 int depth = 0; /* Number of unclosed parens we've seen. */
433 for (scan = s; *scan; scan++)
439 else if (*scan == '\\' && *(scan + 1))
442 else if (*scan == c && ! quoted && depth == 0)
444 else if (*scan == '"' || *scan == '\'')
446 else if (*scan == '(' || *scan == '<')
448 else if ((*scan == ')' || *scan == '>') && depth > 0)
455 /* Determines if the gives string corresponds to an Objective-C method
456 representation, such as -[Foo bar:] or +[Foo bar]. Objective-C symbols
457 are allowed to have spaces and parentheses in them. */
460 is_objc_method_format (const char *s)
462 if (s == NULL || *s == '\0')
464 /* Handle arguments with the format FILENAME:SYMBOL. */
465 if ((s[0] == ':') && (strchr ("+-", s[1]) != NULL)
466 && (s[2] == '[') && strchr(s, ']'))
468 /* Handle arguments that are just SYMBOL. */
469 else if ((strchr ("+-", s[0]) != NULL) && (s[1] == '[') && strchr(s, ']'))
474 /* Given a list of NELTS symbols in SYM_ARR, return a list of lines to
475 operate on (ask user if necessary).
476 If CANONICAL is non-NULL return a corresponding array of mangled names
477 as canonical line specs there. */
479 static struct symtabs_and_lines
480 decode_line_2 (struct symbol *sym_arr[], int nelts, int funfirstline,
483 struct symtabs_and_lines values, return_values;
488 struct cleanup *old_chain;
489 char **canonical_arr = (char **) NULL;
490 const char *select_mode = multiple_symbols_select_mode ();
492 if (select_mode == multiple_symbols_cancel)
494 canceled because the command is ambiguous\n\
495 See set/show multiple-symbol."));
497 values.sals = (struct symtab_and_line *)
498 alloca (nelts * sizeof (struct symtab_and_line));
499 return_values.sals = (struct symtab_and_line *)
500 xmalloc (nelts * sizeof (struct symtab_and_line));
501 old_chain = make_cleanup (xfree, return_values.sals);
505 canonical_arr = (char **) xmalloc (nelts * sizeof (char *));
506 make_cleanup (xfree, canonical_arr);
507 memset (canonical_arr, 0, nelts * sizeof (char *));
508 *canonical = canonical_arr;
514 init_sal (&return_values.sals[i]); /* Initialize to zeroes. */
515 init_sal (&values.sals[i]);
516 if (sym_arr[i] && SYMBOL_CLASS (sym_arr[i]) == LOC_BLOCK)
517 values.sals[i] = find_function_start_sal (sym_arr[i], funfirstline);
521 /* If select_mode is "all", then do not print the multiple-choice
522 menu and act as if the user had chosen choice "1" (all). */
523 if (select_mode == multiple_symbols_all
524 || ui_out_is_mi_like_p (interp_ui_out (top_level_interpreter ())))
529 printf_unfiltered (_("[0] cancel\n[1] all\n"));
532 if (sym_arr[i] && SYMBOL_CLASS (sym_arr[i]) == LOC_BLOCK)
534 if (values.sals[i].symtab)
535 printf_unfiltered ("[%d] %s at %s:%d\n",
537 SYMBOL_PRINT_NAME (sym_arr[i]),
538 values.sals[i].symtab->filename,
539 values.sals[i].line);
541 printf_unfiltered (_("[%d] %s at ?FILE:%d [No symtab? Probably broken debug info...]\n"),
543 SYMBOL_PRINT_NAME (sym_arr[i]),
544 values.sals[i].line);
548 printf_unfiltered (_("?HERE\n"));
552 prompt = getenv ("PS2");
557 args = command_line_input (prompt, 0, "overload-choice");
560 if (args == 0 || *args == 0)
561 error_no_arg (_("one or more choice numbers"));
569 while (*arg1 >= '0' && *arg1 <= '9')
571 if (*arg1 && *arg1 != ' ' && *arg1 != '\t')
572 error (_("Arguments must be choice numbers."));
577 error (_("canceled"));
582 for (i = 0; i < nelts; i++)
584 if (canonical_arr[i] == NULL)
586 symname = SYMBOL_LINKAGE_NAME (sym_arr[i]);
587 canonical_arr[i] = xstrdup (symname);
591 memcpy (return_values.sals, values.sals,
592 (nelts * sizeof (struct symtab_and_line)));
593 return_values.nelts = nelts;
594 discard_cleanups (old_chain);
595 return return_values;
598 if (num >= nelts + 2)
600 printf_unfiltered (_("No choice number %d.\n"), num);
605 if (values.sals[num].pc)
609 symname = SYMBOL_LINKAGE_NAME (sym_arr[num]);
610 make_cleanup (xfree, symname);
611 canonical_arr[i] = xstrdup (symname);
613 return_values.sals[i++] = values.sals[num];
614 values.sals[num].pc = 0;
618 printf_unfiltered (_("duplicate request for %d ignored.\n"), num);
623 while (*args == ' ' || *args == '\t')
626 return_values.nelts = i;
627 discard_cleanups (old_chain);
628 return return_values;
631 /* A helper function for decode_line_1 and friends which skips P
632 past any method overload information at the beginning of P, e.g.,
633 "(const struct foo *)".
635 This function assumes that P has already been validated to contain
636 overload information, and it will assert if *P != '('. */
638 find_method_overload_end (char *p)
642 gdb_assert (*p == '(');
662 /* The parser of linespec itself. */
664 /* Parse a string that specifies a line number.
665 Pass the address of a char * variable; that variable will be
666 advanced over the characters actually parsed.
670 LINENUM -- that line number in current file. PC returned is 0.
671 FILE:LINENUM -- that line in that file. PC returned is 0.
672 FUNCTION -- line number of openbrace of that function.
673 PC returned is the start of the function.
674 VARIABLE -- line number of definition of that variable.
676 FILE:FUNCTION -- likewise, but prefer functions in that file.
677 *EXPR -- line in which address EXPR appears.
679 This may all be followed by an "if EXPR", which we ignore.
681 FUNCTION may be an undebuggable function found in minimal symbol table.
683 If the argument FUNFIRSTLINE is nonzero, we want the first line
684 of real code inside a function when a function is specified, and it is
685 not OK to specify a variable or type to get its line number.
687 DEFAULT_SYMTAB specifies the file to use if none is specified.
688 It defaults to current_source_symtab.
689 DEFAULT_LINE specifies the line number to use for relative
690 line numbers (that start with signs). Defaults to current_source_line.
691 If CANONICAL is non-NULL, store an array of strings containing the canonical
692 line specs there if necessary. Currently overloaded member functions and
693 line numbers or static functions without a filename yield a canonical
694 line spec. The array and the line spec strings are allocated on the heap,
695 it is the callers responsibility to free them.
697 Note that it is possible to return zero for the symtab
698 if no file is validly specified. Callers must check that.
699 Also, the line number returned may be invalid.
701 If NOT_FOUND_PTR is not null, store a boolean true/false value at the location, based
702 on whether or not failure occurs due to an unknown function or file. In the case
703 where failure does occur due to an unknown function or file, do not issue an error
706 /* We allow single quotes in various places. This is a hideous
707 kludge, which exists because the completer can't yet deal with the
708 lack of single quotes. FIXME: write a linespec_completer which we
709 can use as appropriate instead of make_symbol_completion_list. */
711 struct symtabs_and_lines
712 decode_line_1 (char **argptr, int funfirstline, struct symtab *default_symtab,
713 int default_line, char ***canonical, int *not_found_ptr)
717 /* If a file name is specified, this is its symtab. */
718 struct symtab *file_symtab = NULL;
721 /* This says whether or not something in *ARGPTR is quoted with
722 completer_quotes (i.e. with single quotes). */
724 /* Is *ARGPTR is enclosed in double quotes? */
725 int is_quote_enclosed;
726 int is_objc_method = 0;
727 char *saved_arg = *argptr;
728 /* If IS_QUOTED, the end of the quoted bit. */
729 char *end_quote = NULL;
730 /* The "first half" of the linespec. */
736 /* Defaults have defaults. */
738 initialize_defaults (&default_symtab, &default_line);
740 /* See if arg is *PC. */
743 return decode_indirect (argptr);
746 && strchr (get_gdb_completer_quote_characters (),
749 end_quote = skip_quoted (*argptr);
751 /* Check to see if it's a multipart linespec (with colons or
754 /* Locate the end of the first half of the linespec.
755 After the call, for instance, if the argptr string is "foo.c:123"
756 p will point at "123". If there is only one part, like "foo", p
757 will point to "". If this is a C++ name, like "A::B::foo", p will
758 point to "::B::foo". Argptr is not changed by this call. */
760 first_half = p = locate_first_half (argptr, &is_quote_enclosed);
762 /* Check if this is an Objective-C method (anything that starts with
763 a '+' or '-' and a '['). */
764 if (is_objc_method_format (p))
767 /* Check if the symbol could be an Objective-C selector. */
770 struct symtabs_and_lines values;
771 values = decode_objc (argptr, funfirstline, NULL,
772 canonical, saved_arg);
773 if (values.sals != NULL)
777 /* Does it look like there actually were two parts? */
779 if (p[0] == ':' || p[0] == '.')
781 /* Is it a C++ or Java compound data structure?
782 The check on p[1] == ':' is capturing the case of "::",
783 since p[0]==':' was checked above.
784 Note that the call to decode_compound does everything
785 for us, including the lookup on the symbol table, so we
788 if (p[0] == '.' || p[1] == ':')
790 struct symtabs_and_lines values;
792 if (is_quote_enclosed)
794 values = decode_compound (argptr, funfirstline, canonical,
795 saved_arg, p, not_found_ptr);
796 if (is_quoted && **argptr == '\'')
797 *argptr = *argptr + 1;
801 /* No, the first part is a filename; set file_symtab to be that file's
802 symtab. Also, move argptr past the filename. */
804 file_symtab = symtab_from_filename (argptr, p, is_quote_enclosed,
807 /* Check for single quotes on the non-filename part. */
810 is_quoted = (**argptr
811 && strchr (get_gdb_completer_quote_characters (),
814 end_quote = skip_quoted (*argptr);
818 /* file_symtab is specified file's symtab, or 0 if no file specified.
819 arg no longer contains the file name. */
821 /* If the filename was quoted, we must re-check the quotation. */
823 if (end_quote == first_half && *end_quote!= '\0')
825 is_quoted = (**argptr
826 && strchr (get_gdb_completer_quote_characters (),
829 end_quote = skip_quoted (*argptr);
832 /* Check whether arg is all digits (and sign). */
835 if (*q == '-' || *q == '+')
837 while (*q >= '0' && *q <= '9')
840 if (q != *argptr && (*q == 0 || *q == ' ' || *q == '\t' || *q == ','))
841 /* We found a token consisting of all digits -- at least one digit. */
842 return decode_all_digits (argptr, default_symtab, default_line,
843 canonical, file_symtab, q);
845 /* Arg token is not digits => try it as a variable name
846 Find the next token (everything up to end or next whitespace). */
848 if (**argptr == '$') /* May be a convenience variable. */
849 /* One or two $ chars possible. */
850 p = skip_quoted (*argptr + (((*argptr)[1] == '$') ? 2 : 1));
855 error (_("Unmatched single quote."));
857 else if (is_objc_method)
859 /* allow word separators in method names for Obj-C */
860 p = skip_quoted_chars (*argptr, NULL, "");
864 p = skip_quoted (*argptr);
867 /* Keep any template parameters */
869 p = find_template_name_end (p);
871 /* Keep method overload information. */
873 p = find_method_overload_end (p);
875 /* Make sure we keep important kewords like "const" */
876 if (strncmp (p, " const", 6) == 0)
879 copy = (char *) alloca (p - *argptr + 1);
880 memcpy (copy, *argptr, p - *argptr);
881 copy[p - *argptr] = '\0';
884 && copy[0] == copy[p - *argptr - 1]
885 && strchr (get_gdb_completer_quote_characters (), copy[0]) != NULL)
887 copy[p - *argptr - 1] = '\0';
891 copy[p - *argptr - 1] = '\0';
892 while (*p == ' ' || *p == '\t')
896 /* If it starts with $: may be a legitimate variable or routine name
897 (e.g. HP-UX millicode routines such as $$dyncall), or it may
898 be history value, or it may be a convenience variable. */
901 return decode_dollar (copy, funfirstline, default_symtab,
902 canonical, file_symtab);
904 /* Look up that token as a variable.
905 If file specified, use that file's per-file block to start with. */
907 return decode_variable (copy, funfirstline, canonical,
908 file_symtab, not_found_ptr);
913 /* Now, more helper functions for decode_line_1. Some conventions
914 that these functions follow:
916 Decode_line_1 typically passes along some of its arguments or local
917 variables to the subfunctions. It passes the variables by
918 reference if they are modified by the subfunction, and by value
921 Some of the functions have side effects that don't arise from
922 variables that are passed by reference. In particular, if a
923 function is passed ARGPTR as an argument, it modifies what ARGPTR
924 points to; typically, it advances *ARGPTR past whatever substring
925 it has just looked at. (If it doesn't modify *ARGPTR, then the
926 function gets passed *ARGPTR instead, which is then called ARG.)
927 Also, functions that return a struct symtabs_and_lines may modify
928 CANONICAL, as in the description of decode_line_1.
930 If a function returns a struct symtabs_and_lines, then that struct
931 will immediately make its way up the call chain to be returned by
932 decode_line_1. In particular, all of the functions decode_XXX
933 calculate the appropriate struct symtabs_and_lines, under the
934 assumption that their argument is of the form XXX. */
936 /* First, some functions to initialize stuff at the beggining of the
940 initialize_defaults (struct symtab **default_symtab, int *default_line)
942 if (*default_symtab == 0)
944 /* Use whatever we have for the default source line. We don't use
945 get_current_or_default_symtab_and_line as it can recurse and call
947 struct symtab_and_line cursal =
948 get_current_source_symtab_and_line ();
950 *default_symtab = cursal.symtab;
951 *default_line = cursal.line;
957 /* Decode arg of the form *PC. */
959 static struct symtabs_and_lines
960 decode_indirect (char **argptr)
962 struct symtabs_and_lines values;
966 pc = parse_and_eval_address_1 (argptr);
968 values.sals = (struct symtab_and_line *)
969 xmalloc (sizeof (struct symtab_and_line));
972 values.sals[0] = find_pc_line (pc, 0);
973 values.sals[0].pc = pc;
974 values.sals[0].section = find_pc_overlay (pc);
975 values.sals[0].explicit_pc = 1;
982 /* Locate the first half of the linespec, ending in a colon, period,
983 or whitespace. (More or less.) Also, check to see if *ARGPTR is
984 enclosed in double quotes; if so, set is_quote_enclosed, advance
985 ARGPTR past that and zero out the trailing double quote.
986 If ARGPTR is just a simple name like "main", p will point to ""
990 locate_first_half (char **argptr, int *is_quote_enclosed)
996 /* Maybe we were called with a line range FILENAME:LINENUM,FILENAME:LINENUM
997 and we must isolate the first half. Outer layers will call again later
1000 Don't count commas that appear in argument lists of overloaded
1001 functions, or in quoted strings. It's stupid to go to this much
1002 trouble when the rest of the function is such an obvious roach hotel. */
1003 ii = find_toplevel_char (*argptr, ',');
1004 has_comma = (ii != 0);
1006 /* Temporarily zap out second half to not confuse the code below.
1007 This is undone below. Do not change ii!! */
1013 /* Maybe arg is FILE : LINENUM or FILE : FUNCTION. May also be
1014 CLASS::MEMBER, or NAMESPACE::NAME. Look for ':', but ignore
1020 *is_quote_enclosed = 1;
1026 *is_quote_enclosed = 0;
1027 if (strchr (get_gdb_completer_quote_characters (), *p))
1037 char *temp_end = find_template_name_end (p);
1039 error (_("malformed template specification in command"));
1042 /* Check for a colon and a plus or minus and a [ (which
1043 indicates an Objective-C method) */
1044 if (is_objc_method_format (p))
1048 /* Check for the end of the first half of the linespec. End of
1049 line, a tab, a double colon or the last single colon, or a
1050 space. But if enclosed in double quotes we do not break on
1055 && ((p[1] == ':') || (strchr (p + 1, ':') == NULL)))
1056 || ((p[0] == ' ') && !*is_quote_enclosed))
1058 if (p[0] == '.' && strchr (p, ':') == NULL)
1060 /* Java qualified method. Find the *last* '.', since the
1061 others are package qualifiers. Stop at any open parenthesis
1062 which might provide overload information. */
1063 for (p1 = p; *p1 && *p1 != '('; p1++)
1071 while (p[0] == ' ' || p[0] == '\t')
1074 /* If the closing double quote was left at the end, remove it. */
1075 if (*is_quote_enclosed)
1077 char *closing_quote = strchr (p - 1, '"');
1078 if (closing_quote && closing_quote[1] == '\0')
1079 *closing_quote = '\0';
1082 /* Now that we've safely parsed the first half, put back ',' so
1083 outer layers can see it. */
1092 /* Here's where we recognise an Objective-C Selector. An Objective C
1093 selector may be implemented by more than one class, therefore it
1094 may represent more than one method/function. This gives us a
1095 situation somewhat analogous to C++ overloading. If there's more
1096 than one method that could represent the selector, then use some of
1097 the existing C++ code to let the user choose one. */
1099 struct symtabs_and_lines
1100 decode_objc (char **argptr, int funfirstline, struct symtab *file_symtab,
1101 char ***canonical, char *saved_arg)
1103 struct symtabs_and_lines values;
1104 struct symbol **sym_arr = NULL;
1105 struct symbol *sym = NULL;
1107 struct block *block = NULL;
1114 if (file_symtab != NULL)
1115 block = BLOCKVECTOR_BLOCK (BLOCKVECTOR (file_symtab), STATIC_BLOCK);
1118 enum language save_language;
1120 /* get_selected_block can change the current language when there is
1121 no selected frame yet. */
1122 save_language = current_language->la_language;
1123 block = get_selected_block (0);
1124 set_language (save_language);
1127 copy = find_imps (file_symtab, block, *argptr, NULL, &i1, &i2);
1131 sym_arr = (struct symbol **) alloca ((i1 + 1) * sizeof (struct symbol *));
1134 copy = find_imps (file_symtab, block, *argptr, sym_arr, &i1, &i2);
1138 /* i1 now represents the TOTAL number of matches found.
1139 i2 represents how many HIGH-LEVEL (struct symbol) matches,
1140 which will come first in the sym_arr array. Any low-level
1141 (minimal_symbol) matches will follow those. */
1147 /* Already a struct symbol. */
1152 sym = find_pc_function (SYMBOL_VALUE_ADDRESS (sym_arr[0]));
1153 if ((sym != NULL) && strcmp (SYMBOL_LINKAGE_NAME (sym_arr[0]), SYMBOL_LINKAGE_NAME (sym)) != 0)
1155 warning (_("debugging symbol \"%s\" does not match selector; ignoring"), SYMBOL_LINKAGE_NAME (sym));
1160 values.sals = (struct symtab_and_line *) xmalloc (sizeof (struct symtab_and_line));
1163 if (sym && SYMBOL_CLASS (sym) == LOC_BLOCK)
1165 /* Canonicalize this, so it remains resolved for dylib loads. */
1166 values.sals[0] = find_function_start_sal (sym, funfirstline);
1167 build_canonical_line_spec (values.sals, SYMBOL_NATURAL_NAME (sym), canonical);
1171 /* The only match was a non-debuggable symbol, which might point
1172 to a function descriptor; resolve it to the actual code address
1174 struct minimal_symbol *msymbol = (struct minimal_symbol *)sym_arr[0];
1175 struct objfile *objfile = msymbol_objfile (msymbol);
1176 struct gdbarch *gdbarch = get_objfile_arch (objfile);
1177 CORE_ADDR pc = SYMBOL_VALUE_ADDRESS (msymbol);
1179 pc = gdbarch_convert_from_func_ptr_addr (gdbarch, pc,
1182 init_sal (&values.sals[0]);
1183 values.sals[0].pc = pc;
1190 /* More than one match. The user must choose one or more. */
1191 return decode_line_2 (sym_arr, i2, funfirstline, canonical);
1197 /* This handles C++ and Java compound data structures. P should point
1198 at the first component separator, i.e. double-colon or period. As
1199 an example, on entrance to this function we could have ARGPTR
1200 pointing to "AAA::inA::fun" and P pointing to "::inA::fun". */
1202 static struct symtabs_and_lines
1203 decode_compound (char **argptr, int funfirstline, char ***canonical,
1204 char *saved_arg, char *p, int *not_found_ptr)
1206 struct symtabs_and_lines values;
1208 char *saved_arg2 = *argptr;
1212 struct symbol *sym_class;
1213 struct symbol **sym_arr;
1215 char *saved_java_argptr = NULL;
1217 /* First check for "global" namespace specification, of the form
1218 "::foo". If found, skip over the colons and jump to normal
1219 symbol processing. I.e. the whole line specification starts with
1220 "::" (note the condition that *argptr == p). */
1222 && ((*argptr == p) || (p[-1] == ' ') || (p[-1] == '\t')))
1225 /* Given our example "AAA::inA::fun", we have two cases to consider:
1227 1) AAA::inA is the name of a class. In that case, presumably it
1228 has a method called "fun"; we then look up that method using
1231 2) AAA::inA isn't the name of a class. In that case, either the
1232 user made a typo or AAA::inA is the name of a namespace.
1233 Either way, we just look up AAA::inA::fun with lookup_symbol.
1235 Thus, our first task is to find everything before the last set of
1236 double-colons and figure out if it's the name of a class. So we
1237 first loop through all of the double-colons. */
1239 p2 = p; /* Save for restart. */
1241 /* This is very messy. Following the example above we have now the
1244 argptr -> "AAA::inA::fun
1245 saved_arg -> "AAA::inA::fun
1246 saved_arg2 -> "AAA::inA::fun
1247 p2 -> "::inA::fun". */
1249 /* In the loop below, with these strings, we'll make 2 passes, each
1250 is marked in comments.*/
1254 /* Move pointer up to next possible class/namespace token. */
1256 p = p2 + 1; /* Restart with old value +1. */
1258 /* PASS1: at this point p2->"::inA::fun", so p->":inA::fun",
1259 i.e. if there is a double-colon, p will now point to the
1261 /* PASS2: p2->"::fun", p->":fun" */
1263 /* Move pointer ahead to next double-colon. */
1264 while (*p && (p[0] != ' ') && (p[0] != '\t') && (p[0] != '\'')
1267 if (current_language->la_language == language_cplus)
1268 p += cp_validate_operator (p);
1272 temp_end = find_template_name_end (p);
1274 error (_("malformed template specification in command"));
1277 /* Note that, since, at the start of this loop, p would be
1278 pointing to the second colon in a double-colon, we only
1279 satisfy the condition below if there is another
1280 double-colon to the right (after). I.e. there is another
1281 component that can be a class or a namespace. I.e, if at
1282 the beginning of this loop (PASS1), we had
1283 p->":inA::fun", we'll trigger this when p has been
1284 advanced to point to "::fun". */
1285 /* PASS2: we will not trigger this. */
1286 else if ((p[0] == ':') && (p[1] == ':'))
1287 break; /* Found double-colon. */
1289 /* PASS2: We'll keep getting here, until p->"", at which point
1290 we exit this loop. */
1295 break; /* Out of the while (1). This would happen
1296 for instance if we have looked up
1297 unsuccessfully all the components of the
1298 string, and p->""(PASS2) */
1300 /* We get here if p points to ' ', '\t', '\'', "::" or ""(i.e
1302 /* Save restart for next time around. */
1304 /* Restore argptr as it was on entry to this function. */
1305 *argptr = saved_arg2;
1306 /* PASS1: at this point p->"::fun" argptr->"AAA::inA::fun",
1309 /* All ready for next pass through the loop. */
1313 /* Start of lookup in the symbol tables. */
1315 /* Lookup in the symbol table the substring between argptr and
1316 p. Note, this call changes the value of argptr. */
1317 /* Before the call, argptr->"AAA::inA::fun",
1318 p->"", p2->"::fun". After the call: argptr->"fun", p, p2
1320 sym_class = lookup_prefix_sym (argptr, p2);
1322 /* If sym_class has been found, and if "AAA::inA" is a class, then
1323 we're in case 1 above. So we look up "fun" as a method of that
1326 (t = check_typedef (SYMBOL_TYPE (sym_class)),
1327 (TYPE_CODE (t) == TYPE_CODE_STRUCT
1328 || TYPE_CODE (t) == TYPE_CODE_UNION)))
1330 /* Arg token is not digits => try it as a function name.
1331 Find the next token (everything up to end or next
1334 && strchr (get_gdb_completer_quote_characters (),
1337 p = skip_quoted (*argptr);
1338 *argptr = *argptr + 1;
1342 /* At this point argptr->"fun". */
1345 while (*p && *p != ' ' && *p != '\t' && *p != ',' && *p != ':'
1348 /* At this point p->"". String ended. */
1349 /* Nope, C++ operators could have spaces in them
1350 ("foo::operator <" or "foo::operator delete []").
1351 I apologize, this is a bit hacky... */
1352 if (current_language->la_language == language_cplus
1353 && *p == ' ' && p - 8 - *argptr + 1 > 0)
1355 /* The above loop has already swallowed "operator". */
1356 p += cp_validate_operator (p - 8) - 8;
1359 /* Keep any template parameters */
1361 p = find_template_name_end (p);
1363 /* Keep method overload information. */
1364 a = strchr (p, '(');
1366 p = find_method_overload_end (a);
1368 /* Make sure we keep important kewords like "const" */
1369 if (strncmp (p, " const", 6) == 0)
1372 /* Java may append typenames, so assume that if there is
1373 anything else left in *argptr, it must be a typename. */
1374 if (*p && current_language->la_language == language_java)
1380 copy = (char *) alloca (p2 - p + 1);
1381 memcpy (copy, p, p2 - p);
1382 copy[p2 - p] = '\0';
1383 type = lookup_typename (current_language, get_current_arch (),
1387 /* Save the location of this just in case this
1388 method/type combination isn't actually defined.
1389 It will be checked later. */
1390 saved_java_argptr = p;
1396 /* Allocate our own copy of the substring between argptr and
1398 copy = (char *) alloca (p - *argptr + 1);
1399 memcpy (copy, *argptr, p - *argptr);
1400 copy[p - *argptr] = '\0';
1402 && copy[p - *argptr - 1]
1403 && strchr (get_gdb_completer_quote_characters (),
1404 copy[p - *argptr - 1]) != NULL)
1405 copy[p - *argptr - 1] = '\0';
1407 /* At this point copy->"fun", p->"" */
1409 /* No line number may be specified. */
1410 while (*p == ' ' || *p == '\t')
1413 /* At this point arptr->"". */
1415 /* Look for copy as a method of sym_class. */
1416 /* At this point copy->"fun", sym_class is "AAA:inA",
1417 saved_arg->"AAA::inA::fun". This concludes the scanning of
1418 the string for possible components matches. If we find it
1419 here, we return. If not, and we are at the and of the string,
1420 we'll lookup the whole string in the symbol tables. */
1422 values = find_method (funfirstline, canonical, saved_arg,
1423 copy, t, sym_class, not_found_ptr);
1424 if (saved_java_argptr != NULL && values.nelts == 1)
1426 /* The user specified a specific return type for a java method.
1427 Double-check that it really is the one the user specified.
1428 [This is a necessary evil because strcmp_iw_ordered stops
1429 comparisons too prematurely.] */
1430 sym = find_pc_sect_function (values.sals[0].pc,
1431 values.sals[0].section);
1432 /* We just found a SAL, we had better be able to go backwards! */
1433 gdb_assert (sym != NULL);
1434 if (strcmp_iw (SYMBOL_LINKAGE_NAME (sym), saved_arg) != 0)
1436 xfree (values.sals);
1437 error (_("the class `%s' does not have any method instance named %s\n"),
1438 SYMBOL_PRINT_NAME (sym_class), copy);
1442 } /* End if symbol found */
1445 /* We couldn't find a class, so we're in case 2 above. We check the
1446 entire name as a symbol instead. */
1448 copy = (char *) alloca (p - saved_arg2 + 1);
1449 memcpy (copy, saved_arg2, p - saved_arg2);
1450 /* Note: if is_quoted should be true, we snuff out quote here
1452 copy[p - saved_arg2] = '\000';
1453 /* Set argptr to skip over the name. */
1454 *argptr = (*p == '\'') ? p + 1 : p;
1456 /* Look up entire name */
1457 sym = lookup_symbol (copy, 0, VAR_DOMAIN, 0);
1459 return symbol_found (funfirstline, canonical, copy, sym, NULL);
1461 /* Couldn't find any interpretation as classes/namespaces, so give
1462 up. The quotes are important if copy is empty. */
1465 cplusplus_error (saved_arg,
1466 "Can't find member of namespace, class, struct, or union named \"%s\"\n",
1470 /* Next come some helper functions for decode_compound. */
1472 /* Return the symbol corresponding to the substring of *ARGPTR ending
1473 at P, allowing whitespace. Also, advance *ARGPTR past the symbol
1474 name in question, the compound object separator ("::" or "."), and
1475 whitespace. Note that *ARGPTR is changed whether or not the
1476 lookup_symbol call finds anything (i.e we return NULL). As an
1477 example, say ARGPTR is "AAA::inA::fun" and P is "::inA::fun". */
1479 static struct symbol *
1480 lookup_prefix_sym (char **argptr, char *p)
1486 /* Extract the class name. */
1488 while (p != *argptr && p[-1] == ' ')
1490 copy = (char *) alloca (p - *argptr + 1);
1491 memcpy (copy, *argptr, p - *argptr);
1492 copy[p - *argptr] = 0;
1494 /* Discard the class name from the argptr. */
1495 p = p1 + (p1[0] == ':' ? 2 : 1);
1496 while (*p == ' ' || *p == '\t')
1500 /* At this point p1->"::inA::fun", p->"inA::fun" copy->"AAA",
1501 argptr->"inA::fun" */
1503 sym = lookup_symbol (copy, 0, STRUCT_DOMAIN, 0);
1506 /* Typedefs are in VAR_DOMAIN so the above symbol lookup will
1507 fail when the user attempts to lookup a method of a class
1508 via a typedef'd name (NOT via the class's name, which is already
1509 handled in symbol_matches_domain). So try the lookup again
1510 using VAR_DOMAIN (where typedefs live) and double-check that we
1511 found a struct/class type. */
1512 struct symbol *s = lookup_symbol (copy, 0, VAR_DOMAIN, 0);
1515 struct type *t = SYMBOL_TYPE (s);
1517 if (TYPE_CODE (t) == TYPE_CODE_STRUCT)
1525 /* This finds the method COPY in the class whose type is T and whose
1526 symbol is SYM_CLASS. */
1528 static struct symtabs_and_lines
1529 find_method (int funfirstline, char ***canonical, char *saved_arg,
1530 char *copy, struct type *t, struct symbol *sym_class, int *not_found_ptr)
1532 struct symtabs_and_lines values;
1533 struct symbol *sym = NULL;
1534 int i1; /* Counter for the symbol array. */
1535 struct symbol **sym_arr = alloca (total_number_of_methods (t)
1536 * sizeof (struct symbol *));
1538 /* Find all methods with a matching name, and put them in
1541 i1 = find_methods (t, copy, SYMBOL_LANGUAGE (sym_class), sym_arr);
1545 /* There is exactly one field with that name. */
1548 if (sym && SYMBOL_CLASS (sym) == LOC_BLOCK)
1550 values.sals = (struct symtab_and_line *)
1551 xmalloc (sizeof (struct symtab_and_line));
1553 values.sals[0] = find_function_start_sal (sym,
1565 /* If we were given a specific overload instance, use that
1566 (or error if no matches were found). Otherwise ask the user
1567 which one to use. */
1568 if (strchr (saved_arg, '(') != NULL)
1571 for (i = 0; i < i1; ++i)
1573 char *name = saved_arg;
1574 char *canon = cp_canonicalize_string (name);
1578 if (strcmp_iw (name, SYMBOL_LINKAGE_NAME (sym_arr[i])) == 0)
1580 values.sals = (struct symtab_and_line *)
1581 xmalloc (sizeof (struct symtab_and_line));
1583 values.sals[0] = find_function_start_sal (sym_arr[i],
1594 error (_("the class `%s' does not have any method instance named %s\n"),
1595 SYMBOL_PRINT_NAME (sym_class), copy);
1598 return decode_line_2 (sym_arr, i1, funfirstline, canonical);
1605 cplusplus_error (saved_arg,
1606 "the class `%s' does not have destructor defined\n",
1607 SYMBOL_PRINT_NAME (sym_class));
1609 cplusplus_error (saved_arg,
1610 "the class %s does not have any method named %s\n",
1611 SYMBOL_PRINT_NAME (sym_class), copy);
1617 /* Return the symtab associated to the filename given by the substring
1618 of *ARGPTR ending at P, and advance ARGPTR past that filename. If
1619 NOT_FOUND_PTR is not null and the source file is not found, store
1620 boolean true at the location pointed to and do not issue an
1623 static struct symtab *
1624 symtab_from_filename (char **argptr, char *p, int is_quote_enclosed,
1629 struct symtab *file_symtab;
1632 while (p != *argptr && p[-1] == ' ')
1634 if ((*p == '"') && is_quote_enclosed)
1636 copy = (char *) alloca (p - *argptr + 1);
1637 memcpy (copy, *argptr, p - *argptr);
1638 /* It may have the ending quote right after the file name. */
1639 if ((is_quote_enclosed && copy[p - *argptr - 1] == '"')
1640 || copy[p - *argptr - 1] == '\'')
1641 copy[p - *argptr - 1] = 0;
1643 copy[p - *argptr] = 0;
1645 /* Find that file's data. */
1646 file_symtab = lookup_symtab (copy);
1647 if (file_symtab == 0)
1651 if (!have_full_symbols () && !have_partial_symbols ())
1652 throw_error (NOT_FOUND_ERROR,
1653 _("No symbol table is loaded. Use the \"file\" command."));
1654 throw_error (NOT_FOUND_ERROR, _("No source file named %s."), copy);
1657 /* Discard the file name from the arg. */
1659 while (*p == ' ' || *p == '\t')
1668 /* This decodes a line where the argument is all digits (possibly
1669 preceded by a sign). Q should point to the end of those digits;
1670 the other arguments are as usual. */
1672 static struct symtabs_and_lines
1673 decode_all_digits (char **argptr, struct symtab *default_symtab,
1674 int default_line, char ***canonical,
1675 struct symtab *file_symtab, char *q)
1678 struct symtabs_and_lines values;
1679 struct symtab_and_line val;
1687 /* We might need a canonical line spec if no file was specified. */
1688 int need_canonical = (file_symtab == NULL) ? 1 : 0;
1692 val.pspace = current_program_space;
1694 /* This is where we need to make sure that we have good defaults.
1695 We must guarantee that this section of code is never executed
1696 when we are called with just a function name, since
1697 set_default_source_symtab_and_line uses
1698 select_source_symtab that calls us with such an argument. */
1700 if (file_symtab == 0 && default_symtab == 0)
1702 /* Make sure we have at least a default source file. */
1703 set_default_source_symtab_and_line ();
1704 initialize_defaults (&default_symtab, &default_line);
1707 if (**argptr == '+')
1708 sign = plus, (*argptr)++;
1709 else if (**argptr == '-')
1710 sign = minus, (*argptr)++;
1711 val.line = atoi (*argptr);
1717 if (file_symtab == 0)
1718 val.line = default_line + val.line;
1723 if (file_symtab == 0)
1724 val.line = default_line - val.line;
1729 break; /* No need to adjust val.line. */
1732 while (*q == ' ' || *q == '\t')
1735 if (file_symtab == 0)
1736 file_symtab = default_symtab;
1738 /* It is possible that this source file has more than one symtab,
1739 and that the new line number specification has moved us from the
1740 default (in file_symtab) to a new one. */
1741 val.symtab = find_line_symtab (file_symtab, val.line, NULL, NULL);
1742 if (val.symtab == 0)
1743 val.symtab = file_symtab;
1745 val.pspace = SYMTAB_PSPACE (val.symtab);
1747 values.sals = (struct symtab_and_line *)
1748 xmalloc (sizeof (struct symtab_and_line));
1749 values.sals[0] = val;
1752 build_canonical_line_spec (values.sals, NULL, canonical);
1753 values.sals[0].explicit_line = 1;
1759 /* Decode a linespec starting with a dollar sign. */
1761 static struct symtabs_and_lines
1762 decode_dollar (char *copy, int funfirstline, struct symtab *default_symtab,
1763 char ***canonical, struct symtab *file_symtab)
1767 int need_canonical = 0;
1768 struct symtabs_and_lines values;
1769 struct symtab_and_line val;
1772 struct minimal_symbol *msymbol;
1774 p = (copy[1] == '$') ? copy + 2 : copy + 1;
1775 while (*p >= '0' && *p <= '9')
1777 if (!*p) /* Reached end of token without hitting non-digit. */
1779 /* We have a value history reference. */
1780 struct value *val_history;
1781 sscanf ((copy[1] == '$') ? copy + 2 : copy + 1, "%d", &index);
1782 val_history = access_value_history ((copy[1] == '$') ? -index : index);
1783 if (TYPE_CODE (value_type (val_history)) != TYPE_CODE_INT)
1784 error (_("History values used in line specs must have integer values."));
1785 valx = value_as_long (val_history);
1789 /* Not all digits -- may be user variable/function or a
1790 convenience variable. */
1792 /* Look up entire name as a symbol first. */
1793 sym = lookup_symbol (copy, 0, VAR_DOMAIN, 0);
1794 file_symtab = (struct symtab *) NULL;
1796 /* Symbol was found --> jump to normal symbol processing. */
1798 return symbol_found (funfirstline, canonical, copy, sym, NULL);
1800 /* If symbol was not found, look in minimal symbol tables. */
1801 msymbol = lookup_minimal_symbol (copy, NULL, NULL);
1802 /* Min symbol was found --> jump to minsym processing. */
1804 return minsym_found (funfirstline, msymbol);
1806 /* Not a user variable or function -- must be convenience variable. */
1807 if (!get_internalvar_integer (lookup_internalvar (copy + 1), &valx))
1808 error (_("Convenience variables used in line specs must have integer values."));
1813 /* Either history value or convenience value from above, in valx. */
1814 val.symtab = file_symtab ? file_symtab : default_symtab;
1817 val.pspace = current_program_space;
1819 values.sals = (struct symtab_and_line *) xmalloc (sizeof val);
1820 values.sals[0] = val;
1824 build_canonical_line_spec (values.sals, NULL, canonical);
1831 /* Decode a linespec that's a variable. If FILE_SYMTAB is non-NULL,
1832 look in that symtab's static variables first. If NOT_FOUND_PTR is not NULL and
1833 the function cannot be found, store boolean true in the location pointed to
1834 and do not issue an error message. */
1836 static struct symtabs_and_lines
1837 decode_variable (char *copy, int funfirstline, char ***canonical,
1838 struct symtab *file_symtab, int *not_found_ptr)
1842 struct minimal_symbol *msymbol;
1844 sym = lookup_symbol (copy,
1846 ? BLOCKVECTOR_BLOCK (BLOCKVECTOR (file_symtab),
1848 : get_selected_block (0)),
1852 return symbol_found (funfirstline, canonical, copy, sym, file_symtab);
1854 msymbol = lookup_minimal_symbol (copy, NULL, NULL);
1856 if (msymbol != NULL)
1857 return minsym_found (funfirstline, msymbol);
1862 if (!have_full_symbols ()
1863 && !have_partial_symbols ()
1864 && !have_minimal_symbols ())
1865 throw_error (NOT_FOUND_ERROR,
1866 _("No symbol table is loaded. Use the \"file\" command."));
1867 throw_error (NOT_FOUND_ERROR, _("Function \"%s\" not defined."), copy);
1873 /* Now come some functions that are called from multiple places within
1876 /* We've found a symbol SYM to associate with our linespec; build a
1877 corresponding struct symtabs_and_lines. */
1879 static struct symtabs_and_lines
1880 symbol_found (int funfirstline, char ***canonical, char *copy,
1881 struct symbol *sym, struct symtab *file_symtab)
1883 struct symtabs_and_lines values;
1885 if (SYMBOL_CLASS (sym) == LOC_BLOCK)
1887 /* Arg is the name of a function */
1888 values.sals = (struct symtab_and_line *)
1889 xmalloc (sizeof (struct symtab_and_line));
1890 values.sals[0] = find_function_start_sal (sym, funfirstline);
1893 /* Don't use the SYMBOL_LINE; if used at all it points to
1894 the line containing the parameters or thereabouts, not
1895 the first line of code. */
1897 /* We might need a canonical line spec if it is a static
1899 if (file_symtab == 0)
1901 struct blockvector *bv = BLOCKVECTOR (SYMBOL_SYMTAB (sym));
1902 struct block *b = BLOCKVECTOR_BLOCK (bv, STATIC_BLOCK);
1903 if (lookup_block_symbol (b, copy, VAR_DOMAIN) != NULL)
1904 build_canonical_line_spec (values.sals, copy, canonical);
1911 error (_("\"%s\" is not a function"), copy);
1912 else if (SYMBOL_LINE (sym) != 0)
1914 /* We know its line number. */
1915 values.sals = (struct symtab_and_line *)
1916 xmalloc (sizeof (struct symtab_and_line));
1918 memset (&values.sals[0], 0, sizeof (values.sals[0]));
1919 values.sals[0].symtab = SYMBOL_SYMTAB (sym);
1920 values.sals[0].line = SYMBOL_LINE (sym);
1924 /* This can happen if it is compiled with a compiler which doesn't
1925 put out line numbers for variables. */
1926 /* FIXME: Shouldn't we just set .line and .symtab to zero
1927 and return? For example, "info line foo" could print
1929 error (_("Line number not known for symbol \"%s\""), copy);
1933 /* We've found a minimal symbol MSYMBOL to associate with our
1934 linespec; build a corresponding struct symtabs_and_lines. */
1936 static struct symtabs_and_lines
1937 minsym_found (int funfirstline, struct minimal_symbol *msymbol)
1939 struct objfile *objfile = msymbol_objfile (msymbol);
1940 struct gdbarch *gdbarch = get_objfile_arch (objfile);
1941 struct symtabs_and_lines values;
1944 values.sals = (struct symtab_and_line *)
1945 xmalloc (sizeof (struct symtab_and_line));
1946 values.sals[0] = find_pc_sect_line (SYMBOL_VALUE_ADDRESS (msymbol),
1947 (struct obj_section *) 0, 0);
1948 values.sals[0].section = SYMBOL_OBJ_SECTION (msymbol);
1950 /* The minimal symbol might point to a function descriptor;
1951 resolve it to the actual code address instead. */
1952 pc = gdbarch_convert_from_func_ptr_addr (gdbarch,
1955 if (pc != values.sals[0].pc)
1956 values.sals[0] = find_pc_sect_line (pc, NULL, 0);
1959 skip_prologue_sal (&values.sals[0]);