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"
44 /* We share this one with symtab.c, but it is not exported widely. */
46 extern char *operator_chars (char *, char **);
48 /* Prototypes for local functions */
50 static void initialize_defaults (struct symtab
**default_symtab
,
53 static void set_flags (char *arg
, int *is_quoted
, char **paren_pointer
);
55 static struct symtabs_and_lines
decode_indirect (char **argptr
);
57 static char *locate_first_half (char **argptr
, int *is_quote_enclosed
);
59 static struct symtabs_and_lines
decode_objc (char **argptr
,
61 struct symtab
*file_symtab
,
65 static struct symtabs_and_lines
decode_compound (char **argptr
,
72 static struct symbol
*lookup_prefix_sym (char **argptr
, char *p
);
74 static struct symtabs_and_lines
find_method (int funfirstline
,
79 struct symbol
*sym_class
,
82 static NORETURN
void cplusplus_error (const char *name
,
84 ATTR_NORETURN
ATTR_FORMAT (printf
, 2, 3);
86 static int total_number_of_methods (struct type
*type
);
88 static int find_methods (struct type
*, char *,
89 enum language
, struct symbol
**);
91 static int add_matching_methods (int method_counter
, struct type
*t
,
92 enum language language
,
93 struct symbol
**sym_arr
);
95 static int add_constructors (int method_counter
, struct type
*t
,
96 enum language language
,
97 struct symbol
**sym_arr
);
99 static void build_canonical_line_spec (struct symtab_and_line
*,
102 static char *find_toplevel_char (char *s
, char c
);
104 static int is_objc_method_format (const char *s
);
106 static struct symtabs_and_lines
decode_line_2 (struct symbol
*[],
109 static struct symtab
*symtab_from_filename (char **argptr
,
110 char *p
, int is_quote_enclosed
,
114 symtabs_and_lines
decode_all_digits (char **argptr
,
115 struct symtab
*default_symtab
,
118 struct symtab
*file_symtab
,
121 static struct symtabs_and_lines
decode_dollar (char *copy
,
123 struct symtab
*default_symtab
,
125 struct symtab
*file_symtab
);
127 static struct symtabs_and_lines
decode_variable (char *copy
,
130 struct symtab
*file_symtab
,
134 symtabs_and_lines
symbol_found (int funfirstline
,
138 struct symtab
*file_symtab
);
141 symtabs_and_lines
minsym_found (int funfirstline
,
142 struct minimal_symbol
*msymbol
);
144 /* Helper functions. */
146 /* Issue a helpful hint on using the command completion feature on
147 single quoted demangled C++ symbols as part of the completion
151 cplusplus_error (const char *name
, const char *fmt
, ...)
153 struct ui_file
*tmp_stream
;
155 tmp_stream
= mem_fileopen ();
156 make_cleanup_ui_file_delete (tmp_stream
);
160 va_start (args
, fmt
);
161 vfprintf_unfiltered (tmp_stream
, fmt
, args
);
165 while (*name
== '\'')
167 fprintf_unfiltered (tmp_stream
,
168 ("Hint: try '%s<TAB> or '%s<ESC-?>\n"
169 "(Note leading single quote.)"),
172 message
= ui_file_xstrdup (tmp_stream
, NULL
);
173 make_cleanup (xfree
, message
);
174 throw_error (NOT_FOUND_ERROR
, "%s", message
);
177 /* Return the number of methods described for TYPE, including the
178 methods from types it derives from. This can't be done in the symbol
179 reader because the type of the baseclass might still be stubbed
180 when the definition of the derived class is parsed. */
183 total_number_of_methods (struct type
*type
)
188 CHECK_TYPEDEF (type
);
189 if (! HAVE_CPLUS_STRUCT (type
))
191 count
= TYPE_NFN_FIELDS_TOTAL (type
);
193 for (n
= 0; n
< TYPE_N_BASECLASSES (type
); n
++)
194 count
+= total_number_of_methods (TYPE_BASECLASS (type
, n
));
199 /* Recursive helper function for decode_line_1.
200 Look for methods named NAME in type T.
201 Return number of matches.
202 Put matches in SYM_ARR, which should have been allocated with
203 a size of total_number_of_methods (T) * sizeof (struct symbol *).
204 Note that this function is g++ specific. */
207 find_methods (struct type
*t
, char *name
, enum language language
,
208 struct symbol
**sym_arr
)
212 char *class_name
= type_name_no_tag (t
);
214 /* Ignore this class if it doesn't have a name. This is ugly, but
215 unless we figure out how to get the physname without the name of
216 the class, then the loop can't do any good. */
218 && (lookup_symbol_in_language (class_name
, (struct block
*) NULL
,
219 STRUCT_DOMAIN
, language
, (int *) NULL
)))
222 int name_len
= strlen (name
);
226 /* Loop over each method name. At this level, all overloads of a name
227 are counted as a single name. There is an inner loop which loops over
230 for (method_counter
= TYPE_NFN_FIELDS (t
) - 1;
234 char *method_name
= TYPE_FN_FIELDLIST_NAME (t
, method_counter
);
237 if (strncmp (method_name
, "__", 2) == 0 ||
238 strncmp (method_name
, "op", 2) == 0 ||
239 strncmp (method_name
, "type", 4) == 0)
241 if (cplus_demangle_opname (method_name
, dem_opname
, DMGL_ANSI
))
242 method_name
= dem_opname
;
243 else if (cplus_demangle_opname (method_name
, dem_opname
, 0))
244 method_name
= dem_opname
;
247 if (strcmp_iw (name
, method_name
) == 0)
248 /* Find all the overloaded methods with that name. */
249 i1
+= add_matching_methods (method_counter
, t
, language
,
251 else if (strncmp (class_name
, name
, name_len
) == 0
252 && (class_name
[name_len
] == '\0'
253 || class_name
[name_len
] == '<'))
254 i1
+= add_constructors (method_counter
, t
, language
,
259 /* Only search baseclasses if there is no match yet, since names in
260 derived classes override those in baseclasses.
262 FIXME: The above is not true; it is only true of member functions
263 if they have the same number of arguments (??? - section 13.1 of the
264 ARM says the function members are not in the same scope but doesn't
265 really spell out the rules in a way I understand. In any case, if
266 the number of arguments differ this is a case in which we can overload
267 rather than hiding without any problem, and gcc 2.4.5 does overload
268 rather than hiding in this case). */
271 for (ibase
= 0; ibase
< TYPE_N_BASECLASSES (t
); ibase
++)
272 i1
+= find_methods (TYPE_BASECLASS (t
, ibase
), name
,
273 language
, sym_arr
+ i1
);
278 /* Add the symbols associated to methods of the class whose type is T
279 and whose name matches the method indexed by METHOD_COUNTER in the
280 array SYM_ARR. Return the number of methods added. */
283 add_matching_methods (int method_counter
, struct type
*t
,
284 enum language language
, struct symbol
**sym_arr
)
289 for (field_counter
= TYPE_FN_FIELDLIST_LENGTH (t
, method_counter
) - 1;
296 f
= TYPE_FN_FIELDLIST1 (t
, method_counter
);
298 if (TYPE_FN_FIELD_STUB (f
, field_counter
))
302 tmp_name
= gdb_mangle_name (t
,
305 phys_name
= alloca (strlen (tmp_name
) + 1);
306 strcpy (phys_name
, tmp_name
);
310 phys_name
= TYPE_FN_FIELD_PHYSNAME (f
, field_counter
);
312 sym_arr
[i1
] = lookup_symbol_in_language (phys_name
,
320 /* This error message gets printed, but the method
321 still seems to be found
322 fputs_filtered("(Cannot find method ", gdb_stdout);
323 fprintf_symbol_filtered (gdb_stdout, phys_name,
325 DMGL_PARAMS | DMGL_ANSI);
326 fputs_filtered(" - possibly inlined.)\n", gdb_stdout);
334 /* Add the symbols associated to constructors of the class whose type
335 is CLASS_TYPE and which are indexed by by METHOD_COUNTER to the
336 array SYM_ARR. Return the number of methods added. */
339 add_constructors (int method_counter
, struct type
*t
,
340 enum language language
, struct symbol
**sym_arr
)
345 /* For GCC 3.x and stabs, constructors and destructors
346 have names like __base_ctor and __complete_dtor.
347 Check the physname for now if we're looking for a
350 = TYPE_FN_FIELDLIST_LENGTH (t
, method_counter
) - 1;
357 f
= TYPE_FN_FIELDLIST1 (t
, method_counter
);
359 /* GCC 3.x will never produce stabs stub methods, so
360 we don't need to handle this case. */
361 if (TYPE_FN_FIELD_STUB (f
, field_counter
))
363 phys_name
= TYPE_FN_FIELD_PHYSNAME (f
, field_counter
);
364 if (! is_constructor_name (phys_name
))
367 /* If this method is actually defined, include it in the
369 sym_arr
[i1
] = lookup_symbol_in_language (phys_name
,
380 /* Helper function for decode_line_1.
381 Build a canonical line spec in CANONICAL if it is non-NULL and if
382 the SAL has a symtab.
383 If SYMNAME is non-NULL the canonical line spec is `filename:symname'.
384 If SYMNAME is NULL the line number from SAL is used and the canonical
385 line spec is `filename:linenum'. */
388 build_canonical_line_spec (struct symtab_and_line
*sal
, char *symname
,
391 char **canonical_arr
;
392 char *canonical_name
;
394 struct symtab
*s
= sal
->symtab
;
396 if (s
== (struct symtab
*) NULL
397 || s
->filename
== (char *) NULL
398 || canonical
== (char ***) NULL
)
401 canonical_arr
= (char **) xmalloc (sizeof (char *));
402 *canonical
= canonical_arr
;
404 filename
= s
->filename
;
407 canonical_name
= xmalloc (strlen (filename
) + strlen (symname
) + 2);
408 sprintf (canonical_name
, "%s:%s", filename
, symname
);
412 canonical_name
= xmalloc (strlen (filename
) + 30);
413 sprintf (canonical_name
, "%s:%d", filename
, sal
->line
);
415 canonical_arr
[0] = canonical_name
;
420 /* Find an instance of the character C in the string S that is outside
421 of all parenthesis pairs, single-quoted strings, and double-quoted
422 strings. Also, ignore the char within a template name, like a ','
423 within foo<int, int>. */
426 find_toplevel_char (char *s
, char c
)
428 int quoted
= 0; /* zero if we're not in quotes;
429 '"' if we're in a double-quoted string;
430 '\'' if we're in a single-quoted string. */
431 int depth
= 0; /* Number of unclosed parens we've seen. */
434 for (scan
= s
; *scan
; scan
++)
440 else if (*scan
== '\\' && *(scan
+ 1))
443 else if (*scan
== c
&& ! quoted
&& depth
== 0)
445 else if (*scan
== '"' || *scan
== '\'')
447 else if (*scan
== '(' || *scan
== '<')
449 else if ((*scan
== ')' || *scan
== '>') && depth
> 0)
456 /* Determines if the gives string corresponds to an Objective-C method
457 representation, such as -[Foo bar:] or +[Foo bar]. Objective-C symbols
458 are allowed to have spaces and parentheses in them. */
461 is_objc_method_format (const char *s
)
463 if (s
== NULL
|| *s
== '\0')
465 /* Handle arguments with the format FILENAME:SYMBOL. */
466 if ((s
[0] == ':') && (strchr ("+-", s
[1]) != NULL
)
467 && (s
[2] == '[') && strchr(s
, ']'))
469 /* Handle arguments that are just SYMBOL. */
470 else if ((strchr ("+-", s
[0]) != NULL
) && (s
[1] == '[') && strchr(s
, ']'))
475 /* Given a list of NELTS symbols in SYM_ARR, return a list of lines to
476 operate on (ask user if necessary).
477 If CANONICAL is non-NULL return a corresponding array of mangled names
478 as canonical line specs there. */
480 static struct symtabs_and_lines
481 decode_line_2 (struct symbol
*sym_arr
[], int nelts
, int funfirstline
,
484 struct symtabs_and_lines values
, return_values
;
489 struct cleanup
*old_chain
;
490 char **canonical_arr
= (char **) NULL
;
491 const char *select_mode
= multiple_symbols_select_mode ();
493 if (select_mode
== multiple_symbols_cancel
)
495 canceled because the command is ambiguous\n\
496 See set/show multiple-symbol."));
498 values
.sals
= (struct symtab_and_line
*)
499 alloca (nelts
* sizeof (struct symtab_and_line
));
500 return_values
.sals
= (struct symtab_and_line
*)
501 xmalloc (nelts
* sizeof (struct symtab_and_line
));
502 old_chain
= make_cleanup (xfree
, return_values
.sals
);
506 canonical_arr
= (char **) xmalloc (nelts
* sizeof (char *));
507 make_cleanup (xfree
, canonical_arr
);
508 memset (canonical_arr
, 0, nelts
* sizeof (char *));
509 *canonical
= canonical_arr
;
515 init_sal (&return_values
.sals
[i
]); /* Initialize to zeroes. */
516 init_sal (&values
.sals
[i
]);
517 if (sym_arr
[i
] && SYMBOL_CLASS (sym_arr
[i
]) == LOC_BLOCK
)
518 values
.sals
[i
] = find_function_start_sal (sym_arr
[i
], funfirstline
);
522 /* If select_mode is "all", then do not print the multiple-choice
523 menu and act as if the user had chosen choice "1" (all). */
524 if (select_mode
== multiple_symbols_all
525 || ui_out_is_mi_like_p (interp_ui_out (top_level_interpreter ())))
530 printf_unfiltered (_("[0] cancel\n[1] all\n"));
533 if (sym_arr
[i
] && SYMBOL_CLASS (sym_arr
[i
]) == LOC_BLOCK
)
535 if (values
.sals
[i
].symtab
)
536 printf_unfiltered ("[%d] %s at %s:%d\n",
538 SYMBOL_PRINT_NAME (sym_arr
[i
]),
539 values
.sals
[i
].symtab
->filename
,
540 values
.sals
[i
].line
);
542 printf_unfiltered (_("[%d] %s at ?FILE:%d [No symtab? Probably broken debug info...]\n"),
544 SYMBOL_PRINT_NAME (sym_arr
[i
]),
545 values
.sals
[i
].line
);
549 printf_unfiltered (_("?HERE\n"));
553 prompt
= getenv ("PS2");
558 args
= command_line_input (prompt
, 0, "overload-choice");
561 if (args
== 0 || *args
== 0)
562 error_no_arg (_("one or more choice numbers"));
570 while (*arg1
>= '0' && *arg1
<= '9')
572 if (*arg1
&& *arg1
!= ' ' && *arg1
!= '\t')
573 error (_("Arguments must be choice numbers."));
578 error (_("canceled"));
583 for (i
= 0; i
< nelts
; i
++)
585 if (canonical_arr
[i
] == NULL
)
587 symname
= SYMBOL_LINKAGE_NAME (sym_arr
[i
]);
588 canonical_arr
[i
] = xstrdup (symname
);
592 memcpy (return_values
.sals
, values
.sals
,
593 (nelts
* sizeof (struct symtab_and_line
)));
594 return_values
.nelts
= nelts
;
595 discard_cleanups (old_chain
);
596 return return_values
;
599 if (num
>= nelts
+ 2)
601 printf_unfiltered (_("No choice number %d.\n"), num
);
606 if (values
.sals
[num
].pc
)
610 symname
= SYMBOL_LINKAGE_NAME (sym_arr
[num
]);
611 make_cleanup (xfree
, symname
);
612 canonical_arr
[i
] = xstrdup (symname
);
614 return_values
.sals
[i
++] = values
.sals
[num
];
615 values
.sals
[num
].pc
= 0;
619 printf_unfiltered (_("duplicate request for %d ignored.\n"), num
);
624 while (*args
== ' ' || *args
== '\t')
627 return_values
.nelts
= i
;
628 discard_cleanups (old_chain
);
629 return return_values
;
632 /* The parser of linespec itself. */
634 /* Parse a string that specifies a line number.
635 Pass the address of a char * variable; that variable will be
636 advanced over the characters actually parsed.
640 LINENUM -- that line number in current file. PC returned is 0.
641 FILE:LINENUM -- that line in that file. PC returned is 0.
642 FUNCTION -- line number of openbrace of that function.
643 PC returned is the start of the function.
644 VARIABLE -- line number of definition of that variable.
646 FILE:FUNCTION -- likewise, but prefer functions in that file.
647 *EXPR -- line in which address EXPR appears.
649 This may all be followed by an "if EXPR", which we ignore.
651 FUNCTION may be an undebuggable function found in minimal symbol table.
653 If the argument FUNFIRSTLINE is nonzero, we want the first line
654 of real code inside a function when a function is specified, and it is
655 not OK to specify a variable or type to get its line number.
657 DEFAULT_SYMTAB specifies the file to use if none is specified.
658 It defaults to current_source_symtab.
659 DEFAULT_LINE specifies the line number to use for relative
660 line numbers (that start with signs). Defaults to current_source_line.
661 If CANONICAL is non-NULL, store an array of strings containing the canonical
662 line specs there if necessary. Currently overloaded member functions and
663 line numbers or static functions without a filename yield a canonical
664 line spec. The array and the line spec strings are allocated on the heap,
665 it is the callers responsibility to free them.
667 Note that it is possible to return zero for the symtab
668 if no file is validly specified. Callers must check that.
669 Also, the line number returned may be invalid.
671 If NOT_FOUND_PTR is not null, store a boolean true/false value at the location, based
672 on whether or not failure occurs due to an unknown function or file. In the case
673 where failure does occur due to an unknown function or file, do not issue an error
676 /* We allow single quotes in various places. This is a hideous
677 kludge, which exists because the completer can't yet deal with the
678 lack of single quotes. FIXME: write a linespec_completer which we
679 can use as appropriate instead of make_symbol_completion_list. */
681 struct symtabs_and_lines
682 decode_line_1 (char **argptr
, int funfirstline
, struct symtab
*default_symtab
,
683 int default_line
, char ***canonical
, int *not_found_ptr
)
687 /* If a file name is specified, this is its symtab. */
688 struct symtab
*file_symtab
= NULL
;
691 /* This is NULL if there are no parens in *ARGPTR, or a pointer to
692 the closing parenthesis if there are parens. */
694 /* This says whether or not something in *ARGPTR is quoted with
695 completer_quotes (i.e. with single quotes). */
697 /* Is part of *ARGPTR is enclosed in double quotes? */
698 int is_quote_enclosed
;
699 int is_objc_method
= 0;
700 char *saved_arg
= *argptr
;
701 /* If IS_QUOTED, the end of the quoted bit. */
702 char *end_quote
= NULL
;
707 /* Defaults have defaults. */
709 initialize_defaults (&default_symtab
, &default_line
);
711 /* See if arg is *PC. */
714 return decode_indirect (argptr
);
716 /* Set various flags. 'paren_pointer' is important for overload
717 checking, where we allow things like:
718 (gdb) break c::f(int)
721 set_flags (*argptr
, &is_quoted
, &paren_pointer
);
723 end_quote
= skip_quoted (*argptr
);
725 /* Check to see if it's a multipart linespec (with colons or
728 /* Locate the end of the first half of the linespec.
729 After the call, for instance, if the argptr string is "foo.c:123"
730 p will point at "123". If there is only one part, like "foo", p
731 will point to "". If this is a C++ name, like "A::B::foo", p will
732 point to "::B::foo". Argptr is not changed by this call. */
734 p
= locate_first_half (argptr
, &is_quote_enclosed
);
736 /* Check if this is an Objective-C method (anything that starts with
737 a '+' or '-' and a '['). */
738 if (is_objc_method_format (p
))
741 paren_pointer
= NULL
; /* Just a category name. Ignore it. */
744 /* Check if the symbol could be an Objective-C selector. */
747 struct symtabs_and_lines values
;
748 values
= decode_objc (argptr
, funfirstline
, NULL
,
749 canonical
, saved_arg
);
750 if (values
.sals
!= NULL
)
755 *argptr
= *argptr
+ 1;
757 /* Does it look like there actually were two parts? */
759 if (p
[0] == ':' || p
[0] == '.')
761 /* Is it a C++ or Java compound data structure?
762 The check on p[1] == ':' is capturing the case of "::",
763 since p[0]==':' was checked above.
764 Note that the call to decode_compound does everything
765 for us, including the lookup on the symbol table, so we
768 if (p
[0] == '.' || p
[1] == ':')
770 if (paren_pointer
== NULL
)
771 return decode_compound (argptr
, funfirstline
, canonical
,
772 saved_arg
, p
, not_found_ptr
);
773 /* Otherwise, fall through to decode_variable below. */
777 /* No, the first part is a filename; set file_symtab to be that file's
778 symtab. Also, move argptr past the filename. */
780 file_symtab
= symtab_from_filename (argptr
, p
, is_quote_enclosed
,
783 /* Check for single quotes on the non-filename part. */
786 is_quoted
= (**argptr
787 && strchr (get_gdb_completer_quote_characters (),
790 end_quote
= skip_quoted (*argptr
);
795 /* No one really seems to know why this was added. It certainly
796 breaks the command line, though, whenever the passed
797 name is of the form ClassName::Method. This bit of code
798 singles out the class name, and if funfirstline is set (for
799 example, you are setting a breakpoint at this function),
800 you get an error. This did not occur with earlier
801 verions, so I am ifdef'ing this out. 3/29/99 */
804 /* Check if what we have till now is a symbol name */
806 /* We may be looking at a template instantiation such
807 as "foo<int>". Check here whether we know about it,
808 instead of falling through to the code below which
809 handles ordinary function names, because that code
810 doesn't like seeing '<' and '>' in a name -- the
811 skip_quoted call doesn't go past them. So see if we
812 can figure it out right now. */
814 copy
= (char *) alloca (p
- *argptr
+ 1);
815 memcpy (copy
, *argptr
, p
- *argptr
);
816 copy
[p
- *argptr
] = '\000';
817 sym
= lookup_symbol (copy
, 0, VAR_DOMAIN
, 0);
820 *argptr
= (*p
== '\'') ? p
+ 1 : p
;
821 return symbol_found (funfirstline
, canonical
, copy
, sym
, NULL
);
823 /* Otherwise fall out from here and go to file/line spec
828 /* file_symtab is specified file's symtab, or 0 if no file specified.
829 arg no longer contains the file name. */
831 /* Check whether arg is all digits (and sign). */
834 if (*q
== '-' || *q
== '+')
836 while (*q
>= '0' && *q
<= '9')
839 if (q
!= *argptr
&& (*q
== 0 || *q
== ' ' || *q
== '\t' || *q
== ','))
840 /* We found a token consisting of all digits -- at least one digit. */
841 return decode_all_digits (argptr
, default_symtab
, default_line
,
842 canonical
, file_symtab
, q
);
844 /* Arg token is not digits => try it as a variable name
845 Find the next token (everything up to end or next whitespace). */
847 if (**argptr
== '$') /* May be a convenience variable. */
848 /* One or two $ chars possible. */
849 p
= skip_quoted (*argptr
+ (((*argptr
)[1] == '$') ? 2 : 1));
854 error (_("Unmatched single quote."));
856 else if (is_objc_method
)
858 /* allow word separators in method names for Obj-C */
859 p
= skip_quoted_chars (*argptr
, NULL
, "");
861 else if (paren_pointer
!= NULL
)
863 p
= paren_pointer
+ 1;
867 p
= skip_quoted (*argptr
);
870 /* Keep any template parameters */
872 p
= find_template_name_end (p
);
874 copy
= (char *) alloca (p
- *argptr
+ 1);
875 memcpy (copy
, *argptr
, p
- *argptr
);
876 copy
[p
- *argptr
] = '\0';
879 && copy
[0] == copy
[p
- *argptr
- 1]
880 && strchr (get_gdb_completer_quote_characters (), copy
[0]) != NULL
)
882 copy
[p
- *argptr
- 1] = '\0';
886 copy
[p
- *argptr
- 1] = '\0';
887 while (*p
== ' ' || *p
== '\t')
891 /* If it starts with $: may be a legitimate variable or routine name
892 (e.g. HP-UX millicode routines such as $$dyncall), or it may
893 be history value, or it may be a convenience variable. */
896 return decode_dollar (copy
, funfirstline
, default_symtab
,
897 canonical
, file_symtab
);
899 /* Look up that token as a variable.
900 If file specified, use that file's per-file block to start with. */
902 return decode_variable (copy
, funfirstline
, canonical
,
903 file_symtab
, not_found_ptr
);
908 /* Now, more helper functions for decode_line_1. Some conventions
909 that these functions follow:
911 Decode_line_1 typically passes along some of its arguments or local
912 variables to the subfunctions. It passes the variables by
913 reference if they are modified by the subfunction, and by value
916 Some of the functions have side effects that don't arise from
917 variables that are passed by reference. In particular, if a
918 function is passed ARGPTR as an argument, it modifies what ARGPTR
919 points to; typically, it advances *ARGPTR past whatever substring
920 it has just looked at. (If it doesn't modify *ARGPTR, then the
921 function gets passed *ARGPTR instead, which is then called ARG: see
922 set_flags, for example.) Also, functions that return a struct
923 symtabs_and_lines may modify CANONICAL, as in the description of
926 If a function returns a struct symtabs_and_lines, then that struct
927 will immediately make its way up the call chain to be returned by
928 decode_line_1. In particular, all of the functions decode_XXX
929 calculate the appropriate struct symtabs_and_lines, under the
930 assumption that their argument is of the form XXX. */
932 /* First, some functions to initialize stuff at the beggining of the
936 initialize_defaults (struct symtab
**default_symtab
, int *default_line
)
938 if (*default_symtab
== 0)
940 /* Use whatever we have for the default source line. We don't use
941 get_current_or_default_symtab_and_line as it can recurse and call
943 struct symtab_and_line cursal
=
944 get_current_source_symtab_and_line ();
946 *default_symtab
= cursal
.symtab
;
947 *default_line
= cursal
.line
;
952 set_flags (char *arg
, int *is_quoted
, char **paren_pointer
)
957 /* 'has_if' is for the syntax:
958 (gdb) break foo if (a==b)
960 if ((ii
= strstr (arg
, " if ")) != NULL
||
961 (ii
= strstr (arg
, "\tif ")) != NULL
||
962 (ii
= strstr (arg
, " if\t")) != NULL
||
963 (ii
= strstr (arg
, "\tif\t")) != NULL
||
964 (ii
= strstr (arg
, " if(")) != NULL
||
965 (ii
= strstr (arg
, "\tif( ")) != NULL
)
967 /* Temporarily zap out "if (condition)" to not confuse the
968 parenthesis-checking code below. This is undone below. Do not
976 && strchr (get_gdb_completer_quote_characters (),
979 *paren_pointer
= strchr (arg
, '(');
980 if (*paren_pointer
!= NULL
)
981 *paren_pointer
= strrchr (*paren_pointer
, ')');
983 /* Now that we're safely past the paren_pointer check, put back " if
984 (condition)" so outer layers can see it. */
991 /* Decode arg of the form *PC. */
993 static struct symtabs_and_lines
994 decode_indirect (char **argptr
)
996 struct symtabs_and_lines values
;
1000 pc
= parse_and_eval_address_1 (argptr
);
1002 values
.sals
= (struct symtab_and_line
*)
1003 xmalloc (sizeof (struct symtab_and_line
));
1006 values
.sals
[0] = find_pc_line (pc
, 0);
1007 values
.sals
[0].pc
= pc
;
1008 values
.sals
[0].section
= find_pc_overlay (pc
);
1009 values
.sals
[0].explicit_pc
= 1;
1016 /* Locate the first half of the linespec, ending in a colon, period,
1017 or whitespace. (More or less.) Also, check to see if *ARGPTR is
1018 enclosed in double quotes; if so, set is_quote_enclosed, advance
1019 ARGPTR past that and zero out the trailing double quote.
1020 If ARGPTR is just a simple name like "main", p will point to ""
1024 locate_first_half (char **argptr
, int *is_quote_enclosed
)
1030 /* Maybe we were called with a line range FILENAME:LINENUM,FILENAME:LINENUM
1031 and we must isolate the first half. Outer layers will call again later
1032 for the second half.
1034 Don't count commas that appear in argument lists of overloaded
1035 functions, or in quoted strings. It's stupid to go to this much
1036 trouble when the rest of the function is such an obvious roach hotel. */
1037 ii
= find_toplevel_char (*argptr
, ',');
1038 has_comma
= (ii
!= 0);
1040 /* Temporarily zap out second half to not confuse the code below.
1041 This is undone below. Do not change ii!! */
1047 /* Maybe arg is FILE : LINENUM or FILE : FUNCTION. May also be
1048 CLASS::MEMBER, or NAMESPACE::NAME. Look for ':', but ignore
1054 *is_quote_enclosed
= 1;
1059 *is_quote_enclosed
= 0;
1064 char *temp_end
= find_template_name_end (p
);
1066 error (_("malformed template specification in command"));
1069 /* Check for a colon and a plus or minus and a [ (which
1070 indicates an Objective-C method) */
1071 if (is_objc_method_format (p
))
1075 /* Check for the end of the first half of the linespec. End of
1076 line, a tab, a double colon or the last single colon, or a
1077 space. But if enclosed in double quotes we do not break on
1082 && ((p
[1] == ':') || (strchr (p
+ 1, ':') == NULL
)))
1083 || ((p
[0] == ' ') && !*is_quote_enclosed
))
1085 if (p
[0] == '.' && strchr (p
, ':') == NULL
)
1087 /* Java qualified method. Find the *last* '.', since the
1088 others are package qualifiers. */
1089 for (p1
= p
; *p1
; p1
++)
1097 while (p
[0] == ' ' || p
[0] == '\t')
1100 /* If the closing double quote was left at the end, remove it. */
1101 if (*is_quote_enclosed
)
1103 char *closing_quote
= strchr (p
- 1, '"');
1104 if (closing_quote
&& closing_quote
[1] == '\0')
1105 *closing_quote
= '\0';
1108 /* Now that we've safely parsed the first half, put back ',' so
1109 outer layers can see it. */
1118 /* Here's where we recognise an Objective-C Selector. An Objective C
1119 selector may be implemented by more than one class, therefore it
1120 may represent more than one method/function. This gives us a
1121 situation somewhat analogous to C++ overloading. If there's more
1122 than one method that could represent the selector, then use some of
1123 the existing C++ code to let the user choose one. */
1125 struct symtabs_and_lines
1126 decode_objc (char **argptr
, int funfirstline
, struct symtab
*file_symtab
,
1127 char ***canonical
, char *saved_arg
)
1129 struct symtabs_and_lines values
;
1130 struct symbol
**sym_arr
= NULL
;
1131 struct symbol
*sym
= NULL
;
1133 struct block
*block
= NULL
;
1140 if (file_symtab
!= NULL
)
1141 block
= BLOCKVECTOR_BLOCK (BLOCKVECTOR (file_symtab
), STATIC_BLOCK
);
1144 enum language save_language
;
1146 /* get_selected_block can change the current language when there is
1147 no selected frame yet. */
1148 save_language
= current_language
->la_language
;
1149 block
= get_selected_block (0);
1150 set_language (save_language
);
1153 copy
= find_imps (file_symtab
, block
, *argptr
, NULL
, &i1
, &i2
);
1157 sym_arr
= (struct symbol
**) alloca ((i1
+ 1) * sizeof (struct symbol
*));
1160 copy
= find_imps (file_symtab
, block
, *argptr
, sym_arr
, &i1
, &i2
);
1164 /* i1 now represents the TOTAL number of matches found.
1165 i2 represents how many HIGH-LEVEL (struct symbol) matches,
1166 which will come first in the sym_arr array. Any low-level
1167 (minimal_symbol) matches will follow those. */
1173 /* Already a struct symbol. */
1178 sym
= find_pc_function (SYMBOL_VALUE_ADDRESS (sym_arr
[0]));
1179 if ((sym
!= NULL
) && strcmp (SYMBOL_LINKAGE_NAME (sym_arr
[0]), SYMBOL_LINKAGE_NAME (sym
)) != 0)
1181 warning (_("debugging symbol \"%s\" does not match selector; ignoring"), SYMBOL_LINKAGE_NAME (sym
));
1186 values
.sals
= (struct symtab_and_line
*) xmalloc (sizeof (struct symtab_and_line
));
1189 if (sym
&& SYMBOL_CLASS (sym
) == LOC_BLOCK
)
1191 /* Canonicalize this, so it remains resolved for dylib loads. */
1192 values
.sals
[0] = find_function_start_sal (sym
, funfirstline
);
1193 build_canonical_line_spec (values
.sals
, SYMBOL_NATURAL_NAME (sym
), canonical
);
1197 /* The only match was a non-debuggable symbol, which might point
1198 to a function descriptor; resolve it to the actual code address
1200 struct minimal_symbol
*msymbol
= (struct minimal_symbol
*)sym_arr
[0];
1201 struct objfile
*objfile
= msymbol_objfile (msymbol
);
1202 struct gdbarch
*gdbarch
= get_objfile_arch (objfile
);
1203 CORE_ADDR pc
= SYMBOL_VALUE_ADDRESS (msymbol
);
1205 pc
= gdbarch_convert_from_func_ptr_addr (gdbarch
, pc
,
1208 init_sal (&values
.sals
[0]);
1209 values
.sals
[0].pc
= pc
;
1216 /* More than one match. The user must choose one or more. */
1217 return decode_line_2 (sym_arr
, i2
, funfirstline
, canonical
);
1223 /* This handles C++ and Java compound data structures. P should point
1224 at the first component separator, i.e. double-colon or period. As
1225 an example, on entrance to this function we could have ARGPTR
1226 pointing to "AAA::inA::fun" and P pointing to "::inA::fun". */
1228 static struct symtabs_and_lines
1229 decode_compound (char **argptr
, int funfirstline
, char ***canonical
,
1230 char *saved_arg
, char *p
, int *not_found_ptr
)
1232 struct symtabs_and_lines values
;
1234 char *saved_arg2
= *argptr
;
1238 struct symbol
*sym_class
;
1239 struct symbol
**sym_arr
;
1242 /* First check for "global" namespace specification, of the form
1243 "::foo". If found, skip over the colons and jump to normal
1244 symbol processing. I.e. the whole line specification starts with
1245 "::" (note the condition that *argptr == p). */
1247 && ((*argptr
== p
) || (p
[-1] == ' ') || (p
[-1] == '\t')))
1250 /* Given our example "AAA::inA::fun", we have two cases to consider:
1252 1) AAA::inA is the name of a class. In that case, presumably it
1253 has a method called "fun"; we then look up that method using
1256 2) AAA::inA isn't the name of a class. In that case, either the
1257 user made a typo or AAA::inA is the name of a namespace.
1258 Either way, we just look up AAA::inA::fun with lookup_symbol.
1260 Thus, our first task is to find everything before the last set of
1261 double-colons and figure out if it's the name of a class. So we
1262 first loop through all of the double-colons. */
1264 p2
= p
; /* Save for restart. */
1266 /* This is very messy. Following the example above we have now the
1269 argptr -> "AAA::inA::fun
1270 saved_arg -> "AAA::inA::fun
1271 saved_arg2 -> "AAA::inA::fun
1272 p2 -> "::inA::fun". */
1274 /* In the loop below, with these strings, we'll make 2 passes, each
1275 is marked in comments.*/
1279 /* Move pointer up to next possible class/namespace token. */
1281 p
= p2
+ 1; /* Restart with old value +1. */
1283 /* PASS1: at this point p2->"::inA::fun", so p->":inA::fun",
1284 i.e. if there is a double-colon, p will now point to the
1286 /* PASS2: p2->"::fun", p->":fun" */
1288 /* Move pointer ahead to next double-colon. */
1289 while (*p
&& (p
[0] != ' ') && (p
[0] != '\t') && (p
[0] != '\''))
1291 if (current_language
->la_language
== language_cplus
)
1292 p
+= cp_validate_operator (p
);
1296 temp_end
= find_template_name_end (p
);
1298 error (_("malformed template specification in command"));
1301 /* Note that, since, at the start of this loop, p would be
1302 pointing to the second colon in a double-colon, we only
1303 satisfy the condition below if there is another
1304 double-colon to the right (after). I.e. there is another
1305 component that can be a class or a namespace. I.e, if at
1306 the beginning of this loop (PASS1), we had
1307 p->":inA::fun", we'll trigger this when p has been
1308 advanced to point to "::fun". */
1309 /* PASS2: we will not trigger this. */
1310 else if ((p
[0] == ':') && (p
[1] == ':'))
1311 break; /* Found double-colon. */
1313 /* PASS2: We'll keep getting here, until p->"", at which point
1314 we exit this loop. */
1319 break; /* Out of the while (1). This would happen
1320 for instance if we have looked up
1321 unsuccessfully all the components of the
1322 string, and p->""(PASS2) */
1324 /* We get here if p points to ' ', '\t', '\'', "::" or ""(i.e
1326 /* Save restart for next time around. */
1328 /* Restore argptr as it was on entry to this function. */
1329 *argptr
= saved_arg2
;
1330 /* PASS1: at this point p->"::fun" argptr->"AAA::inA::fun",
1333 /* All ready for next pass through the loop. */
1337 /* Start of lookup in the symbol tables. */
1339 /* Lookup in the symbol table the substring between argptr and
1340 p. Note, this call changes the value of argptr. */
1341 /* Before the call, argptr->"AAA::inA::fun",
1342 p->"", p2->"::fun". After the call: argptr->"fun", p, p2
1344 sym_class
= lookup_prefix_sym (argptr
, p2
);
1346 /* If sym_class has been found, and if "AAA::inA" is a class, then
1347 we're in case 1 above. So we look up "fun" as a method of that
1350 (t
= check_typedef (SYMBOL_TYPE (sym_class
)),
1351 (TYPE_CODE (t
) == TYPE_CODE_STRUCT
1352 || TYPE_CODE (t
) == TYPE_CODE_UNION
)))
1354 /* Arg token is not digits => try it as a function name.
1355 Find the next token (everything up to end or next
1358 && strchr (get_gdb_completer_quote_characters (),
1361 p
= skip_quoted (*argptr
);
1362 *argptr
= *argptr
+ 1;
1366 /* At this point argptr->"fun". */
1368 while (*p
&& *p
!= ' ' && *p
!= '\t' && *p
!= ',' && *p
!= ':')
1370 /* At this point p->"". String ended. */
1371 /* Nope, C++ operators could have spaces in them
1372 ("foo::operator <" or "foo::operator delete []").
1373 I apologize, this is a bit hacky... */
1374 if (current_language
->la_language
== language_cplus
1375 && *p
== ' ' && p
- 8 - *argptr
+ 1 > 0)
1377 /* The above loop has already swallowed "operator". */
1378 p
+= cp_validate_operator (p
- 8) - 8;
1382 /* Allocate our own copy of the substring between argptr and
1384 copy
= (char *) alloca (p
- *argptr
+ 1);
1385 memcpy (copy
, *argptr
, p
- *argptr
);
1386 copy
[p
- *argptr
] = '\0';
1388 && copy
[p
- *argptr
- 1]
1389 && strchr (get_gdb_completer_quote_characters (),
1390 copy
[p
- *argptr
- 1]) != NULL
)
1391 copy
[p
- *argptr
- 1] = '\0';
1393 /* At this point copy->"fun", p->"" */
1395 /* No line number may be specified. */
1396 while (*p
== ' ' || *p
== '\t')
1399 /* At this point arptr->"". */
1401 /* Look for copy as a method of sym_class. */
1402 /* At this point copy->"fun", sym_class is "AAA:inA",
1403 saved_arg->"AAA::inA::fun". This concludes the scanning of
1404 the string for possible components matches. If we find it
1405 here, we return. If not, and we are at the and of the string,
1406 we'll lookup the whole string in the symbol tables. */
1408 return find_method (funfirstline
, canonical
, saved_arg
,
1409 copy
, t
, sym_class
, not_found_ptr
);
1411 } /* End if symbol found */
1414 /* We couldn't find a class, so we're in case 2 above. We check the
1415 entire name as a symbol instead. */
1417 copy
= (char *) alloca (p
- saved_arg2
+ 1);
1418 memcpy (copy
, saved_arg2
, p
- saved_arg2
);
1419 /* Note: if is_quoted should be true, we snuff out quote here
1421 copy
[p
- saved_arg2
] = '\000';
1422 /* Set argptr to skip over the name. */
1423 *argptr
= (*p
== '\'') ? p
+ 1 : p
;
1425 /* Look up entire name */
1426 sym
= lookup_symbol (copy
, 0, VAR_DOMAIN
, 0);
1428 return symbol_found (funfirstline
, canonical
, copy
, sym
, NULL
);
1430 /* Couldn't find any interpretation as classes/namespaces, so give
1431 up. The quotes are important if copy is empty. */
1434 cplusplus_error (saved_arg
,
1435 "Can't find member of namespace, class, struct, or union named \"%s\"\n",
1439 /* Next come some helper functions for decode_compound. */
1441 /* Return the symbol corresponding to the substring of *ARGPTR ending
1442 at P, allowing whitespace. Also, advance *ARGPTR past the symbol
1443 name in question, the compound object separator ("::" or "."), and
1444 whitespace. Note that *ARGPTR is changed whether or not the
1445 lookup_symbol call finds anything (i.e we return NULL). As an
1446 example, say ARGPTR is "AAA::inA::fun" and P is "::inA::fun". */
1448 static struct symbol
*
1449 lookup_prefix_sym (char **argptr
, char *p
)
1455 /* Extract the class name. */
1457 while (p
!= *argptr
&& p
[-1] == ' ')
1459 copy
= (char *) alloca (p
- *argptr
+ 1);
1460 memcpy (copy
, *argptr
, p
- *argptr
);
1461 copy
[p
- *argptr
] = 0;
1463 /* Discard the class name from the argptr. */
1464 p
= p1
+ (p1
[0] == ':' ? 2 : 1);
1465 while (*p
== ' ' || *p
== '\t')
1469 /* At this point p1->"::inA::fun", p->"inA::fun" copy->"AAA",
1470 argptr->"inA::fun" */
1472 sym
= lookup_symbol (copy
, 0, STRUCT_DOMAIN
, 0);
1475 /* Typedefs are in VAR_DOMAIN so the above symbol lookup will
1476 fail when the user attempts to lookup a method of a class
1477 via a typedef'd name (NOT via the class's name, which is already
1478 handled in symbol_matches_domain). So try the lookup again
1479 using VAR_DOMAIN (where typedefs live) and double-check that we
1480 found a struct/class type. */
1481 struct symbol
*s
= lookup_symbol (copy
, 0, VAR_DOMAIN
, 0);
1484 struct type
*t
= SYMBOL_TYPE (s
);
1486 if (TYPE_CODE (t
) == TYPE_CODE_STRUCT
)
1494 /* This finds the method COPY in the class whose type is T and whose
1495 symbol is SYM_CLASS. */
1497 static struct symtabs_and_lines
1498 find_method (int funfirstline
, char ***canonical
, char *saved_arg
,
1499 char *copy
, struct type
*t
, struct symbol
*sym_class
, int *not_found_ptr
)
1501 struct symtabs_and_lines values
;
1502 struct symbol
*sym
= NULL
;
1503 int i1
; /* Counter for the symbol array. */
1504 struct symbol
**sym_arr
= alloca (total_number_of_methods (t
)
1505 * sizeof (struct symbol
*));
1507 /* Find all methods with a matching name, and put them in
1510 i1
= find_methods (t
, copy
, SYMBOL_LANGUAGE (sym_class
), sym_arr
);
1514 /* There is exactly one field with that name. */
1517 if (sym
&& SYMBOL_CLASS (sym
) == LOC_BLOCK
)
1519 values
.sals
= (struct symtab_and_line
*)
1520 xmalloc (sizeof (struct symtab_and_line
));
1522 values
.sals
[0] = find_function_start_sal (sym
,
1534 /* There is more than one field with that name
1535 (overloaded). Ask the user which one to use. */
1536 return decode_line_2 (sym_arr
, i1
, funfirstline
, canonical
);
1543 cplusplus_error (saved_arg
,
1544 "the class `%s' does not have destructor defined\n",
1545 SYMBOL_PRINT_NAME (sym_class
));
1547 cplusplus_error (saved_arg
,
1548 "the class %s does not have any method named %s\n",
1549 SYMBOL_PRINT_NAME (sym_class
), copy
);
1555 /* Return the symtab associated to the filename given by the substring
1556 of *ARGPTR ending at P, and advance ARGPTR past that filename. If
1557 NOT_FOUND_PTR is not null and the source file is not found, store
1558 boolean true at the location pointed to and do not issue an
1561 static struct symtab
*
1562 symtab_from_filename (char **argptr
, char *p
, int is_quote_enclosed
,
1567 struct symtab
*file_symtab
;
1570 while (p
!= *argptr
&& p
[-1] == ' ')
1572 if ((*p
== '"') && is_quote_enclosed
)
1574 copy
= (char *) alloca (p
- *argptr
+ 1);
1575 memcpy (copy
, *argptr
, p
- *argptr
);
1576 /* It may have the ending quote right after the file name. */
1577 if (is_quote_enclosed
&& copy
[p
- *argptr
- 1] == '"')
1578 copy
[p
- *argptr
- 1] = 0;
1580 copy
[p
- *argptr
] = 0;
1582 /* Find that file's data. */
1583 file_symtab
= lookup_symtab (copy
);
1584 if (file_symtab
== 0)
1588 if (!have_full_symbols () && !have_partial_symbols ())
1589 throw_error (NOT_FOUND_ERROR
,
1590 _("No symbol table is loaded. Use the \"file\" command."));
1591 throw_error (NOT_FOUND_ERROR
, _("No source file named %s."), copy
);
1594 /* Discard the file name from the arg. */
1596 while (*p
== ' ' || *p
== '\t')
1605 /* This decodes a line where the argument is all digits (possibly
1606 preceded by a sign). Q should point to the end of those digits;
1607 the other arguments are as usual. */
1609 static struct symtabs_and_lines
1610 decode_all_digits (char **argptr
, struct symtab
*default_symtab
,
1611 int default_line
, char ***canonical
,
1612 struct symtab
*file_symtab
, char *q
)
1615 struct symtabs_and_lines values
;
1616 struct symtab_and_line val
;
1624 /* We might need a canonical line spec if no file was specified. */
1625 int need_canonical
= (file_symtab
== NULL
) ? 1 : 0;
1629 val
.pspace
= current_program_space
;
1631 /* This is where we need to make sure that we have good defaults.
1632 We must guarantee that this section of code is never executed
1633 when we are called with just a function name, since
1634 set_default_source_symtab_and_line uses
1635 select_source_symtab that calls us with such an argument. */
1637 if (file_symtab
== 0 && default_symtab
== 0)
1639 /* Make sure we have at least a default source file. */
1640 set_default_source_symtab_and_line ();
1641 initialize_defaults (&default_symtab
, &default_line
);
1644 if (**argptr
== '+')
1645 sign
= plus
, (*argptr
)++;
1646 else if (**argptr
== '-')
1647 sign
= minus
, (*argptr
)++;
1648 val
.line
= atoi (*argptr
);
1654 if (file_symtab
== 0)
1655 val
.line
= default_line
+ val
.line
;
1660 if (file_symtab
== 0)
1661 val
.line
= default_line
- val
.line
;
1666 break; /* No need to adjust val.line. */
1669 while (*q
== ' ' || *q
== '\t')
1672 if (file_symtab
== 0)
1673 file_symtab
= default_symtab
;
1675 /* It is possible that this source file has more than one symtab,
1676 and that the new line number specification has moved us from the
1677 default (in file_symtab) to a new one. */
1678 val
.symtab
= find_line_symtab (file_symtab
, val
.line
, NULL
, NULL
);
1679 if (val
.symtab
== 0)
1680 val
.symtab
= file_symtab
;
1682 val
.pspace
= SYMTAB_PSPACE (val
.symtab
);
1684 values
.sals
= (struct symtab_and_line
*)
1685 xmalloc (sizeof (struct symtab_and_line
));
1686 values
.sals
[0] = val
;
1689 build_canonical_line_spec (values
.sals
, NULL
, canonical
);
1690 values
.sals
[0].explicit_line
= 1;
1696 /* Decode a linespec starting with a dollar sign. */
1698 static struct symtabs_and_lines
1699 decode_dollar (char *copy
, int funfirstline
, struct symtab
*default_symtab
,
1700 char ***canonical
, struct symtab
*file_symtab
)
1704 int need_canonical
= 0;
1705 struct symtabs_and_lines values
;
1706 struct symtab_and_line val
;
1709 struct minimal_symbol
*msymbol
;
1711 p
= (copy
[1] == '$') ? copy
+ 2 : copy
+ 1;
1712 while (*p
>= '0' && *p
<= '9')
1714 if (!*p
) /* Reached end of token without hitting non-digit. */
1716 /* We have a value history reference. */
1717 struct value
*val_history
;
1718 sscanf ((copy
[1] == '$') ? copy
+ 2 : copy
+ 1, "%d", &index
);
1719 val_history
= access_value_history ((copy
[1] == '$') ? -index
: index
);
1720 if (TYPE_CODE (value_type (val_history
)) != TYPE_CODE_INT
)
1721 error (_("History values used in line specs must have integer values."));
1722 valx
= value_as_long (val_history
);
1726 /* Not all digits -- may be user variable/function or a
1727 convenience variable. */
1729 /* Look up entire name as a symbol first. */
1730 sym
= lookup_symbol (copy
, 0, VAR_DOMAIN
, 0);
1731 file_symtab
= (struct symtab
*) NULL
;
1733 /* Symbol was found --> jump to normal symbol processing. */
1735 return symbol_found (funfirstline
, canonical
, copy
, sym
, NULL
);
1737 /* If symbol was not found, look in minimal symbol tables. */
1738 msymbol
= lookup_minimal_symbol (copy
, NULL
, NULL
);
1739 /* Min symbol was found --> jump to minsym processing. */
1741 return minsym_found (funfirstline
, msymbol
);
1743 /* Not a user variable or function -- must be convenience variable. */
1744 if (!get_internalvar_integer (lookup_internalvar (copy
+ 1), &valx
))
1745 error (_("Convenience variables used in line specs must have integer values."));
1750 /* Either history value or convenience value from above, in valx. */
1751 val
.symtab
= file_symtab
? file_symtab
: default_symtab
;
1754 val
.pspace
= current_program_space
;
1756 values
.sals
= (struct symtab_and_line
*) xmalloc (sizeof val
);
1757 values
.sals
[0] = val
;
1761 build_canonical_line_spec (values
.sals
, NULL
, canonical
);
1768 /* Decode a linespec that's a variable. If FILE_SYMTAB is non-NULL,
1769 look in that symtab's static variables first. If NOT_FOUND_PTR is not NULL and
1770 the function cannot be found, store boolean true in the location pointed to
1771 and do not issue an error message. */
1773 static struct symtabs_and_lines
1774 decode_variable (char *copy
, int funfirstline
, char ***canonical
,
1775 struct symtab
*file_symtab
, int *not_found_ptr
)
1779 struct minimal_symbol
*msymbol
;
1781 sym
= lookup_symbol (copy
,
1783 ? BLOCKVECTOR_BLOCK (BLOCKVECTOR (file_symtab
),
1785 : get_selected_block (0)),
1789 return symbol_found (funfirstline
, canonical
, copy
, sym
, file_symtab
);
1791 msymbol
= lookup_minimal_symbol (copy
, NULL
, NULL
);
1793 if (msymbol
!= NULL
)
1794 return minsym_found (funfirstline
, msymbol
);
1799 if (!have_full_symbols ()
1800 && !have_partial_symbols ()
1801 && !have_minimal_symbols ())
1802 throw_error (NOT_FOUND_ERROR
,
1803 _("No symbol table is loaded. Use the \"file\" command."));
1804 throw_error (NOT_FOUND_ERROR
, _("Function \"%s\" not defined."), copy
);
1810 /* Now come some functions that are called from multiple places within
1813 /* We've found a symbol SYM to associate with our linespec; build a
1814 corresponding struct symtabs_and_lines. */
1816 static struct symtabs_and_lines
1817 symbol_found (int funfirstline
, char ***canonical
, char *copy
,
1818 struct symbol
*sym
, struct symtab
*file_symtab
)
1820 struct symtabs_and_lines values
;
1822 if (SYMBOL_CLASS (sym
) == LOC_BLOCK
)
1824 /* Arg is the name of a function */
1825 values
.sals
= (struct symtab_and_line
*)
1826 xmalloc (sizeof (struct symtab_and_line
));
1827 values
.sals
[0] = find_function_start_sal (sym
, funfirstline
);
1830 /* Don't use the SYMBOL_LINE; if used at all it points to
1831 the line containing the parameters or thereabouts, not
1832 the first line of code. */
1834 /* We might need a canonical line spec if it is a static
1836 if (file_symtab
== 0)
1838 struct blockvector
*bv
= BLOCKVECTOR (SYMBOL_SYMTAB (sym
));
1839 struct block
*b
= BLOCKVECTOR_BLOCK (bv
, STATIC_BLOCK
);
1840 if (lookup_block_symbol (b
, copy
, NULL
, VAR_DOMAIN
) != NULL
)
1841 build_canonical_line_spec (values
.sals
, copy
, canonical
);
1848 error (_("\"%s\" is not a function"), copy
);
1849 else if (SYMBOL_LINE (sym
) != 0)
1851 /* We know its line number. */
1852 values
.sals
= (struct symtab_and_line
*)
1853 xmalloc (sizeof (struct symtab_and_line
));
1855 memset (&values
.sals
[0], 0, sizeof (values
.sals
[0]));
1856 values
.sals
[0].symtab
= SYMBOL_SYMTAB (sym
);
1857 values
.sals
[0].line
= SYMBOL_LINE (sym
);
1861 /* This can happen if it is compiled with a compiler which doesn't
1862 put out line numbers for variables. */
1863 /* FIXME: Shouldn't we just set .line and .symtab to zero
1864 and return? For example, "info line foo" could print
1866 error (_("Line number not known for symbol \"%s\""), copy
);
1870 /* We've found a minimal symbol MSYMBOL to associate with our
1871 linespec; build a corresponding struct symtabs_and_lines. */
1873 static struct symtabs_and_lines
1874 minsym_found (int funfirstline
, struct minimal_symbol
*msymbol
)
1876 struct objfile
*objfile
= msymbol_objfile (msymbol
);
1877 struct gdbarch
*gdbarch
= get_objfile_arch (objfile
);
1878 struct symtabs_and_lines values
;
1881 values
.sals
= (struct symtab_and_line
*)
1882 xmalloc (sizeof (struct symtab_and_line
));
1883 values
.sals
[0] = find_pc_sect_line (SYMBOL_VALUE_ADDRESS (msymbol
),
1884 (struct obj_section
*) 0, 0);
1885 values
.sals
[0].section
= SYMBOL_OBJ_SECTION (msymbol
);
1887 /* The minimal symbol might point to a function descriptor;
1888 resolve it to the actual code address instead. */
1889 pc
= gdbarch_convert_from_func_ptr_addr (gdbarch
,
1892 if (pc
!= values
.sals
[0].pc
)
1893 values
.sals
[0] = find_pc_sect_line (pc
, NULL
, 0);
1897 struct symtab_and_line sal
;
1899 values
.sals
[0].pc
= find_function_start_pc (gdbarch
,
1901 values
.sals
[0].section
);
1903 sal
= find_pc_sect_line (values
.sals
[0].pc
, values
.sals
[0].section
, 0);
1905 /* Check if SKIP_PROLOGUE left us in mid-line, and the next
1906 line is still part of the same function. If there is no
1907 line information here, sal.pc will be the passed in PC. */
1908 if (sal
.pc
!= values
.sals
[0].pc
1909 && (lookup_minimal_symbol_by_pc_section (values
.sals
[0].pc
,
1910 values
.sals
[0].section
)
1911 == lookup_minimal_symbol_by_pc_section (sal
.end
,
1912 values
.sals
[0].section
)))
1913 /* Recalculate the line number (might not be N+1). */
1914 values
.sals
[0] = find_pc_sect_line (sal
.end
, values
.sals
[0].section
, 0);